Versionsexport

Versionsexporte geben für eine gesamte Version für jeden Knoten und seine Eigenschaften einen Datensatz aus. Diese Informationen können in eine Datei oder eine Datenbanktabelle ausgegeben werden.

Tipp:

Um die Exportreihenfolge beim Exportieren in eine Datenbanktabelle beizubehalten, können Sie der Ausgabe eine Datensatz-ID-Spalte hinzufügen. Diese Spalte stellt einen automatisch generierten, numerischen Wert bereit, der mit 1 beginnt und für jede Zeile im Export sequenziell erhöht wird.

Hinweis:

Hierarchiebeziehungen und lokale Eigenschaften sind für diesen Exporttyp nicht verfügbar.

So erstellen Sie einen Versionsexport:

Wählen Sie auf der Homepage Export aus.
Klicken Sie auf .
Wählen Sie Version 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 in der Registerkarte Stil eine der folgenden Optionen aus:
- Knotenauswahl – Zum Festlegen der Knotentypen (Alle Knoten, Nur Astknoten, Nur Blattknoten), die im Export eingeschlossen werden.
- 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, wie z.B. der Auswahl eines obersten Knotens oder einem Abfragefilter, nicht ausgefiltert werden. Die Struktur von impliziten gemeinsamen Knoten unterhalb eines gemeinsamen übergeordneten Knotens wird im Vorgängerabschnitt des Hierarchieexports wiedergegeben.
  - 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.
Wählen Sie im Bereich Batchvalidierungen den Typ der auszuführenden Validierungen aus.
Hinweis:

Batchvalidierungen werden für die gesamte im Export angegebene Version ausgeführt. Validierungen werden vor dem Export ausgeführt. Wenn Fehler auftreten, wird der Export unterbrochen.
- Keine – Es werden keine Validierungen ausgeführt.
- Zugewiesen – Alle zugewiesenen Validierungen, die ausgeführt wurden.
- Ausgewählt - Klicken Sie auf , um die auszuführenden Validierungen auszuwählen.
Hinweis:

Validierungen werden für die gesamte Version ausgeführt.
Wählen Sie in der Registerkarte Filter Optionen aus:
- Wählen Sie unter Validierung eine Validierung zum Anwenden auf den Export aus.
- Wählen Sie unter Abfrage eine Abfrage zum Anwenden auf den Export aus, oder klicken Sie auf , um eine Abfrage zu definieren.
  
  Hinweis:
  
  Der Inklusionsfilter legt den Satz der Knoten aus den einzelnen zu vergleichenden Hierarchien fest.
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 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.
  - 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
- 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 individuellen 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 für Benutzer mit der Anwendungsadministratorrolle angezeigt und ausgeführt werden können.
- Klicken Sie zum Validieren des Exports auf .
  
  Sie können Validierungsfehler in die Zwischenablage kopieren.
- 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.