Vergleichsexport

Vergleichsexporte vergleichen zwei Hierarchien und geben für jeden Knoten, der den Vergleichskriterien entspricht, einen Datensatz aus. Sie können diese Informationen an eine Datei oder eine Datenbanktabelle ausgeben. Dieser Export kann dazu verwendet werden, inkrementelle Änderungen an Zielsystemen bereitzustellen.

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.

So erstellen Sie einen Vergleichsexport:

Wählen Sie auf der Homepage Export aus.
Klicken Sie auf .
Wählen Sie Vergleich 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 die Versionen, die Hierarchien und die obersten Knoten für den Vergleich aus.

Hinweis:

Sie müssen sowohl für die aktuelle als auch die vorherige Version eine Hierarchie und oberste Knoten auswählen.

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 Optionen aus:
- Knotenauswahl – Zum Festlegen der Knotentypen (Alle Knoten, Nur Astknoten, Nur Blattknoten), die im Export eingeschlossen werden.
- Join-Eigenschaft – Standardmäßig werden in den einzelnen Hierarchien Zuordnungsknoten verglichen, die denselben Namen haben. Sie können außerdem Knoten aufgrund anderer Eigenschaften verknüpfen. Wenn zum Beispiel eine Eigenschaft mit dem Namen SortCode einen eindeutigen Schlüssel in den angegebenen Hierarchien aufweist, wird diese Eigenschaft verwendet, um die Unterschiede zwischen Knoten zu ermitteln, die in den einzelnen Hierarchien denselben SortCode haben.
- Hinzugefügt – Schließt alle Knoten in der Zielhierarchie ein, die nicht in der Quellhierarchie enthalten sind.
- Gelöscht – Schließt alle Knoten in der Quellhierarchie ein, die nicht in der Zielhierarchie enthalten sind.
- Zusammengeführt – Schließt Informationen im Export ein (wenn die Zusammenführungsfunktion aktiviert ist).
- Verschoben – Schließt alle Knoten ein, die unterschiedliche übergeordnete Knoten in den Vergleichshierarchien haben.
- Umbenannt – Schließt alle Knoten ein, die unterschiedliche Namen, aber dieselbe interne NodeID in den verglichenen Hierarchien haben.
- Eigenschaftsaktualisierungen – Schließt alle Knoten ein, die in den verglichenen Hierarchien unterschiedliche Werte in der angegebenen Eigenschaftsliste haben. Wählen Sie Bearbeiten aus, um Eigenschaften auszuwählen.
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 in der Registerkarte Filter eine der folgenden 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. Der Ausschlussfilter schließt Knoten aus den Exportergebnissen aus.
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 kommagetrennte 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 Primärschlüssel, der beim Ermitteln von Duplikaten verwendet wird.
- 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.
  - 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.