SendGrid

Mengonfigurasi autentikasi

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

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

Tindakan SendMail2

Tindakan ini akan mengirim email beserta lampiran.

Parameter input tindakan kirim email

Parameter output dari tindakan kirim email

Tindakan ini menampilkan pesan konfirmasi apakah email berhasil dikirim atau tidak.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - Mengirim email

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

   {
       "FromName": "Name",
       "FromEmail": "cloudysanfrancisco@gmail.com",
       "Subject": "[{\"value\": \"cymbalgroup.com\",\"type\": \"text/plain\"}]",
       "TemplateId": "d-c4bc730a0b094a3a9d9cabb7347b5edc",
       "Personalizations": "[{\"subject\": \"Test Subject3\",\"send_at\": 1698659820,\"from\": {\"name\": \"hi\",\"email\": \"email@gmail\"},\"to\":      
       [{\"email\": \"email@gmail.com\",\"name\": \"test\"}\n ]}]",
       "Content": "[{\"value\": \"abc@cdata.com\",\"type\": \"text/plain\"}]"
   }

Tindakan ini akan menampilkan pesan konfirmasi. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas akan memiliki nilai yang mirip dengan berikut:

[{
"Success": "True"
}]

Contoh operasi entity

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

Contoh - Mencantumkan semua kontak

Contoh ini mencantumkan semua kontak dalam entitas NMCContacts.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCContacts dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Secara opsional, di bagian Input Tugas pada tugas Konektor, Anda dapat memfilter kumpulan hasil dengan menentukan klausa filter. Contohnya, City='Bangalore' Anda juga dapat menentukan beberapa kondisi filter menggunakan operator logika. Sebagai contoh, City='Bangalore' and region='asia-south2'

Contoh - Mendapatkan data

Contoh ini mendapatkan data dengan ID yang ditentukan dari entitas NMCSegments.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCSegments dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 di kolom Default Value.

   Di sini, 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 adalah nilai kunci utama dalam entity NMCSegments.

Contoh - Membuat catatan

Contoh ini membuat data dalam entitas NMCSenders.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCSenders dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Nickname": "Test",
   "FromEmail": "test1@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test1@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   {
   "Id": 5360940.0
   }

Contoh - Membuat catatan

Contoh ini membuat data dalam entitas NMCLists.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCLists dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Name": "TEST_CON_LIST1699262238224",
   "ContactCount": 3.0}

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   {
   "Id": "d927f128-b718-447a-affe-417f1a8b3abd"}

Contoh - Memperbarui data

Contoh ini memperbarui data dalam entitas NMCSenders.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCSenders dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Nickname": "Test",
   "FromEmail": "test2@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test2@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

5. Klik entityId, lalu masukkan 5360940.0 di kolom Default Value.

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   {
   "Id":"5360940.0"
   }

Contoh - Menghapus data

Contoh ini menghapus data dengan ID yang ditentukan di entitas NMCSegments.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih NMCSegments dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan c58b9151-7279-428a-bac2-12b4bf2b48b0 di kolom Default Value.