Administratorhandbuch > Dienstprogramme > AE DB Change > Änderung von exportierten Daten

AE DB Change

Änderung von exportierten Daten

Die meisten Objekte, die mit dem Transportkoffer weitergegeben werden, können nach dem Export aus der Datenbank mit dem Dienstprogramm AE DB Change verändert werden. Es ist möglich, ausgewählte Attribute von Objekten sowie beliebige Zeichenfolgen aus deren Scripts zu manipulieren. Damit können Sie mit geringem Aufwand Daten an ein anderes Automation Engine System oder an einen anderen Mandanten anpassen.

Sie finden bei den Beschreibungen zu den Attributen eine Spalte namens Zugriffe. Ist dort Change-Programm vermerkt, kann das Attribut mit dem Dienstprogramm verändert werden. Dies geschieht über eine Scriptdatei, die beim Programmaufruf übergeben wird. Sie enthält Anweisungen mit denen die Attribute, die sich in der Transportdatei befinden, angepasst werden.

Auch die Namen der Ordner lassen sich mit dem AE DB Change ändern. Das anzugebende Attribut heißt in diesem Fall FOLDER_NAME.

Achten Sie darauf, dass die Transportdatei alle Attribute enthält, die geändert werden sollen. Dies stellen Sie sicher indem Sie in der INI-Datei des Dienstprogramm AE DB Unload den folgenden Parameter auf "1" setzen:

[TRANSPORT]
all_entities=1

Dieser bewirkt, dass auch jene Attribute exportiert werden, die keinen Wert enthalten.

Ablauf

  1. Geben Sie alle Objekte, die Sie anpassen wollen in den Transportkoffer.
  2. Entladen Sie den Transportkoffer mit dem Dienstprogramm AE DB Unload.
  3. Schreiben Sie eine oder mehrere Scriptdateien, die Anweisungen für die Attributänderung enthalten.
  4. Rufen Sie das Dienstprogramm AE DB Change mit den Startparametern auf.

Programmaufruf

Das Dienstprogram AE DB Change ist im Batchmodus zu starten, was die Verarbeitung auch großer Datenmengen im Hintergrund erlaubt. Die Verarbeitung und deren Ergebnisse werden in einer Log-Datei protokolliert. Der Name dieser Datei einschließlich der Pfadangabe ist in der INI-Datei des Programms hinterlegt.

Rufen Sie das Programm über die Kommandozeile mit folgenden Parametern auf:

UCYBCHNG[.EXE] [-B] [-IPfad und Name der INI-Datei] -1Scriptdatei-2Transportdatei[-3Ausgabedatei][-LD]

Der Parameter -B startet das Programm im Batchmodus. Mit -I können Sie den Pfad und Namen der INI-Datei definieren. Die Dateien müssen mit komplettem Pfad angegeben werden. Mit dem Parameter -L legen Sie die Sprache fest, in der die Verarbeitung protokolliert wird (Standardwert ist E für Englisch).

Wenn Sie den dritten Parameter nicht angeben, wird der Name für die Ausgabedatei aus dem der Eingabedatei plus der Bezeichnung „_Neu“ bzw. „_New“ gebildet (je nachdem, welche Sprache Sie mit dem Parameter -L definiert haben). Bsp: Für die Eingabedatei „uc_transport“ wird die Ausgabedatei „uc_transport_Neu“ angelegt.

Beispiel

ucybchng -b -1c:\transport\uc_change.txt -2c:\transport\uc_transport.txt -3c:\transport\uc_transport_new.txt

Rückgabewerte

Das Dienstprogramm liefert nach der Beendigung der Verarbeitung je nach eingetretener Situation einen speziellen Rückgabewert.

Rückgabewert

Beschreibung

0

Das Dienstprogramm hat die Verarbeitung erfolgreich beendet.

1

Die Transportdatei ist nicht vorhanden oder lässt sich nicht öffnen.

2

Die Scriptdatei ist nicht vorhanden oder lässt sich nicht öffnen.

3

Weder die Transport- noch die Scriptdatei sind vorhanden oder lassen sich öffnen.

4

Die Ausgabedatei lässt sich nicht zum Schreiben öffnen.

5 Die Scriptdatei enthält einen Fehler (siehe Logdatei).
21400 EXIT_CODE_NOT_A_TRANSPORT_FILE
21424 EXIT_CODE_NO_DATA_IN_TRANSPORT_FILE
21432 EXIT_CODE_INVALID_VERSION_TRANSPORT_CASE
21433 EXIT_CODE_TOO_FEW_PARAMETERS

 

Siehe auch:

Syntax der Script-Datei
Genereller Ablauf - Transportkoffer

Veränderbare Attribute

Startparameter

Aufbau der INI-Datei, AE DB Change

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH