Установка и настройка надстройки "Видимость запасов"

Примечание

Вместо Azure Active Directory теперь используется Microsoft Entra ID. Подробнее

В этой статье описывается, как установить надстройку отображения запасов для Microsoft Dynamics 365 Supply Chain Management.

Необходимо использовать Microsoft Dynamics Lifecycle Services, чтобы установить надстройку видимости запасов. Lifecycle Services — это портал совместной работы, который предоставляет среду и набор регулярно обновленных служб, которые помогут управлять жизненным циклом приложений для управления финансами и операциями. Дополнительные сведения см. в разделе Ресурсы Lifecycle Services.

Совет

Если вы консультант по функциональным возможностям или решениям, рекомендуется присоединиться к группе Надстройка "Видимость запасов" в Yammer, где можно ознакомиться с последними достижениями, обмениватьсясоветами с другими консультантами и разработчиками, а также обсуждать функции.

Если вы испытываете технические проблемы или сталкиваетесь с исключениями, вы можете получить помощь, отправив сообщение электронной почты непосредственно команде продукта "Видимость запасов" в inventvisibilitysupp@microsoft.com (пожалуйста, не забудьте включить свой код среды Supply Chain Management).

Полезные образцы кода и руководства по устранению неполадок см. в репозитории "Видимость запасов" GitHub.

Необходимые условия для видимости запасов

Перед установкой надстройки видимости запасов необходимо сделать следующее:

  • Получите проект внедрения Lifecycle Services с по крайней мере одной развернутой средой.
  • Убедитесь, что необходимые условия для настройки надстроек завершены. Сведения об этих предварительных требованиях см. в разделе Обзор надстроек. Для контроля запасов не требуется связывание с двойной записью.

В следующей таблице перечислены страны/регионы, в которых Inventory Visibility в настоящее время поддерживается.

Регион Azure Краткое название региона
Восточная Азия eas
Юго-Восточная Азия seas
Восточная Австралия eau
Юго-восточная Австралия seau
Южная Бразилия sbr
Центральная Канада cca
Восточная Канада eca
Восточный Китай 2 cne2
Северный Китай 2 cnn2
Северная Европа neu
Западная Европа weu
Центральная Франция cfr
Южная Франция sfr
Центральная Индия cin
Южная Индия sin
Восточная Япония ejp
Западная Япония wjp
Восточная Норвегия eno
Западная Норвегия wno
Западная часть ЮАР wza
Северная часть ЮАР nza
Северная Швейцария nch
Западная Швейцария wch
Северная часть ОАЭ nae
Южная часть Соединенного Королевства suk
Западная часть Соединенного Королевства wuk
Восточная часть США eus
Западная часть США wus

При возникновении каких-либо вопросов о необходимых условиях свяжитесь с группой по продукту видимости запасов по адресу inventvisibilitysupp@microsoft.com.

Установка надстройки видимости запасов

Перед установкой надстройки зарегистрируйте приложение и добавьте секрет клиента в Microsoft Entra в своей подписке Azure. Инструкции см. в разделе Регистрация приложения и Добавление секрета клиента. Обязательно запишите значения Идентификатор приложения (клиента), Секрет клиента и Идентификатора арендатора, так как они понадобятся позже.

Важно

Если имеется более одной среды Lifecycle Services, создайте отдельное приложение Microsoft Entra для каждой из них. При использовании того же кода приложения и кода клиента для установки надстройки Видимость запасов в различных средах, в старых средах будет выдаваться маркер. В результате только последняя установка будет действительной.

