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

# Catatan iterasi openAPI YiDA

> Rilis ini meningkatkan openAPI YiDA yang ada untuk memberi developer kemampuan yang lebih luas dan pengalaman yang lebih mulus, mencakup 14 perubahan API di 4 modul serta menghapus 11 API yang tidak lagi tersedia.

## 1. Latar belakang

Rilis ini meningkatkan openAPI YiDA yang ada untuk memberi developer YiDA (seperti penyedia layanan ISV atau pengguna YiDA yang perlu memanggil API) kemampuan yang lebih luas dan pengalaman pengembangan yang lebih mulus, sehingga mereka dapat memaksimalkan potensi pengembangannya.

## 2. Daftar konten iterasi

Rilis ini mencakup **14 perubahan API di 4 modul** serta **menghapus 11 API yang tidak lagi tersedia**, dengan rincian sebagai berikut:

<table>
  <tr>
    <td>**Modul**</td>
    <td>**Nama API dan tautan dokumentasi**</td>
    <td>**Deskripsi**</td>
    <td>**Kasus penggunaan**</td>
    <td>**Detail**</td>
  </tr>

  <tr>
    <td rowSpan={2}>**Platform**</td>
    <td>Kueri catatan eksekusi panggilan layanan formulir YiDA</td>
    <td>Kueri catatan eksekusi panggilan layanan untuk ID formulir YiDA tertentu, termasuk status panggilan, endpoint, dan hasilnya.</td>
    <td>Contoh: pada daftar manajemen data aplikasi YiDA di sebuah organisasi, gunakan API ini untuk mengambil detail catatan panggilan layanan bagi suatu instans formulir.</td>
    <td>--</td>
  </tr>

  <tr>
    <td>Kueri daftar aplikasi YiDA</td>
    <td>Kueri daftar aplikasi YiDA di suatu organisasi, termasuk status, ikon, dan kode aplikasi.</td>
    <td>Contoh: gunakan API ini untuk mengambil detail aplikasi YiDA di Organisasi Anda.</td>
    <td>--</td>
  </tr>

  <tr>
    <td rowSpan={6}>**Kueri dan operasi data**</td>
    <td>Kueri instans formulir dengan kondisi pencarian lanjutan</td>
    <td>Ambil detail instans formulir menggunakan Filter.</td>
    <td>Pada halaman yang ditampilkan, masukkan Filter untuk mengueri instans formulir yang memenuhi kondisi. Contoh: filter berdasarkan pengirim formulir atau waktu mulai pembuatan.</td>
    <td rowSpan={3}>1. Setelah beralih ke struktur penyimpanan pencarian baru, batas maksimum hasil kueri naik dari **5.000** menjadi **30.000** rekam.<br />2. Pencarian eksak dan fuzzy kini didukung, menggantikan perilaku sebelumnya yang hanya mendukung pencarian fuzzy.<br />3. Untuk semua API kueri, jika parameter input `searchFieldJson` disediakan, API tersebut kini mendukung kondisi Filter yang digunakan di "Manajemen data". Untuk detailnya, lihat Pencarian dengan kondisi filter manajemen data.<br />4. API Get workflow instance menambahkan parameter input `orderConfigJson` untuk menentukan aturan pengurutan. Untuk cara mengisi parameter ini, lihat Bidang bawaan yang tersedia untuk mengurutkan hasil pencarian.</td>
  </tr>

  <tr>
    <td>Kueri data instans formulir</td>
    <td>Panggil API ini untuk mengueri data instans formulir.</td>

    <td />
  </tr>

  <tr>
    <td>Get workflow instance</td>
    <td>Ambil informasi instans alur kerja YiDA, termasuk ID instans, waktu pembuatan, dan pemrakarsa.</td>
    <td>Contoh: panggil API ini untuk mengambil detail instans alur kerja pada daftar alur kerja aplikasi YiDA di sebuah organisasi.</td>
  </tr>

  <tr>
    <td>Ambil data subformulir</td>
    <td>Panggil API ini untuk memperoleh data komponen subformulir menggunakan ID instans formulir dan identifikasi unik komponen subformulir.</td>

    <td />

    <td>--</td>
  </tr>

  <tr>
    <td>Ambil data tabel utama</td>
    <td>Kueri data tabel utama secara terpisah.</td>

    <td />

    <td>Jika halaman formulir berisi banyak komponen subformulir (bukan banyak instans subformulir) dan openAPI "Kueri data formulir" mengalami timeout, pisahkan operasi menjadi dua langkah:<br />Langkah 1: Gunakan Ambil data tabel utama untuk mengueri tabel utama.<br />Langkah 2: Gunakan Ambil data subformulir untuk mengueri data subformulir yang diperlukan.</td>
  </tr>

  <tr>
    <td>Tambah atau perbarui instans formulir</td>
    <td>Filter instans formulir berdasarkan kondisi yang diberikan. Jika ada instans yang cocok, perbarui dengan nilai formulir yang ditentukan; jika tidak ada instans yang cocok, buat instans baru dengan nilai formulir tersebut.</td>
    <td>Data asli<br />Terdapat data yang memenuhi kondisi<br />Tidak ada data yang cocok, sehingga rekam baru dibuat</td>
    <td>Berlaku untuk kasus ketika openAPI (baik open platform maupun API frontend) harus mematuhi aturan asosiasi bisnis, misalnya memvalidasi nilai Unik dari nomor rekam. (Saat ini duplikat sulit dideteksi dan tidak dapat ditampilkan secara langsung. Contoh: sebelum setiap penulisan, Anda harus mengueri apakah Bidang Unik sudah ada, yang memerlukan lebih dari dua panggilan API per rekam.)</td>
  </tr>

  <tr>
    <td rowSpan={5}>**Operasi batch**</td>
    <td>Buat instans formulir secara batch</td>
    <td>Buat data instans formulir secara batch dan kembalikan ID instans yang baru dibuat.</td>
    <td>Contoh: panggil API ini pada daftar instans YiDA di tampilan manajemen data aplikasi YiDA sebuah organisasi untuk menambahkan instans baru dengan item reimbursement "Tambah instans formulir batch".<br />Data formulir asli<br />Data setelah panggilan berhasil</td>
    <td><ol><li>Jika aturan bisnis tidak dieksekusi, jumlah maksimum instans formulir yang dapat dibuat batch per panggilan sinkron atau asinkron adalah **100**.</li><li>Jika aturan bisnis dieksekusi</li></ol><br /><ol /></td>
  </tr>

  <tr>
    <td>Hapus instans formulir secara batch</td>
    <td>Hapus data instans formulir secara batch dan singkirkan rekam dari daftar instans formulir.</td>
    <td>Contoh: tampilan manajemen data aplikasi YiDA sebuah organisasi berisi empat instans formulir YiDA. Panggil API ini untuk menghapus instans YiDA pertama.<br />Data formulir asli<br />Data formulir setelah panggilan berhasil</td>
    <td><ol><li>Jika aturan bisnis tidak dieksekusi, jumlah maksimum instans formulir yang dapat dihapus batch per panggilan sinkron atau asinkron adalah **500**.</li><li>Jika aturan bisnis dieksekusi</li></ol><br /><ol /></td>
  </tr>

  <tr>
    <td>Perbarui nilai komponen dalam instans formulir secara batch</td>
    <td>Perbarui nilai komponen dalam instans formulir YiDA secara batch berdasarkan ID instans formulir YiDA.</td>
    <td>Contoh: panggil API ini pada daftar instans formulir aplikasi YiDA sebuah organisasi untuk memperbarui nilai komponen item reimbursement di empat formulir sekaligus. Nilai item reimbursement diubah menjadi "Item reimbursement diperbarui".<br />Data formulir asli<br />Data formulir setelah panggilan berhasil</td>
    <td rowSpan={2}><ol><li>Jika aturan bisnis tidak dieksekusi, jumlah maksimum instans formulir yang dapat diperbarui batch per panggilan sinkron atau asinkron adalah **500**.</li><li>Jika aturan bisnis dieksekusi</li></ol><br /><ol /></td>
  </tr>

  <tr>
    <td>Perbarui instans formulir secara batch berdasarkan data instans formulir</td>
    <td>Perbarui informasi instans formulir secara batch berdasarkan data komponen formulir YiDA.</td>
    <td>Contoh: pada daftar manajemen data aplikasi YiDA sebuah organisasi, empat instans formulir YiDA menggunakan komponen item reimbursement. Panggil API ini untuk memperbarui nilai komponen item reimbursement sehingga keempat formulir YiDA ikut diperbarui.<br />Data formulir asli<br />Data formulir setelah panggilan berhasil</td>
  </tr>

  <tr>
    <td>Ambil data instans formulir secara batch</td>
    <td>Ambil detail instans formulir secara batch, termasuk nama instans dan pengirim.</td>
    <td>Contoh: panggil API ini pada daftar instans YiDA di tampilan manajemen data aplikasi YiDA sebuah organisasi untuk mengueri detail instans secara batch berdasarkan ID instans.</td>

    <td />
  </tr>

  <tr>
    <td rowSpan={2}>**Komponen**</td>
    <td>Simpan data formulir (pembuatan tunggal)</td>
    <td>Panggil API ini untuk membuat instans formulir YiDA tanpa proses persetujuan.</td>

    <td />

    <td />
  </tr>

  <tr>
    <td>Pembuatan batch, sama seperti Buat instans formulir secara batch</td>
    <td>--</td>
    <td>--</td>
    <td>--</td>
  </tr>

  <tr>
    <td rowSpan={3}>**Lainnya**</td>
    <td>API self-invocation platform YiDA tidak stabil</td>
    <td>Diselesaikan: `searchFieldJson.json` kadang gagal mengembalikan data untuk waktu yang lama, terutama setelah indikator pemuatan ditambahkan (menyegarkan halaman mengatasi masalah).</td>
    <td>Solusi: gunakan `/dingtalk/web/APP_PR185LWG5XWYCPITZ58C/query/formProcInstData/getInstanceDatasLight.json` untuk mengatur ukuran data subformulir yang dikembalikan per kueri.</td>
    <td>--</td>
  </tr>

  <tr>
    <td>Menghapus API berikut</td>
    <td>--</td>
    <td>--</td>
    <td>--</td>
  </tr>

  <tr>
    <td>Menyusun ulang kategori API:<br /><ul><li>Beberapa API yang sebelumnya berada di kategori "Tugas" telah dipindahkan ke kategori "Formulir/Alur kerja".</li></ul></td>
    <td>--</td>
    <td>--</td>
    <td>--</td>
  </tr>
</table>