Format für Anforderungsladedatei

In diesem Thema wird das Format der Microsoft Excel-Tabellen beschrieben, mit dem Anforderungselemente geladen werden.

Wichtige Aspekte

• Jedes Arbeitsblatt in einer Tabellenkalkulationsdatei entspricht einem Ansichtspunkt.

• Sie können mehrere Arbeitsblätter in mehrere Ansichtspunkte laden.

• Arbeitsblätter (und ihre entsprechenden Ansichtspunkte) müssen Labels mit 30 oder weniger Zeichen verwenden.

  Hinweis:

  Wenn ein Ansichtspunktname länger als 30 Zeichen ist, müssen Sie ein Label erstellen, das für das Arbeitsblatt verwendet wird, wenn Anforderungselemente in einen Ansichtspunkt geladen werden. Informationen zum Verwenden eines Labels finden Sie unter Ansichtspunkte prüfen.

• Tabellen können Formeln zum Abrufen von Eigenschaftswerten für die Standardspalten enthalten. Tabellenformeln können auch für anwendungsspezifische (FCGL, PLN) und benutzerdefinierte Eigenschaften verwendet werden. Eigenschaftszellen mit leeren Formelwerten werden übersprungen. Eigenschaftszellen mit den Formelwerten <clear> oder <blank>.

• Arbeitsblätter werden in der Reihenfolge von links nach rechts verarbeitet.

• Doppelte Zeilen in der Importdatei werden während des Ladevorgangs nicht verarbeitet.

• Datumsangaben und Zeitstempel für unterstützte Gebietsschemas müssen eines der folgenden Java-Datumsformatmuster aufweisen:

  • Kurz

  • Standard

  • Lang

  • Mittel

  Hinweis:

  Informationen zum Java-Datum und zu Zeitformaten finden Sie unter Vordefinierte Formate verwenden.

• Wenn mehr als 10000 Knoten vorhanden sind, erstellen Sie mehrere Ladedateien mit jeweils weniger als 10000 Knoten.

• Für Knoten, die in einem Hierarchieansichtspunkt hinzugefügt oder eingefügt werden, bei dem das übergeordnete Element nicht bekannt ist, verwenden Sie das Schlüsselwort <Unbekannt> in der Spalte "Übergeordnet", damit der Wert des übergeordneten Elements für jedes Anforderungselement berechnet und gespeichert wird. Ein Administrator muss einen Ausdruck definiert haben, um den übergeordneten Wert zu berechnen. Informationen hierzu finden Sie unter Den übergeordneten Wert eines Knotens berechnen und speichern.

• Um die Namen hinzugefügter oder eingefügter Knoten zu berechnen, lassen Sie die Spalte "Name" leer, oder verwenden Sie das Schlüsselwort <cn> oder <cn ####>. Der Knoten muss zum Berechnen des Namenswertes eingerichtet sein. Informationen hierzu finden Sie unter Namen eines Knotens berechnen und speichern.

Wichtige Aspekte zu Spalten

• Die Tabelle muss Spaltenheader enthalten, die mit den Namen der reservierten Spalten oder mit den Namen von Eigenschaften übereinstimmen. Informationen hierzu finden Sie unter Reservierte Spaltennamen.

  Hinweis:

  Sie können kein Blatt laden, wenn die Spalte "Name" fehlt.

• Spaltenheader für Eigenschaften müssen aus dem Eigenschaftsnamen oder dem benutzerdefinierten angezeigten Label der Eigenschaft bestehen, sofern eines eingerichtet wurde (diese Option wird in der Registerkarte für die Eigenschaften des Ansichtspunktinspektors festgelegt). Der Eigenschaftsname darf nicht den Namespace enthalten. Beispiel: Core.Description ist nicht gültig.
• Wenn die Ladedatei eine Spalte für die Eigenschaft für den alternativen Namen enthält:
  • Wenn der Knotentyp, in den geladen werden soll, die Eigenschaft für den alternativen Namen enthält, werden beim Laden der Datei die folgenden Vorgänge ausgeführt:
    • Wenn eine Zeile einen Knotennamen enthält, wird der alternative Name in die Spalte "Alternativer Name" geladen.
    • Wenn eine Zeile keinen Knotennamen enthält, wird der alternative Name verwendet, um einen übereinstimmenden Knoten im Ansichtspunkt mit demselben Wert für die Eigenschaft für den alternativen Namen zu suchen.

  • Wenn der Knotentyp, in den geladen werden soll, die Eigenschaft für den alternativen Namen nicht enthält, wird die Spalte ignoriert.

• Die Reihenfolge der Spalten kann beliebig sein.
• Wenn der Spaltenheader nicht mit einem der Namen für reservierte Spalten oder mit einem der Eigenschaftsnamen übereinstimmt, wird die Spalte ignoriert. Dies bedeutet, dass die Tabelle Kommentare enthalten kann, die nicht geladen werden.

Verarbeitungsreihenfolge von Zeilen

Beim Laden von Datensätzen aus einer Anforderungsdatei sortiert der Ladeprozess die Dateiinhalte, damit übergeordnete Knoten vor untergeordneten Knoten zu einem Ansichtspunkt hinzugefügt werden. Dadurch werden Validierungsfehler verhindert, wenn sich in der Ladedatei die Zeile für einen untergeordneten Knoten vor einer Zeile für einen übergeordneten Knoten befindet.

Diese Ladedatei enthält beispielsweise eine übergeordnete Zeile, Analytics, vor der sich in der Datei zwei untergeordnete Zeilen befinden, Emily und Jack, deren übergeordnetes Element jeweils Analytics ist:

Wenn diese Datei geladen wird, sortiert der Ladeprozess die Inhalte so, dass zuerst Analytics und anschließend Emily, Jack und Mary hinzugefügt werden.

Verarbeitung von <Blank> und <Clear> und leere Felder

Die Eingabe des Schlüsselwortes <blank> oder <clear> und das Leerlassen von Zellen in der Anforderungsladedatei werden beim Verarbeiten einer Anforderungsdatei unterschiedlich behandelt:

• Das Schlüsselwort <clear> löscht die vorhandenen Werte aus einer Eigenschaft.
• Das Schlüsselwort <blank> setzt die Eigenschaft auf einen definierten Wert für leere Eigenschaften.
• Leere Zellen in der Datei werden ignoriert.

Sowohl die Schlüsselwörter <blank> und <clear> als auch leere Zellen werden für alle Datentypen unterstützt. Für Listendatentypen werden leere Einträge innerhalb einer Liste jedoch nicht unterstützt. Das heißt, die Liste selbst kann leer sein, ein Eintrag in der Liste aber nicht.

Beispiele:

• Listenwert: '<blank>' wird unterstützt. Beachten Sie, dass durch Importieren des Wertes "blank" für eine Liste alle vorhandenen definierten, geerbten oder Standardwerte in der Liste überschrieben werden.
• Listenwert: 'A,B,C' wird unterstützt.
• Listenwert: 'A,,C' wird nicht unterstützt.

Reservierte Spaltennamen

Wichtige Aspekte

• Wenn eine Eigenschaft denselben Namen wie eine reservierte Spalte aufweist, können Sie einen alternativen Spaltennamen verwenden. Nachfolgend finden Sie die unterstützten alternativen Namen.

• Wenn die Tabelle in einen Ansichtspunkt für eine Liste geladen wird, werden Spalten und Aktionen für Hierarchien ignoriert. Beispiel: In einem Listenansichtspunkt werden Aktionen zum Verschieben und Einfügen ignoriert.

Tabelle 10-2 Aktionscodes

Aktionscode	Beschreibung
Add	Erstellt einen neuen Knoten.
Delete	Löscht einen Knoten.
<Empty cell>	Wenn die Zelle Action Code leer ist, wird die Zeile mit dem Aktionscode Update aktualisiert.
Insert	Fügt einen vorhandenen Knoten in eine Hierarchie unter dem von den Zellen Parent und Parent Node Type angegebenen Knoten ein.
Move	Verschiebt einen vorhandenen Knoten an eine neue Position in einer Hierarchie. Dabei wird der Knoten von seiner aktuellen Position entfernt.
Prop_Update	Aktualisiert den Eigenschaftswert nur für einen vorhandenen Knoten. Um andere Aktionen durchzuführen, verwenden Sie den Aktionscode Update. Sie können den Eigenschaftswert für eine definierte Eigenschaft löschen. Das Löschen des Eigenschaftswertes löscht den gespeicherten Wert und setzt den Wert auf den Standardwert oder geerbten Wert zurück. Beispielsweise löscht die untenstehende Aktion "Prop_Update" den Wert für die Beschreibung.
Rename	Benennt einen vorhandenen Knoten um.
Reorder	Ordnet einen Knoten in einem Hierarchieansichtspunkt neu an. Sie können nur Knoten in einem Ansichtspunkt neu anordnen, der ein Hierarchieset verwendet, das eine Neuanordnung für diesen Knotentyp (übergeordneter oder unterer Knoten) zulässt. Weitere Informationen finden Sie unter Knoten neu anordnen.
Remove	Entfernt den Knoten aus dem angegebenen übergeordneten Knoten.
Update	Aktualisiert die Eigenschaftswerte eines vorhandenen Knotens. Die Aktion Update führt außerdem zusätzliche Aktionen durch, wenn sie für die Zellen in einer Zeile erforderlich sind. In der folgenden Liste ist beschrieben, wie dies funktioniert: Wenn der Knoten nicht vorhanden ist, wird er hinzugefügt. Wenn der Ansichtspunkt hierarchisch ist, wird der Knoten an der Stelle der Hierarchie eingefügt, die von den Zellen Parent und Parent Node Type angegeben wird. Wenn der Ansichtspunkt hierarchisch ist, der Knoten aber nicht unter dem angegebenen übergeordneten Knoten vorhanden ist, hängt die resultierende Aktion davon ab, ob das Hierarchieset gemeinsame Knoten zulässt: Wenn gemeinsame Knoten zulässig sind, wird der Knoten unter dem angegebenen übergeordneten Knoten eingefügt. Wenn gemeinsame Knoten nicht zulässig sind, wird der Knoten unter den angegebenen übergeordneten Knoten verschoben. Sie können eine Eigenschaft auf einen leeren Wert aktualisieren, wenn die Eigenschaft Leerzeichen erlaubt. Sie müssen den Indikator <blank> in der Zelle verwenden. Eine leere Zelle führt nicht zu den gleichen Ergebnissen. So setzt beispielsweise die untenstehende Aktualisierungsaktion die Eigenschaft für den Mandanten (Legal Entity) auf einen leeren Wert. Auch wenn die Zelle für die Beschreibung leer ist, ändert sich die vorhandene Beschreibung für EMA nicht.