Hierarchieexport

Bei Hierarchieexporten werden Knoten und Eigenschaften von Hierarchien ausgegeben. Diese Informationen können in eine Datei oder eine Datenbanktabelle ausgegeben werden. Dieser Exporttyp kann für die Erstellung eines Parent-Child-Formats oder einer einfachen Liste von Hierarchieknoten verwendet werden.

So erstellen Sie einen Hierarchieexport:

Wählen Sie auf der Homepage Export aus.
Klicken Sie auf .
Wählen Sie Hierarchie als den Exporttyp aus.
Optional: So erstellen Sie Ersatzparameter für den Export:
1. Klicken Sie auf .
2. Klicken Sie auf Hinzufügen, und fügen Sie Schlüsselwertpaare hinzu.
  
  Hinweis:
  
  Bei Schlüsselwertpaaren können "<%" oder "%>" nicht nacheinander verwendet werden, und es können keine Gleichheitszeichen verwendet werden.
3. Klicken Sie auf OK.
Wählen Sie in der Registerkarte Quelle eine Version oder Versionsvariable aus.

Sie können auch die Normalversion, die Basisversion oder die Stichtagsversion auswählen. Die Liste der Versionen wird auf die Normalversionen zurückgesetzt. Um eine Basisversion oder eine Stichtagsversion auszuwählen, klicken Sie in der Versionsliste auf Normal.
Wählen Sie unter Hierarchieauswahl eine Option aus:
- Oberste Knoten - Klicken Sie auf Hinzufügen, wählen Sie eine Hierarchie und einen Knoten aus, und klicken Sie auf OK. Wiederholen Sie den Vorgang, bis alle Knoten hinzugefügt sind.
  
  Hinweis:
  
  Verwenden Sie die Pfeile, um die Knoten neu anzuordnen, die festlegen, in welcher Reihenfolge die Hierarchieknoten exportiert werden.
- Hierarchiegruppe – Wählen Sie eine Hierarchiegruppeneigenschaft und eine Hierarchiegruppe aus.
  
  Hinweis:
  
  Sie können für die Hierarchiegruppeneigenschaft und die Hierarchiegruppe Substitutionsvariablen verwenden.
  - Hierarchiegruppeneigenschaft - Wählen Sie eine Hierarchiegruppeneigenschaft aus, oder wählen Sie [Wert aus Parameter abrufen] aus. Wählen Sie anschließend den für die Eigenschaft zu verwendenden Parameter aus.
  - Hierarchiegruppe - Wählen Sie eine Hierarchiegruppe aus, oder wählen Sie [Wert aus Parameter abrufen] aus. Wählen Sie anschließend den für die Gruppe zu verwendenden Parameter aus.
Wählen Sie in der Registerkarte Stil eine der folgenden Optionen aus:
- Knotenauswahl – Zum Festlegen der Knoten (Alle Knoten, Nur Astknoten, Nur Blattknoten), die im Export eingeschlossen werden.
- Obersten und untergeordnete Knoten einschließen – Wählen Sie diese Option aus, um die Ausgabe für alle Knoten unterhalb des obersten Knotens einzuschließen. Wenn diese Option deaktiviert ist, wird nur der oberste Knoten eingeschlossen. Diese Option ist nützlich, wenn ein Einzeldatensatz für jede ausgewählte Hierarchie exportiert wird.
- Inaktive Knoten einschließen – Wählen Sie diese Option aus, um inaktive Knoten im Export einzuschließen.
- Gemeinsame Knoten implizit einschließen – Wählen Sie diese Option aus, um abhängige Knoten unterhalb von gemeinsamen Astknoten einzuschließen, die explizit gemeinsam verwendet werden. Implizite gemeinsame Knoten werden nur exportiert, wenn sie von einer anderen Option nicht ausgefiltert werden.
  - Wenn im Export ein Abfragefilter verwendet wird, muss der Administrator die gemeinsamen Knoten explizit einschließen. Zum Beispiel muss der Filter (Anzahl untergeordnete Elemente=0) geändert werden in ((Anzahl untergeordnete Elemente=0 OR (Kennzeichen für gemeinsamen Knoten = True)).
  - Für den impliziten gemeinsamen Knoten geben die Eigenschaften des übergeordneten Elements die Werte des tatsächlichen Knotens (des Primärknotens) wieder. Wenn Ihr Export zum Beispiel die Eigenschaft "Übergeordneter Knoten" für einen impliziten gemeinsamen Knoten enthält, wird der übergeordnete Knoten als der Primärknoten angezeigt.
- Duplikate anhand von Schlüsseln entfernen – Wählen Sie diese Option aus, um den Primärschlüssel (definiert in der Registerkarte "Spaltenoptionen") zu verwenden, um zu verhindern, dass doppelte Datensätze exportiert werden.
- Ausgabe mit Registern – Wählen Sie diese Option aus, um die Knoten für jede Ebene einer Hierarchie mit Registerzeichen einzurücken, um ein strukturiertes Ausgabeformat zu erhalten.
Wählen Sie im Bereich Batchvalidierungen den Typ der auszuführenden Validierungen aus.
Hinweis:

Batchvalidierungen werden nur für die Hierarchien und Knoten ausgeführt, die im Export eingeschlossen sind. Validierungen werden vor dem Export ausgeführt. Wenn Fehler auftreten, wird der Export unterbrochen.
- Keine – Es werden keine Validierungen ausgeführt.
- Zugewiesen – Alle Validierungen, die der Version, den Hierarchien und Knoten für den ausgeführten Export zugewiesen werden.
- Ausgewählt - Klicken Sie auf , um die auszuführenden Validierungen auszuwählen.
Wählen Sie im Abschnitt Wiederholungsparameter unter den folgenden Optionen aus:
- Eigenschaft für Wiederholungsanzahl – Verweist auf eine lokale, auf Knotenebene befindliche Ganzzahleigenschaft, die einen Knoten innerhalb einer Exportstruktur wiederholt. Wenn zum Beispiel bei einer Parent-Child-Hierarchie A-B-C die Eigenschaft "Eigenschaft für Wiederholungsanzahl" den Wert 2 für Knoten B und den Wert von 1 für die Knoten A und C aufweist, sieht der Knoten folgendermaßen aus: A,B,B,C (Knoten B wird zweimal wiederholt).
  
  Hinweis:
  
  Bei der Verwendung von "Eigenschaft für Wiederholungsanzahl" muss der Wert auf mindestens 1 festgelegt werden, damit Knoten in die Exportergebnisse eingeschlossen werden. Es wird empfohlen, den Standardwert für "Eigenschaft für Wiederholungsanzahl" auf 1 festzulegen.
- Eigenschaft für maximale Tiefe und Wert für maximale Tiefe - Legen die maximale Tiefe der Exportstruktur fest. Dieser Wert kann als eine auf Hierarchieebene befindliche Ganzzahleigenschaft (Eigenschaft für maximale Tiefe) oder als ein absoluter Wert (Wert für maximale Tiefe) definiert werden.
  
  Wenn eine maximale Tiefe definiert ist, sind die Wiederholungsoptionen aktiviert, um Knoten automatisch bis zur definierten Ebene in der Exportstruktur zu wiederholen. Wenn zum Beispiel in einer Parent-Child-Hierarchie für die Knoten A-B-C der "Wert für maximale Tiefe" auf 6 festgelegt, für den Knoten B die "Eigenschaft für Wiederholungsanzahl" auf 2 festgelegt und die Option "Untersten Blattknoten wiederholen" ausgewählt ist, sieht die Exportstruktur folgendermaßen aus: A,B,B,C,C,C (die Exportstruktur hat eine Tiefe von sechs Ebenen, der Blattknoten C wird bis zur 6. Ebene wiederholt, und der Knoten B wird zweimal wiederholt).
Wählen Sie in der Registerkarte Filter eine der folgenden Optionen aus:
- Wählen Sie unter Validierung eine Validierung zum Filtern des Exports aus.
- Wählen Sie unter Abfrage eine Abfrage zum Anwenden auf den Export aus, oder klicken Sie auf , um eine Abfrage zu definieren.
- Textdatei verwenden, um abhängige Knoten ein- oder auszuschließen – Wählen Sie diese Option aus, wenn Sie eine Textdatei erstellt haben, die Knoten enthält, die im Export eingeschlossen oder aus dem Export ausgeschlossen werden sollen. Das Dateiformat ist eine Liste von Knotennamen mit einem Namen pro Zeile. Wählen Sie eine Verbindung aus, geben Sie einen Dateinamen ein, und wählen Sie aus, ob die Knoten im Export eingeschlossen oder aus dem Export ausgeschlossen werden sollen.
Wählen Sie in der Registerkarte Spalten die Eigenschaften aus, die in den Exportergebnissen als Spalten angezeigt werden sollen, und verschieben Sie sie von Verfügbar nach Ausgewählt.

Weitere Informationen finden Sie unter Bestimmte Spalten exportieren

Tipp:

Verwenden Sie die Kategorieliste, um zur Vereinfachung der Navigation eine Eigenschaftskategorie auszuwählen. Verwenden Sie die Nach-oben- und Nach-unten-Pfeile, um die Spalten in der Liste "Ausgewählt" anzuordnen. Das erste Element in der Liste ist die erste Spalte, das zweite Element in der Liste ist die zweite Spalte usw.
Wählen Sie in der Registerkarte Spaltenoptionen eine der folgenden Optionen aus:
- Pivotieren – Wenn die Eigenschaft eine durch Komma getrennte Liste von Werten enthält, wird für jeden Wert ein separater Datensatz exportiert, und alle anderen Exportspalten werden auf dieselben Werte gesetzt. Die Option "Pivotieren" ist möglicherweise für nur eine Spalte ausgewählt.
- Standardwerte überspringen – Wird verwendet, um einen Leerwert (leere Zeichenfolge) oder NULL-Wert (in der Ausgabe an eine Datenbanktabelle) im Export festzulegen, wenn der Feldwert mit dem Standardwert der Eigenschaft identisch ist.
- Primärschlüssel – Zum Definieren eines Feldes (oder von Feldern) als der Primärschlüssel, der beim Ermitteln von Duplikaten verwendet wird (Dies wird von der Option "Duplikate entfernen" in der Registerkarte "Stil" verwendet.)
- Dynamischer Wert – Wenn Sie eine dynamische Spalte hinzugefügt haben, definieren Sie hier den Wert für die Spalte. Der Wert kann Null oder eine Kombination aus konstanten Werten und Substitutionsvariablen sein.
Wählen Sie in der Registerkarte Ziel den Ausgabetyp für die Ergebnisse aus:
- Clientdatei – Zum Herunterladen der Ergebnisse über den Browser
- Serverdatei – Verwenden Sie eine externe Verbindung, und speichern Sie die Ergebnisse in einem Netzwerk-Dateisystem oder FTP-Verzeichnis.
- Datenbanktabelle – Speichern Sie die Ergebnisse in einer Datenbanktabelle.
Führen Sie eine Aktion aus:
- Wenn Sie in eine Clientdatei exportieren möchten, wählen Sie die Optionen aus:
  - Spaltenüberschriften – Schließt die Spaltenüberschriften im Export ein, basierend auf den Labels der ausgewählten Eigenschaften.
  - Zeichenfolgen in Anführungszeichen - Setzt jeden Spaltenwert in Anführungszeichen. Alle vorhandenen Anführungszeichen innerhalb des Spaltenwerts werden verdoppelt.
    
    Beispiel:
```
=IF("ABC","XYZ",)
```
    wird geändert in
```
"=IF(""ABC"",""XYZ"",)"
```
  - Feste Breite – Ermöglicht die Angabe von Feldbreiten, der linken oder rechten Ausrichtung der Spalte und die Anzahl der Auffüllzeichen. Sie können die Spalteninformationen im Abschnitt "Feste Breite - Optionen" eingeben.
  - Zeichencodierung – Wählen Sie mindestens eine Codierungsoption aus. Die Codierung gilt für die Ausgabedatei und für die Datei zum Ein- oder Ausschließen eines Knotens, falls angegeben.
  - Optionen unter Ersetzen – Wählen Sie in den Listen bis zu drei Zeichen aus, die ersetzt werden sollen. Alle Instanzen im Export werden wie angegeben ersetzt. Zum Beispiel können alle Kommas durch Tabulatoren ersetzt werden.
  - Kopf-/Fußzeile – Fügen Sie zwischen der Kopf-/Fußzeile und dem Haupttext eine Zeile hinzu, oder geben Sie den Text ein, der in der Kopf-/Fußzeile der Exportergebnisse gedruckt werden soll. Geben Sie im Textfeld Textzeilen ein, oder klicken Sie auf , um den Texteditor zu öffnen.
    
    Hinweis:
    
    Sie können Anpassungstags einfügen, um die Lesbarkeit der exportierten Ergebnisse weiter zu verbessern. Weitere Informationen finden Sie unter Anpassungstags.
  - Trennzeichenoptionen – Zur Auswahl eines Feldtrennzeichens und eines Datensatztrennzeichens
- Wenn Sie in eine Datenbanktabelle exportieren möchten, müssen Sie die Verbindung festlegen und die Datenbanktabelle auswählen: Sie müssen bereits eine gültige externe Datenbankverbindung erstellt haben, damit sie in der Dropdown-Liste angezeigt wird. Sie können außerdem eine der folgenden Optionen auswählen:
  - Optionen unter "Tabelle löschen"
    - Tabelle nicht löschen – Hängt an vorhandene Daten in der angegebenen Tabelle an.
    - Anhand von Versions-ID(s) löschen – Löscht die Daten in der Tabelle, bei denen das angegebene Schlüsselfeld der aktuellen Versions-ID der exportierten Daten entspricht. Wenn diese Option ausgewählt ist, muss im Abschnitt "Datenbankspalten - Optionen" ein Schlüsselfeld angegeben werden. Wenn der Export ausgeführt wird, werden zuerst alle Daten in der Tabelle gelöscht, bei denen das Schlüsselfeld der aktuellen Versions-ID der exportierten Daten entspricht. Bei den anderen Optionen unter "Tabelle löschen" wird das Schlüsselfeld ignoriert.
    - Alle Zeilen löschen – Löscht vor dem Schreiben der Exportausgabe die Tabellendaten.
  - Transaktionen verwenden – Der Export wird innerhalb einer Datenbanktransaktion ausgeführt und ermöglicht, dass der gesamte Vorgang rückgängig gemacht wird, wenn ein Exportfehler auftritt.
  - Schnelles Hinzufügen verwenden – Führt einen Vorgang für Masseneinfügen in die Zieldatenbanktabelle aus, um eine verbesserte Exportleistung zu erzielen. Die Option ist nur mit einer datenbankspezifischen Verbindung verfügbar.
  - Schnelles Löschen verwenden – Führt einen Vorgang für Massenlöschen für die Zieldatenbanktabelle aus, um eine verbesserte Exportleistung zu erzielen. Die Option ist nur mit einer datenbankspezifischen Verbindung verfügbar.
  - Datenbankspalten - Optionen – Jede exportierte Spalte muss einem Feld in der externen Datenbanktabelle zugeordnet sein. Wählen Sie unter "Feldname" den Namen eines Feldes aus. Wenn Sie "Anhand von Versions-ID(s) löschen" ausgewählt haben, geben Sie ein Schlüsselfeld ein.
    
    Tipp:
    
    Die Option für Länge kann leer gelassen werden, sodass die Zeichenfolgenlängen bis zur Datenbankspaltendeklaration zur Datenbank gesendet werden können.
    
    Hinweis:
    
    Die Spalte muss denselben Datentyp aufweisen wie das Datenbankfeld, dem sie zugeordnet wird. Wenn eine Zeichenfolgeeigenschaft zum Beispiel einem numerischen Datenbankfeld zugeordnet wird, tritt ein Fehler auf.
- Wenn Sie in eine Serverdatei exportieren möchten, müssen Sie die Verbindung festlegen und einen Dateinamen eingeben. Sie müssen bereits eine gültige externe Verbindung zu einer UNC- oder FTP-Datei erstellt haben. Sie können außerdem eine der folgenden Optionen auswählen:
  - Spaltenüberschriften – Schließt Spaltenüberschriften ein.
  - Zeichenfolgen in Anführungszeichen - Setzt jeden Spaltenwert in Anführungszeichen. Alle vorhandenen Anführungszeichen innerhalb des Spaltenwerts werden verdoppelt.
    
    Beispiel:
```
=IF("ABC","XYZ",)
```
    wird geändert in
```
"=IF(""ABC"",""XYZ"",)"
```
  - Feste Breite – Ermöglicht die Angabe von Feldbreiten, der linken oder rechten Ausrichtung der Spalte und die Anzahl der Auffüllzeichen. Sie können die Spalteninformationen im Abschnitt "Feste Breite - Optionen" eingeben.
  - Zeichencodierung – Wählen Sie mindestens eine Codierungsoption aus.
  - Optionen unter Ersetzen – Wählen Sie in den Listen bis zu drei Zeichen aus, die ersetzt werden sollen. Zum Bespiel können Kommas durch Tabulatoren ersetzt werden.
  - Kopf-/Fußzeile – Fügen Sie zwischen der Kopf-/Fußzeile und dem Haupttext eine Zeile hinzu, oder geben Sie den Text ein, der in der Kopf-/Fußzeile der Exportergebnisse gedruckt werden soll. Geben Sie im Textfeld Textzeilen ein, oder klicken Sie auf , um den Texteditor zu öffnen.
    
    Hinweis:
    
    Sie können Anpassungstags einfügen, um die Lesbarkeit der exportierten Ergebnisse weiter zu verbessern. Weitere Informationen finden Sie unter Anpassungstags.
  - Optionen unter Trennzeichen – Zur Auswahl eines Feldtrennzeichens und eines Datensatztrennzeichens
Führen Sie einen der folgenden Schritte aus:
- Klicken Sie zum Speichern des Exports auf .
  
  Sie werden aufgefordert, einen Namen, eine Beschreibung und eine Objektzugriffsgruppe für den Export zu definieren: Wählen Sie eine benutzerdefinierte Gruppe oder eine der folgenden Gruppen aus:
  - Benutzer – Persönliche Objekte, die nur von einem einzelnen Benutzer angezeigt und ausgeführt werden können.
  - Standard – Öffentliche Objekte, die von allen Benutzern angezeigt und ausgeführt werden können. Nur Benutzer mit der Datenmanagerrolle können Standardexporte erstellen und ändern.
  - System – Beschränkte Objekte, die nur von Benutzern mit der Anwendungsadministratorrolle angezeigt und ausgeführt werden können.
- Klicken Sie zum Validieren des Exports auf .
- Klicken Sie zum Ausführen des Exports auf .
  
  Wenn Sie Validierungen in der Registerkarte Stil ausführen möchten, klicken Sie auf , um die Validierungen auszuführen. Wenn keine Fehler auftreten, wird der Export ausgeführt. Wenn Validierungsfehler auftreten, wird der Export unterbrochen und ein Fehler angezeigt. Klicken Sie auf , um eine Liste der Validierungsfehler anzuzeigen.