Dynamics 365 Business Central

Contoh konfigurasi koneksi

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

OAuth 2.0 - Jenis koneksi kredensial klien

Jenis koneksi kunci akses

Untuk informasi tentang cara membuat Ruang Kerja Dynamics 365 Business Central, lihat Selamat datang di Dynamics 365 Business Central.

Untuk informasi tentang Dynamics 365 Business Central API, lihat Referensi Dynamics365BusinessCentral API.

Contoh operasi entity

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

Contoh - Mencantumkan semua pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrders dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, Anda dapat menetapkan filterClause.

Anda harus menggunakan tanda kutip tunggal (') untuk mengapit nilai untuk klausul filter. Anda dapat menggunakan klausa filter untuk memfilter data berdasarkan kolom.

Contoh - Mendapatkan pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrders dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Tetapkan ID entity ke "841c04f9-3391-ef11-8a6b-002248d4e29e", yang merupakan kunci yang akan diteruskan. Untuk menetapkan ID entitas, di bagian Data Mapper pada Data Mapping, klik Open Data Mapping Editor, lalu masukkan "841c04f9-3391-ef11-8a6b-002248d4e29e" di kolom Input Value dan pilih EntityId sebagai variabel lokal.

   Nilai untuk ID Entitas harus diteruskan secara langsung, seperti "841c04f9-3391-ef11-8a6b-002248d4e29e". Di sini, "841c04f9-3391-ef11-8a6b-002248d4e29e" adalah nilai kunci utama yang unik.

   Jika meneruskan satu ID Entitas menampilkan error karena adanya dua kunci gabungan, Anda dapat menggunakan klausa filter untuk meneruskan nilai.

Contoh - Menghapus pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrders dari daftar Entity.
3. Pilih operasi DELETE, lalu klik Selesai.
4. Tetapkan ID entity ke "841c04f9-3391-ef11-8a6b-002248d4e29e", yang merupakan kunci yang akan diteruskan. Untuk menetapkan ID entitas, di bagian Data Mapper pada Data Mapping, klik Open Data Mapping Editor, lalu masukkan "841c04f9-3391-ef11-8a6b-002248d4e29e" di kolom Input Value dan pilih EntityId sebagai variabel lokal.

   Jika entity memiliki dua kunci utama atau bisnis gabungan, bukan menentukan entityId, Anda juga dapat menetapkan filterClause ke id='841c04f9-3391-ef11-8a6b-002248d4e29e'.

Contoh - Membuat pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrders dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai variabel lokal.

   {
        "orderDate": "2024-10-30",
        "customerNumber": "10000",
        "currencyCode": "INR",
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07"
        }
        

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas salesOrders akan memiliki nilai yang mirip dengan berikut:

   {
        "id": "2e048d8a-a796-ef11-8a6b-6045bdae882d"
        }
        

Contoh - Membuat baris pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrderLines dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai variabel lokal.

   {
        "documentId": "b747cc93-c37f-ef11-ac23-7c1e523b4365",
        "sequence": 10014,
        "itemId": "8b0f75c5-f26e-ef11-a678-6045bdc89b07",
        "lineType": "Item",
        "lineObjectNumber": "1996-S"
        }
        

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas salesOrderLines akan memiliki nilai yang mirip dengan berikut:

   {
        "id": "35535130-d09d-ef11-8a6b-002248d4cc93"
        }
        

Contoh - Membuat penawaran penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesQuotes dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai variabel lokal.

   {
        "paymentTermsId": "590d75c5-f26e-ef11-a678-6045bdc89b07",
        "currencyCode": "INR",
        "customerNumber": "30000"
        }
        

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas salesQuotes akan memiliki nilai yang mirip dengan berikut:

   {
        "id": "2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e"
        }
        

Contoh - Membuat pesanan pembelian

1. Pada dialog Configure connector task, klik Entities.
2. Pilih purchaseOrders dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai variabel lokal.

   {
        "vendorId": "7e0f75c5-f26e-ef11-a678-6045bdc89b07",
        "vendorNumber": "10000"
        }
        

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas purchaseOrders akan memiliki nilai yang mirip dengan berikut:

   {
        "id": "53389ee7-a796-ef11-8a6b-6045bdae882d"
        }
        

Contoh - Membuat item

1. Pada dialog Configure connector task, klik Entities.
2. Pilih items dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai variabel lokal.

   {
        "number": "4000-D",
        "displayName": "Charlie Altostrat",
        "type": "Inventory",
        "itemCategoryId": "d61672cb-f26e-ef11-a678-6045bdc89b07",
        "baseUnitOfMeasureCode": "PCS"
        }
        

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas items akan memiliki nilai yang mirip dengan berikut:

   {
        "id": "fad09437-8d9e-ef11-8a6b-000d3af0e092"
        }
        

Contoh - Memperbarui pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrders dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   {
        "phoneNumber": "7764872993"
        }
        

5. Tetapkan ID entity di Data Mapper ke entity salesOrders. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Contoh - Memperbarui baris pesanan penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesOrderLines dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   {
        "description": "Test from Altostrat"
        }
        

5. Tetapkan ID entitas di Data Mapper ke entitas salesOrderLines. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Contoh - Memperbarui penawaran penjualan

1. Pada dialog Configure connector task, klik Entities.
2. Pilih salesQuotes dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   {
        "currencyCode": "USD"
        }
        

5. Tetapkan ID entitas di Data Mapper ke entitas salesQuotes. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Contoh - Memperbarui pesanan pembelian

1. Pada dialog Configure connector task, klik Entities.
2. Pilih purchaseOrders dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Tetapkan ID entitas di Data Mapper ke entitas purchaseOrders. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Contoh - Memperbarui item

1. Pada dialog Configure connector task, klik Entities.
2. Pilih items dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Tetapkan ID entitas di Data Mapper ke entitas item. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai variabel lokal.

   Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.