Novell Doc: ZENworks 10 Asset Management-Referenz

9.9 Arbeiten mit Importfiltern

ZENworks Asset Management kann Kaufdatensätze aus einer standardmäßigen Asset Management-Importdatei oder aus einer der folgenden Händler-Importdateien importieren:

Compliance-Bericht für CompuCom*-Software
Verlaufsbericht für Softchoice-Produkt
ZENworks Asset Management – Reseller Connector Report
Compliance-Bericht für SHI-Lizenz
KMD-Bestandsbericht: Automatischer Import von SAP mit relevanten Daten für Bestandsverwaltung

Die folgenden Informationen werden bereitgestellt, wenn eine Händler-Importdatei bearbeitet werden muss oder wenn eine standardmäßige Asset Management-Importdatei erstellt werden soll:

9.9.1 Format

Importdateien sind durch Tabulatoren begrenzte ASCII-Textdateien. Die erste Zeile enthält die Spaltenüberschriften. Jede weitere Zeile ist eine Datenzeile, die das Listenelement (oder Details) eines bestimmten Produkts in einem Kaufdatensatz identifiziert. Das folgende Beispiel enthält die ersten Zeilen einer Datei; es werden nur die ersten sechs Spaltenüberschriften angezeigt.

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

Die Reihenfolge der Spalten ist dabei nicht wichtig. Sie können beispielsweise die Spalten Auftragsnummer und Auftragsdatum vertauschen oder Spalten mit unerwünschten Informationen entfernen.

9.9.2 Felder

In der nachfolgenden Tabelle sind die Felder aufgeführt, die in jeder Händler-Importdatei verwendet werden.

Die erste Spalte in der Tabelle erfasst standardmäßige Importdateien sowie Insight-, CompuCom-, SHI- und KMD-Importdateien, da diese dieselben Feldnamen verwenden. Als einzige Ausnahme verwendet KMD PO_NUMBER anstelle von PO#. Die zweite Spalte in der Tabelle erfasst die Softchoice-Importdatei.

Die Felder 1–13 identifizieren den Kaufdatensatz. Die Felder 14–30 identifizieren ein Listenelement (oder Detail) eines Produkts, das im Kaufdatensatz enthalten ist. Wenn zwei Produkte in demselben Kaufdatensatz enthalten sein sollen, müssen die Informationen in den Feldern 1–13 übereinstimmen.

Bei der Arbeit mit Importdateien gelten folgende Regeln:

