> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mendapatkan nilai kolom laporan absensi

> Panggil API DingTalk Smart Attendance untuk mengambil nilai dan informasi kolom laporan absensi berdasarkan ID pengguna, ID kolom laporan, dan rentang waktu.

Panggil API ini untuk mendapatkan data nilai kolom dari laporan DingTalk Smart Attendance. Data mencakup semua nilai kolom laporan dalam rentang waktu tertentu beserta informasi kolom terkait, untuk digunakan oleh ISV yang ditunjuk.

## Deskripsi panggilan API

* Informasi absensi pengguna yang sudah keluar dari organisasi tidak tersedia melalui API ini. Cari data absensi pengguna yang sudah keluar di [OA Admin Console](https://attend.dingtalk.io/portal/index.html).
* Saat mengambil nilai bidang "Hari absensi wajib", API ini hanya mengembalikan nilai dalam 15 hari terakhir. Untuk tanggal lebih dari 15 hari yang lalu, nilai hari absensi wajib adalah 0.

## Permintaan

| **Informasi dasar** | |
| - | - |
| URL HTTP | [https://api.dingtalk.io/topapi/attendance/getcolumnval](https://api.dingtalk.io/topapi/attendance/getcolumnval) |
| Metode HTTP | POST |
| Tipe aplikasi yang didukung | appType-Aplikasi internal　appType-Aplikasi perusahaan pihak ketiga |
| Izin | permission-qyapi\_base-Izin dasar yang diperlukan untuk memanggil API organisasi |

### Parameter query

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| access\_token | String | Ya | 6d1bxxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini.   - Untuk Aplikasi internal, panggil API [Mendapatkan access\_token Aplikasi internal](https://help.dingtalk.io/id/open/development/obtain-orgapp-token) untuk memperolehnya. - Untuk Aplikasi perusahaan pihak ketiga, panggil API untuk mendapatkan access\_token organisasi pihak ketiga untuk memperolehnya. |

### Isi permintaan

| Nama | Tipe | Wajib | Contoh | Deskripsi |
| - | - | - | - | - |
| userid | String | Ya | manager4220 | ID pengguna dari pengguna terkait. |
| column\_id\_list | String | Ya | 129339038 | ID kolom laporan. Panggil API [Mendapatkan definisi kolom laporan absensi](https://help.dingtalk.io/id/open/development/queries-the-enterprise-attendance-report-column.md) untuk memperoleh nilai parameter id. Pisahkan beberapa nilai dengan koma. Panjang maksimum: 20. |
| from\_date | Date | Ya | 2018-07-11 12:12:12 | Waktu mulai. |
| to\_date | Date | Ya | 2018-07-11 12:12:12 | Waktu selesai. Selisih antara waktu mulai dan waktu selesai tidak boleh lebih dari 31 hari. |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/getcolumnval" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=4bfc0fxxxx3916c7' \
-d 'column_id_list=1%2C2%2C3' \
-d 'from_date=2018-07-11+12%3A12%3A12' \
-d 'to_date=2018-07-11+12%3A12%3A12' \
-d 'userid=zhangsan'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getcolumnval");
OapiAttendanceGetcolumnvalRequest req = new OapiAttendanceGetcolumnvalRequest();
req.setUserid("manager4220");
req.setColumnIdList("129339038");
req.setFromDate(StringUtils.parseDateTime("2020-09-07 12:12:12"));
req.setToDate(StringUtils.parseDateTime("2020-09-09 12:12:12"));
OapiAttendanceGetcolumnvalResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());
```

Python

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import dingtalk.api

req=dingtalk.api.OapiAttendanceGetcolumnvalRequest("https://api.dingtalk.io/topapi/attendance/getcolumnval")

req.userid="zhangsan"
req.column_id_list="1,2,3"
req.from_date="2018-07-11 12:12:12"
req.to_date="2018-07-11 12:12:12"
try:
  resp= req.getResponse(access_token)
  print(resp)
except Exception,e:
  print(e)
```

PHP

```php theme={"theme":{"light":"github-light","dark":"github-dark"}}
include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiAttendanceGetcolumnvalRequest;
$req->setUserid("zhangsan");
$req->setColumnIdList("1,2,3");
$req->setFromDate("2018-07-11 12:12:12");
$req->setToDate("2018-07-11 12:12:12");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/getcolumnval");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/getcolumnval");
OapiAttendanceGetcolumnvalRequest req = new OapiAttendanceGetcolumnvalRequest();
req.Userid = "zhangsan";
req.ColumnIdList = "1,2,3";
req.FromDate = DateTime.Parse("2018-07-11 12:12:12");
req.ToDate = DateTime.Parse("2018-07-11 12:12:12");
OapiAttendanceGetcolumnvalResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama | Tipe | Contoh | Deskripsi |
| - | - | - | - |
| request\_id | String | 45n2azecqj21 | ID permintaan. |
| errcode | Number | 0 | Kode pengembalian. |
| result | ColumnValListForTopVo | | Hasil yang dikembalikan. |
| column\_vals | ColumnValForTopVo\[] | | Informasi kolom dan data nilai kolom. |
| column\_vals | ColumnDayAndVal\[] | | Data nilai kolom. |
| date | Date | 2020-09-09 00:00:00 | Tanggal. |
| value | String | 1.0 | Nilai kolom. |
| column\_vo | ColumnForTopVo | | Informasi kolom. |
| id | Number | 129339038 | ID kolom laporan. |
| fixed\_value | String | 0 | Nilai tetap.  **Catatan**  Beberapa kolom laporan memiliki nilai tetap. Nilainya hanya dikembalikan di bidang ini, tidak di column\_vals. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": {
    "column_vals": [
      {
        "column_vals": [
          {
            "date": "2020-09-07 00:00:00",
            "value": "1.0"
          },
          {
            "date": "2020-09-08 00:00:00",
            "value": "1.0"
          },
          {
            "date": "2020-09-09 00:00:00",
            "value": "1.0"
          }
        ],
        "column_vo": {
          "id": 129339038
        }
      }
    ]
  },
  "request_id": "45n2azecqj21"
}
```

### Kode error

Jika terjadi error saat memanggil API ini, cari solusinya di dokumen [Kode error global](https://help.dingtalk.io/id/open/development/server-api-error-codes-1.md) berdasarkan pesan error yang muncul.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.