Integrasi proses dan halaman DingTalk

1. Pengenalan fitur

Panduan ini membantu admin perusahaan atau developer mengintegrasikan proses persetujuan dan halaman pada sistem Persetujuan OA DingTalk dengan sistem bisnis pihak ketiga (seperti ERP, CRM, dan sistem keuangan), guna mewujudkan pintu masuk terpadu, pertukaran data, dan keterhubungan proses. Melalui integrasi ini, Anda dapat meningkatkan tingkat otomatisasi perkantoran, menghindari input berulang, serta memperbaiki efisiensi kolaborasi lintas sistem.

2. Skenario penggunaan

Mulai proses dari sistem bisnis, panggil API resmi Persetujuan OA DingTalk untuk membuat proses Persetujuan OA DingTalk, lalu buka halaman detail persetujuan DingTalk di sisi DingTalk untuk memproses alurnya.

3. Alur bisnis

Alur interaksi menyeluruh antara sistem bisnis dan sisi DingTalk adalah sebagai berikut:

Diagram alur bisnis integrasi proses dan halaman Persetujuan OA DingTalk: sistem bisnis memulai persetujuan, lalu membuka halaman detail resmi di sisi DingTalk untuk pemrosesan dan pengambilan status

4. Efek implementasi

1. Memulai proses dari sistem bisnis untuk membuat proses Persetujuan OA

Sistem bisnis memanggil API Persetujuan OA DingTalk untuk memulai persetujuan dan secara otomatis membuat proses Persetujuan OA DingTalk:

Halaman inisiasi sistem bisnis membuat formulir persetujuan pengembalian biaya melalui API Persetujuan OA

2. Membuka halaman detail Persetujuan OA resmi dari daftar Persetujuan OA DingTalk untuk melakukan persetujuan

Klik formulir persetujuan pada daftar Persetujuan OA DingTalk untuk membuka halaman detail resmi:

Membuka halaman detail persetujuan resmi dari daftar Persetujuan OA DingTalk, menampilkan konten formulir dan catatan proses

3. Membuka halaman detail Persetujuan OA resmi dari Tugas DingTalk untuk melakukan persetujuan

Klik tugas pada Pusat Tugas DingTalk untuk membuka halaman detail resmi:

Membuka halaman detail Persetujuan OA resmi dari Pusat Tugas DingTalk untuk melakukan tindakan persetujuan

5. Alur pengembangan

Alur interaksi API antara Aplikasi internal dan Persetujuan OA DingTalk adalah sebagai berikut:

Diagram sekuens interaksi API antara Aplikasi internal dan Persetujuan OA DingTalk, mencakup pembuatan templat, inisiasi instance, tindakan persetujuan, dan notifikasi callback

Pengenalan alur integrasi

Dokumen ini menunjukkan cara membuat Aplikasi internal dan menggunakan API terkait Persetujuan OA resmi—melalui API seperti membuat/memperbarui templat persetujuan resmi, memulai/menarik kembali/berkomentar pada instance persetujuan, menyetujui/menolak/mengalihkan tugas persetujuan, mengunggah/mengunduh lampiran persetujuan, serta peristiwa callback instance Persetujuan OA resmi/tugas persetujuan—guna mewujudkan skenario integrasi di mana sistem bisnis melakukan inisiasi dan halaman detail Persetujuan OA resmi dibuka di sisi DingTalk.

Prasyarat: selesaikan alur Buat aplikasi. Langkah 1: Masuk ke halaman detail aplikasi, lalu dapatkan client ID dan Client Secret aplikasi; Langkah 2: Ajukan Izin API, khususnya izin terkait “Persetujuan OA”; Langkah 3: Dapatkan kredensial akses aplikasi melalui Dapatkan access token Aplikasi internal. Saat memanggil API, gunakan access token untuk mengautentikasi identitas pemanggil; Langkah 4: Panggil API terkait Persetujuan OA:

Buat templat Persetujuan OA resmi: Admin dapat membuatnya secara manual di Admin Console OA, atau sistem bisnis dapat memanggil Server API versi baru — antarmuka Buat atau perbarui templat formulir persetujuan untuk memperoleh kode unik templat processCode. Jika processCode yang dikembalikan API tidak tersimpan, Anda dapat masuk ke Admin Console DingTalk untuk melihatnya;

Kode templat persetujuan dapat dilihat pada pengaturan templat di Admin Console:

Halaman pengaturan templat persetujuan di Admin Console OA, tempat kode unik templat processCode dapat dilihat

{
    "name": "Integrasi proses dan halaman Persetujuan OA DingTalk",
    "description": "Anda dapat memulai proses dari sistem bisnis, memanggil API resmi Persetujuan OA DingTalk untuk membuat proses Persetujuan OA DingTalk, kemudian membuka halaman detail persetujuan DingTalk di sisi DingTalk untuk memproses alurnya.",
    "templateConfig": {
        "disableStopProcessButton": false,
        "disableFormEdit": false,
        "disableHomepage": false,
        "hidden": false
    },
    "formComponents": [
        {
            "componentType": "TextField",
            "props": {
                "label": "Kotak input satu baris", // Judul kontrol
                "placeholder": "Silakan masukkan", // Petunjuk input
                "componentId": "TextField_17EZKEGSOCTC0", // ID kontrol, unik dalam formulir, tanpa makna bisnis
                "required": false, // Wajib atau tidak, default opsional
                "bizAlias": "staffId" // Identifier bisnis kontrol, unik dalam formulir, pilih salah satu dengan componentId
            }
        },
        {
            "componentType": "TextareaField",
            "props": {
                "label": "Kotak input multi-baris",
                "placeholder": "Silakan masukkan konten Teks multi-baris, gunakan \r\n untuk ganti baris", // Petunjuk input
                "componentId": "TextareaField_17EZKEGSOCTC0",
                "required": false
            }
        },
        {
            "componentType": "NumberField",
            "props": {
                "label": "Kotak input Angka",
                "placeholder": "Silakan masukkan angka",
                "componentId": "NumberField_108PIFZM21F40",
                "required": false,
                "unit": "Yuan", // Satuan Angka
                "defaultValue": "10" // Default
            }
        },
        {
            "componentType": "DDSelectField",
            "props": {
                "options": [ // Daftar opsi yang dapat dipilih
                    {
                        "value": "Opsi 1", // Nama tampilan opsi
                        "key": "option_0" // Kunci unik dalam kontrol, opsional, sistem akan membuatnya secara default
                    },
                    {
                        "value": "Opsi 2",
                        "key": "option_1"
                    },
                    {
                        "value": "Opsi 3",
                        "key": "option_2"
                    },
                    {
                        "key": "other", // Kunci khusus untuk opsi lainnya
                        "value": "Lainnya"
                    }
                ],
                "label": "Kotak Pilih",
                "placeholder": "Silakan pilih",
                "componentId": "DDSelectField_14T8M4EKXAV40",
                "required": false
            }
        },
        {
            "componentType": "DDMultiSelectField",
            "props": {
                "options": [
                    {
                        "value": "Opsi 1",
                        "key": "option_0"
                    },
                    {
                        "value": "Opsi 2",
                        "key": "option_1"
                    },
                    {
                        "value": "Opsi 3",
                        "key": "option_2"
                    },
                    {
                        "key": "other", // Kunci khusus untuk opsi lainnya
                        "value": "Lainnya"
                    }
                ],
                "label": "Kotak Pilih Banyak",
                "placeholder": "Silakan pilih",
                "componentId": "DDMultiSelectField_1XJ7NG1GSD6O0",
                "required": false
            }
        },
        {
            "componentType": "DDDateField",
            "props": {
                "unit": "小时", // Format tanggal, Nilai enum (小时 jam, 天 hari)
                "format": "yyyy-MM-dd HH:mm", // Format tanggal, opsional, jam berkorespondensi dengan yyyy-MM-dd HH:mm, hari berkorespondensi dengan yyyy-MM-dd HH:mm
                "bizAlias": "",
                "label": "Tanggal",
                "placeholder": "Silakan pilih",
                "componentId": "DDDateField_SQL0DF3MS9C0",
                "required": false,
                "defaultValue": "2021-12-21 17:46" // Default
            }
        },
        {
            "componentType": "DDDateRangeField",
            "props": {
                "unit": "小时",
                "format": "yyyy-MM-dd HH:mm",
                "bizAlias": "",
                "label": "[\"Waktu Mulai\",\"Waktu Selesai\"]",
                "placeholder": "Silakan pilih",
                "componentId": "DDDateRangeField_7MPG14N3OOO0",
                "duration": true, // Apakah durasi dihitung otomatis
                "required": false
            }
        },
        {
            "componentType": "TextNote",
            "props": {
                "link": "https://www.dingtalk.io/", // Hyperlink
                "notPrint": "0",
                "bizAlias": "",
                "componentId": "TextNote_13RP7230RAF40",
                "content": "Teks keterangan" // Teks keterangan
            }
        },
        {
            "componentType": "PhoneField",
            "props": {
                "mode": "phone", // Nilai enum: phone_tel: ponsel dan telepon rumah, phone: ponsel, tel: telepon rumah
                "label": "Telepon",
                "placeholder": "Silakan masukkan",
                "componentId": "PhoneField_Y0XWOX6ZP6O0",
                "required": false
            }
        },
        {
            "componentType": "DDPhotoField",
            "props": {
                "label": "Gambar",
                "componentId": "DDPhotoField_P50A0HMHB280",
                "required": false
            }
        },
        {
            "componentType": "MoneyField",
            "props": {
                "upper": "0", // Nominal perlu huruf besar (0 tidak, 1 perlu), default perlu huruf besar
                "label": "Nominal (Yuan)",
                "placeholder": "Silakan masukkan nominal",
                "componentId": "MoneyField_L1PP26ZDV400",
                "required": false
            }
        },
        {
            "componentType": "DDAttachment",
            "props": {
                "label": "Lampiran",
                "componentId": "DDAttachment_18U4QTOWLMPS0",
                "required": false
            }
        },
        {
            "componentType": "InnerContactField",
            "props": {
                "label": "Kontak",
                "placeholder": "Silakan pilih",
                "componentId": "InnerContactField_162USP4V1BC00",
                "choice": "1", // Nilai enum: 1 mendukung Pilih Banyak, 0 Pilih tunggal, default 0
                "required": false,
                "bizAlias": ""
            }
        },
        {
            "componentType": "DepartmentField",
            "props": {
                "multiple": false, // Apakah mendukung Pilih Banyak, true Pilih Banyak, false Pilih tunggal
                "label": "Departemen",
                "placeholder": "Silakan pilih",
                "componentId": "DepartmentField_1GY5JSPOCY000",
                "required": false
            }
        },
        {
            "componentType": "RelateField",
            "props": {
                "label": "Formulir persetujuan terkait",
                "placeholder": "Silakan pilih",
                "componentId": "RelateField_5X1DL4KMKUW0",
                "required": false,
                "bizAlias": "",
                "availableTemplates": [ // Daftar templat persetujuan yang dapat diasosiasikan, kosong berarti dapat mengasosiasikan data instance dari semua templat persetujuan
                    {
                        "name": "Persetujuan OA Resmi-POP-0328-Rentang tanggal 7", // Nama formulir persetujuan yang dapat diasosiasikan
                        "processCode": "PROC-AF45DE4C-7520-4842-9128-EB7BD0A4EA85" // formCode formulir persetujuan yang dapat diasosiasikan
                    }
                ]
            }
        },
        {
            "componentType": "AddressField",
            "props": {
                "addressModel": "district", // Nilai enum, city provinsi/kota, district provinsi/kota/distrik, street provinsi/kota/distrik-jalan
                "bizAlias": "",
                "label": "Provinsi/Kota/Distrik",
                "componentId": "AddressField_1P9H21H8R2LC0",
                "required": false
            }
        },
        {
            "componentType": "StarRatingField",
            "props": {
                "limit": 5, // Nilai enum: skala 5, skala 10
                "label": "Peringkat",
                "placeholder": "Silakan masukkan",
                "componentId": "StarRatingField_10E5NHTA2W0G0",
                "required": false,
                "bizAlias": ""
            }
        },
        {
            "children": [ // Daftar sub-kontrol dalam detail, daftar sub-kontrol mengikuti standar atribut masing-masing kontrol
                {
                    "componentType": "TextField",
                    "props": {
                        "label": "Kotak input satu baris",
                        "placeholder": "Silakan masukkan",
                        "componentId": "TextField_1UE1ZY1A28AO0",
                        "required": false
                    }
                },
                {
                    "componentType": "MoneyField",
                    "props": {
                        "payEnable": false,
                        "upper": "0",
                        "bizAlias": "",
                        "label": "Nominal (Yuan)",
                        "placeholder": "Silakan masukkan nominal",
                        "componentId": "MoneyField_1S85G4YLMM5C0",
                        "required": false
                    }
                },
                {
                    "componentType": "NumberField",
                    "props": {
                        "unit": "Yuan",
                        "payEnable": false,
                        "bizAlias": "",
                        "label": "Kotak input Angka",
                        "placeholder": "Silakan masukkan angka",
                        "componentId": "NumberField_1XP6AWG50SE80",
                        "required": false
                    }
                }
            ],
            "componentType": "TableField",
            "props": {
                "tableViewMode": "table", // Metode pengisian detail, Nilai enum: list: daftar, table: tabel
                "verticalPrint": true, // Metode Cetak detail, true: vertikal, false: horizontal
                "statField": [ // Pengaturan penghitungan total untuk kontrol Angka dan nominal
                    {
                        "componentId": "MoneyField_1S85G4YLMM5C0",
                        "label": "Nominal (Yuan)"
                    },
                    {
                        "componentId": "NumberField_1XP6AWG50SE80",
                        "label": "Kotak input Angka"
                    }
                ],
                "bizAlias": "",
                "label": "Spreadsheet",
                "componentId": "TableField_1MLEPEAQSXHC0"
            }
        }
    ]
}

