AE DB Change

Administratoren verwenden das AE-Dienstprogramm DB Change (ucybchng), um Daten zu ändern, die mit Hilfe des Transportkoffers aus der Datenbank exportiert wurden. Sie können ausgewählte Objektattribute ändern und Strings ersetzen, indem Sie eine bestimmte Script-Datei verwenden, für die die AE die beiden Anweisungen REPLACE und REPLACE_PART bereitstellt. Es sind spezielle Schlüssel verfügbar, mit denen Sie die Verwendung von Objekten in einem bestimmten Objekttyp ersetzen, die Verbindung oder die Anmeldung von SQL-Variablenobjekten ändern können. Sie können auch Objektvariablen, Ordnernamen, Bedingungswerte in Workflows oder die Attribute von RA-Jobs ändern. Dies macht es einfach, Daten anzupassen, die in einem anderen AE-System oder Mandanten verwendet werden sollten.

Ü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 die Befehle enthalten, die die relevanten Attribute ändern. Siehe unten im Abschnitt Syntax der Script-Datei, die Attribute ändert
3. Rufen Sie das Dienstprogramm AE DB Change mit den entsprechenden Startparametern auf. Siehe unten im Abschnitt Starten des Dienstprogramms

Stellen Sie sicher, dass die Transportdatei alle Attribute enthält, die geändert werden sollen. Setzen Sie dazu den Parameter all_entities= in der INI-Datei des Dienstprogramms AE DB Unload auf "1". In diesem Fall werden alle Attribute exportiert, selbst die, die keine Werte enthalten. Weitere Informationen finden Sie in der INI-Datei von Utility DB Unload

[TRANSPORT]
all_entities=1

Änderbare Objektattribute

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.

• FileTransfer-Attribute
• Benachrichtigungsattribute
• Script-Attribute
• Jobobjekt-Attribute
• Remote Task Manager-Attribute
• VARA-Objekt-Attribute
• Ereignisobjektattribute
• Jobgruppen-Attribute
• Schedule-Attribute
• Workflow-Attribute

Syntax der Script-Datei, die Attribute ändert

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

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

REPLACE_PART Objekttyp, Name, Attribut, Teil des alten Wertes, neuer Wert

• Objekttyp
  Die Kurzbezeichnung des Objekttyps.
  Format: Ohne Anführungszeichen.
  Sie können die Platzhalterzeichen "*" und "?" verwenden. "*" steht für eine beliebige Anzahl von Zeichen und "?" für genau ein Zeichen. Dies bedeutet, dass Sie die REPLACE -Anweisung für alle Objekttypen verwenden können.
• Name
  Der Name des Objekts, das geändert werden soll.
  Format: Ohne Anführungszeichen
  Wichtig!
  • Objekte: Sie müssen den Pfad nicht angeben, da Objektnamen innerhalb eines Mandanten eindeutig sind.
  • Ordner: Geben Sie den gesamten Pfad an (z. B. \TEST\Workflow). Lassen Sie die geschweiften Klammern weg, die Ordnertitel darstellen. Wenn Sie diese in den Pfad einbeziehen, werden Ihre Änderungen ignoriert.
    
• Attribut
  Der Name des Attributs, das geändert werden soll, oder ein spezieller Schlüssel.
  Format: Ohne Anführungszeichen
  Sie können das Platzhalterzeichen * verwenden. Das heißt, dass Sie die REPLACE-Anweisung für alle Attribute verwenden können.
  Informationen zu den Objektattributen einschließlich ihrer zulässigen Werte finden Sie auf der Seite "Attribute"
Informationen zu speziellen Schlüsseln finden Sie unten in Spezielle Schlüssel für den Attributparameter
Für Rapid Automation-Attribute finden Sie nachfolgend in Schlüssel, die Rapid Automation Attribute ändern

