安装 Warehouse Management 移动应用

项目
02/06/2024

票据

Azure Active Directory 现在是 Microsoft Entra ID。了解详细信息

本文介绍如何在每个移动设备上下载和安装 Warehouse Management 移动应用，以及如何配置应用来连接到 Microsoft Dynamics 365 Supply Chain Management 环境。可以手动配置每个设备，也可以通过文件或使用 QR 代码导入连接字符串。

Warehouse Management 移动应用仅供内部业务使用。您不能在任何应用商店或类似的分发服务中对外重新发布或分发 Warehouse Management 移动应用。

必备项

操作系统要求

Warehouse Management 移动应用可用于 Microsoft Windows、Google Android 和 Apple iOS 操作系统。若要使用此应用，您的移动设备上必须安装以下操作系统之一：

Windows 10（通用 Windows 平台 [UWP]）2018 年 10 月更新 1809（内部版本 10.0.17763）或更高版本
Android 5.0 或更高版本
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

在 Supply Chain Management 中打开或关闭 Warehouse Management 移动应用功能

要使用 Warehouse Management 移动应用，必须在您的系统中打开新仓库应用的用户设置、图标和步骤标题功能。从 Supply Chain Management 10.0.25 开始，此功能是强制性的，无法关闭。

获取仓库管理移动应用

对于较小部署，通常可能在每个设备上从相关商店安装此应用，然后手动配置与您在使用的环境之间的连接。

对于较大部署，您可以自动化应用部署和/或配置，如果您管理很多设备，这样会更加方便。例如，您可能使用移动设备管理和移动应用程序管理解决方案，如 Microsoft Intune。有关如何批量部署 Warehouse Management 移动应用的安装和更新的信息，请参阅使用基于用户的身份验证批量部署移动应用或使用基于服务的身份验证批量部署移动应用（具体取决于您使用的身份验证方法类型）。

从应用商店安装应用

在单个设备上安装应用的最简单方法是从应用商店安装，应用商店始终会提供最新的正式发布版本。 Microsoft Intune 也可以从应用商店获取应用。使用以下链接之一从应用商店安装应用：

Windows (UWP)：Microsoft Store 中的 Warehouse Management
Android：Google Play 商店中的 Warehouse Management
iOS：Apple App Store 中的 Warehouse Management

作为从应用商店安装的替代方法，您可以从 Microsoft App Center 下载应用。 App Center 提供可以旁加载的可安装包。除了当前版本外，App Center 还允许您下载以前的版本，并且可以提供包含您可以试用的即将发布功能的预览版本。若要从 Microsoft App Center 中下载 Warehouse Management 移动应用的当前、先前或预览版本，请使用以下链接之一：

Windows (UWP)：Warehouse Management (Windows)

有关如何在 Windows 设备上安装下载的包然后设置所需证书的说明，请参阅从 App Center 安装版本。
Android：Warehouse Management (Android)

可能需要执行一些额外步骤才能安装。有关详细信息，请参阅测试 Android 应用。
iOS：此应用的 iOS 版本只能通过 App Store 获取。

有关如何安装从 App Center 下载的内部版本的信息，请参阅安装内部版本。

Warehouse Management 移动应用不在中国的应用商店提供。但是，官方支持从 Microsoft App Center 下载并与世纪互联在中国运营的 Dynamics 365 Supply Chain Management 一起使用。

确定您将使用的身份验证方法

由于 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 时记录的客户端 ID。（有关详细信息，请参阅以下文章之一，具体取决于您使用的身份验证方法：基于用户的身份验证或基于服务的身份验证。）
`ActiveDirectoryResource`	指定 Supply Chain Management 的根 URL。
`ActiveDirectoryTenant`	指定要用于 Supply Chain Management 服务器的 Microsoft Entra ID 域名。此值的格式为 `https://login.windows.net/<your-Microsoft-Entra-ID-domain-name>`。下面是一个示例：`https://login.windows.net/contosooperations.onmicrosoft.com`。有关如何查找 Microsoft Entra ID 域名的详细信息，请参阅查找用户的重要 ID。
`Company`	在 Supply Chain Management 中指定希望应用程序连接到的法人。
`ConnectionType`	（可选）指定连接设置应使用证书、客户端密码还是设备代码连接到环境。有效值为 `"Certificate"`、`"ClientSecret"`、`"DeviceCode"` 和 `"UsernamePassword"`。默认值为 `"DeviceCode"`。注意：不能导入客户端密码。
`IsEditable`	（可选）指定应用用户是否应该可以编辑连接设置。有效值为 `"true"` 和 `"false"`。默认值为 `"true"`。
`IsDefault`	（可选）指定连接是否为默认连接。打开应用时，将提前选中设置为默认连接的连接。只能将一个连接设置为默认连接。有效值为 `"true"` 和 `"false"`。默认值为 `"false"`。
`CertificateThumbprint`	（可选）对于 Windows 设备，您可以为连接指定证书指纹。对于 Android 设备，则应用用户必须在首次使用连接时选择证书。
`UseBroker`	（可选）此参数仅适用于 `"UsernamePassword"` 连接类型。它确定代理是否用于使用 Intune 公司门户（仅 Android）和 Microsoft Authenticator（Android 和 iOS）的单一登录 (SSO) 身份验证。对于基于代理的身份验证，将它设置为 `"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 码，可以在设备上手动配置此应用，以便通过 Microsoft Entra ID 应用程序连接到 Supply Chain Management 服务器。

在您的移动设备上启动仓库管理移动应用。
如果应用以演示模式启动，选择连接设置。如果应用启动时出现登录页，选择更改连接。
选择设置连接。
选择手动输入。 新建连接页将出现，显示手动输入连接详细信息所需的设置。
输入以下信息：
- 身份验证方法 - 选择以下值之一以指定用于通过 Supply Chain Management 进行身份验证的方法。您在此处选择的方法必须与 Azure 中应用的设置相匹配。
  - 设备代码 - 使用设备代码流进行身份验证。此方法是一种基于用户的身份验证方法。
  - 用户名和密码 - 使用 SSO 或要求用户输入用户名和密码进行身份验证。此方法是一种基于用户的身份验证方法。
  - 客户端密码（已弃用）- 使用客户端密码进行身份验证。此方法是一种基于服务的身份验证方法。
  - 证书（已弃用） - 使用证书进行身份验证。此方法是一种基于服务的身份验证方法。
- 连接名称 – 输入新连接的名称。下次打开连接设置时，将在选择连接字段中显示此名称。您输入的名称必须唯一。（换句话说，如果在设备上存储了其他任何连接名称，该名称必须与这些名称不同。）
- Microsoft Entra ID 客户端 ID – 输入您在设置 Microsoft Entra ID 时记录的客户端 ID。（有关详细信息，请参阅以下文章之一，具体取决于您使用的身份验证方法：基于用户的身份验证或基于服务的身份验证。）
- Microsoft Entra ID 客户端密码 – 只有当身份验证方法设置为客户端密码（已弃用）时，此字段才可用。输入您在设置 Microsoft Entra ID 时记录的客户端密码。（有关详细信息，请参阅以下文章之一，具体取决于您使用的身份验证方法：基于用户的身份验证或基于服务的身份验证。）
- 证书指纹 – 此字段仅可用于 Windows 设备，且仅在身份验证方法设置为证书（已弃用）时可用。输入您在设置 Microsoft Entra ID 时记录的证书指纹。（有关详细信息，请参阅以下文章之一，具体取决于您使用的身份验证方法：基于用户的身份验证或基于服务的身份验证。）
- 环境 URL - 指定 Supply Chain Management 的根 URL。
  
  重要提示
  
  请勿为此值使用反斜杠 (/)。确保 HTTPS (SSL) 证书有效。
- Microsoft Entra ID 租户 – 输入与 Supply Chain Management 服务器一起使用的 Microsoft Entra ID 域名。此值的格式为 https://login.windows.net/<your-Microsoft-Entra-ID-domain-name>。下面是一个示例：https://login.windows.net/contosooperations.onmicrosoft.com。有关如何查找 Microsoft Entra ID 域名的详细信息，请参阅查找用户的重要 ID。
  
  注意
  
  请勿为此值使用反斜杠 (/)。
- 公司 – 在希望应用程序连接到的 Supply Chain Management 中输入法人（公司）。
- 使用代理 - 仅当身份验证方法字段设置为用户名和密码时，此选项才适用。它确定代理是否用于使用 Intune 公司门户（仅 Android）或 Microsoft Authenticator（Android 和 iOS）的 SSO 身份验证。对于基于代理的身份验证和 SSO，将此选项设置为是。将它设置为否，以要求手动输入用户名和密码。
- 域名 - 仅当身份验证方法字段设置为用户名和密码时，此字段才适用。您可以使用它让工作人员更轻松地登录。如果您不设置此字段，工作人员必须输入完整的 Microsoft Entra ID 用户主体名称才能登录。用户主体名称的格式为 <用户名>@<域名>。如果您在此处指定 <域名> 部分，工作人员只需输入 <用户名> 部分即可登录。（尽管如此，工作人员仍然可以输入完整的用户主体名称。）
选择页面右上角的保存按钮。
如果您使用证书进行身份验证，请完成以下步骤之一：
- 对于 Android 设备，在出现提示时选择证书。
- 对于 iOS 设备，请按照导入连接设置部分第 5 步中的说明进行操作。
此应用将连接到您的 Supply Chain Management 服务器，并显示登录页。

对丢失或遭到入侵的设备取消访问权限

如果设备丢失或遭到入侵，您必须取消设备对 Supply Chain Management 的访问权限。用于取消访问权限的方法取决于如何配置设备以使用 Supply Chain Management 进行身份验证。有关说明，请参阅以下文章之一：

如果使用基于用户的身份验证，请参阅基于用户的身份验证
如果使用基于服务的身份验证（已弃用），请参阅基于服务的身份验证

通过