Dynamics 365 Business Central

Ejemplos de configuración de conexiones

En esta sección se indican los valores de ejemplo de los distintos campos que se configuran al crear la conexión.

OAuth 2.0: tipo de conexión de credenciales de cliente

Tipo de conexión de clave de acceso

Tipo de conexión de Azure AD

Para obtener información sobre cómo crear un espacio de trabajo de Dynamics 365 Business Central, consulta el artículo Bienvenido a Dynamics 365 Business Central.

Para obtener información sobre la API de Dynamics 365 Business Central, consulta la referencia de la API de Dynamics 365 Business Central.

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: Mostrar todos los pedidos de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrders en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, puede definir filterClause.

Debe usar comillas simples (") para incluir el valor de una cláusula de filtro. Puede usar la cláusula de filtro para filtrar registros en función de las columnas.

Ejemplo: Obtener un pedido de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrders en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad "841c04f9-3391-ef11-8a6b-002248d4e29e", que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Asignación de datos de Mapeador de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca "841c04f9-3391-ef11-8a6b-002248d4e29e" en el campo Valor de entrada y elija EntityId como variable local.

   El valor de Entity Id debe transferirse directamente, como "841c04f9-3391-ef11-8a6b-002248d4e29e". En este caso, "841c04f9-3391-ef11-8a6b-002248d4e29e" es el valor de clave principal único.

   Si al enviar un solo ID de entidad se produce un error debido a la presencia de dos claves compuestas, puede usar la cláusula de filtro para enviar el valor.

Ejemplo: eliminar un pedido de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrders en la lista Entity.
3. Selecciona la operación DELETE y, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad "841c04f9-3391-ef11-8a6b-002248d4e29e", que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Asignación de datos de Mapeador de datos, haga clic en Abrir editor de asignación de datos y, a continuación, introduzca "841c04f9-3391-ef11-8a6b-002248d4e29e" en el campo Valor de entrada y elija EntityId como variable local.

   Si la entidad tiene dos claves empresariales o primarias compuestas en lugar de especificar el entityId, también puedes definir filterClause como id='841c04f9-3391-ef11-8a6b-002248d4e29e'.

Ejemplo: Crear un pedido

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrders en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload como variable local.

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

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload response de la tarea salesOrders tendrá un valor similar al siguiente:

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

Ejemplo: Crear una línea de pedido de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrderLines en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload como variable local.

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

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload response de la tarea salesOrderLines tendrá un valor similar al siguiente:

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

Ejemplo: Crear una oferta de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesQuotes en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload como variable local.

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

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload response de la tarea salesQuotes tendrá un valor similar al siguiente:

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

Ejemplo: Crear una orden de compra

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona purchaseOrders en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload como variable local.

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

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload response de la tarea purchaseOrders tendrá un valor similar al siguiente:

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

Ejemplo: crear un elemento

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona items en la lista Entity.
3. Selecciona la operación Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload como variable local.

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

   Si la integración se realiza correctamente, el parámetro connectorOutputPayload response de la tarea items tendrá un valor similar al siguiente:

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

Ejemplo: actualizar un pedido de ventas

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrders en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
        "phoneNumber": "7764872993"
        }
        

5. Define el ID de entidad en Data Mapper como la entidad de salesOrders. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Ejemplo: actualizar una línea de pedido de venta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesOrderLines en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
        "description": "Test from Altostrat"
        }
        

5. Defina el ID de entidad en Data Mapper como la entidad de salesOrderLines. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Ejemplo: actualizar una oferta

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona salesQuotes en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Mapper de datos de la tarea Asignación de datos, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
        "currencyCode": "USD"
        }
        

5. Defina el ID de entidad en Data Mapper como la entidad de salesQuotes. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Ejemplo: actualizar una orden de compra

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona purchaseOrders en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Mapper de datos de la tarea Asignación de datos, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Defina el ID de entidad en Data Mapper como la entidad de purchaseOrders. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Ejemplo: actualizar un elemento

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona items en la lista Entity.
3. Selecciona la operación Update y, a continuación, haz clic en Hecho.
4. En la sección Mapper de datos de la tarea Asignación de datos, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Defina el ID de entidad en Data Mapper como la entidad de los elementos. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.