Tugas Pemetaan Data

Tugas Pemetaan Data memungkinkan Anda melakukan penetapan variabel dalam integrasi Anda. mendapatkan dan mengatur properti objek json, dan menerapkan fungsi transformasi tersarang ke nilai. Variabel dapat berupa variabel integrasi atau variabel tugas.

Misalnya, Anda dapat menetapkan nilai dari variabel integrasi X ke variabel tugas Y atau dari variabel tugas Y ke integrasi variabel X. Untuk informasi selengkapnya tentang variabel dalam Integrasi Apigee, lihat Menggunakan variabel di Integrasi Apigee.

Mengonfigurasi tugas Pemetaan Data

Untuk mengonfigurasi tugas Pemetaan Data, lakukan langkah-langkah berikut:

1. Di UI Apigee, pilih Organisasi Apigee Anda.
2. Klik Develop > Integrasi.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di desainer integrasi.

4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
5. Klik dan tempatkan elemen Pemetaan Data di editor integrasi.
6. Klik elemen Pemetaan Data pada desainer untuk melihat tugas Pemetaan Data panel konfigurasi.
7. Klik Open Data Mapping Editor untuk melihat nilai default tugas dan menambahkan pemetaan baru. Untuk langkah-langkah mendetail tentang menambahkan pemetaan, lihat Menambahkan pemetaan.

   Untuk informasi selengkapnya tentang tata letak editor pemetaan data, lihat Ringkasan pemetaan data.

Menambahkan pemetaan

Untuk menambahkan pemetaan, lakukan langkah-langkah berikut:

1. Di panel konfigurasi tugas Pemetaan Data, klik Open Data Mapping Editor.
2. Konfigurasikan Input pemetaan:
   1. Tarik variabel atau subkolomnya dari daftar Variabel ke baris Input. Untuk melihat subkolom variabel yang tersedia, klik expand_more (Luaskan) di samping variabel tersebut dalam daftar Variabel.
   2. Atau, di baris Input, klik Variabel atau Nilai, lalu lakukan tindakan berikut:
      • Pilih Variabel untuk menelusuri dan menggunakan variabel yang ada. Untuk membuat variabel baru, klik + Tambahkan variabel baru, lalu masukkan nama dan jenis data dari variabel baru.
      • Pilih Nilai untuk memasukkan nilai literal dari jenis string, integer, double, atau Boolean).
      • Pilih Fungsi untuk menelusuri dan menggunakan fungsi dasar.

        Fungsi dasar digunakan untuk mengambil atau menghasilkan nilai selama eksekusi integrasi. Misalnya, membuat UUID acak atau mengambil region integrasi saat ini. Untuk mengetahui informasi tentang fungsi dasar yang didukung, lihat Fungsi dasar yang didukung.

      • Klik Simpan.
   3. Klik + (Tambahkan fungsi) pada variabel input, nilai, atau fungsi dasar di baris Input untuk menambahkan fungsi pemetaan dari daftar fungsi pemetaan yang tersedia. Fungsi pemetaan dapat memiliki satu atau beberapa parameter. Selanjutnya, setiap parameter dapat memiliki nilai, variabel, atau fungsi dasar yang diikuti dengan rantai fungsi pemetaan.
      • Untuk menambahkan fungsi bertingkat, klik + (Tambahkan fungsi) di samping parameter fungsi. Demikian pula, untuk menghapus atau menghapus fungsi yang baru ditambahkan, klik - (Hapus fungsi sebelumnya).
      • Untuk menambahkan, menghapus, atau mengubah fungsi di antara ekspresi pemetaan, klik fungsi lalu pilih Tambahkan Fungsi, Hapus Fungsi, atau Ubah Fungsi masing-masing dari menu drop-down.

      Untuk mengetahui informasi selengkapnya tentang fungsi pemetaan, lihat fungsi pemetaan.

      Untuk informasi tentang fungsi pemetaan yang didukung, lihat Jenis data dan fungsi pemetaan yang didukung.

      • Untuk menghapus variabel di dalam ekspresi pemetaan, klik cancel (Remove) di samping baris variabel.
      • Untuk menghapus seluruh baris Input, klik clear (Clear) di baris.
