Поделиться через

Регистрация и просмотр успешных записей API

  • Статья

В этой статье описывается, как настроить и использовать функцию Журнал регистрации запасов для надстройки видимости запасов. Эта функция создает журнал успешно обновленных записей API-интерфейса запасов. Записи включают метку времени и указывают тип API-интерфейса.

Настройка журнала регистрации запасов

Чтобы начать вести журнал успешно обновленных записей API-интерфейса запасов, необходимо включить эту функцию в Microsoft Power Apps.

  1. Войдите в Power Apps и перейдите в раздел Видимость запасов>Параметры>Управление функциями.
  2. Включите функцию История журнала запасов.
  3. Перейдите в раздел Параметры администрирования и выберите Обновить конфигурацию.

Просмотр журнала регистрации запасов

После включения этой функции вы можете просматривать записи журнала либо с помощью приложения Видимость запасов в Power Apps, либо путем вызова API-интерфейса.

Просмотр записей журнала с помощью приложения Видимость запасов в Power Apps

Выполните следующие действия, чтобы просмотреть журнал с помощью приложения Видимость запасов в Power Apps.

  1. Войдите в Power Apps и перейдите в раздел Видимость запасов>Операционная видимость>Журнал регистрации запасов.
  2. Введите идентификатор продукта, идентификатор организации, идентификатор сайта, идентификатор склада и диапазон дат, чтобы получить и просмотреть данные журнала.

Получение записей журнала путем вызова API-интерфейса

Выполните следующие действия, чтобы извлечь записи журнала путем вызова API-интерфейса видимости запасов.

  1. Запустите инструмент, позволяющий вызывать API. Используйте инструмент для доступа к API {inventoryVisibilityEndpoint}/api/environment/{yourEnvironmentId}/logTransactionDetails с помощью метода Post.

  2. Настройте и отправьте текст запроса для получения интересующих вас данных журнала. В следующем примере показан текст запроса, в котором системе предлагается подготовить и получить журнал. Этот шаг необходим, поскольку журнал хранится в Azure Data Lake и переносится в Dataverse только по запросу. API возвращает идентификатор задания журнала регистрации, который можно использовать для проверки статуса завершения задания.

    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. Используйте API {inventoryVisibilityEndpoint}/api/environment/{yourEnvironmentId}/getJobProgress?jobId={jobIdFromPreviousStep} для отслеживания статуса задания журнала регистрации запасов.

  4. Когда API-интерфейс сообщит, что задание успешно выполнено, вы можете просмотреть журналы в Dataverse, открыв таблицу отчета о регистрации транзакций (is_transactionloggingreport).