Salesforce

Contoh konfigurasi koneksi

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

Jenis koneksi nama pengguna dan sandi

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Tindakan

Konektor ini memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data Salesforce. Untuk menjalankan kueri SQL kustom, konektor menyediakan tindakan Jalankan kueri kustom.

Untuk membuat kueri kustom, ikuti langkah-langkah berikut:

1. Ikuti petunjuk mendetail untuk menambahkan tugas konektor.
2. Saat Anda mengonfigurasi tugas konektor, di jenis tindakan yang ingin Anda lakukan, pilih Tindakan.
3. Dalam daftar Tindakan, pilih Jalankan kueri kustom, lalu klik Selesai.

   

4. Luaskan bagian Input tugas, lalu lakukan hal berikut:
   1. Di kolom Waktu tunggu setelah, masukkan jumlah detik untuk menunggu hingga kueri dieksekusi.

      Nilai default: 180 detik.

   2. Di kolom Jumlah baris maksimum, masukkan jumlah baris maksimum yang akan ditampilkan dari database.

      Nilai default: 25.

   3. Untuk memperbarui kueri kustom, klik Edit Skrip Kustom. Dialog Script editor akan terbuka.

      

   4. Dalam dialog Editor skrip, masukkan kueri SQL, lalu klik Simpan.

      Anda dapat menggunakan tanda tanya (?) dalam pernyataan SQL untuk merepresentasikan satu parameter yang harus ditentukan dalam daftar parameter kueri. Misalnya, kueri SQL berikut memilih semua baris dari tabel Employees yang cocok dengan nilai yang ditentukan untuk kolom LastName:

      SELECT * FROM Employees where LastName=?

   5. Jika Anda telah menggunakan tanda tanya dalam kueri SQL, Anda harus menambahkan parameter dengan mengklik + Tambahkan Nama Parameter untuk setiap tanda tanya. Saat menjalankan integrasi, parameter ini menggantikan tanda tanya (?) dalam kueri SQL secara berurutan. Misalnya, jika Anda telah menambahkan tiga tanda tanya (?), maka Anda harus menambahkan tiga parameter sesuai urutan.

      

      Untuk menambahkan parameter kueri, lakukan hal berikut:

      1. Dari daftar Jenis, pilih jenis data parameter.
      2. Di kolom Nilai, masukkan nilai parameter.
      3. Untuk menambahkan beberapa parameter, klik + Tambahkan Parameter Kueri.

Konektor Salesforce tidak mendukung nilai berparameter untuk klausa OFFSET, dan tidak dapat diganti secara dinamis menggunakan parameter kueri. Namun, parameter kueri didukung dalam klausa WHERE.

Bagian ini mencantumkan tindakan yang didukung oleh konektor Salesforce. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan CreateJobv2

Gunakan tindakan ini untuk membuat Tugas.

Parameter input tindakan CreateJobV2

Untuk contoh cara mengonfigurasi tindakan CreateJobV2, lihat Contoh.

Tindakan UploadJobDataV2

Gunakan tindakan ini untuk mengupload file Job dalam format CSV ke Salesforce.

Parameter input tindakan UploadJobDataV2

Untuk contoh cara mengonfigurasi tindakan UploadJobDataV2, lihat Contoh.

Tindakan CreateBatch

Tindakan ini akan membuat batch Salesforce.

Parameter input tindakan CreateBatch

Parameter output tindakan CreateBatch

Untuk contoh cara mengonfigurasi tindakan CreateBatch, lihat Contoh.

Tindakan CreateJob

Tindakan ini menambahkan entri objek Salesforce.

Parameter input tindakan CreateJob

Parameter output tindakan CreateJob

Untuk contoh cara mengonfigurasi tindakan CreateJob, lihat Contoh.

Tindakan GetBatch

Tindakan ini mendapatkan informasi tentang batch Salesforce.

Parameter input tindakan GetBatch

Parameter output tindakan GetBatch

Untuk contoh cara mengonfigurasi tindakan GetBatch, lihat Contoh.

Tindakan GetJob

Tindakan ini mendapatkan informasi tentang tugas Salesforce.

Parameter input tindakan GetJob

Parameter output tindakan GetJob

Untuk contoh cara mengonfigurasi tindakan GetJob, lihat Contoh.

Tindakan UploadAttachment

Tindakan ini mengupload lampiran dan mengaitkannya dengan entitas di Salesforce.

Parameter input tindakan UploadAttachment

Parameter output tindakan UploadAttachment

Untuk contoh cara mengonfigurasi tindakan UploadAttachment, lihat Contoh.

Tindakan GetBatchResults

Tindakan ini mendapatkan hasil batch Salesforce.

Parameter input tindakan GetBatchResults

Parameter output tindakan GetBatchResults

Untuk contoh cara mengonfigurasi tindakan GetBatchResults, lihat Contoh.

Contoh tindakan

Contoh - CreateJobV2