3. Konfigurasikan Output pemetaan:
   1. Tarik variabel dari daftar Variabel ke baris Output. Jika variabel tersebut tidak yang tersedia, lalu klik buat baru untuk mengonfigurasi nama dan jenis data variabel baru. Secara opsional, Anda dapat mengklik variabel output dan memilih apakah akan menggunakan variabel tersebut sebagai output integrasi, atau sebagai input untuk integrasi lain.
   2. Untuk menghapus variabel output, klik clear (Hapus).
4. (Opsional) Untuk menghapus baris pemetaan, klik delete (Hapus pemetaan ini).
5. Tutup Editor Pemetaan Data setelah pemetaan selesai. Setiap perubahan akan disimpan secara otomatis.

Pemetaan data yang telah selesai dapat dilihat dari panel konfigurasi tugas Pemetaan Data, seperti yang ditunjukkan dalam gambar berikut:

Jenis data dan fungsi pemetaan yang didukung

Integrasi Apigee mendukung jenis data berikut untuk variabel dalam tugas Pemetaan Data:

• String dan array String
• Array bilangan bulat dan bilangan bulat
• Array Ganda dan Ganda
• Array Boolean dan Boolean
• JSON

Fungsi dasar yang didukung

Praktik terbaik

Menggunakan tugas Pemetaan Data dapat menjadi cara yang ampuh untuk mengubah dan meneruskan variabel kunci ke berbagai tugas dalam integrasi Anda. Berikut ini adalah beberapa kiat yang perlu diingat saat Anda integrasi:

• Pemetaan dijalankan secara berurutan dari atas ke bawah. Artinya, jika variabel input A dipetakan ke variabel output B di baris pertama, variabel tersebut B tersedia untuk pemetaan di baris berikutnya.
• Di setiap baris, jenis data baris Input harus cocok dengan jenis data pada baris Output. Untuk melakukan transmisi antar-jenis, gunakan fungsi transformasi seperti TO_STRING dan TO_INT.
• Tidak ada batasan untuk panjang perantaian transformasi. Namun, melakukan proses debug pada transformasi berantai besar bisa jadi sulit. Sebaiknya pertahankan agar transformasi input tetap dapat dibaca dan pisahkan transformasi yang kompleks menjadi beberapa pemetaan.
• Jika pemetaan memerlukan nilai penggantian, tetapkan nilai penggantian untuk pemetaan. Jika Anda tidak memberikan nilai penggantian, pemetaan akan menampilkan error saat nilai input atau transformasi menampilkan null.
• Saat menghapus variabel, pastikan untuk menghapus pemetaan yang memuatnya.

Untuk mengetahui informasi tentang batas penggunaan yang berlaku bagi tugas Pemetaan Data, lihat Batas penggunaan.

Pertimbangan

Untuk variabel JSON, berdasarkan skema JSON, Integrasi Apigee menafsirkan properti turunan variabel sebagai jenis JSON dalam kasus berikut:

• Jika jenis properti turunan menetapkan null. Contoh:

  {
    "properties": {
      "PersonID": {
        "type": [
          "double",
          "null"
        ],
        "readOnly": false
      }
    }
  }
  

• Apakah jenis properti turunan menentukan beberapa jenis data. Contoh:

  {
    "properties": {
      "PersonID": {
        "type": [
          "integer",
          "string",
          "number"
        ],
        "readOnly": false
      }
    }
  }
  

Dalam kasus ini, menggunakan fungsi pemetaan data, Anda harus secara eksplisit mengonversi variabel turunan ke jenis yang diinginkan.

Contoh berikut menggambarkan berbagai jenis deklarasi properti dan menunjukkan cara menggunakan fungsi pemetaan data untuk mendapatkan jenis yang diinginkan:

{
  "type": "object",
  "properties": {
    "dbIntegers": {
      "type": "array",
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "dbBooleans": {
      "type": [
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  }
}

dbIntegers.TO_INT_ARRAY()

{
  "type": "object",
  "properties": {
    "dbId": {
      "type": [
        "number",
        "null"
      ],
      "readOnly": false
    },
    "dbStatus": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": false
    }
  }
}

dbId.TO_DOUBLE()

dbStatus.TO_BOOLEAN()

{
  "type": "object",
  "properties": {
    "dbString": {
      "type": [
        "string"
      ],
      "readOnly": false
    }
  }
}

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.