Importdimension: Verwenden des Befehlszeilen-Dienstprogramms für Planning

Aktualisiert: 2009-04-30

Verwenden Sie den Befehl importdimension, um Dimensionselemente aus einer Datei im CSV-Format zu importieren.

Hinweis:
Sie müssen Mitglied der Modelliererrolle sein, um diesen Befehl verwenden zu können.

Wichtig:
Elemente mit vorhandener Element-ID werden nicht importiert.

Syntax

ppscmd importdimension [Optionen] file [Dateien]

Parameter	Erforderlich?	Beschreibung
/server <ServerUri>	Nein	Gibt den Server-URI an, mit dem eine Verbindung hergestellt werden soll. Die Standardwerte sind die von Planning Business Modeler verwendeten Werte.
/application <AppLabel>	Nein	Gibt die zu öffnende Anwendung an. Die Standardwerte sind die von Planning Business Modeler verwendeten Werte.
/site <SiteLabel>	Nein	Gibt die zu öffnende Modellsite an. Der Standardwert ist die Modeler-Standardmodellsite.
/dimension <DimLabel>	Ja	Gibt das Dimensionsobjekt an, das importiert werden soll.
/hierarchy <HierarchyLabel>	Nein	Gibt das Hierarchieobjekt an, das importiert werden soll. Ohne Angabe von /hierarchy werden Elemente in die Hierarchie Alle Elemente der Dimension importiert.
/encoding <FileEncoding>	Nein	Gibt die Dateicodierung der CSV-Datei an. Der Standardwert ist UTF8.

Die folgenden Kennzeichen liefern in Verbindung mit dem Befehl importdimension zusätzliche Anweisungen für den Server.

Kennzeichen	Beschreibung
/OverrideExistingMember	Überschreibt vorhandene Objekte beim Import einer CSV-Datei. Dieses Kennzeichen legt das erste Vorkommen einer doppelten Bezeichnung fest, um die Werte im System zu überschreiben. Wenn in der Datei Duplikate vorhanden sind, überschreiben sie sich nicht gegenseitig. Duplikate werden übersprungen.
/CreateNewProperty	Erstellt beim Importieren einer CSV-Datei neue Elementeigenschaften. Dieses Kennzeichen unterstützt den Eigenschaftentyp Element der Dimension nur, wenn die Elementeigenschaft bereits über Planning Business Modeler erstellt wurde. Es wird auch nicht angewendet, wenn das /IgnoreExtraColumns-Kennzeichen verwendet wird. Beim Erstellen einer neuen Eigenschaft wird die Eigenschaft immer als String-Datentyp erstellt, sofern in der CSV-Datei nichts anderes angegeben ist. Leere Werte werden für alle vorhandenen Elemente festgelegt.
/IgnoreExtraColumns	Ignoriert zusätzliche Spalten in der CSV-Datei.

Keine

Die folgenden Befehlszeilenbeispiele veranschaulichen die Verwendung des Befehls importdimension.

ppscmd importdimension /app app1 /site site1 /dim dim1 myfile.csv

ppscmd importdimension /app app1 /site site1 /dim dim1 /hierarchy h1 myfile.csv

Verwenden Sie das folgende CSV-Dateiformat.

Spalte	Beschreibung
Bezeichnung	Erforderlich. Der Elementbezeichnung. Die erste Spalte der CSV-Datei muss die Label-Spalte sein. Die CSV-Datei muss immer mindestens Spaltenwerte für Name und Bezeichnung enthalten. Alle anderen Spaltenüberschriften sollten einer Elementeigenschaftenüberschrift in der Dimension entsprechen. Wenn die Liste mehrere Bezeichnungen enthält, wird nur die erste importiert, alle anderen werden übersprungen.
Parent	Optional. Die Elementbezeichnung für dieses Element für hierarchische Beziehungen in einer Elementgruppe.
Beschreibung	Optional. Die Beschreibung des Elements.
Name	Erforderlich. Der Name des Elements.

Beispiel:

Bezeichnung	Parent	Beschreibung	Name
Element1		Element1	Element1
Element2	Element1	Element2	Element2

Mögliche Dateicodierungen sind ISO-8859, UTF8, UNICODE oder ASCII. Verwenden Sie ISO-8859 für 8-Bit-Zeichencodierung.