Zusätzliche Funktionen von Windchill > Windchill PartsLink > Klassifikationsverwaltung > Klassifikationsstruktur > Klassifikationsstruktur aus CSV-Datei importieren
  
Klassifikationsstruktur aus CSV-Datei importieren
Um eine Klassifikationsstruktur zu importieren, muss die Klassifikationsstruktur in einer XML-Datei gegliedert werden. Sie können die XML-Datei vor dem Import ändern, aber wenn die Struktur komplex ist, ist dies nicht leicht zu bewerkstelligen.
Es ist viel einfacher, stattdessen eine CSV-Datei zu verwalten. Wenn Sie bereit sind, die Struktur zu importieren, können Sie die CSV-Datei mit dem Dienstprogramm CSVToXMLGenerator in eine XML-Datei umwandeln, die importiert werden kann.
* 
PTC empfiehlt Ihnen, mit diesem Dienstprogramm die erste Klassifikationsstruktur zu erstellen. Sie sollten dieses Dienstprogramm nicht verwenden, um eine vorhandene Struktur zu aktualisieren. Alle Daten in der vorhandenen Struktur, die nicht in der CSV-Datei repräsentiert sind, werden überschrieben und demzufolge entfernt.
Um eine CSV-Datei in eine XML-Datei umzuwandeln, führen Sie in einer Windchill-Shell den folgenden Befehl aus:
Windchill com.ptc.windchill.csm.csvtoxml.CSVToXMLGenerator <Pfad zur CSV-Datei> -verbose
dabei gilt:
• <Pfad der CSV-Datei> ist der Pfad der CSV-Datei auf dem lokalen Computer.
• Der Parameter verbose ist optional und muss für Debugging-Vorgänge verwendet werden.
Die XML-Datei wird mit dem gleichen Namen und am gleichen Speicherort wie die CSV-Datei generiert.


Vorbereitung
• Um das Dienstprogramm CSVToXMLGenerator verwenden zu können, muss der Windchill Server nicht ausgeführt werden.
• Die importierte CSV-Datei muss in einem eindeutigen Format vorliegen. Dieses Format ist nicht mit dem Format der CSV-Datei identisch, die mit der Aktion Nach CSV exportieren in der Tabelle Klassifikationsstruktur generiert wird.
• Bevor die resultierende XML-Datei geladen wird, sollte das Folgende bereits in Windchill enthalten sein. (Dies ist nicht der Fall, wenn eine exportierte ZIP- oder JAR-Datei importiert wird.)
◦ Globale Aufzählungen
◦ Wiederverwendbare Attribute
◦ Maßgrößen
• Um die generierte XML-Datei zu importieren, komprimieren Sie sie in einer ZIP-Datei. Wählen Sie in der Klassifikationsstruktur das Menüelement Aktionen > Importieren aus.


Importfehler und unterstützte Werte
Wenn Sie die Datei nach Windchill importieren, findet eine Validierung der Daten statt. Wenn die XML-Datei ungültige Daten oder Werte enthält, tritt während des Importvorgangs ein Fehler auf.
Auch wenn es einfacher ist, mit einer CSV-Datei zu arbeiten, besitzt das Format, das vom Dienstprogramm CSVToXMLGenerator akzeptiert wird, einige Einschränkungen. Sie können z.B. keine Schaltbilder oder Bilder importieren. Sie können auch keine Regeln für die automatische Benennung angeben.
Wenn ein Attribut oder eine Beschränkung nicht in den nachstehenden Tabellen aufgeführt wird, wird das jeweilige Element nicht unterstützt und führt während des Imports zu einem Fehler.


CSV-Formatierungsregeln
• Einzelwerte, die ein Komma enthalten, müssen in doppelte Anführungszeichen gesetzt werden. Beispiel:
Hongkong, Berlin, "New York, NY", London
• Verwenden Sie als Escape-Zeichen für das doppelte Anführungszeichen ein doppeltes Anführungszeichen. Beispiel:
Teile im Katalog ""Laufwerkssystem""


