：Gunakan pengaturan layanan

Nilai parameter permintaan dan respons

DataService Studio menggunakan JSONPath untuk mendapatkan nilai parameter. JSONPath adalah bahasa query yang memungkinkan Anda mengekstrak data dari file JSON. Untuk informasi lebih lanjut, lihat JSONPath.

Parameter

• Parameter Permintaan Alur Kerja

  Pada tab konfigurasi alur kerja, klik tab Request Param di panel navigasi di sebelah kanan. Kemudian, Anda dapat mengonfigurasi parameter permintaan dalam mode manual adding atau automatic parsing.

  • Manual adding: Klik Add Parameter dan tambahkan parameter permintaan untuk alur kerja secara manual.

  • Automatic parsing: Jika node pertama alur kerja adalah node API, klik Automatically parse request parameters untuk secara otomatis memetakan parameter permintaan node API ini ke parameter permintaan alur kerja.

• Parameter Permintaan Node API

  Klik node API. Di panel yang muncul, klik Input Request Parameters dan tentukan nilai untuk parameter permintaan.

  • Jika Anda tidak menentukan nilai untuk parameter permintaan, DataService Studio mendapatkan nilai parameter yang sama di lapisan pertama string JSON yang dikembalikan oleh node induk, dan menetapkan nilai tersebut ke parameter permintaan.

    Catatan

    Jika node saat ini adalah node pertama alur kerja, nilai parameter permintaan node ini ditetapkan ke parameter yang sama dari alur kerja.

  • Jika Anda menentukan nilai untuk parameter permintaan, DataService Studio menggunakan nilai yang Anda tentukan.

    Catatan

    Untuk merujuk nilai parameter tertentu yang dikembalikan oleh node leluhur tertentu, Anda harus menggunakan ekspresi JSONPath.

• Parameter Respons Node API

  Klik node API. Di panel yang muncul, pilih set output results dan sesuaikan keluaran node menggunakan ekspresi JSON. Contoh kode berikut memberikan contoh:

  {
    "return1":"$.data.rows.user_id",
    "return2":"$.data.rows.user_name"
  }

• Parameter Permintaan Node Python

  Klik node Python. Di panel yang muncul, tentukan parameter permintaan di bidang Request Parameters.

• Parameter Respons Node Python

  Klik node Python. Di panel yang muncul, pilih set output results dan sesuaikan keluaran node menggunakan ekspresi JSON. Contoh kode berikut memberikan contoh:

  {
    "return1":"$.data.rows.user_id",
    "return2":"$.data.rows.user_name"
  }

Contoh

1. Pergi ke halaman DataService Studio.

   Masuk ke Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Di panel navigasi di sebelah kiri, pilih Data Analysis and Service > DataService Studio. Pada halaman yang muncul, pilih ruang kerja yang diinginkan dari daftar drop-down dan klik Go to DataService Studio.

2. Daftarkan API.

   Dalam contoh ini, metode pendaftaran digunakan untuk membuat API.

   1. Di panel navigasi di sebelah kiri, klik ikon untuk pergi ke halaman Service Development.

   2. Geser pointer di atas ikon dan pilih Create API > Register API.

   3. Di kotak dialog Register API, konfigurasikan parameter berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Daftarkan API.

   4. Klik OK.

3. Daftarkan Fungsi.

   1. Di tab Service Development, geser pointer di atas ikon dan pilih Create Function > Create Python Function.

      Anda juga dapat memperluas proses bisnis yang diinginkan, klik kanan Function, dan kemudian pilih Create Function > Create Python Function.

   2. Di kotak dialog Create Python Function, konfigurasikan parameter berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Kelola Fungsi.

   3. Klik OK.

   4. Di tab konfigurasi fungsi, masukkan kode berikut di bagian Edit Code:

      # -*- coding: utf-8 -*-
      # event (str) : in filter it is the API result, in other cases, it is your param
      # context : some environment information, temporarily useless
      # import module limit: json,time,random,pickle,re,math
      import json
      def handler(event,context):
          # load str to json object
          obj = json.loads(event)
          # add your code here
          # end add
          return obj

   5. Di bagian Environment Configuration, konfigurasikan parameter Memory dan Function Timeout.

   6. Klik ikon di toolbar.