Setelah templat persetujuan berhasil dibuat, pengguna dapat melihat/mengedit templat formulir Persetujuan OA resmi, melihat/mencari data templat, mengekspor/menghapus data templat, dan tindakan lainnya di Admin Console Persetujuan OA DingTalk;

Mulai instance Persetujuan OA resmi: Pengguna dapat memulai persetujuan secara manual melalui aplikasi resmi Persetujuan OA, atau sistem bisnis dapat memanggil Server API versi baru — antarmuka Mulai instance persetujuan berdasarkan processCode templat untuk memulai instance persetujuan dan memperoleh instanceId instance persetujuan;

{
    "processCode": "PROC-C512D64A-60F6-4F83-B708-xxx",
    "originatorUserId": "manager98xx",
    "deptId": -1,
    "microappAgentId": 348925476,
    "formComponentValues": [
        {
            "name": "Tanggal",
            "value": "2021-08-17"
        },
        {
            "name": "[\"Waktu Mulai\",\"Waktu Selesai\"]",
            "value": "[\"2019-02-19\",\"2019-02-25\"]"
        },
        {
            "name": "KTP",
            "value": "xxxx"
        },
        {
            "name": "Gambar",
            "value": "[\"http://url1\",\"http://url2\",\"http://url3\"]"
        },
        {
            "name": "Spreadsheet",
            "value": "[[{\"name\":\"Kotak input satu baris\",\"value\":\"[Baidu](https://www.baidu.com/)\"},{\"name\":\"Kotak input Angka\",\"value\":\"100\"}]]"
        },
        {
            "name": "Nominal (Yuan)",
            "value": "100"
        },
        {
            "name": "Lampiran",
            "value": "[{\"spaceId\": \"163xxxx658\", \"fileName\": \"2644.JPG\", \"fileSize\": \"333\", \"fileType\": \"jpg\", \"fileId\": \"643xxxx140\"}]"
        },
        {
            "name": "Provinsi/Kota/Distrik",
            "value": "Beijing,Kota Beijing,Distrik Hedong"
        },
        {
            "name": "Peringkat",
            "value": "5"
        },
        {
            "name": "Kotak Teks",
            "value": "Contoh Kotak Teks"
        }
    ],
    "approvers": [
        {
            "actionType": "NONE",
            "userIds": [
                "manager98xx"
            ]
        },
        {
            "actionType": "OR",
            "userIds": [
                "manager98xx"
            ]
        }
    ]
}