После регистрации приложения и добавления к нему секрета клиента в Microsoft Entra ID выполните следующие действия, чтобы установить надстройку "Отображение запасов".

  1. Выполните вход в Lifecycle Services.

  2. На домашней странице выберите проект, в котором развернута среда.

  3. На странице проекта выберите среду, в которой требуется установить надстройку.

  4. На странице среды прокрутите вниз, чтобы увидеть раздел Надстройки среды в разделе Интеграция Power Platform. Там можно найти имя среды Dataverse. Убедитесь, что имя среды Dataverse является именем, которое будет использоваться для отображения запасов.

    Примечание

    В настоящее время поддерживаются только среды Dataverse, созданные с использованием Lifecycle Services. Если среда Dataverse была создана каким-либо другим способом (например, с помощью центра администрирования PowerApps) и если она связана с вашей средой Supply Chain Management, необходимо сначала устранить проблему с сопоставлением, прежде чем устанавливать надстройку видимости запасов.

    Возможно, что среда с двойной записью связана с экземпляром Dataverse, а Lifecycle Services не настроен для интеграции Power Platform. Это несоответствие ссылок может привести к непредсказуемому поведению. Рекомендуется, чтобы сведения среды Lifecycle Services соответствовали сведениям среды, к который вы подключены в двойной записи, чтобы одно и то же подключение можно было использовать в бизнес-событиях, виртуальных таблицах и надстройках. См. раздел Несоответствие ссылок для получения сведений о том, как исправить проблему сопоставления. После устранения проблемы сопоставления можно продолжить установку отображения запасов.

  5. В разделе Надстройки сред выберите Установить новую надстройку.

    Страница среды в Lifecycle Services

  6. Выберите ссылку Установить новую надстройку. Откроется список доступных надстроек.

  7. Выберите Контроль запасов в списке.

  8. Задайте следующие поля для своей среды:

    • Microsoft Entra Идентификатор (клиента) приложения — введите идентификатор приложения Microsoft Entra, который был создан ранее и который вы записали.
    • Microsoft Entra Идентификатор арендатора — введите идентификатор арендатора, который вы записали ранее.

    Страница настройки надстройки

  9. Примите условия, установив флажок Условия.

  10. Выберите Установить. Статус надстройки будет отображаться как Установка. После завершения установки обновите страницу. Статус должен изменяться на Установлено.

  11. В Dataverse в области переходов в левой части выберите раздел Приложения и убедитесь, что Видимость запасов Power Apps установлена успешно. Если раздела Приложения не существует, обратитесь к группе по продукту видимости запасов по адресу inventvisibilitysupp@microsoft.com.

Примечание

Если система предупреждает вас, что у вас нет разрешения на установку видимости запасов в Lifecycle Services, необходимо связаться с администратором, чтобы изменить разрешение.

Если установка со страницы Lifecycle Services занимает больше часа, тогда у вашей учетной записи пользователя может отсутствовать разрешение на установку решений в среде Dataverse. Чтобы устранить проблему, выполните следующие действия:

  1. Отмените процесс установки надстройки видимости запасов со страницы Lifecycle Services.

  2. Выполните вход в центр администрирования Microsoft 365 и убедитесь, что учетной записи пользователя, которую требуется использовать для установки надстройки, назначена лицензия "План Dynamics 365 Unified Operations". При необходимости назначьте лицензию

  3. Войдите в центр администрирования Power Platform, используя соответствующую учетную запись пользователя. Затем установите надстройку видимости запасов, выполнив следующие действия:

    1. Выберите среду, в которую необходимо установить надстройку.
    2. Выберите Приложения Dynamics 365.
    3. Выберите Установить приложение.
    4. Выберите Видимость запасов
  4. По завершении установки вернитесь на страницу Lifecycle Services и повторите попытку переустановить надстройку Видимость запасов.

Настройка Видимости запасов в Supply Chain Management

Развертывание пакета интеграции контроля запасов

Если вы используете Supply Chain Management версии 10.0.17 или более ранней, обратитесь в группу поддержки видимости запасов по адресу inventvisibilitysupp@microsoft.com для получения пакетного файла. Затем разверните пакет в Lifecycle Services.

Примечание

Если во время развертывания возникает ошибка несоответствия версий, необходимо вручную импортировать проект X++ в среду разработки. Затем создайте развертываемый пакет в среде разработки и разверните его в рабочей среде.

Этот код включен в Supply Chain Management 10.0.18. Если вы используете эту версию или более позднюю, развертывание не требуется.

Убедитесь, что в среде Supply Chain Management включены следующие функции. (По умолчанию они включены.)

Описание функции Версия кода Переключить класс
Включение и отключение использования складских аналитик в таблице InventSum 10.0.11 InventUseDimOfInventSumToggle
Включение и отключение использования складских аналитик в таблице InventSumDelta 10.0.12 InventUseDimOfInventSumDeltaToggle

Настройка интеграции Видимости запасов

