Dynamics 365 Business Central

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

OAuth 2.0: tipo de conexão de credenciais do cliente

Tipo de conexão da chave de acesso

Para saber como criar um espaço de trabalho do Dynamics 365 Business Central, consulte Bem-vindo ao Dynamics 365 Business Central.

Para informações sobre a API Dynamics 365 Business Central, consulte a referência da API Dynamics365BusinessCentral.

Exemplos de operações de entidade

Esta seção mostra como realizar algumas das operações de entidade neste conector.

Exemplo: listar todos os pedidos de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrders na lista Entity.
3. Selecione a operação List e clique em Concluído.
4. Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause.

Use aspas simples (") para incluir o valor de uma cláusula de filtro. É possível usar a cláusula de filtro para filtrar registros com base nas colunas.

Exemplo: receber um pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrders na lista Entity.
3. Selecione a operação Get e clique em Concluído.
4. Defina o ID da entidade como "841c04f9-3391-ef11-8a6b-002248d4e29e", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira "841c04f9-3391-ef11-8a6b-002248d4e29e" no campo Valor de entrada e escolha EntityId como a variável local.

   O valor do ID da entidade precisa ser transmitido diretamente, como "841c04f9-3391-ef11-8a6b-002248d4e29e". Aqui, "841c04f9-3391-ef11-8a6b-002248d4e29e" é o valor da chave primária exclusiva.

   Se a transmissão de um único ID de entidade gerar um erro devido à presença de duas chaves compostas, use a cláusula de filtro para transmitir o valor.

Exemplo: excluir um pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrders na lista Entity.
3. Selecione a operação DELETE e clique em Concluído.
4. Defina o ID da entidade como "841c04f9-3391-ef11-8a6b-002248d4e29e", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e insira "841c04f9-3391-ef11-8a6b-002248d4e29e" no campo Valor de entrada e escolha EntityId como a variável local.

   Se a entidade tiver duas chaves primárias ou de negócios compostas em vez de especificar o entityId, também será possível definir a filterClause como id='841c04f9-3391-ef11-8a6b-002248d4e29e'.

Exemplo: criar um pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrders na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como a variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa salesOrders vai ter um valor semelhante a este:

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

Exemplo: criar uma linha de pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrderLines na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como a variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa salesOrderLines terá um valor semelhante a este:

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

Exemplo: criar um orçamento de vendas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesQuotes na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como a variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa salesQuotes terá um valor semelhante a este:

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

Exemplo: criar uma ordem de compra

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione purchaseOrders na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como a variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa purchaseOrders terá um valor semelhante a este:

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

Exemplo: criar um item

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione items na lista Entity.
3. Selecione a operação Create e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como a variável local.

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

   Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa items terá um valor semelhante a este:

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

Exemplo: atualizar um pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrders na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   {
        "phoneNumber": "7764872993"
        }
        

5. Defina o ID da entidade no Data Mapper como a entidade das vendas. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como id ='5e9226d3-1c7b-ef11-a671-6045bdaef76c'.

Exemplo: atualizar uma linha de pedido de venda

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesOrderLines na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   {
        "description": "Test from Altostrat"
        }
        

5. Defina o ID da entidade no Data Mapper como a entidade das salesOrderLines. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como id ='35535130-d09d-ef11-8a6b-002248d4cc93'.

Exemplo: atualizar uma cotação de vendas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione salesQuotes na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   {
        "currencyCode": "USD"
        }
        

5. Defina o ID da entidade no Data Mapper como a entidade das vendas de cotações. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como id='2116bd4e-3ba3-ef11-8a6b-6045bdacfb5e'.

Exemplo: atualizar uma ordem de compra

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione purchaseOrders na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   {
        "shipToName": "Charlie Cruz"
        }
        

5. Defina o ID da entidade no Data Mapper como a entidade das purchaseOrders. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como id ='6b88738e-3891-ef11-8a6b-002248d4e29e'.

Exemplo: atualizar um item

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione items na lista Entity.
3. Selecione a operação Update e clique em Concluído.
4. Na seção Data Mapper da tarefa Data Mapping, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   {
        "displayName": "Updates Altostrat name"
        }
        

5. Defina o ID da entidade no Data Mapper como a entidade dos itens. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como a variável local.

   Em vez de especificar o entityId, você também pode definir a filterClause como id ='fad09437-8d9e-ef11-8a6b-000d3af0e092'.