> ## 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.

# Integration Center

> Artikel ini menjelaskan cara menghubungkan data tugas ke pusat tugas atau sistem tugas organisasi Anda melalui platform YiDA, mencakup langkah-langkah rinci untuk mengonfigurasi Konektor HTTP, menyiapkan tindakan Konektor, dan menangani Peristiwa terkait Persetujuan.

## **Ikhtisar fitur**

Setelah data dikirim melalui halaman proses YiDA, data tugas dihasilkan di pusat tugas, baik pada tingkat aplikasi maupun tingkat organisasi. Tugas dikategorikan berdasarkan status menjadi "Dibuat oleh saya", "Untuk diproses oleh saya", "Diproses oleh saya", dan "CC untuk saya". Seiring proses berjalan, data ini disimpan, diperbarui, dan dikueri oleh layanan YiDA.

Organisasi pada YiDA Edisi Dedicated dapat menggunakan fitur integrasi pesan tugas persetujuan perusahaan di Integration Center untuk menghubungkan layanan YiDA ke pusat tugas atau sistem tugas milik sendiri. Ketika proses Aplikasi menghasilkan atau memperbarui tugas, YiDA memanggil layanan Organisasi untuk mengirim (push) datanya.

Setelah Konektor terkonfigurasi, setiap tugas Persetujuan (semua tugas) dari setiap Aplikasi YiDA di dalam Organisasi otomatis dikirim ke alamat layanan terdaftar yang ditampilkan di bawah. Melalui Callback layanan terkait, Organisasi dapat memproses dan mengonsumsi Peristiwa Persetujuan YiDA secara selektif sesuai kebutuhan.

## **Cara menggunakan**

### **Prasyarat**

1. Organisasi menggunakan YiDA Edisi Dedicated.
2. Organisasi memiliki sistem layanan sendiri yang dapat mengekspos layanan berbasis HTTP untuk dipanggil YiDA.
3. Layanan memenuhi persyaratan Format Callback YiDA.
4. Layanan dapat diakses melalui jaringan.

### **Alur integrasi**

#### **Buat Konektor HTTP**

Buat Konektor HTTP di Organisasi target dan Konfigurasikan layanan yang akan dihubungkan, seperti ditampilkan di bawah:

Anda dapat membuat Konektor terpisah untuk setiap layanan antarmuka dengan satu Tindakan per Konektor, atau membuat beberapa Tindakan dalam satu Konektor untuk mewakili layanan antarmuka yang berbeda.