После установки надстройки подготовьте систему Supply Chain Management для работы с ней, выполнив следующие действия.

  1. В Supply Chain Management откройте рабочую область Управление функциями и включите функцию Интеграция контроля запасов.

  2. Перейдите в раздел Управление запасами>Настройка>Параметры интеграции видимости запасов.

  3. Откройте вкладку Общие и внесите следующие настройки:

    • Конечная точка видимости запасов — введите URL-адрес среды, в которой выполняется Видимость запасов. Дополнительную информацию см. в разделе Поиск конечной точки службы и прочтите конфигурацию.
    • Максимальное число записей в одном запросе — задать максимальное число записей для включения в один запрос. Необходимо ввести положительное целое число меньше или равное 1000. Значение по умолчанию — 512. Настоятельно рекомендуется сохранить значение по умолчанию, если вы не получили рекомендации от службы поддержки Майкрософт или, в ином случае, не уверены, что необходимо изменить.
  4. Следующие дополнительные функции улучшают функциональность Inventory Visibility. Решите, что нужно сделать: использовать одну из этих функций или обе. Если решите использовать обе, их нужно настроить. (Можно также настроить их позже.)

    • Предварительные резервирования и смещения — предварительное резервирование помогает организациям получить единый источник истинности доступных запасов, особенно в процессе выполнения заказа. Дополнительные сведения о том, как активировать и настроить эту функцию, см. в разделе Резервирования в Inventory Visibility.
    • Поддержка номенклатур процессов управления складом (WMS) — эта функция позволяет использовать номенклатуры WMS с Inventory Visibility. Дополнительные сведения о том, как активировать и настроить эту функцию, см. в разделе Поддержка видимости запасов для номенклатур WMS.
    • Сводка запасов. Эта функция предоставляет сводку запасов для продуктов вместе со всеми аналитиками. Сведения о том, как активировать и настроить эту функцию, см. в разделе Сводка запасов.
    • Предварительная загрузка оптимизированного запроса запасов в наличии. Эта функция обеспечивает сводную сводку по запасам для продуктов по настроенным аналитикам. Сведения о том, как включить и настроить эту функцию, см. в разделе Предварительная загрузка оптимизированного запроса запасов в наличии.
  5. После завершения настройки выбранных дополнительных функций перейдите в раздел Управление запасами>Периодические>Интеграция видимости запасов и включите задание. Все события изменения запасов из модуля Supply Chain Management будут разнесены в контроль запасов.

Примечание

Если при включении задания интеграции видимости запасов вы получаете сообщение об ошибке, в котором говорится, что необходимо обновить схему раздела, см. раздел Обновление схемы секционирования на две, если при включении задания интеграции видимости запасов выводится сообщение об ошибке этой статьи для получения инструкций.

Список последних исправлений, доступных для функций интеграции видимости запасов в Supply Chain Management, см. в разделе Последние исправления Dynamics 365 SCM.

Обновление схемы секционирования на две, если при включении задания интеграции видимости запасов выводится сообщение об ошибке

При попытке включить пакетное задание интеграции видимости запасов из Supply Chain Management вы можете получить следующее сообщение об ошибке:

Невозможно выполнить синхронизацию более 500 000 записей на одном и том же складе. Чтобы устранить эту проблему, обновите схему секционирования на 2 в надстройке "Видимость запасов". Для получения дополнительной информации свяжитесь с группой поддержки видимости запасов по адресу inventvisibilitysupp@microsoft.com.

Если вы получили это сообщение об ошибке, выполните следующие действия, чтобы обновить схему разделов для предотвращения проблемы с нехваткой памяти. Если вы не получите это сообщение об ошибке, эту процедуру можно пропустить.

  1. В Power Apps, удалите все данные о запасах.
  2. Настройте систему для отправки запросов API в службу видимости запасов.
  3. После удаления данных вызовите API-интерфейс Get с телом none, чтобы получить все коды разделов (используя /api/environment/{environmentId}/allpartitionids). Просмотрите ответ, чтобы подтвердить, что данные полностью очищены. Результат должен быть пустым.
  4. Вызовите API-интерфейс Post с телом none для изменения схемы секционирования (используя /api/environment/{environmentId}/updatePartitionSchema?newversion=2).
  5. В Power Apps включите функцию расширенных данных складской инвентаризации и обновите конфигурацию.
  6. В Power Apps проверьте конфигурацию среды выполнения. В поле CachePartitonIdVersion должно отображаться значение ByLocationAndProductIdMod64.
  7. В Supply Chain Management перейдите в раздел Управление запасами>Периодические задачи>Интеграция видимости запасов и включите это задание.

Обновление надстройки видимости запасов

Чтобы обновить установленную версию надстройки "Видимость запасов" до последней версии, выполните следующие действия:

  1. Войдите в Центр администрирования Power Platform.

  2. В панели навигации выберите Среды.

  3. Откройте среду, в которой необходимо обновить надстройку "Видимость запасов".

  4. В разделе Ресурсы выберите Приложения Dynamics 365.

  5. Найдите в списке строку, где Имя равно Видимость запасов Dynamics 365. Проверьте значение для этой строки в столбце Статус.

    • Если Статус равен Установлено, то уже запущена последняя версия, так что эту процедуру можно пропустить.
    • Если Статус имеет значение Доступно обновление, то обновление доступно. Переходите к следующему шагу.

    Совет

    Чтобы просмотреть текущую версию надстройки, независимо от статуса, откройте меню Дополнительные действия приложения (кнопка с многоточием), затем выберите Сведения.

  6. Если на странице видно, что обновление доступно, откройте меню Дополнительные действия приложения (кнопка с многоточием), затем выберите Обновить.

  7. Открывается диалоговое окно. Установите флажок Принимаю условия обслуживания, затем выберите Обновить.

  8. Откроется всплывающее окно с запросом подтверждения действия. Для продолжения введите имя своей среды в предоставленное поле и затем выберите Обновить.

