Integration Center

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

Organisasi menggunakan YiDA Edisi Dedicated.
Organisasi memiliki sistem layanan sendiri yang dapat mengekspos layanan berbasis HTTP untuk dipanggil YiDA.
Layanan memenuhi persyaratan Format Callback YiDA.
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.

Tambah Tindakan Konektor

Untuk petunjuk pembuatan Tindakan Konektor, lihat: https://docs.aliwork.com/docs/yida_support/wtwabe/zevvr1/_1/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.

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.

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

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

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.

Memulai

Mulai Cepat

Manajemen Formulir

Desain Alur Kerja

Desain Laporan

Desain Tabel Agregat

Desain Portal

Halaman Kustom

Integrasi & Otomatisasi

Cool App

Manajemen Aplikasi

Manajemen Platform

Internasionalisasi

YiDA Dedicated

Fitur Pengembang

Ikhtisar fitur

Cara menggunakan

Prasyarat

Alur integrasi

Buat Konektor HTTP

Tambah Tindakan Konektor

Tindakan Konektor: Buat tugas

Tindakan Konektor: Selesaikan tugas

Tindakan Konektor: Batalkan tugas

Tindakan Konektor: Hapus tugas

Proses penandatanganan

Konfigurasikan kebijakan sinkronisasi

Hasil

FAQ

​Ikhtisar fitur

​Cara menggunakan

​Prasyarat

​Alur integrasi

​Buat Konektor HTTP

​Tambah Tindakan Konektor

Tindakan Konektor: Buat tugas

Tindakan Konektor: Selesaikan tugas

Tindakan Konektor: Batalkan tugas

Tindakan Konektor: Hapus tugas

​Proses penandatanganan

​Konfigurasikan kebijakan sinkronisasi

​Hasil

​FAQ

Ikhtisar fitur

Cara menggunakan

Prasyarat

Alur integrasi

Buat Konektor HTTP

Tambah Tindakan Konektor

Proses penandatanganan

Konfigurasikan kebijakan sinkronisasi

Hasil

FAQ