Skip to main content

​
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:
ModulNama API dan tautan dokumentasiDeskripsiKasus penggunaanDetail
PlatformKueri catatan eksekusi panggilan layanan formulir YiDAKueri catatan eksekusi panggilan layanan untuk ID formulir YiDA tertentu, termasuk status panggilan, endpoint, dan hasilnya.Contoh: pada daftar manajemen data aplikasi YiDA di sebuah organisasi, gunakan API ini untuk mengambil detail catatan panggilan layanan bagi suatu instans formulir.—
Kueri daftar aplikasi YiDAKueri daftar aplikasi YiDA di suatu organisasi, termasuk status, ikon, dan kode aplikasi.Contoh: gunakan API ini untuk mengambil detail aplikasi YiDA di Organisasi Anda.—
Kueri dan operasi dataKueri instans formulir dengan kondisi pencarian lanjutanAmbil detail instans formulir menggunakan Filter.Pada halaman yang ditampilkan, masukkan Filter untuk mengueri instans formulir yang memenuhi kondisi. Contoh: filter berdasarkan pengirim formulir atau waktu mulai pembuatan.1. Setelah beralih ke struktur penyimpanan pencarian baru, batas maksimum hasil kueri naik dari 5.000 menjadi 30.000 rekam.
2. Pencarian eksak dan fuzzy kini didukung, menggantikan perilaku sebelumnya yang hanya mendukung pencarian fuzzy.
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.
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.
Kueri data instans formulirPanggil API ini untuk mengueri data instans formulir.
Get workflow instanceAmbil informasi instans alur kerja YiDA, termasuk ID instans, waktu pembuatan, dan pemrakarsa.Contoh: panggil API ini untuk mengambil detail instans alur kerja pada daftar alur kerja aplikasi YiDA di sebuah organisasi.
Ambil data subformulirPanggil API ini untuk memperoleh data komponen subformulir menggunakan ID instans formulir dan identifikasi unik komponen subformulir.—
Ambil data tabel utamaKueri data tabel utama secara terpisah.Jika halaman formulir berisi banyak komponen subformulir (bukan banyak instans subformulir) dan openAPI “Kueri data formulir” mengalami timeout, pisahkan operasi menjadi dua langkah:
Langkah 1: Gunakan Ambil data tabel utama untuk mengueri tabel utama.
Langkah 2: Gunakan Ambil data subformulir untuk mengueri data subformulir yang diperlukan.
Tambah atau perbarui instans formulirFilter 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.Data asli
Terdapat data yang memenuhi kondisi
Tidak ada data yang cocok, sehingga rekam baru dibuat		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.)
Operasi batchBuat instans formulir secara batchBuat data instans formulir secara batch dan kembalikan ID instans yang baru dibuat.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”.
Data formulir asli
Data setelah panggilan berhasil
  1. Jika aturan bisnis tidak dieksekusi, jumlah maksimum instans formulir yang dapat dibuat batch per panggilan sinkron atau asinkron adalah 100.
  2. Jika aturan bisnis dieksekusi

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

      Perbarui nilai komponen dalam instans formulir secara batchPerbarui nilai komponen dalam instans formulir YiDA secara batch berdasarkan ID instans formulir YiDA.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”.
      Data formulir asli
      Data formulir setelah panggilan berhasil
      1. Jika aturan bisnis tidak dieksekusi, jumlah maksimum instans formulir yang dapat diperbarui batch per panggilan sinkron atau asinkron adalah 500.
      2. Jika aturan bisnis dieksekusi

        Perbarui instans formulir secara batch berdasarkan data instans formulirPerbarui informasi instans formulir secara batch berdasarkan data komponen formulir YiDA.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.
        Data formulir asli
        Data formulir setelah panggilan berhasil
        Ambil data instans formulir secara batchAmbil detail instans formulir secara batch, termasuk nama instans dan pengirim.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.
        KomponenSimpan data formulir (pembuatan tunggal)Panggil API ini untuk membuat instans formulir YiDA tanpa proses persetujuan.
        Pembuatan batch, sama seperti Buat instans formulir secara batch———
        LainnyaAPI self-invocation platform YiDA tidak stabilDiselesaikan: searchFieldJson.json kadang gagal mengembalikan data untuk waktu yang lama, terutama setelah indikator pemuatan ditambahkan (menyegarkan halaman mengatasi masalah).Solusi: gunakan /dingtalk/web/APP_PR185LWG5XWYCPITZ58C/query/formProcInstData/getInstanceDatasLight.json untuk mengatur ukuran data subformulir yang dikembalikan per kueri.—
        Menghapus API berikut———
        Menyusun ulang kategori API:
        • Beberapa API yang sebelumnya berada di kategori “Tugas” telah dipindahkan ke kategori “Formulir/Alur kerja”.
        		———