9.9 使用导入文件

ZENworks Asset Management 可以从标准的资产管理导入文件或下列任意代销商导入文件中导入购买记录:

以下信息用于您需要修改代销商导入文件或需要创建标准资产管理导入文件的情况:

9.9.1 格式

导入文件是采用制表符分隔的 ASCII 文本文件。第一行是列标题。其他每一行都是数据行,显示购买记录中特定产品的行项目(或细节)。以下示例包含了一个文件的前几行;仅显示了前六个列标题。

PO#    OrderDate    Reseller    Recipient    CompanyName    ShippingAddress1
1234   12/16/2009   CheapSoft   Jen Adams    Novell         1800 S. Novell Pl.
87654  12/18/2009   Soft-R-Us   Nigel Ray    Novell         404 Wyman Street

列的顺序并不重要。例如,您可以交换 PO# 和 OrderDate 列的顺序,也可以去除包含无用信息的列。

9.9.2 字段

下表列出了各种代销商导入文件使用的字段。

该表的第一列涵盖了标准导入文件、Insight、CompuCom、SHI 和 KMD 导入文件,因为这些文件都使用相同的字段名称。其中一个例外是,KMD 使用 PO_NUMBER 而不是 PO#。该表的第二列涵盖 Softchoice 导入文件。

第 1-13 个字段用于标识购买记录。第 14-30 个字段用于标识包含在购买记录中的产品行项目(或细节)。如果要将两个产品包含在同一条购买记录中,则第 1-13 个字段中的信息必须相匹配。

使用导入文件时,请遵守以下规则:

  • 仅使用既定用于该导入文件的相应字段。例如,编辑 Softchoice 导入文件时,请仅包含“Softchoice 字段”列中列出的字段。任何无效的字段都会导致导入失败。

  • 以下字段为必需的字段:(PO# | PO_NUMBER | PURCHASEORDER)、(OrderDate | ORDERDATE)、(ProductName | ITEMDESC) 和 (PurchaseQty | QTYORD)。去除这些字段会导致导入失败。

  • LicensesPerPackage 字段也是必需的字段;不过,如果缺少该字段,导入程序会指派一个默认值 1。

  • 如果需要,可将所有非必需的字段去除。如果要去除,请将字段列标题以及所对应的每行的字段文本都去除。

表 9-1 导入文件字段

标准、KMD、Insight、CompuCom 和 SHI 字段

Softchoice 字段

说明

1

PO#(标准、Insight、CompuCom、SHI)

PO_NUMBER (KMD)

PURCHASEORDER

采购订单编号。

记录中必须包含此字段或 OrderDate 字段。如果这两个字段中都没有数据,则不会导入该记录。

导入期间创建的 ZENworks 购买记录对象会使用采购订单编号作为其名称。如果您没有提供采购订单编号,购买记录对象的名称会默认为未知 (MM_DD_YY),其中 MM_DD_YY 为采用相应区域设置格式的当前日期。

最大字段长度为 32 个字符。

2

OrderDate

ORDERDATE

产品的定购日期。

记录中必须包含此字段或 PO# 字段。如果这两个字段中都没有数据,则不会导入该记录。

如果提供的是采购订单编号而不是日期,OrderDate 字段默认会使用导入日期。

对于标准、Insight、CompuCom 或 SHI 导入文件,OrderDate 字段要求使用 ZENworks 控制中心服务器区域设置决定的短日期格式。例如,如果服务器区域设置为美国英语格式,则正确的日期格式为 m/d/yyyy(12/16/2009 或 5/3/2010)。

对于 KMD 导入格式,OrderDate 字段要求使用 d/M/yy 格式(例如,28/1/09)。

对于 Softchoice 导入格式,ORDERDATE 字段要求使用 dd-MMM-yyyy 格式(例如,18-JUL-2010)。

3

Reseller

 

销售此订单中的产品的代销商。

最大字段长度为 64 个字符。

4

Recipient

SHIPCONTACTNAME

向其发送此订单中的产品的个人。

最大字段长度为 32 个字符。

5

CompanyName

COMPANYNAME

执行订单的公司或实体的名称。

最大字段长度为 32 个字符。

6

ShippingAddress1

SHIPADDR

发运地址的第一行。

最大字段长度为 64 个字符。

7

ShippingAddress2

SHIPCITYSTZIP

发运地址的第二行。

最大字段长度为 64 个字符。

8

ShippingAddress3

 

发运地址的第三行。

最大字段长度为 64 个字符。

9

City

 

订单的发货城市。

最大字段长度为 32 个字符。

10

State

 

订单的发货省份/州。

最大字段长度为 32 个字符。

11

Zip

 

发运目的地的邮政编码。

最大字段长度为 16 个字符。

12

Country

 

订单的发货国家/地区。

最大字段长度为 32 个字符。

13

Notes

 

有关购买记录的一般注释文本字段。

最大字段长度为 255 个字符。

14

Manufacturer

PUBLISHER

所购产品的制造商。

Manufacturer、ProductName、Version、ProductType 和 LicensesPerPackage 字段用于确定产品的唯一性。

最大字段长度为 64 个字符。

15

ProductName

ITEMDESC

所购产品的名称或说明。此字段为必填字段。

Manufacturer、ProductName、Version、ProductType 和 LicensesPerPackage 字段用于确定产品的唯一性。

最大字段长度为 255 个字符。

16

Version

 

所购产品的版本。

Manufacturer、ProductName、Version、ProductType 和 LicensesPerPackage 字段用于确定产品的唯一性。

最大字段长度为 32 个字符。

17

ProductType

 

所购产品的类型。此字段有助于建立产品代表的内容,例如完全许可证、升级或媒体。

Manufacturer、ProductName、Version、ProductType 和 LicensesPerPackage 字段用于确定产品的唯一性。

最大字段长度为 32 个字符。

18

LicensesPerPackage

 

每份所购产品中包含的许可证数。

例如,如果产品为 5 个许可证的包,则此值为 5。默认值为 1。不支持范围值(例如,1-25),范围值会导致导入期间跳过该行项目。

Manufacturer、ProductName、Version、ProductType 和 LicensesPerPackage 字段用于确定产品的唯一性。

19

ResellerSKU

SKU

代销商指派的 SKU 号。与特定代销商通讯时,此值可能非常重要。

最大字段长度为 32 个字符。

20

MfrPart#

MFGSKU

制造商指派的部件号。如果有,此值常用于区分各产品。

最大字段长度为 32 个字符。

21

PurchaseQty

QTYORD

订单中所购产品的份数。

此值必须为单个值。不支持范围值(例如,1-25),范围值会导致导入期间跳过该记录。

值必须在 -1000000 和 1000000 之间。

22

Serial#

 

与所购产品关联的软件序列号

最大字段长度为 40 个字符。

23

Site1

 

Site、Department 和 CostCenter 字段用于跟踪用户群。您可以将一个行项目与任意或所有这些列中的某个值关联,以便可以加总特定用户群内的许可证数。要让这些值有意义,必须将相应的用户群与 ZENworks Asset Management 库存中的设备关联。

最大字段长度为 32 个字符。

24

Department1

 

25

CostCenter1

 

26

Comment

COMMENTS

有关所购产品的一般注释文本字段。

最大字段长度为 128 个字符。

27

Invoice#

INVOICE

所购产品的发票编号。

多个发票可与同一个采购订单号关联。

28

UnitMSRP

 

UnitMSRP 是单份产品的厂商建议零售价。

UnitPrice 是单份产品的实际应付价格。

ExtendedPrice 是所购产品所有份数的成本。如果 ExtendedPrice 字段中没有值,将根据 PurchaseQty 和 UnitPrice 字段的值来计算该值。如果值存在,将导入该值并且不会检查该值是否与计算得出的值相匹配。

如果字段中显示有货币符号和千位分隔符,导入数据时会去除这些符号。

导入程序使用服务器的区域设置来确定用于表示千位分隔符和十进制分隔符的字符。如果值包含混合货币,则导入的成本值可能会不正确。

不支持范围值(例如,25.00-39.99),范围值会导致导入期间跳过该记录。

29

UnitPrice

 

30

ExtendedPrice

 

1CostCenter、DepartmentSite值对于已启用用户群分配的许可产品来说是有意义的。对于拥有相应用户群分配类型(地点、部门或成本中心),并已启用使用日后导入的购买记录中的用户群数据更新许可证分配的许可产品,会更新其分配数量(以及许可证数量)。