Dynamics 365 Business Central

Esempi di configurazione delle connessioni

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

OAuth 2.0 - Tipo di connessione con credenziali client

Tipo di connessione della chiave di accesso

Tipo di connessione Azure AD

Per informazioni su come creare uno spazio di lavoro Dynamics 365 Business Central, consulta Ti diamo il benvenuto in Dynamics 365 Business Central.

Per informazioni sull'API Dynamics 365 Business Central, consulta il riferimento all'API Dynamics365BusinessCentral.

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti gli ordini di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrders dall'elenco Entity.
3. Seleziona l'operazione List e poi fai clic su Fine.
4. Nella sezione Input dell'attività dell'attività Connettori, puoi impostare filterClause.

Devi utilizzare virgolette singole (") per racchiudere il valore di una clausola di filtro. Puoi utilizzare la clausola filtro per filtrare i record in base alle colonne.

Esempio: ricevi un ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrders dall'elenco Entity.
3. Seleziona l'operazione Get e poi fai clic su Fine.
4. Imposta l'ID entità su "841c04f9-3391-ef11-8a6b-002248d4e29e", che è la chiave da passare. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci "841c04f9-3391-ef11-8a6b-002248d4e29e" nel campo Valore di input e scegli EntityId come variabile locale.

   Il valore dell'ID entità deve essere passato direttamente, ad esempio "841c04f9-3391-ef11-8a6b-002248d4e29e". In questo caso, "841c04f9-3391-ef11-8a6b-002248d4e29e" è il valore univoco della chiave primaria.

   Se il passaggio di un singolo ID entità genera un errore a causa della presenza di due chiavi composite, puoi utilizzare la clausola di filtro per passare il valore.

Esempio: eliminare un ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrders dall'elenco Entity.
3. Seleziona l'operazione DELETE e fai clic su Fine.
4. Imposta l'ID entità su "841c04f9-3391-ef11-8a6b-002248d4e29e", che è la chiave da passare. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci "841c04f9-3391-ef11-8a6b-002248d4e29e" nel campo Valore di input e scegli EntityId come variabile locale.

   Se l'entità ha due chiavi principali o aziendali composite, anziché specificare entityId, puoi anche impostare filterClause su id='841c04f9-3391-ef11-8a6b-002248d4e29e'.

Esempio: creare un ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrders dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione è riuscita, il parametro risposta connectorOutputPayload della task salesOrders avrà un valore simile al seguente:

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

Esempio: crea una riga di ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrderLines dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione è riuscita, il parametro risposta connectorOutputPayload della task salesOrderLines avrà un valore simile al seguente:

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

Esempio: creare un preventivo di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesQuotes dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione è riuscita, il parametro risposta connectorOutputPayload della task salesQuotes avrà un valore simile al seguente:

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

Esempio: creare un ordine di acquisto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona purchaseOrders dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione è riuscita, il parametro risposta connectorOutputPayload della task purchaseOrders avrà un valore simile al seguente:

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

Esempio: crea un articolo

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona items dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione è riuscita, il parametro risposta connectorOutputPayload della task items avrà un valore simile al seguente:

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

Esempio: aggiornare un ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrders dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
        "phoneNumber": "7764872993"
        }
        

5. Imposta l'ID entità in Data Mapper sull'entità degli ordini di vendita. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Esempio: aggiorna una riga dell'ordine di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesOrderLines dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
        "description": "Test from Altostrat"
        }
        

5. Imposta l'ID entità in Data Mapper sull'entità delle righe di ordine di vendita. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Esempio: aggiornare una proposta di vendita

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona salesQuotes dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
        "currencyCode": "USD"
        }
        

5. Imposta l'ID entità in Data Mapper sull'entità delle offerte di vendita. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Esempio: aggiornare un ordine di acquisto

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona purchaseOrders dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Imposta l'ID entità in Data Mapper sull'entità degli ordini di acquisto. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Esempio: aggiorna un articolo

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona items dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel Input Value campo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Imposta l'ID entità in Data Mapper sull'entità degli elementi. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, poi inserisci un valore simile al seguente nel Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.