Von Knoten und Attributen gemeinsam benutzte Spalten
Es gibt 7 Spalten, die entweder Knoten- oder Attributinformationen enthalten. Diese Spalten verwenden das folgende Format:
Knoten/Attribut
Die Angabe vor dem Schrägstrich bezieht sich auf Klassifikationsknoten, die Angabe nach dem Schrägstrich bezieht sich auf Klassifikationsattribute.
Spaltenname
Knotenwert
Attributwert
Knoten/Attribut
Diese Spalte zeigt an, ob die Zeile einen Klassifikationsknoten oder ein Klassifikationsattribut enthält.
Geben Sie einen der folgenden Werte ein:
• Knoten
• Attribut
ParentIntName/NodeIntName
Interner Name des Eltern-Knotens.
* 
Verwenden Sie NULL zur Kennzeichnung des Stammknotens.
Interner Name des Knotens, für den das Attribut definiert ist.
NodeIntName/AttributeIntName
Interner Name des Knotens.
Interner Name des Attributs.
DisplayName/DisplayName
Anzeigename des Knotens.
Anzeigename des Attributs.
Description/IBAName
Eingabewert im Feld Beschreibung für den Knoten.
Name des wiederverwendbaren Attributs.
Keywords/DataType
Eingabewert im Feld Suchbegriffe für den Knoten.
Der Datentyp des Attributs.
Die folgenden Werte sind zulässig:
wt.units.FloatingPointWithUnits
java.lang.Boolean
java.sql.Timestamp
java.lang.Long
java.lang.String
com.ptc.core.meta.common.Hyperlink
com.ptc.core.meta.common.FloatingPoint
Namespace
Für einen Namespace festgelegter Name
IsInstantiable/Description
Eingabewert im Feld Instantiierbar für den Knoten.
Die folgenden Werte sind zulässig:
TRUE
FALSE
Eingabewert im Feld Beschreibung für das Attribut.
Sie könnten z.B. eine CSV-Datei erstellen, die in den "Knoten"-Zeilen die folgenden Werte enthält:
* 
Die Anordnung der Spalten in der CSV-Datei muss mit jener im obigen Screenshot identisch sein.
Nachdem die CSV-Datei in eine XML-Datei konvertiert und dann importiert wurde, ergibt sich die folgende Struktur:
Für den Knoten "Gewindeeinsatz" wurden die folgenden Werte definiert:
Attributspalten
Die folgenden Spalten gelten nur für "Attribut"-Zeilen:
Spaltenname
Zulässige Werte
DefaultValue
Standardwert für das Attribut.
Für mehrere Standardwerte verwenden Sie eine kommagetrennte Liste. Beispiel:
0.0 m, 1.5 m
http://google.com(Google), http://ptc.com(PTC)
IsSingleValued
Geben Sie an, ob das Attribut einen Einzelwert besitzt.
Zulässige Werte:
TRUE
FALSE
IsRequired
Geben Sie an, ob das Attribut erforderlich ist.
Zulässige Werte:
TRUE
FALSE
StringLength
Geben Sie für Zeichenfolgenwerte eine Längenbeschränkung an.
Verwenden Sie das folgende Format: [Untergrenze, Obergrenze]
Beispiel:
[2,5] – Zeichenfolge muss zwischen 2 und 5 Zeichen enthalten
[NULL,50] – Zeichenfolge darf nicht mehr als 50 Zeichen enthalten
[10,NULL] – Zeichenfolge muss mindesten 10 Zeichen enthalten
Kleinbuchstaben
Wandeln Sie Großbuchstaben in Kleinbuchstaben um.
Zulässige Werte:
TRUE
FALSE
Großbuchstaben
Wandeln Sie Kleinbuchstaben in Großbuchstaben um.
Zulässige Werte:
TRUE
FALSE
LegalValueList
Eine Liste zulässiger Werte.
Trennen Sie einzelne Werte mithilfe eines senkrechten Striches ("|"). Beispiel:
1,0 m|1,5 m|2,0 m
Kupfer|Aluminium|Stahl
EnumeratedList
Aufzählungswerteliste. Sie können eine lokale oder eine globale Aufzählungswerteliste angeben.
Lokale Aufzählungsbeschränkungen verwenden das folgende Format:
LOCAL##<Sortierungstyp>##<interner Name>##<Anzeigename>~~<interner Name>##<Anzeigename>
dabei gilt:
• <Sortierungstyp> – Der Wert des Sortierungstyps lautet Automatic_Sort oder Manual_Sort.
• <interner Name>##<Anzeigename> – Geben Sie den internen Namen und den Anzeigenamen des Aufzählungseintrags an.
• ~~ – Verwenden Sie zwei Tildezeichen, um Mehrfacheinträge zu trennen.
Beispiel:
LOCAL##Manual_Sort##red1##Light Red~~red2##Dark Red~~green1##Light Green
Globale Aufzählungsbeschränkungen verwenden das folgende Format:
GLOBAL##<Aufzählung>##<Eltern-Aufzählung>##<Organisation>##<Organisationsmappenname>##/<Domäne>
dabei gilt:
• <Aufzählung> – interne Name der Aufzählung.
• <Elternteil-Aufzählung> – Wenn es sich bei der Aufzählung um eine Unteraufzählung handelt, geben Sie den internen Namen ihrer Elternteil-Aufzählung an. Wenn die Aufzählung keine Elternteil-Aufzählung besitzt, lassen Sie dieses Feld leer.
• <Organisation> – Wert von Besitzende Organisation für die Aufzählung.
• <Organisationsmappenname> – interner Name der Organisationsmappe, die die Aufzählung enthält.
• /<Domäne> – Wert von Domäne für die Aufzählung.
Beispiel:
GLOBAL##Countries##LocaleCodes##Site##Org_Locales##/System
GLOBAL##LocaleCodes####Site##Org_Locales##/System
* 
Die Sortierreihenfolge, die für die globale Aufzählung angegeben ist, wird als Standardsortierreihenfolge verwendet.
Sie könnten z.B. eine CSV-Datei erstellen, die in den "Attribut"-Zeilen die folgenden Werte enthält:
* 
Die Anordnung der Spalten in der CSV-Datei muss mit jener im obigen Screenshot identisch sein.
Für den Knoten "Gewindeeinsatz" wurden die folgenden Attribute definiert: