Novell Doc: Referência do ZENworks 10 Asset Management - Trabalhando com arquivos de importação

9.9 Trabalhando com arquivos de importação

O ZENworks Asset Management pode importar registros de compra de um arquivo de importação padrão do Gerenciamento de Bens ou de qualquer um dos arquivos de importação dos seguintes revendedores:

Relatório de conformidade de software da CompuCom*
Relatório de histórico de produto da Softchoice
Relatório do conector do revendedor do ZENworks Asset Management
Relatório de conformidade de licença da SHI
KMD Asset Report: Importação automática de SAP com dados relevantes de gerenciamento de bens

As informações a seguir são fornecidas caso você precise modificar o arquivo de importação de um revendedor ou se quiser criar um arquivo de importação padrão do Gerenciamento de Bens:

9.9.1 Formato

Os arquivos de importação são arquivos de texto ASCII delimitados por tabulação. A primeira linha inclui os cabeçalhos de coluna. Cada linha adicional é uma linha de dados que identifica o item de linha de um produto específico (ou detalhe) em um registro de compra. O exemplo a seguir inclui algumas das primeiras linhas de um arquivo; apenas os seis primeiros cabeçalhos de coluna são exibidos.

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

A ordem das colunas não é importante. Por exemplo, é possível inverter as colunas PO# e OrderDate ou remover qualquer coluna que tenha informações indesejadas.

9.9.2 Campos

A tabela mostrada a seguir lista os campos usados no arquivo de importação de cada revendedor.

A primeira coluna da tabela abrange os arquivos de importação padrão, Insight, CompuCom, SHI e KMD, pois eles usam os mesmos nomes de campo. A única exceção é que a KMD usa PO_NUMBER em vez de PO#. A segunda coluna da tabela abrange o arquivo de importação da Softchoice.

Os campos de 1 a 13 identificam o registro de compra. Os campos de 14 a 30 identificam o item de linha do produto (ou detalhe) incluído no registro de compra. Para que os dois produtos sejam incluídos no mesmo registro de compra, as informações dos campos de 1 a 13 devem ser correspondentes.

Ao trabalhar com um arquivo de importação, as seguintes regras são aplicáveis:

Use apenas os campos destinados ao arquivo de importação em questão. Por exemplo, ao editar o arquivo de importação da Softchoice, inclua apenas os campos listados na coluna Campos da Softchoice. Qualquer campo inválido provocará falha na importação.
Os seguintes campos são obrigatórios: (PO# | PO_NUMBER | PURCHASEORDER), (OrderDate | ORDERDATE), (ProductName | ITEMDESC) e (PurchaseQty | QTYORD). A remoção desses campos provoca falha na importação.
O campo LicensesPerPackage também é obrigatório; no entanto, se estiver ausente, o importador atribuirá o valor padrão de 1.
Todos os campos não obrigatórios podem ser removidos, se desejado. Ao fazer isso, remova o cabeçalho de coluna do campo e o texto do campo de cada linha subseqüente.

Tabela 9-1 Campos de Arquivo de Importação

Campos Padrão, KMD, Insight, CompuCom e SHI		Campos da Softchoice	Descrição
1	PO# (padrão, Insight, CompuCom, SHI) PO_NUMBER (KMD)	PURCHASEORDER	O número do pedido de compra. Esse campo ou o campo OrderDate deve ser incluído no registro. Se nenhum dos campos tiver dados, o registro não será importado. O objeto Registro de compra do ZENworks (criado durante a importação) usa o número de PO como o seu nome. Se você não especificar um número de PO, o nome do objeto Registro de compra será padronizado como Desconhecido (MM_DD_AA), em que MM_DD_AA é a data atual no formato apropriado ao idioma. O comprimento máximo do campo é de 32 caracteres.
2	OrderDate	ORDERDATE	A data em que foi feito o pedido. Esse campo ou o campo PO# deve ser incluído no registro. Se nenhum dos campos tiver dados, o registro não será importado. Se você especificar um número de PO, mas não uma data, o campo OrderDate assumirá a data da importação como padrão. Para um arquivo de importação padrão, Insight, CompuCom, ou SHI, o campo OrderDate requer o formato de data abreviado determinado pelo idioma do servidor do ZENworks Control Center. Por exemplo, se o idioma do servidor for Inglês (EUA), o formato de data correto será m/d/aaaa (12/16/2009 ou 5/3/2010). Para um arquivo de importação KMD, o campo OrderDate requer o formato d/M/aa (por exemplo, 28/1/09). Para um arquivo de importação Softchoice, o campo ORDERDATE requer o formato dd-MMM-aaaa (por exemplo, 18-JUL-2010).
3	Revendedor		O revendedor que vendeu os produtos deste pedido. O comprimento máximo do campo é de 64 caracteres.
4	Recipient	SHIPCONTACTNAME	O indivíduo para o qual os produtos deste pedido foram enviados. O comprimento máximo do campo é de 32 caracteres.
5	CompanyName	COMPANYNAME	O nome da empresa ou entidade que executou o pedido. O comprimento máximo do campo é de 32 caracteres.
6	ShippingAddress1	SHIPADDR	A primeira linha do endereço de entrega. O comprimento máximo do campo é de 64 caracteres.
7	ShippingAddress2	SHIPCITYSTZIP	A segunda linha do endereço de entrega. O comprimento máximo do campo é de 64 caracteres.
8	Endereço de Entrega(3)		A terceira linha do endereço de entrega. O comprimento máximo do campo é de 64 caracteres.
9	Cidade		A cidade na qual o pedido foi entregue. O comprimento máximo do campo é de 32 caracteres.
10	Estado		O estado no qual o pedido foi entregue. O comprimento máximo do campo é de 32 caracteres.
11	CEP		O CEP ou código postal do destino da entrega. O comprimento máximo do campo é de 16 caracteres.
12	País		O país no qual o pedido foi entregue. O comprimento máximo do campo é de 32 caracteres.
13	Notas		Um campo de texto para notas gerais sobre o registro de compra. O comprimento máximo do campo é de 255 caracteres.
14	Manufacturer	PUBLISHER	O fabricante do produto adquirido. Os campos Fabricante, Nome do Produto, Versão, Tipo de Produto e Licenças por Pacote são usados para determinar a existência de um produto exclusivo. O comprimento máximo do campo é de 64 caracteres.
15	ProductName	ITEMDESC	O nome ou a descrição do produto adquirido. Esse campo é necessário. Os campos Fabricante, Nome do Produto, Versão, Tipo de Produto e Licenças por Pacote são usados para determinar a existência de um produto exclusivo. O comprimento máximo do campo é de 255 caracteres.
16	Versão		A versão do produto adquirido. Os campos Fabricante, Nome do Produto, Versão, Tipo de Produto e Licenças por Pacote são usados para determinar a existência de um produto exclusivo. O comprimento máximo do campo é de 32 caracteres.
17	Tipo de Produto		O tipo de produto adquirido. Esse campo ajuda a estabelecer o que o produto representa, como licença completa, upgrade ou mídia. Os campos Fabricante, Nome do Produto, Versão, Tipo de Produto e Licenças por Pacote são usados para determinar a existência de um produto exclusivo. O comprimento máximo do campo é de 32 caracteres.
18	Licenças por Pacote		O número de licenças incluídas em cada unidade do produto adquirido. Por exemplo, se o produto for um pacote 5, esse valor será 5. O padrão é 1. Valores de faixa (por exemplo, 1-25) não são suportados e fazem com que o item de linha seja ignorado durante a importação. Os campos Fabricante, Nome do Produto, Versão, Tipo de Produto e Licenças por Pacote são usados para determinar a existência de um produto exclusivo.
19	ResellerSKU	SKU	O número de SKU atribuído pelo revendedor. Esse valor pode ser importante durante a comunicação com um determinado revendedor. O comprimento máximo do campo é de 32 caracteres.
20	MfrPart#	MFGSKU	O número de peça designado pelo fabricante. Se disponível, esse valor pode ser usado freqüentemente para distinguir um produto de outro. O comprimento máximo do campo é de 32 caracteres.
21	PurchaseQty	QTYORD	O número de unidades do produto adquiridas no pedido. Deve ser um valor único. Valores de faixa (por exemplo, 1-25) não são suportados e fazem com que o registro seja ignorado durante a importação. O valor deve ser entre -1000000 e 1000000.
22	Serial#		O número de série do software associado ao produto pedido O comprimento máximo do campo é de 40 caracteres.
23	Site¹		Os campos Site, Departamento e Centro de Custo são usados para controlar os dados demográficos. Você pode associar um item de linha a um valor em uma ou todas as colunas de forma que as quantidades de licença possam ser resumidas em um único dado demográfico. Para esses valores terem significado, os dados demográficos correspondentes devem ser associados a dispositivos no inventário do ZENworks Asset Management. O comprimento máximo do campo é de 32 caracteres.
24	Department¹
25	CostCenter¹
26	Comment	COMMENTS	Um campo de texto para comentários gerais sobre o produto comprado. O comprimento máximo do campo é de 128 caracteres.
27	Invoice#	INVOICE	O número da fatura do produto adquirido. Várias faturas podem ser associadas ao mesmo número de pedido de compra.
28	MSRP da Unidade		O Preço Unitário Sugerido é o preço sugerido do fabricante para uma unidade do produto. O Preço Unitário é o preço real pago por uma unidade do produto. O Preço Estendido é o custo de todas as unidades do produto adquiridas. Se não houver valor algum no campo Preço Estendido, um valor será calculado com base nos valores dos campos Quantidade da Compra e Preço Unitário. Se existir um valor, ele será importado e não haverá verificação quanto a sua correspondência em relação ao valor calculado. Se símbolos de moeda e separadores de milhar aparecerem nos campos, eles serão desfeitos quando os dados forem importados. O importador usa o idioma do servidor para determinar os caracteres que são usados como separadores de decimais monetários e de milhar. Se os valores tiverem uma combinação de moedas, os valores de custo importados poderão ficar incorretos. Valores de faixa (por exemplo, 25,00-39,99) não são suportados e fazem com que o registro seja ignorado durante a importação.
29	Preço Unitário
30	Preço Estendido

¹Os valores de Cost Center, Department e Site são significativos para os produtos licenciados com alocações demográficas habilitadas. A quantidade alocada é atualizada (junto com a quantidade de licenças) para os produtos licenciados que tiverem o tipo de alocação demográfica correspondente (site, departamento ou centro de custo) e que tiverem habilitado a opção Atualizar alocações de licença com dados demográficos das importações de registro de compras futuros.