Setelah instance persetujuan berhasil dimulai, pengguna dapat masuk ke Pusat Persetujuan OA DingTalk untuk melihat empat Daftar utama persetujuan (Belum diproses, Sudah diproses, Sudah diinisiasi, Yang saya terima), mencari data instance persetujuan, mengeksekusi persetujuan, dan tindakan lainnya;
Tambah Lampiran komentar persetujuan: Jika perlu menambahkan Lampiran komentar persetujuan, unggah dahulu file ke ruang Drive persetujuan, lalu panggil Server API versi baru — antarmuka Tambah komentar persetujuan. Untuk Panduan penggunaan lengkap, lihat: Alur komentar dan penarikan kembali persetujuan:
1. Panggil dahulu Server API versi baru — antarmuka Dapatkan informasi ruang Drive persetujuan untuk memperoleh izin unggah ruang Drive dan spaceId ruang Drive persetujuan;
2. Panggil client-side JSAPI — antarmuka Unggah Lampiran ke Drive/Pilih file dari Drive untuk memperoleh informasi dasar file. Alur contoh ini diimplementasikan menggunakan JSAPI Explorer;
3. Setelah memperoleh spaceId ruang Drive persetujuan, panggil Server API versi baru — antarmuka Tambah komentar persetujuan berdasarkan instanceId instance persetujuan untuk menambahkan komentar pada Formulir persetujuan.

