Установка мобильного приложения Warehouse Management

Статья
01/03/2024

Примечание

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

В этой статье описан порядок загрузки и установки мобильного приложения управления складом на каждом из мобильных устройств и способ его настройки для подключения к среде Microsoft Dynamics 365 Supply Chain Management. Можно настроить каждое устройство вручную или импортировать параметры подключения из файла или путем сканирования QR-кода.

Мобильное приложение Warehouse Management предназначено только для внутреннего использования в вашем бизнесе. Вы не имеете права публиковать или распространять мобильное приложение Warehouse Management в каком-либо магазине приложений или аналогичной службе распространения приложений вне вашей организации.

Необходимые условия

Требования к операционной системе

Мобильное приложение Warehouse Management доступно в операционных системах Microsoft Windows, Google Android и Apple iOS. Чтобы использовать это приложение, на мобильном устройстве должна быть установлена одна из следующих операционных систем:

Windows 10 (универсальная платформа Windows (UWP)), обновление 1809 за октябрь 2018 года (сборка 10.0.17763) или более поздней версии
Android 4.4 или более поздняя версия
iOS 13.0 или более поздняя версия

Внешние URL-адреса, необходимые приложению

Чтобы мобильное приложение Warehouse Management правильно функционировало, внутренняя сеть должна разрешить ему доступ к следующим внешним URL-адресам:

*.microsoft.com
*.microsoftonline.com
login.windows.net
*.appcenter.ms
*.ces.microsoftcloud.com
*.onyx.azure.net
play.google.com
itunes.apple.com
*.cdn-apple.com
*.networking.apple
login.microsoftonline.com
login.microsoft.com
sts.windows.net
login.partner.microsoftonline.cn
login.chinacloudapi.cn
login.microsoftonline.us
login-us.microsoftonline.com
*.applicationinsights.azure.com
*.applicationinsights.azure.us
*.applicationinsights.azure.cn

Включение или отключение функций мобильного приложения Warehouse Management в Supply Chain Management

Чтобы использовать мобильное приложение Warehouse Management, для системы должна быть включена функция Параметры пользователя, значки и названия шагов для нового приложения склада. В Supply Chain Management 10.0.25 эта функция обязательна и не может быть отключена. При запуске версии, более старой, чем 10.0.25, администраторы могут включать или выключать эту функцию путем поиска функции Параметры пользователя, значки и названия шагов для нового приложения склада в рабочей области Управление функциями.

Получение мобильного приложения управления складом

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

Для больших развертываний можно автоматизировать развертывание и/или настройку приложения, что может быть более удобным при управлении многими устройствами. Например, можно использовать управление мобильными устройствами и решение для управления мобильными приложениями, например Microsoft Intune. Сведения о массовом развертывании установок и обновлений мобильного приложения Warehouse Management см. в разделе Массовое развертывание мобильного приложения с проверкой подлинности на основе пользователей или Массовое развертывание мобильного приложения с проверкой подлинности на основе службы (в зависимости от того, какой метод проверки подлинности вы используете).

Установите приложение из магазина приложений

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

Windows (UWP):Warehouse Management в Microsoft Store
Android:Warehouse Management в Google Play Маркет
iOS:Warehouse Management в Apple App Store

В качестве альтернативы установке из магазина приложений вместо этого можно загрузить приложение из центра приложений Microsoft. Центр приложений предоставляет устанавливаемые пакеты, для которых можно загрузить неопубликованные приложения. В дополнение к текущей версии центр приложений также позволяет загрузить предыдущие версии и может предоставить предварительные версии с предстоящими функциями, которые можно попробовать. Для загрузки текущих, предыдущих или предварительных версий мобильного приложения управления складом из центра приложения Майкрософт используйте одну из следующих ссылок:

Windows (UWP):Warehouse Management (Windows)

Инструкции по установке загруженного пакета на устройстве с Windows и последующей настройке необходимых сертификатов см. в разделе Установка сборки из центра приложений.
Android:Warehouse Management (Android)

Для установки может потребоваться несколько дополнительных шагов. Подробности см. в разделе Тестирование приложений Android.
iOS: версия приложения для iOS доступна только в магазине App Store.

Сведения о том, как установить сборку, загруженную из центра приложений, см. в разделе Установка сборки.

Мобильное приложение Warehouse Management недоступно в магазинах приложений в Китае. Однако его загрузка из центра приложений Майкрософт и использование вместе с Dynamics 365 Supply Chain Management, предоставляемым 21Vianet в Китае, официально поддерживается.

Выбор используемых способов проверки подлинности

Поскольку мобильное приложение Warehouse Management имеет доступ на чтение/запись к некоторым из ваших данных Supply Chain Management, каждое устройство должно проходить проверку подлинности в Supply Chain Management. Приложение поддерживает несколько способов проверки подлинности. Перед началом развертывания приложения изучите доступные способы проверки подлинности и решите, какой из них вы будете использовать.

После проверки подлинности устройства в Supply Chain Management, каждый работник, использующий это устройство, входит в систему, используя свою учетную запись работника в Supply Chain Management. После этого загружаются личные параметры работника (такие как склад по умолчанию и параметры приложения). Таким образом, разные работники могут входить в систему и выходить из нее каждую смену, в то время как само устройство продолжает быть аутентифицированным в Supply Chain Management.

Подробные сведения о каждом способе проверки подлинности и его настройке см. в следующих статьях:

Проверка подлинности на основе пользователей^ Проверка подлинности на основе пользователей для мобильного приложения Warehouse Management
Проверка подлинности на основе служб (устарела): Проверка подлинности на основе служб для мобильного приложения Warehouse Management

Важно

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

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

Проверка подлинности на основе пользователей: Удаление доступа для устройства, которое использует проверку подлинности не основе пользователя
Проверка подлинности на основе службы (нерекомендуемая): Отзыв доступа для устройства, проходящего проверку подлинности с помощью сертификата или секрета клиента

Настройка приложения путем импортирования параметров подключения

Для облегчения поддержки и развертывания приложения на многих мобильных устройствах можно импортировать параметры подключения вместо того, чтобы вводить их вручную на каждом устройстве. В этом разделе объясняется, как создавать и импортировать параметры.

Создание файла параметров подключения или QR кода

Можно импортировать настройки подключения из файла или QR-кода. Для обоих подходов необходимо сначала создать файл параметров, использующий формат и синтаксис JavaScript Object Notation (JSON). Файл должен включать список подключений, содержащий отдельные подключения, которые необходимо добавить. В следующей таблице перечислены параметры, которые необходимо указать в файле параметров подключения.

Параметр	Описание
`ConnectionName`	Укажите имя параметра подключения. Оно может содержать до 20 знаков. Поскольку это значение является уникальным идентификатором для параметра подключения, убедитесь, что он уникален в списке. Если на устройстве уже существует подключение с таким именем, оно будет переопределено настройками из импортированного файла.
`ActiveDirectoryClientAppId`	Укажите идентификатор клиента, который вы записали при настройке Microsoft Entra ID. (Дополнительную информацию см. в одной из следующих статей, в зависимости от того, какой способ проверки подлинности используется: Проверка подлинности на основе пользователей или Проверка подлинности на основе службы.)
`ActiveDirectoryResource`	Укажите корневой URL-адрес Supply Chain Management.
`ActiveDirectoryTenant`	Укажите доменное имя Microsoft Entra ID, используемое с сервером Supply Chain Management. Это значение имеет форму `https://login.windows.net/<your-Microsoft-Entra-ID-domain-name>`. Вот пример: `https://login.windows.net/contosooperations.onmicrosoft.com`. Дополнительные сведения о получении доменного имени Microsoft Entra ID см. в разделе Поиск важных кодов для пользователя.
`Company`	Укажите юридическое лицо в Supply Chain Management, к которому должно подключаться приложение.
`ConnectionType`	(Необязательно) Укажите, что должно использоваться в параметре подключения для подключения к среде — сертификат, секрет клиента или код устройства. Допустимые значения — `"Certificate"`, `"ClientSecret"`, `"DeviceCode"` и `"UsernamePassword"`. Значение по умолчанию — `"DeviceCode"`. Примечание: секреты клиента невозможно импортировать.
`IsEditable`	(Необязательно) Укажите, должен ли пользователь приложения иметь возможность редактирования параметров подключения. Допустимые значения — `"true"` и `"false"`. Значение по умолчанию — `"true"`.
`IsDefault`	(Необязательно) Укажите, является ли подключение подключением по умолчанию. Подключение, установленное в качестве подключения по умолчанию, будет выбираться автоматически при открытии приложения. Установить в качестве подключения по умолчанию можно только одно подключение. Допустимые значения — `"true"` и `"false"`. Значение по умолчанию — `"false"`.
`CertificateThumbprint`	(Необязательно) Для устройств Windows можно указать отпечаток сертификата для подключения. Для устройств Android пользователь приложения должен выбрать сертификат при первом использовании подключения.
`UseBroker`	(Необязательно) Этот параметр применяется только к типу подключения `"UsernamePassword"`. Он определяет, будет ли брокер использоваться для проверки подлинности единого входа (SSO) с помощью портала компании Intune (только Android) и Microsoft Authenticator (Android и iOS). Установите его на `"true"` для проверки подлинности на основе брокера. Установите его на `"false"` для требования ввода вручную имени пользователя и пароля.

В следующем примере показан допустимый файл параметров подключения, содержащий два подключения. Как видно, список подключений (с именем "ConnectionList" в файле) — это объект с массивом, в котором каждое подключение хранится как объект. Каждый объект должен быть заключен в фигурные скобки ({}) и отделяться запятыми, а массив должен быть заключен в квадратные скобки ([]).

{
    "ConnectionList": [
        {
            "ActiveDirectoryClientAppId":"aaaaaaaa-bbbb-ccccc-dddd-eeeeeeeeeeee",
            "ConnectionName": "Connection1",
            "ActiveDirectoryResource": "https://yourenvironment.cloudax.dynamics.com",
            "ActiveDirectoryTenant": "https://login.windows.net/contosooperations.onmicrosoft.com",
            "Company": "USMF",
            "IsEditable": false,
            "IsDefaultConnection": true,
            "CertificateThumbprint": "aaaabbbbcccccdddddeeeeefffffggggghhhhiiiii",
            "ConnectionType": "Certificate"
        },
        {
            "ActiveDirectoryClientAppId":"aaaaaaaa-bbbb-ccccc-dddd-eeeeeeeeeeee",
            "ConnectionName": "Connection2",
            "ActiveDirectoryResource": "https://yourenvironment2.cloudax.dynamics.com",
            "ActiveDirectoryTenant": "https://login.windows.net/contosooperations.onmicrosoft.com",
            "Company": "USMF",
            "IsEditable": true,
            "IsDefaultConnection": false,
            "ConnectionType": "ClientSecret"
        },
        {
            "ActiveDirectoryClientAppId":"aaaaaaaa-bbbb-ccccc-dddd-eeeeeeeeeeee",
            "ConnectionName": "Connection3",
            "ActiveDirectoryResource": "https://yourenvironment2.cloudax.dynamics.com",
            "ActiveDirectoryTenant": "https://login.windows.net/contosooperations.onmicrosoft.com",
            "Company": "USMF",
            "IsEditable": true,
            "IsDefaultConnection": false,
            "ConnectionType": "DeviceCode"
        },
        {
            "ActiveDirectoryClientAppId":"aaaaaaaa-bbbb-ccccc-dddd-eeeeeeeeeeee",
            "ConnectionName": "Connection4",
            "ActiveDirectoryResource": "https://yourenvironment2.cloudax.dynamics.com",
            "ActiveDirectoryTenant": "https://login.windows.net/contosooperations.onmicrosoft.com",
            "Company": "USMF",
            "IsEditable": true,
            "IsDefaultConnection": false,
            "UseBroker": true,
            "ConnectionType": "UsernamePassword"
        }
    ]
}

Можно либо сохранить сведения в формате JSON, либо создать QR-код с тем же содержимым. Если сохранить информацию в виде файла, рекомендуется сохранить их, используя имя по умолчанию connections.json, особенно если оно будет храниться в местонахождении по умолчанию на каждом мобильном устройстве.

Сохраните файл параметров подключения на каждом устройстве

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

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

Невозможно удалить подключение, используя файл параметров подключения.

Как упоминалось, именем файла по умолчанию является connections.json. Местонахождение файлов по умолчанию зависит от типа используемого устройства:

Windows:C:\Users\<User>\AppData\Local\Packages\Microsoft.WarehouseManagement_8wekyb3d8bbwe\LocalState
Android:Android\data\com.Microsoft.WarehouseManagement\files
iOS: общий доступ к файлам еще не поддерживается.

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

Примечание

При удалении приложения путь по умолчанию и его содержимое удаляются.

Импорт параметров подключения

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

Запустите мобильное приложение управления складом на мобильном устройстве. При первом запуске приложения отображается приветственное сообщение. Выберите Выберите подключение.
Если вы импортируете настройки подключения из файла и при сохранении файла использовались имя и местоположение по умолчанию, приложение могло уже найти этот файл. В этом случае пропустите шаг 4. В противном случае выберите Настройка подключения, затем перейдите к шагу 3.
В диалоговом окне Настройка подключения выберите Добавить из файла или Добавить из QR-кода в зависимости от того, как необходимо импортировать настройки:
- Если вы импортируете настройки подключения из файла, выберите Добавить из файла, перейдите к файлу на локальном устройстве и выберите его. Если выбрать пользовательское местонахождение, приложение сохранит его и будет автоматически использовать в следующий раз.
- Если параметры подключения импортируются путем сканирования QR-кода, выберите пункт Добавить из QR-кода. Приложение запрашивает разрешение на использование камеры устройства. После предоставления разрешения камера запускается, чтобы ее можно было использовать для сканирования. В зависимости от качества камеры устройства и сложности QR-кода, может оказаться затруднительным получить правильное сканирование. В этом случае попробуйте уменьшить сложность QR-кода путем создания только одного подключения по одному QR-коду. (В настоящее время для сканирования QR-кода можно использовать только камеру устройства.)
После успешного завершения загрузки параметров подключения отображается выбранное подключение.
Выполните одно из следующих действий, чтобы выбрать сертификат проверки подлинности, в зависимости от того, какой тип устройства используется.
- Если вы используете устройство Android и используете для проверки подлинности сертификат, устройство предлагает выбрать сертификат.
- Если вы используете устройство iOS и используете для проверки подлинности сертификат, выберите Изменить параметры подключения, затем выберите Выбрать сертификат. На открывшейся странице выберите Выбрать сертификат, чтобы открыть браузер файлов, и выберите файл сертификата. Затем приложение выводит подтверждение Сертификат выбран. Введите пароль сертификата и выберите Импорт сертификата. Наконец, сохраните параметры подключения.
Приложение подключается к серверу Supply Chain Management и отображает страницу входа.

Вручную настройте приложение

Если у вас нет файла или QR-кода, можно вручную настроить приложение на устройстве для подключения к серверу Supply Chain Management через приложение Microsoft Entra ID.

Запустите мобильное приложение управления складом на мобильном устройстве.
Если приложение запускается в демонстрационном режиме, выберите Параметры подключения. Если при запуске приложения появится страница Вход, выберите Изменить подключение.
Выберите Настройка подключения.
Выберите Ввод вручную. Отображается страница Создать подключение, на которой отображаются параметры, необходимые для ввода сведений о подключении вручную.
Введите следующую информацию:
- Метод проверки подлинности — выберите одно из следующих значений, чтобы указать метод, используемый для проверки подлинности в Supply Chain Management. Выбранный здесь способ должен соответствовать конфигурации приложения в Azure.
  - Код устройства — проверка подлинности с использованием потока с кодом устройства. Этот метод основан на проверке подлинности на основе пользователей.
  - Имя пользователя и пароль — выполните проверку подлинности, используя SSO или попросив пользователя ввести имя пользователя и пароль. Этот метод основан на проверке подлинности на основе пользователей.
  - Секрет клиента (устарело) — аутентификация с помощью секрета клиента. Этот метод основан на проверке подлинности на основе службы.
  - Сертификат (устарело) — аутентификация с помощью сертификата. Этот метод основан на проверке подлинности на основе службы.
- Имя подключения — введите имя для нового подключения. Это имя будет отображаться в поле выбрать подключение при следующем открытии параметров подключения. Необходимо ввести уникальное имя. (Иными словами, оно должно отличаться от имен всех остальных подключений, которые хранятся на устройстве, если там имеются другие имена подключений.)
- Идентификатор клиента Microsoft Entra ID — укажите идентификатор клиента, который вы записали при настройке Microsoft Entra ID. (Дополнительную информацию см. в одной из следующих статей, в зависимости от того, какой способ проверки подлинности используется: Проверка подлинности на основе пользователей или Проверка подлинности на основе службы.)
- Секрет клиента Microsoft Entra ID — это поле доступно только в том случае, если в качестве Способа проверки подлинности задано значение Секрет клиента (нерекомендуемый). Введите секрет клиента, который вы записали при настройке Microsoft Entra ID. (Дополнительную информацию см. в одной из следующих статей, в зависимости от того, какой способ проверки подлинности используется: Проверка подлинности на основе пользователей или Проверка подлинности на основе службы.)
- Отпечаток сертификата — это поле доступно только для устройств Windows и только в том случае, если параметру Способ проверки подлинности задано значение Сертификат (нерекомендуемый). Введите отпечаток сертификата, который вы записали при настройке Microsoft Entra ID. (Дополнительную информацию см. в одной из следующих статей, в зависимости от того, какой способ проверки подлинности используется: Проверка подлинности на основе пользователей или Проверка подлинности на основе службы.)
- URL-адрес среды — укажите корневой URL-адрес Supply Chain Management.
  
  Важно
  
  Не завершайте это значение символом косой черты (/). Убедитесь, что сертификат HTTPS (SSL) является действительным.
- Клиент Microsoft Entra ID — введите доменное имя Microsoft Entra ID, используемое с сервером Supply Chain Management. Это значение имеет форму https://login.windows.net/<your-Microsoft-Entra-ID-domain-name>. Вот пример: https://login.windows.net/contosooperations.onmicrosoft.com. Дополнительные сведения о получении доменного имени Microsoft Entra ID см. в разделе Поиск важных кодов для пользователя.
  
  Важно
  
  Не завершайте это значение символом косой черты (/).
- Компания — введите юридическое лицо (компанию) в Supply Chain Management, к которому должно подключаться приложение.
- Использовать брокера — эта настройка применяется только в том случае, если в поле Метод проверки подлинности установлено значение Имя пользователя и пароль. Он определяет, будет ли брокер использоваться для проверки подлинности единого входа (SSO) с помощью портала компании Intune (только Android) и Microsoft Authenticator (Android и iOS). Установите значение Да для проверки подлинности на основе брокера и SSO. Установите его на Нет для требования ввода вручную имени пользователя и пароля.
- Доменное имя — это поле применяется только в том случае, если в поле Метод проверки подлинности установлено значение Имя пользователя и пароль. Вы можете использовать его, чтобы облегчить вход для работников. Если вы не установили это поле, работники должны ввести свое полное имя субъекта-пользователя Microsoft Entra ID для входа в систему. Имя субъекта-пользователя имеет форму <имя пользователя>@<доменное имя>. Если вы укажите здесь часть <доменного имени>, работники смогут войти в систему, введя только часть <имени пользователя>. (Тем не менее работники все еще смогут вводить свое полное имя субъекта-пользователя.)
Выберите кнопку Сохранить в верхнем правом углу страницы.
Если для проверки подлинности используется сертификат, выполните одно из следующих действий:
- Для устройств Android выберите сертификат в ответ на соответствующее предложение.
- Для устройств iOS выполните инструкции, приведенные в шаге 5 раздела Импорт параметров подключения.
Приложение подключается к серверу Supply Chain Management и отображает страницу входа.

Отзыв доступа в случае утери или компрометации устройства

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

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