Contoh ini membuat Tugas.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateJobV2, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu Anda harus memasukkan nilai yang mirip dengan berikut di kolom Default Value:

    {
     "ObjectName": "Contact",
     "Action": "insert"
    }

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

 
  [{
  "ID": "750dM000005HjdnQAC",
  "State": "Open",
  "JobType": null,
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches",
  "ContentType": "CSV",
  "CreatedDate": "2024-08-07T09:16:16.000+0000",
  "CreatedById": "005dM0000061WSFQA2",
  "ConcurrencyMode": "Parallel",
  "SystemModStamp": "2024-08-07T09:16:16.000+0000"
  }] 

Contoh - UploadJobDataV2

Contoh ini mengupload file Job ke Salesforce.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UploadJobDataV2, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

    {
     "Content":   "FirstName,LastName,Email,MobilePhone,External_Id__c\\nGinelle,Merioth,gmerioth0@example.com,851-555-8435,4d13cac0-2c11-48e9-891d-49ee9508a6c7\\nDalli,Tumilson,dtumilson1@example.com,881-555-6742,38bcb24b-247f-498b-9502-c98995a1e04b\\nRobbin,Purveys,rpurveys2@example.com,732-555-6909,35d96c7a-3856-4809-8c49-35ddb9fa7dd9\\nLothaire,Ivanchenkov,livanchenkov3@example.com,144-555-1959,75f63f26-6f4a-406f-a9f4-807f4a8a7b51",
     "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches"
    }

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

 
  [{
  "Uploaded": "true"
  }]

Contoh - CreateBatch

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateBatch, lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
   "JobId": "750dL000007EipxQAC",
   "Aggregate": "\n    Walter\n    White\n  \n  \n    Rob\n    Brown\n  \n",
   "ContentType": "XML"
   }

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

 
[{
  "ID": "751dL000003ziC5QAI",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-03T04:48:53.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Queued",
  "StateMessage": null,
  "SystemModstamp": "2024-09-03T04:48:53.000Z",
  "TotalProcessingTime": "0"
}]

Contoh - CreateJob

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateJob, lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
     "ObjectName": "Campaign",
     "Action": "insert"
   }

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

 
 [{
  "ID": "750dL000007GgD7QAK",
  "JobID": "750dL000007GgD7QAK",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-03T05:31:41.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "0",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "0",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-03T05:31:41.000Z",
  "TotalProcessingTime": "0"
}]

Contoh - GetBatch

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan GetBatch, lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
     "BatchId": "751dL000003yKlJQAU",
     "JobId": "750dL000007EipxQAC"
   }

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

 
[{
  "ID": "751dL000003yKlJQAU",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-02T11:44:15.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Failed",
  "StateMessage": "InvalidBatch : Failed to parse XML. Unexpected XML element 'sObject' found at  START_TAG seen ... @1:9 it should be 'sObjects'",
  "SystemModstamp": "2024-09-02T11:44:15.000Z",
  "TotalProcessingTime": "0"
}]

Contoh - GetJob

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan GetJob , lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
     "JobId": "750dL000007EipxQAC"
   } 

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

 
[{
  "ID": "750dL000007EipxQAC",
  "JobID": "750dL000007EipxQAC",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-02T11:17:42.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "2",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "2",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-02T11:17:42.000Z",
  "TotalProcessingTime": "0"
}]

Contoh - UploadAttachment

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UploadAttachment, lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
     "ObjectId": "001dL00000SC6j7QAD",
     "FileName": "My files/salesforce/con.csv",
     "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
   }

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

 
[{
  "Id": "00PdL000000EJUDUA4"
}]

Contoh - GetBatchResults

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan GetBatchResults, lalu klik Selesai.
3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:

   {
     "BatchId": "751dL000004D17FQAS",
     "JobId": "750dL000007XKUhQAO",
     "ContentType": "XML"
   }

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

 
[{
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}, {
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}]

Contoh operasi entity

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

Contoh - Membuat lampiran

Lampiran pembuatan entitas hanya membuat lampiran tanpa file konten di dalamnya. Untuk menambahkan file, kita perlu melakukan tindakan Upload Lampiran dengan memberikan konteks file dalam input.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Lampiran dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta data pada Tugas, klik editor OpenDataMapping, lalu masukkan nilai yang mirip dengan berikut di field:

   {
     "Name": "New Attachment",
     "Description": "New created attachment",
     "ParentId": "001dL00000SC6j7QAD",
     "Body": "Body"
   }
   

5. Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
     "Id": "00PdL000000EJKXUA4"
   }
   

Contoh - Memperbarui lampiran

Lampiran pembaruan entitas hanya memperbarui nama atau deskripsi lampiran. Untuk menambahkan file, kita perlu melakukan tindakan Upload Lampiran dengan memberikan konteks file dalam input.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Lampiran dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Tetapkan ID entitas ke Update an Attachment. Untuk menetapkan ID entitas, di bagian Pemeta data pada Tugas, klik EntityID, lalu masukkan 00PdL000000EJKXUA4 di kolom yang tersedia.
5. Di bagian Pemeta data pada Tugas, klik editor OpenDataMapping, lalu masukkan nilai yang mirip dengan berikut di field:

   {
     "Name": "New Attachment",
     "Description": "New updated attachment",
     "Body": "Body"
   }
   

Atau, alih-alih menentukan entityId, Anda juga dapat menyetel filterClause ke 00PdL000000EJKXUA4.

6. Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
     "Id": "00PdL000000EJKXUA4"
   }