{
    "commentUserId": "manager98xx",
    "processInstanceId": "DQ7-X2EESQunrozGEe_xxx",
    "text": "Uji tambah komentar persetujuan",
    "file": {
        "attachments": [
            {
                "spaceId": "817447xxx",
                "fileSize": "173404",
                "fileId": "6660150xxx",
                "fileName": "lampiran-komentar.jpg",
                "fileType": "jpg"
            }
        ],
        "photos": [
            "https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9227796361/p352432.png"
        ]
    }
}

Pratinjau dan Unduh Lampiran persetujuan: Jika perlu melakukan Pratinjau/Unduh Lampiran, panggil Server API — antarmuka Otorisasi Unduh file Drive persetujuan dan antarmuka Otorisasi Pratinjau Lampiran persetujuan untuk memberikan otorisasi pada file Drive persetujuan, lalu panggil Server API — antarmuka Unduh Lampiran persetujuan untuk memperoleh Tautan file downloadUri sebagai sarana pengunduhan. Untuk Panduan penggunaan lengkap, lihat: Alur operasi Lampiran persetujuan;
Setujui/tolak tugas persetujuan: pemberi persetujuan dapat menyetujui atau menolak tugas persetujuan secara manual melalui Pusat Persetujuan OA DingTalk atau Pusat Tugas DingTalk. Alternatifnya, sistem bisnis dapat memanggil Server API versi baru — antarmuka Dapatkan detail satu instance persetujuan berdasarkan instanceId instance persetujuan untuk memperoleh detail instance persetujuan beserta informasi taskId setiap node tugas dari tugas persetujuan;

Berdasarkan instanceId instance persetujuan dan taskId node tugas yang bersesuaian, panggil Server API versi baru — antarmuka Setujui atau tolak tugas persetujuan untuk melaksanakan tindakan tugas persetujuan. Setelah semua node persetujuan menyetujui, Formulir persetujuan tersebut dinyatakan lulus;

