配置库存可见性数据源

项目
04/15/2024

本文提供了库存可见性的数据源配置的全面概览。它涵盖了设置和优化数据源配置以增强库存管理流程的基本步骤。

每个数据源配置都包括以下组成部分：

数据源名称
维度（维度映射）
实际度量
计算度量

注意

如果您最近从 UI 版本 1 转换到 UI 版本 2，请参阅本文的库存可见性 UI 版本 1 和 UI 版本 2 之间的差异部分，以了解哪些内容发生了更改。

对于新安装，我们建议您从一开始就使用 UI 版本 2。如果您仍在使用 UI 版本 1，我们建议您测试新版本，然后尽快升级到 UI 版本 2。

先决条件

首先，按照安装和设置库存可见性中的说明安装并设置库存可见性加载项。

库存可见性 UI 版本 1 和 UI 版本 2 之间的差异

Microsoft Power Apps 中的库存可见性应用支持两个版本的用户界面：UI 版本 1 和 UI 版本 2。每个版本都使用不同且独立的配置设置集合。因此，您必须选择您希望使用哪个版本。

设置数据源时，UI 版本 2 与 UI 版本 1 在以下方面有所不同：

实际度量 - 在 UI 版本 2 中，您不再需要为实际度量指定数据源。默认情况下，UI 版本 2 使用当前数据源。
计算度量 - 在 UI 版本 2 中，您可以通过两个步骤指定计算度量：
1. 设置计算度量元数据以指定计算度量的名称和数据源。
2. 添加计算度量行。每行都包含一个实际度量名称和一个运算符（加法或减法），用于在计算过程中将该行与其他行组合起来。

添加数据源（数据源名称）

各数据源表示您的数据的来源系统。数据源名称示例包括 fno（对应 Dynamics 365 Supply Chain Management）和 pos（代表“销售点”）。默认情况下，Supply Chain Management 在库存可见性中设置为默认数据源 (fno)。

注意

fno 数据源是为 Supply Chain Management 预留的。如果您的库存可见性加载项与 Supply Chain Management 环境集成，我们建议您不要删除数据源中与 fno 相关的配置。

重要提示

添加数据源时，请务必先验证数据源名称、实际度量和维度映射，然后再更新库存可见性服务的配置。选择更新配置之后，不能修改这些设置。

在 UI 版本 2 中添加数据源

当您使用库存可见性 UI 版本 2 时，本部分适用。

若要在 UI 版本 2 中添加数据源，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格上，选择功能管理。
在数据源设置磁贴上，选择管理。
在数据源设置页面上，在工具栏上选择新建以添加数据源。输入新数据源的名称（例如，ecommerce 或另一个有意义的数据源 ID）。
选择保存。

在 UI 版本 1 中添加数据源

当您使用库存可见性 UI 版本 1 时，本部分适用。

若要在 UI 版本 1 中添加数据源，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格底部的更改区域菜单上，选择旧版 UI。
在导航窗格上，选择配置。
在数据源选项卡上，选择新建数据源以添加数据源。输入新数据源的名称（例如，ecommerce 或另一个有意义的数据源 ID）。

注意

添加数据源时，请务必先验证数据源名称、实际度量和维度映射，然后再更新库存可见性服务的配置。选择更新配置之后，不能修改这些设置。

维度（维度映射）

维度配置的目的是根据维度组合标准化用于发布事件和查询的多系统集成。库存可见性提供可从数据源的维度映射的基础维度的列表。三十三个维度可供映射。

如果将 Supply Chain Management 用作一个数据源，13 个维度会默认映射到 Supply Chain Management 标准维度。其他 12 个维度（inventDimension1 到 inventDimension12）还会映射到 Supply Chain Management 中的自定义维度。其余 8 个维度（ExtendedDimension1 到 ExtendedDimension8）是可映射到外部数据源的扩展维度。
如果不将 Supply Chain Management 用作一个数据源，则可以自由映射维度。下表显示可用维度的完整列表。

注意

如果您使用 Supply Chain Management，当更改 Supply Chain Management 和库存可见性之间的默认维度映射时，更改的维度不会同步数据。因此，如果您的维度不在默认维度列表中，并且您正在使用外部数据源，我们建议您使用 ExtendedDimension1 到 ExtendedDimension8 执行映射。

