Dynamics 365 Business Central

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt finden Sie Beispielwerte für die verschiedenen Felder, die Sie beim Erstellen der Verbindung konfigurieren.

OAuth 2.0 – Verbindungstyp „Clientanmeldedaten“

Verbindungstyp für den Zugriffsschlüssel

Informationen zum Erstellen eines Dynamics 365 Business Central-Arbeitsbereichs finden Sie unter Willkommen bei Dynamics 365 Business Central.

Informationen zur Dynamics 365 Business Central API finden Sie in der Dynamics365BusinessCentral API-Referenz.

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Alle Verkaufsaufträge auflisten

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrders aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause festlegen.

Der Wert für eine Filterklausel muss in einfache Anführungszeichen (') gesetzt sein. Mit der Filterklausel können Sie Einträge anhand der Spalten filtern.

Beispiel: Auftrag abrufen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrders aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „841c04f9-3391-ef11-8a6b-002248d4e29e“ fest. Dies ist der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Datenabgleichs-Editor öffnen und geben Sie dann "841c04f9-3391-ef11-8a6b-002248d4e29e" in das Feld Eingabewert ein. Wählen Sie dann „EntityId“ als lokale Variable aus.

   Der Wert für die Entitäts-ID muss direkt übergeben werden, z. B. „841c04f9-3391-ef11-8a6b-002248d4e29e“. Hier ist „841c04f9-3391-ef11-8a6b-002248d4e29e“ der eindeutige Primärschlüsselwert.

   Wenn beim Übergeben einer einzelnen Entitäts-ID aufgrund von zwei zusammengesetzten Schlüsseln ein Fehler auftritt, können Sie den Wert mithilfe der Filterklausel übergeben.

Beispiel: Auftrag löschen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrders aus.
3. Wählen Sie den Vorgang DELETE aus und klicken Sie auf Fertig.
4. Legen Sie die Entitäts-ID auf „841c04f9-3391-ef11-8a6b-002248d4e29e“ fest. Dies ist der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Datenabgleichs-Editor öffnen und geben Sie dann "841c04f9-3391-ef11-8a6b-002248d4e29e" in das Feld Eingabewert ein. Wählen Sie dann „EntityId“ als lokale Variable aus.

   Wenn die Entität zwei zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause auf id='841c04f9-3391-ef11-8a6b-002248d4e29e' festlegen.

Beispiel: Auftrag erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrders aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload“ als lokale Variable aus.

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

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe salesOrders einen Wert, der in etwa so aussieht:

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

Beispiel: Auftragsposition erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrderLines aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload“ als lokale Variable aus.

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

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe salesOrderLines einen Wert, der in etwa so aussieht:

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

Beispiel: Angebot erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesQuotes aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload“ als lokale Variable aus.

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

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe salesQuotes einen Wert, der in etwa so aussieht:

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

Beispiel: Auftrag erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option purchaseOrders aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload“ als lokale Variable aus.

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

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe purchaseOrders einen Wert, der in etwa so aussieht:

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

Beispiel: Artikel erstellen

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option items aus.
3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenabgleich der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.

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

   Wenn die Integration erfolgreich war, hat der Antwortparameter connectorOutputPayload der Aufgabe items einen Wert, der in etwa so aussieht:

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

Beispiel: Verkaufsauftrag aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrders aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
        "phoneNumber": "7764872993"
        }
        

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der „salesOrders“ fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c' festlegen.

Beispiel: Auftragsposition aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesOrderLines aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
        "description": "Test from Altostrat"
        }
        

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der „salesOrderLines“ fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert wie den folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf id ='35535130-d09d-ef11-8a6b-002248d4cc93' festlegen.

Beispiel: Angebot aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option salesQuotes aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
        "currencyCode": "USD"
        }
        

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der „salesQuotes“ fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert wie den folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e' festlegen.

Beispiel: Auftrag aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option purchaseOrders aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der „purchaseOrders“ fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert wie den folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf id ='6b88738e-3891-ef11-8a6b-002248d4e29e' festlegen.

Beispiel: Artikel aktualisieren

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie in der Liste Entity die Option items aus.
3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Datenübersetzer der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie dann „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der Elemente fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert wie den folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

   Anstelle der entityId können Sie auch die filterClause auf id ='fad09437-8d9e-ef11-8a6b-000d3af0e092' festlegen.