Verwenden Sie nur die Felder, die für diese Importdatei vorgesehen sind. Wenn Sie beispielsweise eine Softchoice-Importdatei bearbeiten, beziehen Sie nur die Felder ein, die in der Spalte Softchoice-Felder aufgeführt sind. Ungültige Felder verursachen beim Import Fehler.
Die folgenden Felder sind erforderlich: (PO# | PO_NUMBER | PURCHASEORDER), (OrderDate | ORDERDATE), (ProductName | ITEMDESC) und (PurchaseQty | QTYORD). Wenn diese Felder entfernt werden, treten beim Import Fehler auf.
Das Feld LicensesPerPackage ist ebenfalls erforderlich; wenn es jedoch fehlt, weist das Importprogramm einen Standardwert von 1 zu.
Alle nicht erforderlichen Felder können entfernt werden, falls gewünscht. Entfernen Sie in diesem Fall sowohl die Spaltenüberschrift des Felds als auch den Text in jeder folgenden Zeile.

Tabelle 9-1 Importdateifelder von

Standard-, KMD-, Insight-, CompuCom- und SHI-Felder		Softchoice-Felder	Beschreibung
1	PO# (Standard, Insight, CompuCom, SHI) PO_NUMBER (KMD)	PURCHASEORDER	Die Auftragsnummer. Im Datensatz muss entweder dieses Feld oder das Feld OrderDate enthalten sein. Wenn in keinem der Felder Daten enthalten sind, wird der Datensatz nicht importiert. Das (beim Import erstellte) ZENworks-Kaufdatensatzobjekt verwendet die Auftragsnummer als Namen. Wenn Sie keine Auftragsnummer angeben, wird der Name des Kaufdatensatzobjekts standardmäßig als Unbekannt (MM_TT_JJ) angegeben, wobei MM_TT_JJ das aktuelle Datum im Format der jeweiligen Ländereinstellung darstellt. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
2	OrderDate	ORDERDATE	Das Datum der Bestellung des Produkts. Im Datensatz muss entweder dieses Feld oder das Feld PO# enthalten sein. Wenn in keinem der Felder Daten enthalten sind, wird der Datensatz nicht importiert. Wenn Sie zwar eine Auftragsnummer, aber kein Datum angeben, wird im Feld OrderDate standardmäßig das Importdatum angegeben. Bei einer Standard-, Insight-, CompuCom- oder SHI-Importdatei ist für das Feld OrderDate das kurze Datumsformat erforderlich, das durch die Ländereinstellung des Servers im ZENworks-Kontrollzentrum festgelegt ist. Wenn die Ländereinstellung des Servers beispielsweise US-Englisch lautet, ist das korrekte Datumsformat m/t/jjjj (12/16/2009 oder 5/3/2010). Bei einer KMD-Importdatei ist für das Feld OrderDate das Format t/M/jj erforderlich (z.B. 28/1/09). Bei einer Softchoice-Importdatei ist für das Feld ORDERDATE das Format tt-MMM-jjjj erforderlich (z.B. 18-JUL-2010).
3	Reseller		Der Händler, bei dem die Produkte dieses Auftrags bestellt wurden. Die Länge des Feldes ist auf maximal 64 Zeichen begrenzt.
4	Recipient	SHIPCONTACTNAME	Die Person, an die die Produkte dieses Auftrags geliefert wurden. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
5	CompanyName	COMPANYNAME	Der Name des Unternehmens oder der Organisation, von dem bzw. von der der Auftrag ausgeführt wurde. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
6	ShippingAddress1	SHIPADDR	Die erste Zeile der Lieferadresse. Die Länge des Feldes ist auf maximal 64 Zeichen begrenzt.
7	ShippingAddress2	SHIPCITYSTZIP	Die zweite Zeile der Lieferadresse. Die Länge des Feldes ist auf maximal 64 Zeichen begrenzt.
8	ShippingAddress3		Die dritte Zeile der Lieferadresse. Die Länge des Feldes ist auf maximal 64 Zeichen begrenzt.
9	City		Der Ort der Lieferadresse. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
10	State		Das Bundesland der Lieferadresse. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
11	Zip		Die Postleitzahl der Lieferadresse. Die Länge des Feldes ist auf maximal 16 Zeichen begrenzt.
12	Country		Das Land der Lieferadresse. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
13	Notes		Ein Textfeld für allgemeine Hinweise zum Kaufdatensatz. Die Länge des Feldes ist auf maximal 255 Zeichen begrenzt.
14	Manufacturer	PUBLISHER	Der Hersteller des gekauften Produkts. Die Felder Manufacturer, ProductName, Version, ProductType und LicensesPerPackage definieren ein bestimmtes Produkt. Die Länge des Feldes ist auf maximal 64 Zeichen begrenzt.
15	ProductName	ITEMDESC	Der Name oder die Beschreibung des gekauften Produkts. Dieses Feld ist erforderlich. Die Felder Manufacturer, ProductName, Version, ProductType und LicensesPerPackage definieren ein bestimmtes Produkt. Die Länge des Feldes ist auf maximal 255 Zeichen begrenzt.
16	Version		Die Version des gekauften Produkts. Die Felder Manufacturer, ProductName, Version, ProductType und LicensesPerPackage definieren ein bestimmtes Produkt. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
17	ProductType		Der Typ des gekauften Produkts. Mithilfe dieses Felds wird festgelegt, was das Produkt darstellt (Volllizenz, Aktualisierung oder Medium). Die Felder Manufacturer, ProductName, Version, ProductType und LicensesPerPackage definieren ein bestimmtes Produkt. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
18	LicensesPerPackage		Die Anzahl der Lizenzen, die in jeder gekauften Produkteinheit enthalten sind. Bei einem Produkt, das zum Beispiel fünf Lizenzen enthält, lautet dieser Wert 5. Der Standardwert ist 1. Bereichswerte (z.B. 1–25) werden nicht unterstützt und haben zur Folge, dass das Listenelement beim Importieren übersprungen wird. Die Felder Manufacturer, ProductName, Version, ProductType und LicensesPerPackage definieren ein bestimmtes Produkt.
19	ResellerSKU	SKU	Die vom Händler zugewiesene Lagerhaltungseinheit. Diese Nummer ist eventuell für die Kommunikation mit dem Händler wichtig. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
20	MfrPart#	MFGSKU	Die vom Hersteller zugewiesene Artikelnummer. Sofern vorhanden, lassen sich anhand dieser Nummer Produkte eindeutig identifizieren. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
21	PurchaseQty	QTYORD	Die Anzahl der im Auftrag gekauften Produkteinheiten. Dies muss ein Einzelwert sein. Bereichswerte (z.B. 1–25) werden nicht unterstützt und haben zur Folge, dass der Datensatz beim Importieren übersprungen wird. Der Wert muss zwischen -1000000 und 1000000 liegen.
22	Seriell#		Die Software-Seriennummer des bestellten Produkts Die Länge des Feldes ist auf maximal 40 Zeichen begrenzt.
23	Site¹		Die Felder Site, Department und CostCenter werden zur Beobachtung der Demografien verwendet. Sie können einen Posten einem Wert in einer oder allen dieser Spalten zuweisen, um die Lizenzmengen innerhalb der jeweiligen demografischen Statistik zusammenzufassen. Diese Werte sind jedoch nur von Bedeutung, wenn die entsprechenden demografischen Bereiche Geräten im ZENworks Asset Management-Inventar zugeordnet sind. Die Länge des Feldes ist auf maximal 32 Zeichen begrenzt.
24	Department¹
25	CostCenter¹
26	Comment	COMMENTS	Ein Textfeld für allgemeine Kommentare zum bestellten Produkt. Die Länge des Feldes ist auf maximal 128 Zeichen begrenzt.
27	Invoice#	INVOICE	Die Rechnungsnummer des gekauften Produkts. Einer Auftragsnummer können mehrere Rechnungsnummern zugeordnet sein.
28	UnitMSRP		Der empfohlene Abgabepreis des Herstellers pro Einheit (UnitMSRP) ist der empfohlene Preis des Herstellers für eine Produkteinheit. Der Preis pro Einheit (UnitPrice) ist der tatsächliche Preis, der für eine Produkteinheit gezahlt wurde. Der Angebotspreis bezeichnet die Kosten für alle gekauften Produkteinheiten. Wenn das Feld ExtendedPrice (Angebotspreis) keinen Wert enthält, wird der Preis aus den Werten der Felder PurchaseQty (Stückzahl) und UnitPrice (Stückpreis) berechnet. Ist ein Angebotspreis vorhanden, wird dieser wie vorgegeben importiert. Eine Überprüfung, ob der Preis mit dem aus Stückzahl und Stückpreis berechneten Wert übereinstimmt, findet nicht statt. Währungssymbole und Tausendertrennzeichen in diesem Feld werden beim Import der Daten entfernt. Diese Zeichen werden vom Importprogramm aus der Ländereinstellung des Servers abgeleitet. Falls Ihre Werte verschiedene Währungen enthalten, sind die importierten Kostenwerte möglicherweise falsch. Bereichswerte (z.B. 1–25) werden nicht unterstützt und haben zur Folge, dass der Datensatz beim Importieren übersprungen wird.
29	UnitPrice
30	ExtendedPrice

¹Die Werte der Spalten Kostenstelle, Abteilung und Standort sind für lizenzierte Produkte relevant, für die die demografische Zuordnung aktiviert ist. Für lizenzierte Produkte, die den entsprechenden demografischen Zuordnungstyp aufweisen (Standort, Abteilung oder Kostenstelle) und für die die Option Lizenzzuordnungen mit demografischen Daten aus Importen zukünftiger Kaufdatensätze aktualisieren aktiviert ist, wird (parallel zur Lizenzmenge) die zugeordnete Menge aktualisiert.