SAP Ariba Procurement

Konektor SAP Ariba Procurement memungkinkan Anda melakukan operasi penyisipan, update, dan pembacaan pada data SAP Ariba Procurement.

Versi yang didukung

Konektor ini mendukung SAP Ariba Procurement REST API.

Sebelum memulai

Di project Google Cloud Anda, lakukan tugas berikut:

  • Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi, lihat Konektivitas jaringan.
  • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
  • Memberikan peran IAM roles/secretmanager.viewer dan roles/secretmanager.secretAccessor ke akun layanan yang ingin Anda gunakan untuk konektor
  • Aktifkan secretmanager.googleapis.com (Secret Manager API) dan connectors.googleapis.com (Connectors API). Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan layanan.

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.

    Buka halaman Koneksi

  2. Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
  3. Di bagian Lokasi, selesaikan langkah-langkah berikut:
    1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

    2. Klik Berikutnya.
  4. Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
    1. Konektor: Pilih SAP Ariba Procurement dari daftar konektor yang tersedia.
    2. Versi konektor: Pilih versi konektor dari daftar versi yang tersedia.
    3. Di kolom Nama Koneksi, masukkan nama untuk instance koneksi. Nama koneksi dapat berisi huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan diakhiri dengan huruf atau angka, serta tidak boleh lebih dari 49 karakter.
    4. Deskripsi: Masukkan deskripsi untuk instance koneksi.
    5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    7. ANID: Tentukan ID jaringan SAP Ariba Anda.
    8. Kunci API: Masukkan kunci aplikasi OAuth untuk autentikasi.
    9. Realm: Masukkan realm SAP Ariba untuk koneksi.
    10. API: Masukkan SAP Ariba API untuk mengambil data dari.
    11. Pusat Data: Masukkan lokasi geografis tempat data akun Anda dihosting.
    12. Lingkungan: Masukkan lingkungan SAP Ariba yang ingin Anda hubungkan.
    13. Jika perlu, konfigurasikan Setelan node koneksi:

      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

    14. + TAMBAHKAN LABEL: klik ini untuk menambahkan label ke koneksi dalam bentuk pasangan nilai/kunci.
    15. Klik Berikutnya.
  5. Di bagian Authentication, masukkan detail autentikasi.
    1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi SAP Ariba Procurement:

      • OAuth 2.0 - kredensial klien

      Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

    2. Klik Berikutnya.
  6. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  7. Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

  • OAuth 2.0 - kredensial klien
    • Client ID: Masukkan client ID untuk aplikasi yang Anda buat.
    • Rahasia Klien: Masukkan secret manager secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.
    • Versi secret: Pilih versi secret untuk client secret.
    • Aktifkan Penggantian Autentikasi: Aktifkan opsi ini untuk penggantian autentikasi.

Contoh konfigurasi koneksi

Bagian ini mencantumkan contoh nilai untuk berbagai kolom yang Anda konfigurasi saat membuat koneksi.

OAuth 2.0 - jenis koneksi kredensial klien

Nama kolom Detail
Lokasi europe-west1
Konektor SAP Ariba Procurement
Versi konektor 1
Nama Koneksi gcp-sapariba-procurement-po-supplier
Mengaktifkan Cloud Logging Ya
Akun Layanan my-service-account@my-project.iam.gserviceaccount.com
Tingkat Log Debug
ANID AN11234322444-T
Kunci API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Realm 745628447-T
API PurchaseOrdersSupplierAPI-V1
Pusat Data AS
Lingkungan UJI COBA
Jumlah minimum node 2
Jumlah maksimum node 50
Autentikasi OAuth 2.0 - Kredensial klien
ID Klien 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Rahasia Klien projects/617888503870/secrets/AribaProcurement/versions/10
Versi rahasia 10

Batasan sistem

Konektor SAP Ariba Procurement dapat memproses maksimum 3 transaksi per detik, per node, dan membatasi transaksi apa pun yang melampaui batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Menggunakan koneksi SAP Ariba Procurement dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas konektor.

  • Untuk memahami cara membuat dan menggunakan tugas konektor di Apigee Integration, lihat Tugas konektor.
  • Untuk memahami cara membuat dan menggunakan tugas konektor di Application Integration, lihat tugas konektor.

Tindakan

Bagian ini menunjukkan cara melakukan beberapa tindakan di konektor ini.