• Alter Wert
  Der Attributwert, der geändert werden soll.
  Format: Verwenden Sie einfache (') oder doppelte Anführungszeichen ("). Dies ist wichtig, wenn Sie Strings ersetzen, die Anführungszeichen enthalten. Sie können hier keine Platzhalterzeichen verwenden.
  Es wird zwischen Groß- und Kleinbuchstaben unterschieden, die im Wert verwendet werden. Es wird nicht unterschieden, ob sie innerhalb eines Scripts ersetzt werden.
  
• Neuer Wert
  Der Attributwert, der den alten Wert ersetzen soll.
  Format: Verwenden Sie einfache (') oder doppelte Anführungszeichen ("). Dies ist wichtig, wenn Sie Strings ersetzen, die Anführungszeichen enthalten. Sie können hier keine Platzhalterzeichen verwenden.
  

Hinweise:

• 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.
• Der Host, den Sie in einem Jobobjekt ersetzen, muss vom gleichen BS-Typ wie der ursprüngliche Host sein.

Beispiel

Das folgende Beispielscript ändert den vorhandenen Agenten von AGENT.WIN.1 in AGENT.WIN2 im Jobobjekt MY.JOB.

REPLACE JOBS, MY.JOB, HOST, "AGENT.WIN.1", "AGENT.WIN.2"

REPLACE und REPLACE_PART verwenden

Sie können das Script-Element REPLACE, oder das Script-Element REPLACE_PART zum Ersetzen in Ihren Scripts verwenden. Die Unterschiede sind im Folgenden beschrieben.

REPLACE

Der Parameter Alter Wert wird nur durch Neuer Wert ersetzt, wenn beide Formate genau identisch sind. Eine Ausnahme zu dieser Regel sind Änderungen, die im Script eines Objekts vorgenommen werden. Dies ist vergleichbar mit der Suchen/Ersetzen-Funktion gängiger Texteditoren. Jeder String, der sich innerhalb einer Textzeile befindet, wird ersetzt.

REPLACE_PART

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

Wichtig! Wenn Sie den REPLACE-Befehl in Kombination mit dem Attribut SCRIPT verwenden, können Sie nur vollständige Script-Zeilen ersetzen. Das Dienstprogramm ersetzt keine Teile von Scripts. In diesem Fall würden Sie REPLACE_PART verwenden. 

Ändern der Attributwerte "Y" und "N"

Die Werte "Y" und "N" können dem Dienstprogramm AE DB Change nicht zugewiesen werden. Verwenden Sie in diesem Fall die Zahl "1" anstelle von "Y" und "0" anstelle von "N".

Beispiele

Im Job JOB. TEST.1 wird der Pfad C:\Temp durch D:\Temp unter Verwendung des Objektattributs WIN_CMD ersetzt.

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

Der Host WIN1 wird in allen Ereignisobjekten durch WIN2 ersetzt. Das Attribut, das für diesen Zweck verwendet wird, ist HOST.

REPLACE EVNT, *, HOST, "WIN1", "WIN2"

Der Zielhost ändert sich in allen FileTransfers des Namens FT* mithilfe des Objektattributs FT_DST_HOST von FSU zu FSB.

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

Der String TEST wird in allen Scripts von Objekten mit dem Namen EM+ unter Verwendung des SCRIPT-Objektattributs durch REAL ersetzt. Weitere Informationen finden Sie unter SCRIPTScript-Attribute.

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

Der Kalender ändert sich von FIRM_CALENDAR_2019 in FIRM_CALENDAR_2020 in allen Benachrichtigungsobjektnamen, die mit MM* beginnen. Das Attribut CALENDAR wird verwendet.

REPLACE_PART CALL, MM*, CALENDAR, "2019", "2020"

Im Job SAP.Job.2 ändert sich das SAP-Zielsystem von SAP1 in SAP2 unter Verwendung des Objektattributs SAP_DST_SYSTEM.

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

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

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

Spezielle Schlüssel für den Attributparameter

Statt ein Objektattribut im Attributparameter Ihrer Script-Datei anzugeben, können Sie einige spezielle Schlüssel verwenden.

Schlüssel, die die Verwendung von Objekten in einem bestimmten Objekttyp ersetzen

• OBJECT_USE and OBJECT_USE_ATTR
  Diese Schlüssel können in CALL, JOBS, EVNT, JOBP, JOBF, JSCH, JOBG, SCRI, JOBI, JOBQ, DOCU, VARA, SYNC, FILTER, CALE und LOGIN verwendet werden.

OBJECT_USE_ATTR ersetzt die gleichen Felder wie OBJECT_USE, mit Ausnahme der OT-Tabellenspalten (SCRIPT, PSCRIPT, OSCRIPT) in der Datenbank. Sie verwenden OBJECT_USE_ATTR, wenn Sie ein Objekt haben, das als Attribut UND als Script zugewiesen ist. In diesem Fall würde OBJECT_USE veranlassen, dass das Objekt zweimal umbenannt wird.

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

Beispiele

Das folgende Beispiel ersetzt die Verwendung des Jobobjekts JOB1 durch JOB2 in allen (*) Workflows (JOBP), die dieses Objekt verwenden.

REPLACE JOBP, *, OBJECT_USE, "JOB1", "JOB2"

Das folgende Beispiel ändert die Verwendung von Objekten mit einem Namensteil TSM. nach Objekten, wobei TSM. in allen Objekten, die mit TSM.* beginnen, durch TSM.V1 ersetzt wird.

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

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"

Schlüssel, die die Verbindung oder die Anmeldung von SQL-Variablenobjekten ändern

• SQL_CONNECTION und SQL_LOGIN
  Sie können entweder den vollständigen Wert mit der REPLACE-Anweisung oder nur einen Teil des Werts mit der REPLACE_PART-Anweisung ändern.

Beispiele

Sie können REPLACE oder REPLACE_PART verwenden, um die Verwendung des Verbindungsobjekts CONN.PG1 durch CON2.PG2 in allen JOBS-Objekten zu ersetzen, die mit dem Objektnamen SQL.JOB.PG.* übereinstimmen.

REPLACE JOBS, SQLJOB.PG.*, SQL_CONNECTION, "CONN.PG1", "CONN.PG2"

REPLACE_PART JOBS, SQLJOB.PG.*, SQL_CONNECTION, "PG1", "PG2"

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"

Hinweise:

• Wenn eine Script-Datei das gleiche Attribut mehrmals ändert, müssen Sie immer den Originalwert als Parameter für den alten Wert verwenden. Dies liegt daran, dass das System die Zeilen immer aus der Quelltransportdatei liest, wenn es ein Attribut ändert, und nicht aus der Ausgabedatei.
• Ereignisprozess: Sie können das PSCRIPT-Attribut verwenden, um die Seite Ereignisprozess von Ereignissen zu ändern. Weitere Informationen finden Sie unter Ereignisobjektattribute

Schlüssel, der Objektvariablen ändert

• VALUE gefolgt von einem Doppelpunkt und dem Namen der Objektvariable mit einem führenden &-Zeichen
  Weitere Informationen finden Sie unter Benutzerdefinierte VARA-Objekte.

  Beispiel

  Der Wert der Objektvariablen HOST# des Workflows MM.DAY ändert sich unix01 auf unix02.

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

Schlüssel, die Rapid Automation Attribute ändern

• CVALUE gefolgt von einem Doppelpunkt und dem Namen des Rapid Automation-Attributs
  Dieser Schlüssel ändert die Attribute von Rapid Automation-Jobs.

• JPCVALUE gefolgt von einem Doppelpunkt und dem Namen des Rapid Automation-Attributs
  Dieser Schlüssel ändert die Attribute von Rapid Automation-Jobs in Workflow-Aufgaben, wenn die Standardwerte des Jobs auf Workflow-Ebene überschrieben wurden.

  Beispiele
  Die folgenden Beispiele ändern den Wert der JMS-Queue von test.tibco.queue auf prod.tibco.queue. Die erste Zeile dieses Beispiels ändert den Wert  in RA JMS Agent-Jobs. Die zweite Zeile überschreibt ihn, wenn RA JMS Agent-Jobs als Aufgaben in Workflows aufgenommen werden. Sie können diese Syntax für die Jobs aller Rapid Automation-Agenten verwenden. Passen Sie einfach den Teil nach CVALUE: und/oder JPCVALUE: und CVALUE: an und geben Sie 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"

  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 der Attribute in ihrer spezifischen Dokumentation des Rapid Automation-Agenten. Sie werden nicht in der AWA-Dokumentation dokumentiert, weil jeder Agent seinen eigenen Release-Zyklus hat, der nicht den Automation Engine-Versionen von entsprechen muss.

  Eine andere Möglichkeit, die Rapid Automation-Attributnamen einschließlich ihrer Werte abzurufen, besteht in der Ausführung des folgenden Befehls in der AE-Datenbank. Ersetzen Sie JOBNAME 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'

Schlüssel, der Ordnernamen ändert

• FOLDER_NAME
  

Dieses Dienstprogramm kann die Namen und Pfade von Ordnern ändern. Zu diesem Zweck verwenden Sie REPLACE_PART in Kombination mit dem Schlüssel 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.

Beispiel

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

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

Der Name des Ordners SCHEDULE ändert sich zu SCHEDULE_WEEKDAYS.

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

Mit diesem Dienstprogramm können Sie den Titel eines Ordners nicht ändern. Die Transportdatei zeigt den Ordnertitel in geschweiften Klammern innerhalb des Pfades an (z. B.: \OBJECTS{TITLE}\TEST{}\). Die geschweiften 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.

Beispiel

Alter Pfad: \OBJECTS{TITLE1}\TEST{}\JOBS{TITLE2}
Script-Befehl: REPLACE_PART FOLD, \OBJECTS\TEST\JOBS, FOLDER_NAME, "OBJECTS", "ARCHIV\OBJ"
Neuer Pfad: \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.

(Nur JOBP) Schlüssel, die Bedingungswerte ändern

• CONDITION_PARAMETER
  Dieser Schlüssel ändert Vor- und/oder Nachbedingungsparameter von Aufgaben innerhalb eines Workflows.
  

Beispiele

Die folgenden Beispiele ändern Vor- und/oder Nachbedingungsparameter.
Hinweis: Wenn der Parameterwert OLD_PARAMTER in Ihren Bedingungen mehrmals vorhanden ist, werden alle geändert:

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

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

Starten des Dienstprogramms

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

UCYBCHNG[.EXE] [-B] [-IPfad und Name der INI-Datei] -1Script-Datei-2Transport-Datei[-3Ausgabedatei][-LE]

Parameter

• -B
  Startet das Programm im Batch-Modus.
• -I
  Dient zur Angabe des Pfads und des Namens der INI-Datei. Für die Dateien sind vollständige Pfadangaben erforderlich.
• -L
  Wird verwendet, um die Sprache der Logdatei zu bestimmen.
• -1
  Ihre Script-Datei, die die Änderungsbefehle enthält
• -2
  Die  Transportdatei, die die Objekte enthält, die geändert werden sollen. UC_DATA.TXT wird standardmäßig verwendet.
• -3
  Die Ausgabedatei, die die geänderten Daten enthält

Wenn Sie diesen Parameter nicht definieren, ist der Name der Ausgabedatei gleich dem Namen der Eingabedatei plus der Endung "_New". Beispielsweise wird die Eingabedatei "uc_transport" zur Ausgabedatei "uc_transport_New".

Beispiel

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

Die Verarbeitung und die dazugehörigen Ergebnisse werden in einer Datei protokolliert, deren Namen Sie in der INI-Datei des Dienstprogramms angeben können, siehe Utility DB Change.

Rückgabewerte

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

• 0
  Das Dienstprogramm hat die Verarbeitung erfolgreich beendet.
• 1
  Die Transportdatei existiert nicht oder kann nicht geöffnet werden.
• 2
  Die Script-Datei existiert nicht oder kann nicht geöffnet werden.
• 3
  Die Transport- und die Script-Datei sind nicht vorhanden oder können nicht geöffnet werden.
• 4
  Die Ausgabedatei kann nicht geöffnet werden.
• 5
  Die Script-Datei enthält einen Fehler (siehe Log-Datei).
• 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:

• Startparameter - Dienstprogramme
• Daten transportieren
• Datenbankbereiche