维度类型	基础维度
产品	ColorId
产品	SizeId
产品	StyleId
产品	ConfigId
跟踪	BatchId
跟踪	SerialId
库位	LocationId
库位	SiteId
库存状态	StatusId
仓库特定	WMSLocationId
仓库特定	WMSPalletId
仓库特定	LicensePlateId
其他	VersionId
库存（自定义）	InventDimension1 到 InventDimension12
扩展名	ExtendedDimension1 到 ExtendedDimension8
系统	Empty

注意

上表中列出的维度类型仅供您参考。不必在库存可见性中定义它们。

可以为 Supply Chain Management 预留库存（自定义）维度。在此情况下，改用扩展维度。

外部系统可以通过其 RESTful API 访问库存可见性。对于集成，库存可见性允许您配置外部数据源，以及从外部维度映射到基础维度。下面是维度映射表的示例。

外部维度	基础维度
MyColorId	ColorId
MySizeId	SizeId
MyStyleId	StyleId
MyDimension1	ExtendedDimension1
MyDimension2	ExtendedDimension2

可通过配置维度映射将外部维度直接发送到库存可见性。然后，库存可见性将自动把外部维度转换为基础维度。

在 UI 版本 2 中添加维度映射

当您使用库存可见性 UI 版本 2 时，本部分适用。

若要在 UI 版本 2 中添加维度映射，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格上，选择功能管理。
在数据源设置磁贴上，选择管理。
在数据源设置页面上，选择要设置维度映射的数据源。
在维度映射部分中，在工具栏上选择新建维度映射。
在新建维度映射页面上，设置以下字段：
- 客户维度 - 输入源维度的名称。
- 基础维度 - 选择库存可见性中要映射到的维度。
例如，您已经创建了一个名为 ecommerce 的数据源，它包含一个产品颜色维度。在此情况下，若要执行映射，请首先将 ProductColor 添加到 ecommerce 数据源的维度名称字段。然后，在目标基础维度字段中选择 ColorId。
在工具栏上，选择保存。

在 UI 版本 1 中添加维度映射

若要在 UI 版本 1 中添加维度映射，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格底部的更改区域菜单上，选择旧版 UI。
在导航窗格上，选择配置。
在数据源选项卡上，展开要设置维度映射的数据源。
在维度映射部分中，选择添加以添加维度映射行。然后，针对新行设置以下字段：
- 维度名称 - 输入源维度的名称。
- 目标基础维度 - 选择库存可见性中要映射到的维度。
针对新行选择保存链接。

实际度量

当数据源将库存更改发布到库存可见性时，它将使用实际度量发布该更改。实际度量用于修改数量和反映库存状态。可以根据要求定义自己的实际度量。查询可以基于实际度量。

库存可见性提供映射到 Supply Chain Management（fno 数据源）的默认实际度量的列表。这些默认实际度量取自 Supply Chain Management 的现有量列表页面（库存管理>查询和报表>现有量列表）上的库存交易记录状态。下表提供实际度量的示例。

实际度量名称	描述
NotSpecified	未指定
Arrived	已到达
AvailOrdered	已订购可用
AvailPhysical	实际可用
Deducted	已扣除
OnOrder	OnOrder
Ordered	订购时间
PhysicalInvent	实际库存
已领料	已领料
PostedQty	已过帐的数量
QuotationIssue	报价发出量
QuotationReceipt	报价收据
已收到	已接收
Registered	已登记
ReservOrdered	订单预留
ReservPhysical	实际预留
OrderedSum	订购总量

如果您的数据源为 Supply Chain Management，则不必重新创建默认实际度量。但是，对于外部数据源，您可以根据需要创建新的实际度量。

在 UI 版本 2 中添加实际度量

当您使用库存可见性 UI 版本 2 时，本部分适用。

若要在 UI 版本 2 中添加实际度量，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格上，选择功能管理。
在数据源设置磁贴上，选择管理。
在数据源设置页面上，选择要进行维度映射的数据源。然后，在实际度量部分中，在工具栏上选择新建实际度量。
在新建实际度量页面上，为新的实际度量设置以下字段：
- 显示名称 - 输入一个名称，该名称不仅在新度量自己的数据源中是唯一的，而且在所有数据源中也是唯一的。建议格式为 <数据源>.<实际度量名称>（例如 ecommerce.returned）。此格式可确保显示名称在所有数据源中都是独特且唯一的。
- 实际度量名称 - 输入实际度量的名称。
在工具栏上，选择保存。

在 UI 版本 1 中添加实际度量

当您使用库存可见性 UI 版本 1 时，本部分适用。

若要在 UI 版本 1 中添加实际度量，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格底部的更改区域菜单上，选择旧版 UI。
在导航窗格上，选择配置。
在数据源选项卡上，展开要设置实际度量的数据源。
在实际度量部分中，选择添加以添加实际度量行。然后，在新行的度量名称字段中，输入度量的名称。例如，如果您想要在库存可见性的此数据源中记录退货数量，请输入 Returned。
针对新行选择保存链接。

扩展的维度

如果您要使用外部数据源，您可以通过为 InventOnHandChangeEventDimensionSet 和 InventInventoryDataServiceBatchJobTask 类创建类扩展来利用解决方案提供的可扩展性。

请务必在创建扩展后与数据库同步，以便将自定义字段添加到 InventSum 表中。然后，您可以参考本文前面的“维度”部分，以将您的自定义维度映射到库存系统内 BaseDimensions 中八个扩展维度中的任意一个。

注释

有关创建扩展的更多详细信息，请参阅可扩展性主页。

计算度量

可以使用库存可见性对库存实际度量和自定义计算度量进行查询。计算度量提供由实际度量组合构成的自定义计算公式。该功能允许您定义一组将添加的实际度量，和/或一组将减去的实际度量，以便形成自定义度量。

重要

计算的度量是实际度量的构成部分。其公式只能包含不重复的实际度量，而不能包含计算的度量。

通过此配置，您可以定义一组计算度量公式，其中包括加法或减法的修饰符，来获取聚合输出数量总值。

在 UI 版本 2 中添加计算度量

当您使用库存可见性 UI 版本 2 时，本部分适用。

若要在 UI 版本 2 中添加计算度量，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格上，选择功能管理。
在数据源设置磁贴上，选择管理。
在数据源设置页面上，选择要进行维度映射的数据源。然后，在计算度量部分中，在工具栏上选择新建计算度量。
在新建计算度量页面上，为新的计算度量设置以下字段：
- 计算度量显示名称 - 输入一个名称，该名称不仅在新度量自己的数据源中是唯一的，而且在所有数据源中也是唯一的。建议格式为 <数据源>.<计算度量名称>（例如 iv.TotalAvailable）。此格式可确保显示名称在所有数据源中都是独特且唯一的。
- 计算度量名称 - 输入计算度量的名称。
在工具栏上，选择保存并关闭。页面将刷新，现在包含计算度量详细信息部分。
在计算度量详细信息部分中，在工具栏上选择新计算度量详细信息 V2 以为计算度量添加修饰符行。
在新计算度量详细信息页面上，为新修饰符设置以下字段：
- 计算度量公式描述 - 收入计算度量中公式的重要性和用途的详细说明。
- +/- 至结果 - 选择修饰符类型（加或减）。
- 实际度量名称引用 - 选择为修饰符提供值的度量（从所选数据源）的名称。
在工具栏上，选择保存并关闭。
重复步骤 7 到 9，直到您已添加完成计算度量的公式所需的所有修饰符。
在工具栏上，选择保存。

在 UI 版本 1 中添加计算度量

当您使用库存可见性 UI 版本 1 时，本部分适用。

若要在 UI 版本 1 中添加计算度量，请按照以下步骤操作。

登录到您的 Power Apps 环境，然后打开库存可见性应用。
在导航窗格底部的更改区域菜单上，选择旧版 UI。
在导航窗格上，选择配置。
在计算度量选项卡上，选择新建计算度量以添加计算度量。
为新的计算度量值设置以下字段：
- 新建计算度量值名称 – 输入计算度量值的名称。
- 数据源 – 选择要包含新的计算度量的数据源。查询系统是数据源。
新的计算度量中会自动包含一个新的空白修饰符行。为它设置以下字段：
- 修饰符 – 选择修饰符类型（加或减）。
- 数据源 - 选择在其中找到提供修饰符值的度量的数据源。
- 度量值 – 选择为修饰符提供值的度量值（从所选数据源）的名称。
选择保存度量以保存您到目前为止的设置。
如果必须添加另一个修饰符行，请选择添加以添加一行，然后像对第一行所做的那样设置字段。完成后，针对该行选择保存链接。
重复上一步，直到您已添加所有必需的修饰符并已完成计算度量的公式。
选择保存。

在库存可见性中使用计算度量

例如，一家时装公司跨三个数据源运营：

pos – 对应商店渠道。
fno – 对应 Supply Chain Management。
ecommerce – 对应您的 Web 渠道。

如果没有计算度量，当您在站点 1、仓库 11 和 Red 的 ColorID 维度值下查询产品 D0002（机柜）时，可能会得到以下查询结果，其中显示每个预配置的实际度量下的库存数量。但是，您无法了解数据源中可用于预留的总数。

[
    {
        "productId": "D0002",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red"
        },
        "quantities": {
            "pos": {
                "inbound": 80.0,
                "outbound": 20.0
            },
            "fno": {
                "availphysical": 100.0,
                "orderedintotal": 50.0,
                "orderedreserved": 10.0
            },
            "ecommerce": {
                "received": 90.0,
                "scheduled": 30.0,
                "issued": 60.0,
                "reserved": 40.0
            }
        }
    }
]

然后，配置一个名为 MyCustomAvailableforReservation 的计算度量，如下表中所示。消耗系统将使用此计算度量。

消耗系统	计算度量	数据源	实际度量	计算类型
`CrossChannel`	`MyCustomAvailableforReservation`	`fno`	`availphysical`	`Addition`
`CrossChannel`	`MyCustomAvailableforReservation`	`fno`	`orderedintotal`	`Addition`
`CrossChannel`	`MyCustomAvailableforReservation`	`fno`	`orderedreserved`	`Subtraction`
`CrossChannel`	`MyCustomAvailableforReservation`	`pos`	`inbound`	`Addition`
`CrossChannel`	`MyCustomAvailableforReservation`	`pos`	`outbound`	`Subtraction`
`CrossChannel`	`MyCustomAvailableforReservation`	`ecommerce`	`received`	`Addition`
`CrossChannel`	`MyCustomAvailableforReservation`	`ecommerce`	`scheduled`	`Addition`
`CrossChannel`	`MyCustomAvailableforReservation`	`ecommerce`	`issued`	`Subtraction`
`CrossChannel`	`MyCustomAvailableforReservation`	`ecommerce`	`reserved`	`Subtraction`

使用此计算公式时，新查询结果中将包括自定义度量。

[
    {
        "productId": "D0002",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red"
        },
        "quantities": {
            "pos": {
                "inbound": 80.0,
                "outbound": 20.0
            },
            "fno": {
                "availphysical": 100.0,
                "orderedintotal": 50.0,
                "orderedreserved": 10.0
            },
            "ecommerce": {
                "received": 90.0,
                "scheduled": 30.0,
                "issued": 60.0,
                "reserved": 40.0
            },
            "CrossChannel": {
                "MyCustomAvailableforReservation": 220.0
            }
        }
    }
]

MyCustomAvailableforReservation 输出基于自定义度量中的计算设置，为 100 + 50 – 10 + 80 – 20 + 90 + 30 – 60 – 40 = 220。

默认数据源配置

本部分提供有关安装库存可见性时设置的默认数据源配置的详细信息。可以根据需要修改此配置。

重要提示

默认配置已通过各种版本迭代不断发展。您的沙盒环境最初可能是使用过时的默认配置设置的，而您的生产环境是使用最新版本的默认配置初始化的。如果您基于过时的默认配置自定义了第三方系统，当您的生产环境上线时，它可能会遇到问题，尤其是在您尚未检查和调整配置的情况下。为了防止出现这种情况，我们建议在转换生产环境之前彻底检查和更新您的草稿和运行时配置。

数据源配置

iv 数据源的配置

本部分介绍如何配置 iv 数据源。

为“iv”数据源配置的实际度量

为 iv 数据源配置以下实际度量：

Ordered
Softreserved

AvailableToReserve 计算度量

为 iv 数据源配置 AvailableToReserve 计算度量，如下表中所示。

计算类型	数据源	物理度量
附加内容	fno	PhysicalInvent
附加内容	fno	Ordered
附加内容	fno	Arrived
附加内容	pos	传入
附加内容	iv	Ordered
减	fno	ReservPhysical
减	iv	Softreserved
减	pos	传出
减	fno	Softreserved

TotalAvailable 计算度量

为 iv 数据源配置 TotalAvailable 计算度量，如下表中所示。

计算类型	数据源	物理度量
附加内容	fno	AvailOrdered
减	iv	Softreserved
减	@iv	@allocated

TotalOnHand 计算度量

为 iv 数据源配置 TotalOnHand 计算度量，如下表中所示。

计算类型	数据源	物理度量
附加内容	fno	PhysicalInvent

“fno”数据源的配置

本部分介绍如何配置 fno 数据源。

“fno”数据源的维度映射

为 fno 数据源配置下表中列出的维度映射。

外部维度	基础维度
InventBatchId	BatchId
InventColorId	ColorId
InventLocationId	LocationId
InventSerialId	SerialId
InventSiteId	SiteId
InventSizeId	SizeId
InventStatusId	StatusId
InventStyleId	StyleId
LicensePlateId	LicensePlateId
WMSLocationId	WMSLocationId
WMSPalletId	WMSPalletId
ConfigId	ConfigId
InventVersionId	VersionId
InventDimension1	CustomDimension1
InventDimension2	CustomDimension2
InventDimension3	CustomDimension3
InventDimension4	CustomDimension4
InventDimension5	CustomDimension5
InventDimension6	CustomDimension6
InventDimension7	CustomDimension7
InventDimension8	CustomDimension8
InventDimension9	CustomDimension9
InventDimension10	CustomDimension10
InventDimension11	CustomDimension11
InventDimension12	CustomDimension12

为“fno”数据源配置的实际度量

为 fno 数据源配置以下实际度量：

Arrived
PhysicalInvent
ReservPhysical
onorder
notspecified
availordered
availphysical
picked
postedqty
quotationreceipt
received
ordered
ReservOrdered
OrderedSum
SoftReserved

“pos”数据源的配置

本部分介绍如何配置数据源 pos。

“pos”数据源的实际度量

为 pos 数据源配置以下实际度量：

传入
传出

AvailQuantity 计算度量

为 pos 数据源配置 AvailQuantity 计算度量，如下表中所示。

计算类型	数据源	物理度量
附加内容	fno	AvailPhysical
附加内容	pos	传入
减	pos	传出

“iom”数据源的配置

为 iom (Intelligent Order Management) 数据源配置以下实际度量：

OnOrder
OnHand

“erp”数据源的配置

为 erp（企业资源规划）数据源配置以下实际度量：

Unrestricted
QualityInspection

通过

配置库存可见性数据源

先决条件

库存可见性 UI 版本 1 和 UI 版本 2 之间的差异

添加数据源（数据源名称）

在 UI 版本 2 中添加数据源

在 UI 版本 1 中添加数据源

维度（维度映射）

在 UI 版本 2 中添加维度映射

在 UI 版本 1 中添加维度映射

实际度量

在 UI 版本 2 中添加实际度量

在 UI 版本 1 中添加实际度量

扩展的维度

计算度量

在 UI 版本 2 中添加计算度量

在 UI 版本 1 中添加计算度量

在库存可见性中使用计算度量

默认数据源配置

数据源配置

iv 数据源的配置

为“iv”数据源配置的实际度量

AvailableToReserve 计算度量

TotalAvailable 计算度量

TotalOnHand 计算度量

“fno”数据源的配置

“fno”数据源的维度映射

为“fno”数据源配置的实际度量

“pos”数据源的配置

“pos”数据源的实际度量

AvailQuantity 计算度量

“iom”数据源的配置

“erp”数据源的配置

反馈

反馈

其他资源