Novell Doc: Référence de ZENworks 10 Asset Management - Utilisation de fichiers d'importation

9.9 Utilisation de fichiers d'importation

ZENworks Asset Management peut importer des enregistrements d'achats à partir d'un fichier d'importation standard Asset Management ou à partir des fichiers d'importation de revendeurs suivants :

Rapport de conformité de CompuCom Software
Rapport historique du produit Softchoice
Rapport ZENworks Asset Management Reseller Connector
Rapport de conformité de licence SHI
Rapport sur la ressource KMD - importation automatique depuis SAP avec des données pertinentes pour la gestion des ressources

Les informations suivantes sont fournies pour le cas où vous devriez modifier un fichier d'importation de revendeur ou si vous vouliez créer un fichier d'importation standard Asset Management :

9.9.1 Format

Les fichiers d'importation sont des fichiers texte ASCII délimités par des tabulations. La première ligne contient les en-têtes de colonne. Chaque ligne supplémentaire est une ligne de données qui identifie une ligne article (ou détail) d'un produit spécifique dans un enregistrement d'achat. L'exemple suivant inclut les quelques premières lignes d'un fichier ; seuls les 6 premiers en-têtes de colonne sont affichés.

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

L'ordre des colonnes n'a pas d'importance. Par exemple, vous pouvez inverser les colonnes du numéro de bon de commande et de la date de commande ou supprimer toutes les colonnes qui contiennent des informations non souhaitées.

9.9.2 Champs

Le tableau ci-dessous répertorie les champs utilisés dans chaque fichier d'importation de revendeur.

La première colonne couvre les fichiers d'importation standard, Insight, CompuCom, SHI et KMD car ils utilisent les mêmes noms de champ. La seule exception est que KMD utilise PO_NUMBER plutôt que PO#. La deuxième colonne concerne le fichier d'importation Softchoice.

Les champs 1 à 13 identifient l'enregistrement d'achat. Les champs 14 à 30 identifient une ligne article (ou détail) de produit comprise dans l'enregistrement d'achat. Pour que deux produits soient inclus dans le même enregistrement d'achat, les informations des champs 1 à 13 doivent correspondre.

Lorsque vous travaillez avec un fichier d'importation, les règles suivantes s'appliquent :

Utilisez uniquement les champs destinés à ce fichier d'importation. Par exemple, lorsque vous modifiez un fichier d'importation Softchoice, incluez uniquement les champs répertoriés dans la colonne Champs Softchoice. Un champ non valide entraîne l'échec de l'importation.
Les champs suivants sont requis : (PO# | PO_NUMBER | PURCHASEORDER), (OrderDate | ORDERDATE), (ProductName | ITEMDESC) et (PurchaseQty | QTYORD). La suppression de ces champs entraîne l'échec de l'importation.
Le champ LicensesPerPackage est également requis. Cependant, s'il est absent, le programme d'importation attribue la valeur par défaut 1.
Vous pouvez supprimer tous les champs non requis si vous le souhaitez. Dans ce cas, supprimez l'en-tête de colonne et le texte du champ dans chaque ligne suivante.

Tableau 9-1 Champs du fichier d'importation

Champs standard, KMD, Insight, CompuCom et SHI		Champs Softchoice	Description
1	PO# (standard, Insight, CompuCom, SHI) PO_NUMBER (KMD)	PURCHASEORDER	Numéro du bon de commande. Ce champ ou le champ OrderDate doit être inclus dans l'enregistrement. Si tous les deux sont vides, l'enregistrement n'est pas importé. L'objet Enregistrement d'achat ZENworks (créé durant l'importation) utilise le numéro de bon de commande comme nom. Si vous ne fournissez pas ce numéro, le nom de l'enregistrement d'achat est défini par défaut sur Inconnu (JJ_MM_AA), où JJ_MM_AA correspond à la date actuelle au format local approprié. La longueur maximale du champ est de 32 caractères.
2	OrderDate	ORDERDATE	Date à laquelle le produit a été commandé. Ce champ ou le champ PO# doit être inclus dans l'enregistrement. Si tous les deux sont vides, l'enregistrement n'est pas importé. Si vous fournissez un numéro de bon de commande mais pas de date, le champ OrderDate est défini par défaut sur la date d'importation. Pour un fichier d'importation standard, Insight, CompuCom ou SHI, le champ OrderDate requiert le format de date court déterminé par les paramètres locaux du serveur du Centre de contrôle ZENworks. Par exemple, si les paramètres locaux du serveur sont définis sur Français (France), le format de date correct est jj/mm/aaaa (16/12/2009 ou 03/05/2010). Pour un fichier d'importation KMD, le champ OrderDate requiert le format j/m/aa (par exemple 28/1/09). Pour un fichier d'importation Softchoice, le champ ORDERDATE requiert le format jj-mmm-aaaa (par exemple 18-JUL-2010).
3	Reseller		Revendeur auprès duquel les produits de cette commande ont été achetés. La longueur maximale du champ est de 64 caractères.
4	Recipient	SHIPCONTACTNAME	Personne à laquelle les produits de cette commande ont été livrés. La longueur maximale du champ est de 32 caractères.
5	CompanyName	COMPANYNAME	Nom de la société ou de l'entité qui a passé la commande. La longueur maximale du champ est de 32 caractères.
6	ShippingAddress1	SHIPADDR	Première ligne de l'adresse de livraison. La longueur maximale du champ est de 64 caractères.
7	ShippingAddress2	SHIPCITYSTZIP	Deuxième ligne de l'adresse de livraison. La longueur maximale du champ est de 64 caractères.
8	ShippingAddress3		Troisième ligne de l'adresse de livraison. La longueur maximale du champ est de 64 caractères.
9	City		Ville dans laquelle la commande a été livrée. La longueur maximale du champ est de 32 caractères.
10	State		État dans lequel la commande a été livrée. La longueur maximale du champ est de 32 caractères.
11	Zip		Code postal de la destination de la livraison. La longueur maximale du champ est de 16 caractères.
12	Country		Pays dans lequel la commande a été livrée. La longueur maximale du champ est de 32 caractères.
13	Notes		Champ texte dans lequel insérer des remarques générales sur l'enregistrement d'achat. La longueur maximale du champ est de 255 caractères.
14	Manufacturer	PUBLISHER	Fabricant du produit acheté. Les champs Manufacturer, ProductName, Version, ProductType et LicensesPerPackage permettent de déterminer l'existence d'un produit unique. La longueur maximale du champ est de 64 caractères.
15	ProductName	ITEMDESC	Nom ou description du produit acheté. Ce champ est obligatoire. Les champs Manufacturer, ProductName, Version, ProductType et LicensesPerPackage permettent de déterminer l'existence d'un produit unique. La longueur maximale du champ est de 255 caractères.
16	Version		Version du produit acheté. Les champs Manufacturer, ProductName, Version, ProductType et LicensesPerPackage permettent de déterminer l'existence d'un produit unique. La longueur maximale du champ est de 32 caractères.
17	ProductType		Type du produit acheté. Ce champ permet d'établir ce que le produit représente, par exemple une licence complète, une mise à niveau ou des supports. Les champs Manufacturer, ProductName, Version, ProductType et LicensesPerPackage permettent de déterminer l'existence d'un produit unique. La longueur maximale du champ est de 32 caractères.
18	LicensesPerPackage		Nombre de licences incluses dans chaque unité de produit achetée. Par exemple, si le produit est un lot de 5, cette valeur est égale à 5. La valeur par défaut est 1. Si vous spécifiez une plage de valeurs (par exemple, 1-25), celle-ci n'étant pas prise en charge, la ligne article est ignorée durant l'importation. Les champs Manufacturer, ProductName, Version, ProductType et LicensesPerPackage permettent de déterminer l'existence d'un produit unique.
19	ResellerSKU	SKU	Numéro SKU assigné par le revendeur. Cette valeur peut être importante lors des communications avec un revendeur spécifique. La longueur maximale du champ est de 32 caractères.
20	MfrPart#	MFGSKU	Code d'article affecté par le fabricant. Si elle est disponible, cette valeur peut permettre de distinguer des produits différents. La longueur maximale du champ est de 32 caractères.
21	PurchaseQty	QTYORD	Nombre d'unités de produit achetées lors de la commande. Il doit s'agir d'une valeur unique. En effet, les plages de valeurs (par exemple, 1-25) n'étant pas prises en charge, l'enregistrement est alors ignoré durant l'importation. Cette valeur doit être comprise entre -1000000 et 1000000.
22	Serial#		Numéro de série du logiciel associé au produit commandé. La longueur maximale du champ est de 40 caractères.
23	Site¹		Les champs Site, Service et Centre de coût permettent d'assurer un suivi démographique. Vous pouvez associer une ligne budgétaire à une valeur dans n'importe laquelle de ces colonnes afin de répertorier la quantité de licences pour une valeur démographique donnée. Pour que ces valeurs soient significatives, les valeurs démographiques correspondantes doivent être associées aux périphériques dans l'inventaire ZENworks Asset Management. La longueur maximale du champ est de 32 caractères.
24	Department¹
25	CostCenter¹
26	Comment	COMMENTS	Champ texte dans lequel insérer des remarques générales sur le produit acheté. La longueur maximale du champ est de 128 caractères.
27	N° defacture	INVOICE	Numéro de facture du produit acheté. Plusieurs factures peuvent être associées à un même numéro de bon de commande
28	UnitMSRP		Prix conseillé par le fabriquant pour une unité du produit. UnitPrice correspond au prix réel payé pour une unité du produit. ExtendedPrice désigne le coût de toutes les unités du produit achetées. Si aucune valeur n'est présente dans le champ ExtendedPrice, une valeur est calculée en fonction des valeurs des champs PurchaseQty et UnitPrice. Si une valeur existe, elle est importée mais n'est pas vérifiée pour savoir si elle correspond à une valeur calculée. Si les symboles de devises et les séparateurs décimaux apparaissent dans les champs, ils disparaissent lors de l'importation des données. L'outil d'importation utilise les paramètres régionaux du serveur afin de déterminer les caractères à utiliser pour les séparateurs décimaux et monétaires. Si vos valeurs sont exprimées en différentes devises, les valeurs de coût importées peuvent être incorrectes. Si vous spécifiez une plage de valeurs (par exemple, 25,00-39,99), celle-ci n'étant pas prise en charge, l'enregistrement est ignoré durant l'importation.
29	UnitPrice
30	ExtendedPrice

¹Les valeurs Centre de coût, Service et Site sont significatives pour les produits sous licence dont les allocations démographiques sont activées. La quantité allouée est mise à jour (ainsi que la quantité de licences) pour les produits sous licence ayant le type d'allocation démographique correspondante (site, service ou centre de coût) et pour lesquels l'option Mettre à jour les allocations de licence avec les données démographiques des importations d'enregistrements d'achats à venir.