All Products
Search

This Product

    DataWorks:Uji, publikasikan, dan gunakan fungsi

    Document Center

    DataWorks:Uji, publikasikan, dan gunakan fungsi

    Last Updated:Jun 21, 2026

    Topik ini menjelaskan cara menguji, mempublikasikan, dan menggunakan fungsi di DataService Studio. Fungsi tersebut dapat digunakan sebagai filter untuk memproses permintaan dan respons API.

    Prasyarat

    Sebelum menguji fungsi, pastikan Anda telah membuat dan menyimpannya. Untuk informasi selengkapnya, lihat Manage functions.

    Batasan

    Hanya Pemilik ruang kerja dan Pengguna RAM dengan peran Workspace Administrator, Develop, atau O&M yang dapat menguji fungsi. Untuk informasi selengkapnya, lihat Add a workspace member and manage role permissions.

    Langkah 1: Uji fungsi

    1. Buka halaman Data Services.

      1. Login ke DataWorks console. Di Wilayah target, klik Data Analysis and Service > DataService Studio di panel navigasi kiri. Pilih ruang kerja dari daftar drop-down dan klik Go to DataService Studio.

      2. Di halaman Service Development, pada daftar fungsi, klik ganda fungsi yang sedang dikembangkan.

    2. Di halaman edit fungsi, klik Test di bilah alat atas.

      ## --- AviatorScript ---
## $0: nama default parameter input.
## Ekspresi harus dipisahkan oleh titik koma ";".
## Contoh 1:
## $0.a: Dapatkan atribut "a" dari parameter input "$0".
## $0.b[index]: Dapatkan indeks array "b" dari parameter input "$0". Indeks tidak boleh berupa ekspresi atau variabel.
## Contoh 2:
## Input: {"keyA":[1,2],"keyB":"value"}
## Fungsi: $0.keyA[0]=3; $0.keyB="new_value"; return $0;
## Output: {"keyA":[3,2],"keyB":"new_value"}

    3. Di kotak dialog Function Test, masukkan parameter dan klik Confirm.

      Anda dapat melihat status eksekusi di tab Run Results di bagian bawah. Jika pengujian gagal, periksa pesan error, modifikasi fungsi sesuai kebutuhan, lalu uji kembali.

    Langkah 2: Publikasikan fungsi

    Setelah fungsi lolos pengujian, Anda dapat mempublikasikannya.

    1. Di halaman Service Development, pada daftar fungsi, klik ganda fungsi yang telah lolos pengujian.

    2. Di bilah alat atas, klik Submission.

    3. Di halaman edit fungsi, klik Version di panel navigasi kanan. Temukan versi dengan status Can Be Published dan klik Publish di kolom Actions.

      Catatan

      Setelah mempublikasikan fungsi, Anda dapat mengklik Version di panel navigasi kanan pada halaman edit fungsi untuk melihat riwayat publikasi. Anda kemudian dapat melihat Version Details atau mengklik Roll Back.

    Langkah 3: Gunakan fungsi

    Kasus penggunaan

    • Sebagai pre-filter API, fungsi dapat melakukan pemrosesan awal terhadap parameter permintaan API saat dipanggil.

    • Sebagai post-filter API, fungsi dapat melakukan pemrosesan lanjutan dan mentransformasi respons API.

    Batasan

    • Pre-filter dan post-filter untuk suatu API harus menggunakan jenis fungsi yang sama—keduanya harus berupa fungsi Aviator atau keduanya harus berupa fungsi Python.

    • Fitur fungsi Python sedang dalam proses Peningkatan. Oleh karena itu, pembuatan, kloning, dan publikasi fungsi Python baru saat ini tidak didukung.

    Gunakan sebagai filter API

    1. Di halaman Service Development, perluas Workflow > API.

    2. Klik ganda API untuk membuka halaman editnya.

    3. Di panel navigasi kanan, klik Filter.

      Pilih kotak centang Use Pre-filter atau Use Post-filter. Function Type secara default bernilai Aviator Function. Klik daftar drop-down untuk pre-filter atau post-filter untuk memilih satu atau beberapa fungsi. Jika Anda menambahkan beberapa fungsi, fungsi tersebut akan dijalankan sesuai urutan penambahan untuk memproses parameter API.

      Catatan

      • Filter terdiri dari satu atau beberapa fungsi yang memproses awal parameter permintaan API atau memproses lebih lanjut hasil kueri.

      • Jika Anda tidak menemukan fungsi yang dituju dalam daftar drop-down, pastikan fungsi tersebut telah dipublikasikan. Anda juga dapat membuat dan mempublikasikan fungsi baru. Untuk informasi selengkapnya, lihat Publish the function.

    4. Klik Preview Responses Returned by API Operation untuk memverifikasi output filter.