Удаление надстройки видимости запасов

Чтобы удалить надстройку видимости запасов, выполните следующие шаги:

  1. Войдите в Supply Chain Management.

  2. Перейдите Управление запасами>Периодические операции>Интеграция контроля запасов и выключите задание.

  3. Перейдите в Lifecycle Services и откройте страницу среды, в которой требуется удалить надстройку (см. также раздел Установка надстройки видимости запасов).

  4. Выберите Удалить.

  5. Процесс удаления теперь отключает надстройку "Видимость запасов", отменяет регистрацию надстройки в Lifecycle Services и удаляет все временные данные, которые хранятся в кэше данных надстройки "Видимость запасов". Однако основные данные запасов, которые были синхронизированы с вашей подпиской Dataverse, все еще хранятся там. Чтобы удалить эти данные и все решения, которые связаны с видимостью запасов, выполните оставшуюся часть процедуры.

  6. Откройте Power Apps.

  7. Выберите Среда на панели переходов.

  8. Выберите среду Dataverse, связанную с вашей средой Lifecycle Services.

  9. Перейдите в пункт Решения и удалите следующие решения в указанном ниже порядке:

    1. Dynamics 365 Inventory Visibility — привязка
    2. Dynamics 365 Inventory Visibility — подключаемые модули
    3. Dynamics 365 Inventory Visibility — приложение
    4. Dynamics 365 Inventory Visibility — элементы управления
    5. Dynamics 365 Inventory Visibility — основа

    После удаления этих решений данные, хранящиеся в таблицах, также будут удалены.

Важно

Удалить данные и решения, связанные с видимостью запасов в Power Apps, следует только в том случае, если вы уверены, что больше не будете использовать видимость запасов в текущей среде. Если удалить их, а затем переустановить "Видимость запасов" со страницы LCS снова, могут возникнуть такие проблемы, например зависание во время установки и невозможность восстановления.

Если необходимо деинсталлировать и переустановить надстройку из-за восстановления базы данных Supply Chain Management, не удаляйте в ней данные и решения Power Apps. Вместо этого, чтобы устранить любые проблемы с данными, выполните процедуру в разделе Удаление данных видимости запасов из Dataverse, прежде чем восстанавливать базу данных Supply Chain Management.

Очистка данных видимости запасов из Dataverse до восстановления базы данных Supply Chain Management

Если вы использовали видимость запасов, а затем восстановите базу данных Supply Chain Management, то в восстановленной базе данных могут содержаться данные, которые больше не соответствуют данным, которые ранее были синхронизированы надстройкой видимости запасов с Dataverse. Это несоответствие данных может привести к возникновению системных ошибок и других проблем. Таким образом, важно всегда очищать все данные видимости запасов из Dataverse перед восстановлением базы данных Supply Chain Management.

Если требуется восстановить базу данных Supply Chain Management, выполните следующую процедуру:

  1. Войдите в Supply Chain Management.
  2. Перейдите Управление запасами>Периодические операции>Интеграция контроля запасов и выключите задание.
  3. Прекратите отправку запросов в видимость запасов из сторонних систем, если вы их используете.
  4. В Power Apps откройте страницу Конфигурация для приложения Видимость запасов. Затем выберите Очистить данные пользователя в верхнем правом углу. Это очистит "грязные" данные запасов из восстановленной базы данных, не затрагивая существующие конфигурации.
  5. Восстановите базу данных Supply Chain Management, например, как описано в разделе Восстановление базы данных на определенный момент времени (PITR) или Восстановление производственной базы данных на определенный момент времени в среде "песочницы".
  6. Перейдите в раздел Управление запасами>Периодические задачи>Интеграция видимости запасов и снова включите задание.

Важно

Существует несколько способов переноса данных между средами Dataverse, однако мы не рекомендуем их использовать, потому что данные Dataverse включают идентификатор их среды (EnvironmentId), что означает, что непосредственный перенос данных из одной среды в другую приведет к повреждению данных. Если вы столкнетесь с этой проблемой, обратитесь за помощью по адресу inventvisibilitysupp@microsoft.com.