{
    "actionerUserId": "manager98xx",
    "processInstanceId": "fsTunaLIRyeRMrddA1YwZQ0964170020xxxx",
    "remark": "Setuju",
    "taskId": 8333450,
    "result": "agree",
    "file": {
        "attachments": [
            {
                "space_id": "817447xxxx",
                "file_size": "173404",
                "file_id": "6660150xxxx",
                "file_name": "lampiran-komentar.jpg",
                "file_type": "jpg"
            }
        ],
        "photos": [
            "https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/9227796361/p352432.png"
        ]
    }
}

Tarik kembali instance Persetujuan OA resmi: Setelah meninjau persetujuan, jika Anda menemukan bahwa Formulir persetujuan yang dikirim salah dan perlu ditarik kembali, panggil Server API versi baru — Tarik kembali instance persetujuan berdasarkan instanceId instance persetujuan untuk melakukan tindakan penarikan kembali Formulir persetujuan;
{ "isSystem": true, "processInstanceId": "oKPAxjtgSP-AqeVTk-xxxx", "operatingUserId": "manager98xx", "remark": "Tarik kembali instance persetujuan" }
Setelah status Formulir persetujuan berubah, Persetujuan OA mendukung Push peristiwa Callback seperti perubahan status tugas persetujuan dan perubahan status instance persetujuan ke sistem bisnis, sehingga aplikasi perusahaan dapat terintegrasi lebih dalam dengan platform DingTalk untuk berbagi informasi dan berkolaborasi. Untuk Panduan penggunaan lengkap, lihat: Panduan operasi Langganan peristiwa.

6. API yang digunakan

1. Formulir persetujuan

API	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Buat atau perbarui templat persetujuan	Buat atau perbarui templat formulir alur Persetujuan OA, dengan opsi menentukan daftar kontrol formulir dan menghasilkan proses persetujuan default.	Buat atau perbarui templat formulir persetujuan
Dapatkan schema formulir	Dapatkan informasi schema formulir yang bersesuaian melalui processCode.	Dapatkan schema formulir
Dapatkan informasi node dalam alur Formulir persetujuan	Dapatkan informasi node dalam alur Formulir persetujuan.	Dapatkan informasi node dalam alur Formulir persetujuan
Dapatkan daftar Formulir persetujuan yang terlihat oleh Pengguna tertentu	Dapatkan daftar Formulir persetujuan yang terlihat oleh Karyawan tersebut secara paginasi berdasarkan ID pengguna Karyawan.	Dapatkan daftar Formulir persetujuan yang terlihat oleh Pengguna tertentu
Dapatkan semua formulir yang dapat dikelola oleh perusahaan saat ini	Dapatkan semua Formulir persetujuan yang dapat dikelola oleh perusahaan saat ini.	Dapatkan semua formulir yang dapat dikelola oleh perusahaan saat ini

2. Instance persetujuan

API	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Mulai instance persetujuan	Mulai instance Persetujuan OA.	Mulai instance persetujuan
Dapatkan detail satu instance persetujuan	Dapatkan detail instance persetujuan berdasarkan ID instance persetujuan.	Dapatkan detail satu instance persetujuan
Tarik kembali instance persetujuan	Tarik kembali instance persetujuan yang telah dimulai.	Tarik kembali instance persetujuan
Tambah komentar persetujuan	Tambahkan komentar pada instance persetujuan.	Tambah komentar persetujuan
Dapatkan daftar ID instance persetujuan	Dapatkan daftar ID instance persetujuan Departemen terkait dalam Cakupan izin.	Dapatkan daftar ID instance persetujuan

3. Ruang Drive persetujuan & Lampiran

API	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Dapatkan informasi ruang Drive persetujuan	Dapatkan ID ruang Drive persetujuan dan berikan izin unggah Lampiran kepada Pengguna saat ini.	Dapatkan informasi ruang Drive persetujuan
Otorisasi Pratinjau Lampiran persetujuan	Otorisasi Pratinjau Lampiran persetujuan.	Otorisasi Pratinjau Lampiran persetujuan
Otorisasi Unduh file Drive persetujuan	Berikan izin Unduh ruang Drive persetujuan untuk file Drive berdasarkan spaceId ruang Drive dan fileId file.	Otorisasi Unduh file Drive persetujuan
Unduh Lampiran persetujuan	Dapatkan otorisasi Unduh file persetujuan dan hasilkan Tautan Unduh.	Unduh Lampiran persetujuan

4. Tugas persetujuan

API	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Setujui atau tolak tugas persetujuan	Proses satu tugas persetujuan berdasarkan ID templat, ID instance, ID node persetujuan, dan pemberi persetujuan yang ditentukan.	Setujui atau tolak tugas persetujuan
Dapatkan jumlah persetujuan yang menunggu Pengguna	Dapatkan jumlah persetujuan yang belum diproses oleh Pengguna berdasarkan ID pengguna Pengguna.	Dapatkan jumlah persetujuan yang menunggu Pengguna
Alihkan tugas Persetujuan OA	Alihkan tugas Persetujuan OA.	Alihkan tugas Persetujuan OA

5. Peristiwa callback persetujuan

5.1 Peristiwa callback untuk jenis Aplikasi internal

Peristiwa callback	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Instance persetujuan dimulai, selesai, dihentikan, dihapus	Ketika instance persetujuan dimulai, selesai, dihentikan, atau dihapus, server DingTalk melakukan Push peristiwa instance persetujuan ke URL callback developer.	Instance persetujuan dimulai, selesai, dihentikan, dihapus
Tugas persetujuan dimulai, selesai, dibatalkan	Konten yang di-push kepada pelanggan ketika peristiwa persetujuan berupa tugas persetujuan dimulai, selesai, atau dibatalkan.	Tugas persetujuan dimulai, selesai, dibatalkan

5.2 Peristiwa callback untuk Aplikasi perusahaan pihak ketiga

Peristiwa callback	Deskripsi	Spesifikasi versi baru (Server API versi baru)
Perubahan status instance persetujuan (broadcast)	Skenario peristiwa broadcast persetujuan. Templat Formulir persetujuan yang Milik suatu ISV atau aplikasi Persetujuan OA resmi mungkin juga perlu diotorisasi ke ISV lain untuk integrasi sistem. Setelah otorisasi perusahaan diperoleh melalui jsapi mendapatkan data instance persetujuan berotorisasi, untuk templat persetujuan yang telah diotorisasi, ketika instance dan status tugas Formulir persetujuan yang bersesuaian berubah, callback akan di-push ke ISV yang telah diotorisasi.	Perubahan status instance persetujuan (broadcast)
Perubahan status tugas persetujuan (broadcast)	Skenario peristiwa broadcast persetujuan. Templat Formulir persetujuan yang Milik suatu ISV atau aplikasi Persetujuan OA resmi mungkin juga perlu diotorisasi ke ISV lain untuk integrasi sistem. Setelah otorisasi perusahaan diperoleh melalui jsapi mendapatkan data instance persetujuan berotorisasi, untuk templat persetujuan yang telah diotorisasi, ketika instance dan status tugas Formulir persetujuan yang bersesuaian berubah, callback akan di-push ke ISV yang telah diotorisasi.	Perubahan status tugas persetujuan (broadcast)
Perubahan status instance persetujuan (terarah)	Skenario peristiwa terarah persetujuan. Persetujuan OA resmi yang dibuat oleh ISV melalui API terbuka, atau templat “ISV suite” yang dibuat pengguna di Admin Console OA. Pada skenario ini, templat persetujuan tersebut Milik ISV, sehingga ketika pengguna di sisi DingTalk atau pihak ketiga memicu perubahan status instance dan tugas yang bersesuaian melalui API, callback akan di-push secara terarah ke aplikasi ISV yang bersesuaian.	Perubahan status instance persetujuan (terarah)
Perubahan status tugas persetujuan (terarah)	Skenario peristiwa terarah persetujuan. Persetujuan OA resmi yang dibuat oleh ISV melalui API terbuka, atau templat “ISV suite” yang dibuat pengguna di Admin Console OA. Pada skenario ini, templat persetujuan tersebut Milik ISV, sehingga ketika pengguna di sisi DingTalk atau pihak ketiga memicu perubahan status instance dan tugas yang bersesuaian melalui API, callback akan di-push secara terarah ke aplikasi ISV yang bersesuaian.	Perubahan status tugas persetujuan (terarah)

7. Dokumen terkait

Ikhtisar solusi terbuka Pusat proses

Ikhtisar empat solusi integrasi sistem bisnis perusahaan dengan Persetujuan OA DingTalk

Integrasi halaman proses pihak ketiga

Sistem bisnis melakukan inisiasi; halaman detail sistem bisnis dibuka di sisi DingTalk untuk persetujuan

Mulai cepat

Panduan peran

Panduan admin

Kemampuan lanjutan

Integrasi proses dan halaman DingTalk

1. Pengenalan fitur

2. Skenario penggunaan

3. Alur bisnis

4. Efek implementasi

1. Memulai proses dari sistem bisnis untuk membuat proses Persetujuan OA

2. Membuka halaman detail Persetujuan OA resmi dari daftar Persetujuan OA DingTalk untuk melakukan persetujuan

3. Membuka halaman detail Persetujuan OA resmi dari Tugas DingTalk untuk melakukan persetujuan

5. Alur pengembangan

Pengenalan alur integrasi

6. API yang digunakan

1. Formulir persetujuan

2. Instance persetujuan

3. Ruang Drive persetujuan & Lampiran

4. Tugas persetujuan

5. Peristiwa callback persetujuan

5.1 Peristiwa callback untuk jenis Aplikasi internal

5.2 Peristiwa callback untuk Aplikasi perusahaan pihak ketiga

7. Dokumen terkait

Ikhtisar solusi terbuka Pusat proses

Integrasi halaman proses pihak ketiga

​1. Pengenalan fitur

​2. Skenario penggunaan

​3. Alur bisnis

​4. Efek implementasi

​1. Memulai proses dari sistem bisnis untuk membuat proses Persetujuan OA

​2. Membuka halaman detail Persetujuan OA resmi dari daftar Persetujuan OA DingTalk untuk melakukan persetujuan

​3. Membuka halaman detail Persetujuan OA resmi dari Tugas DingTalk untuk melakukan persetujuan

​5. Alur pengembangan

​Pengenalan alur integrasi

​6. API yang digunakan

​1. Formulir persetujuan

​2. Instance persetujuan

​3. Ruang Drive persetujuan & Lampiran

​4. Tugas persetujuan

​5. Peristiwa callback persetujuan

​5.1 Peristiwa callback untuk jenis Aplikasi internal

​5.2 Peristiwa callback untuk Aplikasi perusahaan pihak ketiga

​7. Dokumen terkait

Ikhtisar solusi terbuka Pusat proses

Integrasi halaman proses pihak ketiga

1. Pengenalan fitur

2. Skenario penggunaan

3. Alur bisnis

4. Efek implementasi

1. Memulai proses dari sistem bisnis untuk membuat proses Persetujuan OA

2. Membuka halaman detail Persetujuan OA resmi dari daftar Persetujuan OA DingTalk untuk melakukan persetujuan

3. Membuka halaman detail Persetujuan OA resmi dari Tugas DingTalk untuk melakukan persetujuan

5. Alur pengembangan

Pengenalan alur integrasi

6. API yang digunakan

1. Formulir persetujuan

2. Instance persetujuan

3. Ruang Drive persetujuan & Lampiran

4. Tugas persetujuan

5. Peristiwa callback persetujuan

5.1 Peristiwa callback untuk jenis Aplikasi internal

5.2 Peristiwa callback untuk Aplikasi perusahaan pihak ketiga

7. Dokumen terkait