Dynamics 365 Business Central

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra de los diversos campos que configuras cuando creas la conexión.

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

Tipo de conexión de la clave de acceso

Tipo de conexión de Azure AD

Para obtener información sobre cómo crear un lugar de trabajo de Dynamics 365 Business Central, consulta Te damos la bienvenida a Dynamics 365 Business Central.

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

Ejemplos de operaciones de entidades

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

Ejemplo: Muestra una lista de 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, luego, haz clic en Listo.
4. En la sección Task Input de la tarea Connectors, puedes establecer filterClause.

Debes usar comillas simples (') para encerrar el valor de una cláusula de filtro. Puedes usar la cláusula de filtro para filtrar los registros según las columnas.

Ejemplo: Cómo obtener una orden 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, luego, haz clic en Listo.
4. Establece el ID de la entidad en "841c04f9-3391-ef11-8a6b-002248d4e29e", que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "841c04f9-3391-ef11-8a6b-002248d4e29e" en el campo Input Value y elige EntityId como la variable local.

   El valor del ID de entidad se debe pasar directamente, como "841c04f9-3391-ef11-8a6b-002248d4e29e". Aquí, "841c04f9-3391-ef11-8a6b-002248d4e29e" es el valor único de la clave primaria.

   Si pasar un solo ID de entidad arroja un error debido a la presencia de dos claves compuestas, puedes usar la cláusula de filtro para pasar el valor.

Ejemplo: Borra 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 haz clic en Listo.
4. Establece el ID de la entidad en "841c04f9-3391-ef11-8a6b-002248d4e29e", que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "841c04f9-3391-ef11-8a6b-002248d4e29e" en el campo Input Value y elige EntityId como la variable local.

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

Ejemplo: Crea una orden 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 Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como la 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 de respuesta connectorOutputPayload de la tarea salesOrders tendrá un valor similar al siguiente:

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

Ejemplo: Crea 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como la 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 de respuesta connectorOutputPayload de la tarea salesOrderLines tendrá un valor similar al siguiente:

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

Ejemplo: Crea una oferta de ventas

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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como la variable local.

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

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

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

Ejemplo: Crea 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como la variable local.

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

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

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

Ejemplo: Crea 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como la 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 de respuesta connectorOutputPayload de la tarea items tendrá un valor similar al siguiente:

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

Ejemplo: Actualiza 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 Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   {
        "phoneNumber": "7764872993"
        }
        

5. Establece el ID de la entidad en Data Mapper en la entidad de salesOrders. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Ejemplo: Actualiza 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   {
        "description": "Test from Altostrat"
        }
        

5. Establece el ID de la entidad en Data Mapper en la entidad de salesOrderLines. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Ejemplo: Actualiza una oferta de ventas

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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   {
        "currencyCode": "USD"
        }
        

5. Establece el ID de la entidad en Data Mapper en la entidad de salesQuotes. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Ejemplo: Cómo 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Establece el ID de la entidad en Data Mapper en la entidad de purchaseOrders. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Ejemplo: Actualiza 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 haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Establece el ID de la entidad en Data Mapper en la entidad de los elementos. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como la variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.