4. Buat Alur Kerja.

   1. Di tab Service Development, geser pointer di atas ikon dan pilih Create Workflow.

      Anda juga dapat memperluas proses bisnis yang diinginkan, klik kanan Create Workflow, dan kemudian pilih Create Workflow.

   2. Di kotak dialog Create Workflow, konfigurasikan parameter berdasarkan kebutuhan bisnis Anda.

      

      Parameter	Deskripsi
      API Name	Nama API. Nama harus memiliki panjang 4 hingga 50 karakter dan dapat berisi huruf, angka, dan garis bawah (_). Nama harus dimulai dengan huruf.
      API Path	Jalur untuk menyimpan API, seperti /user. Catatan Jalur dapat memiliki panjang hingga 200 karakter dan dapat berisi huruf, angka, garis miring (/), garis bawah (_), dan tanda hubung (-). Jalur harus dimulai dengan garis miring (/).
      Protocol	Protokol yang digunakan oleh API. Nilai valid: HTTP dan HTTPS. Jika Anda perlu memanggil API menggunakan HTTPS, Anda harus mengaitkan nama domain independen dengan API di konsol API Gateway setelah API dipublikasikan ke API Gateway. Anda juga harus mengunggah Sertifikat Secure Sockets Layer (SSL) di konsol API Gateway. Untuk informasi lebih lanjut, lihat Aktifkan panggilan berbasis HTTPS untuk API.
      Request Method	Metode permintaan. Nilai valid: GET dan POST.
      Response Content Type	Format respons API. Atur nilainya menjadi JSON.
      Visible Range	Rentang pengguna yang dapat melihat API. Nilai valid: Work Space: API terlihat oleh semua anggota di ruang kerja saat ini. Private: API hanya terlihat oleh pemiliknya, dan izin pada API tidak dapat diberikan kepada anggota lain. Catatan Jika Anda menetapkan parameter ini ke Privat, anggota lain di ruang kerja tidak dapat melihat API di daftar API.
      Label	Tag yang ingin Anda tambahkan ke API. Pilih tag dari daftar drop-down Label. Catatan Tag dapat memiliki panjang hingga 20 karakter dan dapat berisi huruf, angka, dan garis bawah (_). Anda dapat mengonfigurasi maksimal lima tag untuk alur kerja.
      Description	Deskripsi API. Deskripsi dapat memiliki panjang hingga 2.000 karakter.
      Destination Folder	Folder untuk menyimpan alur kerja.

   3. Klik OK.

5. Konfigurasikan Alur Kerja.

   1. Di tab konfigurasi alur kerja, seret node ke DAG dan hubungkan node. Gambar berikut menunjukkan contohnya.

      

   2. Klik node API1. Di panel yang muncul, pilih API yang Anda daftarkan dari daftar drop-down Select API, pilih set output results, dan masukkan {"user_id":"$.data[0].id"}.

      

      Gunakan ekspresi JSONPath untuk mengonfigurasi parameter respons. Sintaks untuk mendapatkan nilai parameter adalah ${NodeA.namea}, yang sama dengan sintaks untuk mengonfigurasi parameter permintaan. {"user_id":"$.data[0].id"} menetapkan nilai parameter id elemen pertama dalam array data ke parameter user_id. Kemudian, node API1 mengembalikan {"user_id":"value"} dalam format JSON.

   3. Klik node PYTHON1. Di panel yang muncul, pilih fungsi yang Anda daftarkan dari daftar drop-down Select Function.

   4. Klik node SWITCH1. Di panel yang muncul, klik Set branch conditions.

      Anda dapat memasukkan ekspresi kondisional berdasarkan parameter respons node induk. Sebagai contoh, Anda dapat memasukkan ekspresi dalam format ${Node ID.Parameter}>1 atau $.Parameter>1. Ekspresi kondisional mendukung operator berikut: ==, !=, >=, >, <=, <, &&, !, (), +, -, *, /, dan %.

      Dalam contoh ini, parameter user_id adalah parameter respons dari node API1 dan digunakan sebagai parameter permintaan node SWITCH1.

      Node Cabang 1: $.user_id != 1, menunjukkan bahwa Node Cabang 1 dijalankan jika nilai parameter user_id tidak sama dengan 1.
      Node Cabang 2: $.user_id == 1, menunjukkan bahwa Node Cabang 2 dijalankan jika nilai parameter user_id adalah 1.

   5. Klik node The end. Kemudian, klik tab Response Param di panel navigasi sebelah kanan dan konfigurasikan parameter respons.

6. Uji Alur Kerja.

   1. Klik Test di pojok kanan atas.

   2. Di kotak dialog Test APIs, klik Determine.

   3. Lihat log pelaksanaan dan hasil eksekusi di tab Operation Log dan Execution results di bagian bawah tab konfigurasi.