* Konfigurasikan lima Tindakan Konektor yang bersesuaian dengan pembuatan, penyelesaian, pembatalan, penghapusan, dan CC tugas Persetujuan. Serupa dengan Webhook, ketika Peristiwa ini terpicu, sistem YiDA otomatis melakukan Callback ke alamat terdaftar [www.yourCorpService.com/xx-interface](http://www.yourCorpService.com/xx-interface).

#### **Tambah Tindakan Konektor**

Untuk petunjuk pembuatan Tindakan Konektor, lihat:

[https://docs.aliwork.com/docs/yida\_support/wtwabe/zevvr1/\_1/zbq17y](/id/yida/platform-admin/zbq17y)

Catatan: Saat memanggil layanan Callback pusat tugas dedicated, antarmuka sudah menyertakan Mekanisme coba-lagi verifikasi Tanda tangan. Anda dapat memilih "Tanpa Autentikasi" saat membuat Tindakan Konektor. Jika Anda tetap memerlukan Autentikasi Konektor, ikuti dokumentasi Konektor.

Bagian berikut menjelaskan informasi yang diperlukan oleh pusat tugas dedicated.

##### **Tindakan Konektor: Buat tugas**

* Metode HTTP: POST

* Parameter permintaan:

* Respons: Tidak ada persyaratan khusus.

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Contoh data detail tugas yang dikembalikan saat tugas dibuat oleh saya:
{
  "actionerId": null,
  "actionerName": null,
  "appType": "APP_RY60OCRF33Z7534***",
  "createTime": 1693462062502,
  "currentActivityInstances": null,
  "dataMap": {
    "cascadeDateField_l4sbkqco": null,
    "selectField_l523dlqi_value": null,
    "selectField_l523dlqi_value_en_us": null,
    "multiSelectField_l523dlqk": null,
    "numberField_l4s57vma": "1",
    "selectField_l523dlqi": null,
    "imageField_llyrklcy": "",
    "textareaField_l4s57vmf": "",
    "textField_l4s57vm9": "",
    "tableField_l4s57vmb": "[{\"numberField_li9yr6gs\":\"\",\"textField_l4s57vmc\":\"\",\"textField_l4s57vmd\":\"\",\"textField_l51tzkqs\":\"\"}]"
  },
  "dataType": "pinst",
  "deep3": true,
  "finishTime": null,
  "formInstanceId": "65ab8549-aa06-486a-b5b7-8abe845303a5",
  "formUuid": "FORM-MT866EA1X3N9W79GDQM2HB400M413OS76A2GL51",
  "instValue": "***"
  "modifiedTime": 1693462062502,
  "modifyUserAvatar": "",
  "modifyUserDisplayName": "",
  "modifyUserId": "01690741902689",
  "openAvatar": "",
  "openId": "",
  "openNickname": "",
  "openSource": "",
  "originatorAvatar": "https://static.dingtalk.com/media/lALPDfJ6d8zhRL_NAbjNAbg_440_440.png",
  "originatorCorpId": "ding5d17e3add038d44535c2f4657eb6378f",
  "originatorCorpName": "",
  "originatorDisplayName": "Jane Doe",
  "originatorId": "01690741902689",
  "processApprovedResult": "",
  "processApprovedResultText": "",
  "processCode": "TPROC--9BC6687125N9XAJ8873I0864QY122BZ96A2GL1",
  "processId": 0,
  "processInstanceId": "",
  "processInstanceStatus": "",
  "processInstanceStatusText": "",
  "processName": "",
  "serialNo": "",
  "title": "Permintaan pengunjung untuk 1 orang oleh **",
  "version": 10
}
```

##### **Tindakan Konektor: Selesaikan tugas**

* Metode HTTP: POST

* Parameter permintaan:

* Respons: Tidak ada persyaratan khusus.

##### Tindakan Konektor: Batalkan tugas

* Metode HTTP: POST

* Parameter permintaan:

* Respons: Tidak ada persyaratan khusus.

##### **Tindakan Konektor: Hapus tugas**

Catatan: Penghapusan tugas saat ini hanya terjadi ketika sebuah instansi dihapus. Oleh karena itu, ID instansi diteruskan sebagai parameter saat layanan di-Callback.

* Metode HTTP: POST

* Parameter permintaan:

* Respons: Tidak ada persyaratan khusus.

#### **Proses penandatanganan**

Tanda tangan antarmuka Callback layanan mengenkripsi Parameter permintaan menggunakan MD5. Hasil enkripsi diteruskan ke Penyedia layanan melalui parameter sign. systemToken Aplikasi YiDA diperlukan sebagai kunci penandatanganan.

1. Urutkan semua kunci Parameter permintaan menggunakan String.CASE\_INSENSITIVE\_ORDER.
2. Gabungkan nilai parameter yang bersesuaian sesuai urutan kunci untuk membentuk string yang akan dienkripsi.
3. Tambahkan systemToken ke string hasil langkah 2.
4. Enkripsi string dari langkah 3 dengan algoritma MD5 menggunakan set karakter UTF-8.

<Warning>
  ⚠️ Catatan: systemToken adalah App Secret. Temukan di Pengaturan Aplikasi > Deployment dan Operasi > App Secret.
</Warning>

### Konfigurasikan kebijakan sinkronisasi

* Di Integration Center, Konfigurasikan Konektor Persetujuan yang sudah ada.

## Hasil

Sebagai contoh, diagram di bawah ini menunjukkan bagaimana seorang pelanggan industri menggunakan kapabilitas integrasi dan pengembangan YiDA Edisi Dedicated untuk mengonsolidasikan tugas Persetujuan ke dalam pusat tugas Persetujuan yang dibangun sendiri, sekaligus menyatukan proses BPM di berbagai Aplikasi sistem YiDA serta sistem bisnis, produksi, dan administrasi milik Organisasi pada berbagai platform.

## FAQ

**T: Setelah Integration Center dikonfigurasi, apakah berlaku untuk data historis?**

J: Tidak. Konfigurasi hanya berlaku untuk data baru.

**T: Jika layanan yang di-push oleh Integration Center mengembalikan Kesalahan karena kegagalan pada sistem pelanggan, apakah YiDA menyediakan cara untuk mengueri log terkait? Apakah tersedia Mekanisme coba-lagi cadangan saat push gagal?**

J: YiDA Integration Center digerakkan oleh Peristiwa. Saat ini tidak disediakan mekanisme cadangan, dan sistem belum menyertakan logika coba-lagi.
