Dynamics 365 Business Central

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion avec des identifiants client OAuth 2.0

Type de connexion avec clé d'accès

Type de connexion avec Azure AD

Pour en savoir plus sur la création d'un espace de travail Dynamics 365 Business Central, consultez Bienvenue dans Dynamics 365 Business Central.

Pour en savoir plus sur l'API Dynamics 365 Business Central, consultez la documentation de référence de l'API Dynamics365BusinessCentral.

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister toutes les commandes

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrders dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause.

Vous devez placer la valeur d'une clause de filtre entre des guillemets simples ('). Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes.

Exemple : Obtenir une commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrders dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "841c04f9-3391-ef11-8a6b-002248d4e29e", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "841c04f9-3391-ef11-8a6b-002248d4e29e" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

   La valeur de l'ID d'entité doit être transmise directement, par exemple "841c04f9-3391-ef11-8a6b-002248d4e29e". Dans cet exemple, "841c04f9-3391-ef11-8a6b-002248d4e29e" est la valeur de clé primaire unique.

   Si la transmission d'un seul ID d'entité génère une erreur en raison de la présence de deux clés composites, vous pouvez utiliser la clause de filtre pour transmettre la valeur.

Exemple : Supprimer une commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrders dans la liste Entity.
3. Sélectionnez l'opération DELETE, puis cliquez sur OK.
4. Définissez l'ID d'entité sur "841c04f9-3391-ef11-8a6b-002248d4e29e", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "841c04f9-3391-ef11-8a6b-002248d4e29e" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

   Si l'entité comporte deux clés métier ou clés primaires composites, vous pouvez définir la filterClause sur id='841c04f9-3391-ef11-8a6b-002248d4e29e' au lieu de spécifier l'entityId.

Exemple : Créer une commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrders dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche salesOrders aura une valeur semblable à la suivante :

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

Exemple : Créer une ligne de commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrderLines dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche salesOrderLines aura une valeur semblable à la suivante :

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

Exemple : Créer un devis

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesQuotes dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche salesQuotes aura une valeur semblable à la suivante :

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

Exemple : Créer un bon de commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez purchaseOrders dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche purchaseOrders aura une valeur semblable à la suivante :

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

Exemple : Créer un article

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez items dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.

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

   Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche items aura une valeur semblable à la suivante :

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

Exemple : Modifier une commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrders dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
        "phoneNumber": "7764872993"
        }
        

5. Définissez l'ID d'entité dans Data Mapper sur l'entité salesOrders. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Exemple : Mettre à jour une ligne de commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesOrderLines dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
        "description": "Test from Altostrat"
        }
        

5. Définissez l'ID d'entité dans Data Mapper sur l'entité salesOrderLines. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Exemple : Modifier un devis

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez salesQuotes dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
        "currencyCode": "USD"
        }
        

5. Définissez l'ID d'entité dans Data Mapper sur l'entité salesQuotes. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Exemple : Mettre à jour un bon de commande

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez purchaseOrders dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Définissez l'ID d'entité dans Data Mapper sur l'entité purchaseOrders. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Exemple : Mettre à jour un article

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez items dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Définissez l'ID d'entité dans Data Mapper sur l'entité items. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

   Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.