Tindakan CreateChildElementSchema

Tindakan ini akan membuat file skema untuk array dokumen dalam template tampilan.

Parameter input tindakan CreateChildElementSchema

Nama parameter Jenis Menerima aliran output Deskripsi
ViewTemplateName String Salah Nama template tampilan yang ada.
ChildElement String Salah Elemen turunan atau array dokumen dalam template tampilan dalam notasi titik, seperti LineItems.SplitAccountings.
TableName String Salah Nama untuk tabel baru, seperti View_LineItems_SplitAccountings.
FileName String Salah Nama file untuk skema yang dihasilkan. Ini dapat berupa jalur relatif atau jalur absolut ke lokasi penyimpanan yang diinginkan.
FileStream String Benar Instance aliran output tempat data file ditulis.

Untuk contoh tentang cara mengonfigurasi tindakan CreateChildElementSchema, lihat Contoh.

Tindakan CreateSchema

Membuat file skema untuk tabel atau tampilan yang ditentukan.

Parameter input tindakan CreateSchema

Nama parameter Jenis Menerima aliran output Deskripsi
TableName String Salah Nama untuk tabel baru.
FileName String Salah Nama file untuk skema yang dihasilkan. Ini dapat berupa jalur relatif atau jalur absolut ke lokasi penyimpanan yang diinginkan.
FileStream String Salah Instance aliran output tempat data file ditulis.

Untuk contoh tentang cara mengonfigurasi tindakan CreateSchema, lihat Contoh.

Contoh tindakan

Bagian ini menunjukkan cara melakukan beberapa contoh tindakan di konektor ini.

Contoh - Membuat skema elemen turunan

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan CreateChildElementSchema, lalu klik Selesai.
  3. Di bagian Task Input pada tugas connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}

    4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Contoh - Membuat skema

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan CreateSchema, lalu klik Selesai.
  3. Di bagian Task Input pada tugas connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
  "TableName": "Views"
}

    4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan semua pesanan

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Orders dari daftar Entity.
  3. Pilih operasi List, lalu klik Selesai.
  4. Task Input tugas connectors, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

    5. Anda harus menggunakan tanda kutip tunggal (') untuk menyertakan nilai filterClause. Anda dapat menggunakan filterClause untuk memfilter rekaman berdasarkan kolom.

Contoh - Mencantumkan semua item baris

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih LineItems dari daftar Entity.
  3. Pilih operasi List, lalu klik Selesai.
  4. Di bagian Task Input pada tugas connectors, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

Contoh - Mendapatkan detail pesanan

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Orders dari daftar Entity.
  3. Pilih operasi Get, lalu klik Selesai.
  4. Tetapkan entityId ke "DO240" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "DO240" di kolom Nilai Input dan pilih entityId sebagai variabel lokal.

    5. Anda harus meneruskan nilai untuk entityId secara langsung, seperti "DO240". Di sini, "DO240" adalah nilai kunci utama yang unik.

    Jika meneruskan satu entityId memunculkan error karena adanya dua kunci komposit, Anda dapat menggunakan filterClause untuk meneruskan nilai, seperti DocumentNumber='DO240'.

Contoh - Mendapatkan detail item baris

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih LineItems dari daftar Entity.
  3. Pilih operasi Get, lalu klik Selesai.
  4. Tetapkan filterClause ke LineNumber='1' AND DocumentNumber='DO240' yang merupakan kunci komposit yang akan diteruskan. Untuk menyetel filterClause, di bagian Pemetaan Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "LineNumber='1' AND DocumentNumber='DO240'" di kolom Nilai Input dan pilih filterClause sebagai variabel lokal.

Contoh - Membuat tampilan

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Views dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih entityId, connectorInputPayload, atau filterClause sebagai variabel lokal. 
    {
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}

    Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

    {
  "Success": true
}

Contoh - Memperbarui tampilan

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih Views dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value. 
    {
  "Status": "published"
}
  5. Tetapkan entityId di Pemeta Data ke ID Tampilan. Untuk menetapkan entityId, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih entityId, connectorInputPayload, atau filterClause sebagai variabel lokal.

    Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke TestView = '1754629881645'.

    Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

    {
}

    Objek JSON kosong {}dalam respons menunjukkan bahwa operasi update berhasil.

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya