AE DB Change

Administratoren verwenden das Dienstprogramm AE DB Change (ucybchng), um exportierte Daten zu ändern, die aus der Datenbank mit Hilfe des Transportkoffers exportiert wurden. Ausgewählte Attribute von Objekten können geändert und Strings durch eine Script-Datei ersetzt werden, für die die AE die zwei Parameter REPLACE und REPLACE_PART zu Verfügung stellt. Dadurch wird der Prozess der Datenanpassung für die Verwendung in einem anderen AE-System oder Mandanten vereinfacht.

Dieses Thema beinhaltet Folgendes:

Übersicht der erforderlichen Schritte

  1. Verschieben Sie alle Objekte, die an den Transportkoffer angepasst werden sollen, und entladen Sie den Transportkoffer mit dem Dienstprogramm AE.DB Unload. Siehe Daten transportieren
  2. Schreiben Sie eine oder mehrere Script-Dateien, die Kommandos für Attributänderungen enthalten. Siehe unten Syntax der Script-Datei.
  3. Rufen Sie das Dienstprogramm AE DB Change mit den entsprechenden Startparametern auf. Siehe unten Dienstprogramm starten.

Stellen Sie sicher, dass die Transportdatei alle Attribute enthält, die geändert werden sollen. Sie können dies sicherstellen, indem Sie den Parameter all_entities= auf „1“ in der INI-Datei des Dienstprogramms AE DB Unload setzen:

[TRANSPORT]

all_entities=1

Wenn Sie diesen Parameter setzen, werden auch Attribute exportiert, die keine Werte enthalten.

Änderbare Objekteigenschaften

Die folgenden Links führen Sie zu Themen, die Sie darüber informieren, ob ein bestimmtes Attribut mit diesem Dienstprogramm geändert werden kann. Wenn ja, können Sie eine Script-Datei verwenden, die Kommandos enthält, die die Attribute ändern, die in der Transportdatei gespeichert sind.

Syntax der Script-Datei, die Attribute ändert

Die Automation Engine stellt die beiden Statements REPLACE und REPLACE_PART zur Verfügung, mit denen Sie eine Script-Datei für das Dienstprogramm AE DB Change erstellen können. Der Unterschied zwischen diesen Statements und ihren Strukturen wird im Folgenden beschrieben.

REPLACEObjekttyp, Name, Attribut, alter Wert, neuer Wert,

REPLACE_PARTObjekttyp, Name, Attribut, Teil des alten Wertes, neuer Wert

Sie können Kommentarzeilen in die Script-Datei einfügen. Diese Zeilen müssen mit einem Strichpunkt beginnen.

Sie können AEDB Change keine Abkürzungen zuweisen, Sie müssen vollständige Attributnamen verwenden. Verwenden Sie zum Beispiel „INT_ACCOUNT“ anstelle von „INT_ACC“.

Verwenden Sie REPLACE oder REPLACE_PART

Verwenden Sie entweder die REPLACE oder REPLACE_PARTScript-Elemente für Ihre Script-Ersetzungen. Die Unterschiede werden im Folgenden beschrieben.

REPLACE

Alter Wert wird nur dann durch Neuer Wert ersetzt, wenn Alter Wert genau dem alten Wert entspricht. Eine Ausnahme von dieser Regel sind Änderungen, die im Script eines Objekts vorgenommen werden. Dies ist vergleichbar mit der Such-/Ersatzfunktion gängiger Texteditoren. Jede Zeichenkette, die sich innerhalb einer Textzeile befindet, wird ersetzt.

REPLACE_PART

REPLACE_PART kann verwendet werden, um Teile des Alten Wertes zu ersetzen. Der angegebene Neue Wert wird dann anstelle des alten Wertes eingefügt.

Wichtig! Wenn Sie den Befehl REPLACE in Kombination mit dem Attribut SCRIPT verwenden, können Sie nur vollständige Script-Zeilen ersetzen. Das Dienstprogramm ersetzt keine Teile von Scripts. Benutze stattdessen REPLACE_PART für diesen Zweck. 

Attributwerte für "Y" und "N" ändern

Eine Ausnahme stellen Attribute, die die zulässigen Werte "Y" und "N" beinhalten, dar. Diese beiden Buchstaben können dem Dienstprogramm AE DB Change nicht zugeordnet werden. Verwenden Sie in diesem Fall die Zahl „1“ anstelle von „Y“ und „0“ anstelle von „N“.

Objektvariablen ändern

Sie können Objektvariablen modifizieren. Wählen Sie dazu den Parameter Attribute und geben Sie den Begriff „VALUE“ gefolgt von einem Doppelpunkt und dem Namen der Objektvariablen mit dem vorangestellten Zeichen „&“ an. Siehe VARA-Objekte.

Rapid Automation-Job-Attribute ändern

Sie können die spezifischen Attribute aller Rapid Automation-Jobs mit dem Dienstprogramm AE DB Change ändern. Verwenden Sie einen der folgenden Werte und ändern Sie ihn, indem Sie den Attributnamen wie folgt eingeben

Wichtig! Wenn Sie die Attribute aller Rapid Automation-Jobs oder Workflows ändern, indem Sie * als Namen für die Änderung angeben, wendet das Dienstprogramm AE DB Change Ihre Änderungen auf alle Jobs oder Workflows an, die den von Ihnen festgelegten Anforderungen entsprechen, auch wenn sie zu verschiedenen Agenten oder Agententypen gehören.

Viele Rapid Automation-Agenten enthalten eine Liste von Attributen in der Dokumentation des Agenten. Rapid Automation-Job-Attribute sind nicht in der Automation Engine-Dokumentation dokumentiert, da jeder Agent separat versioniert und nach einem anderen Zeitplan als die Automation Engine freigegeben werden.

Eine weitere Möglichkeit, die Rapid Automation-Attributnamen einschließlich ihrer Werte abzurufen, besteht darin, den folgenden Befehl in der AE-Datenbank auszuführen (ersetzen Sie den JOBNAMEN durch den tatsächlichen Objektnamen des Jobs):

select OCV_VName,ocv_value from OCV,oh where OCV_OH_Idnr=OH_Idnr and oh_name='JOBNAME'

Objektzuweisungen ändern

Sie können Objektverwendungen durch die Parameter OBJECT_USE und OBJECT_USE_ATTR des Dienstprogramms ersetzen. Sie können in den folgenden Objekttypen ersetzt werden: CALL, JOBS, EVNT, JOBP, JOBF, JSCH, JOBG, SCRI, JOBI, JOBQ, DOCU, VARA, SYNC, FILTER, CALE, LOGIN.

OBJECT_USE_ATTR ersetzt die gleichen Felder wie OBJECT_USE mit Ausnahme der Spalten der OT-Tabelle. Sie verwenden OBJECT_USE_ATTR wenn Sie ein Objekt haben, das als Attribut und als Script zugeordnet ist, da OBJECT_USE es sonst zweimal umbenennen würde.

Verwenden Sie den Namen des Objekts, der derzeit für den alten Wert verwendet wird, und den Namen des Objekts, der stattdessen für den neuen Wert verwendet werden soll.

Um die Verbindung und die Anmeldung von Objektvariablen vom Typ SQL zu ändern, können Sie die Schlüsselwörter „SQL_CONNECTION“ und „SQL_LOGIN“ für Attribute verwenden. Sie können entweder den gesamten Wert (REPLACE) oder nur einen Teil des Wertes (REPLACE_PART) ändern.

Hinweise:

Ordnernamen ändern

Dieses Dienstprogramm kann die Namen und Pfade von Ordnern ändern. Zu diesem Zweck verwenden Sie REPLACE_PART in Kombination mit dem Attribut FOLDER_NAME und geben für den Namen den vollständigen Pfad des Ordners an, der geändert werden soll. Für den alten und neuen Wert können Sie entweder einen einzelnen Ordnernamen oder einen Teil des Pfades angeben.

Mit diesem Dienstprogramm können Sie den Titel eines Ordners nicht ändern. Die Transportdatei zeigt den Ordnertitel in geschwungenen Klammern innerhalb des Pfades an (z. B.: \OBJECTS{TITLE}\TEST{}\). Die geschwungenen Klammern sind leer, wenn es keinen Titel gibt.

Wenn Sie einen Ordner innerhalb des Pfades ändern, indem Sie einen oder mehrere Ordner ersetzen, werden die Titel weiterhin auf der alten Ordnerebene verwendet.

Zum Beispiel:

Old path: \OBJECTS{TITLE1}\TEST{}\JOBS{TITLE2}
Script command: REPLACE_PART FOLD, \OBJECTS\TEST\JOBS, FOLDER_NAME, "OBJECTS", "ARCHIV\OBJ"
New path: \ARCHIV{TITLE1}\OBJ{}\TEST{TITLE2}\JOBS{}

Der neue Pfad verwendet weiterhin die Titel auf der alten Ordnerebene. Der Ordner „TEST“ hat nun einen Titel (TITLE"), obwohl er am Anfang keinen Titel hatte.

Bedingungen ändern (nur bei JOBP)

Mit diesem Dienstprogramm können Sie Bedingungen ändern. Verwenden Sie CONDITION_PARAMETER, um Pre- und/oder Post-Condition-Parameter von Aufgaben innerhalb eines Workflows zu ändern.

Beispiele

Im Job SAP.Job.2 ändert sich das SAP-Zielsystem von SAP1 auf SAP2.

REPLACE JOBS, SAP.JOB.2, SAP_DST_SYSTEM, "SAP1", "SAP2"

Der Zielrechner wechselt bei allen Dateiübertragungen mit dem Namen FT* von FSU auf FSB.

REPLACE JOBF, FT*, FT_DST_HOST, "FSU", "FSB"

Die Zeichenkette TEST wird in allen Scripts von Objekten mit dem Namen EM* durch REAL ersetzt.

REPLACE_PART *, EM*, SCRIPT, "TEST", "REAL"

Das änderbare Attribut UC100T wird in allen Objekten durch UC100E ersetzt.

REPLACE *, *, *, "UC100T", "UC100E"

Der Wert der Objektvariablen „HOST#“ des Workflows ändert sich von „unix01“ auf „unix02“.

REPLACE JOBP, MM.DAY, VALUE:HOST#, "unix01",  "unix02".

Im Job JOB.TEST.1 wird C:\Temp durch D:\Temp ersetzt.

REPLACE_PART JOBS, JOB.TEST.1, WIN_CMD, "C:\Temp", "D:\Temp"

Der Kalender ändert sich von FIRM_CALENDAR_2016 auf FIRM_CALENDAR_2017 in allen Benachrichtigungsobjektnamen, die mit MM* beginnen.

REPLACE_PART CALL, MM*, CALENDAR, "2016", "2017"

Der Name des Ordners SCHEDULE ändert sich zu SCHEDULE_WEEKDAYS.

REPLACE_PART FOLD, \MM\SCHEDULE, FOLDER_NAME, "SCHEDULE", "SCHEDULE_WEEKDAYS"

Das folgende Beispiel wechselt den Ordner SCHEDULE auf den Pfad TEST\JSCH.

REPLACE_PART FOLD, \MAWI\SCHEDULE, FOLDER_NAME, "SCHEDULE", "TEST\JSCH"

Der spezifische Parameter „OBJECT_USE“ des Dienstprogramms AE DB Change ersetzt verwendete Objekte. Das folgende Beispiel ersetzt das Sync-Objekt „SYNC1“ durch „SYNC2“ in allen Workflows, die dieses Sync-Objekt verwenden.

REPLACE_PART JOBP, *, OBJECT_USE, "SYNC1", "SYNC2"

Der spezifische Parameter „OBJECT_USE_ATTR“ des Dienstprogramms AE DB Change ersetzt verwendete Objekte mit Ausnahme von OT-Tabellenspalten. Das folgende Beispiel ersetzt „TSM.“ in Objektzuordnungen durch „TSM.V1.“.

REPLACE_PART *, TSM.*, OBJECT_USE_ATTR, "TSM.", "TSM.V1."

Das folgende Beispiel ersetzt die Verbindungs- und Anmeldedaten eines SQL-Variablenobjekts.

REPLACE VARA, VARA.SQL.TEST, SQL_CONNECTION, "CONNECTION.OLD", "CONNECTION.NEW"

REPLACE VARA, VARA.SQL.TEST, SQL_LOGIN, "LOGIN.OLD", "LOGIN.NEW"

Die folgenden Beispiele ändern den Wert der JMS-Queue von „test.tibco.queue“ auf „prod.tibco.queue“. Die erste Zeile überschreibt es in RA JMS Agent-Jobs. Die zweite Zeile überschreibt es, wenn RA JMS Agent-Jobs als Aufgaben in Workflows aufgenommen werden. Diese Syntax funktioniert für Jobs eines beliebigen Rapid Automation-Agenten. Sie müssen einfach den Attributnamen nach „CVALUE:“ und/oder „JPCVALUE:“ weglassen und geben den entsprechenden Alten Wert und Neuen Wert an.

REPLACE JOBS, *, CVALUE:queueName ,"test.tibco.queue","prod.tibco.queue"

REPLACE JOBP, *, JPCVALUE:queueName ,"test.tibco.queue","prod.tibco.queue"

Das folgende Beispiel ändert den SAP-Startmodusparameter von 1 für Sofort auf 0 für So bald wie möglich.

REPLACE JOBS,*,SAP_STARTMODE,"1","0"

Die folgenden Beispiele ändern Pre- und/oder Post-Condition-Parameter:

REPLACE JOBP, *, CONDITION_PARAMETER, "OLD_PARAMTER", "NEW_PARAMETER"

REPLACE_PART JOBP, *, CONDITION_PARAMETER, "OLD", "NEW".

Dienstprogramm starten

Starten Sie das Programm von der Kommandozeile aus mit den folgenden Parametern:

UCYBCHNG[.EXE] [-B] [-IPath and name of the INI file] -1Script File-2Transport File[-3Output File][-LE]

Parameter

Beispiel

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

Die Verarbeitung und deren Ergebnisse werden in einer Datei protokolliert, dessen Namen Sie in der INI-Datei des Dienstprogramms angeben können.

Rückgabewerte

Das Dienstprogramm gibt abhängig von der aufgetretenen Situation bestimmte Rückgabewerte nach Beendigung der Verarbeitung zurück.

Siehe auch: