Partilhar via

Registe e visualize lançamentos de API bem-sucedidos

  • Artigo

Este artigo descreve como configurar e utilizar a característica do histórico do registo do inventário da Visibilidade do Inventário. Esta caraterística cria um registo das publicações da API de inventário atualizadas com êxito. As publicações incluem um carimbo de data/hora e especificam o tipo de API.

Configurar o histórico do registo do inventário

Para começar a manter um registo de publicações da API de inventário atualizadas com sucesso, é necessário ativar a caraterística no Microsoft Power Apps.

  1. Inicie sessão no Power Apps e aceda a Visibilidade do Inventário>Definições>Gestão de caraterísticas.
  2. Ative a caraterística Histórico do registo do inventário.
  3. Aceda a Definições de administrador e selecione Atualizar configuração.

Ver histórico do registo do inventário

Após a ativação da caraterística, pode ver as entradas de registo utilizando a aplicação Visibilidade do Inventário no Power Apps ou ao chamar a API.

Ver entradas de registo com a aplicação Visibilidade do Inventário no Power Apps

Siga estes passos para ver o registo com a aplicação Visibilidade do Inventário no Power Apps.

  1. Inicie sessão no Power Apps e aceda a Visibilidade do Inventário>Visibilidade operacional>Histórico do registo do inventário.
  2. Introduza um ID de produto, ID da organização, ID do site, ID do armazém e intervalo de datas para obter e ver os detalhes do registo.

Obter entradas de registo ao chamar a API

Siga estes passos para obter entradas do registo ao chamar a API de Visibilidade do Inventário.

  1. Execute uma ferramenta que lhe permita chamar APIs. Utilize a ferramenta para aceder à {inventoryVisibilityEndpoint}/api/environment/{yourEnvironmentId}/logTransactionDetailsAPI utilizando o método Post.

  2. Configure e envie um corpo do pedido para obter os dados de registo que lhe interessam. O exemplo a seguir mostra um corpo do pedido que pede ao sistema que prepare e obtenha o registo. Este passo é necessário porque o registo é armazenado no Azure Data Lake e é transferido para o Dataverse apenas a pedido. A API obtém um ID da tarefa do histórico do registo que pode ser utilizado para verificar o estado de conclusão da tarefa.

    Path:

    /api/environment/{environmentId}/logTransactionDetails

Method:

    Post

Headers:

    Api-Version="1.0"

    Authorization="Bearer $access_token"

ContentType:

    application/json

Body:

    {
    "id": "id-contoso-{{datetime}}",
    "organizationId": "usmf",
    "UtcFromDate": "2023/8/23",
    "UtcToDate": "2023/8/23",
    "productId": "D0001",
    "dimensions": {
        "SiteId": "1",
        "LocationId": "13"
    }
}

  3. Utilize a API {inventoryVisibilityEndpoint}/api/environment/{yourEnvironmentId}/getJobProgress?jobId={jobIdFromPreviousStep} para monitorizar o estado da tarefa do histórico do registo do inventário.

  4. Quando a API informa que a tarefa foi concluída com êxito, pode rever os registos no Dataverse ao abrir a tabela de relatórios do registo de transações (is_transactionloggingreport).