Änderung von exportierten Daten

AE DB Change

AE DB Client Copy

---

 Syntax der Scriptdatei

Für die Erstellung einer Scriptdatei für das Dienstprogramm AE DB Change stehen die Script-Anweisungen REPLACE und REPLACE_PART zur Verfügung.

REPLACE Objekttyp, Name, Attribut, Alter Wert, Neuer Wert

REPLACE_PART Objekttyp, Name, Attribut, Teil des alten Werts, Neuer Wert

Eine Scriptdatei kann auch Kommentarzeilen enthalten. Diese müssen dann mit einem Semikolon beginnen.

Es ist nicht möglich, Abkürzungen an AE DB Change zu übergeben. Es müssen immer die vollständigen Attributnamen verwendet werden (z.B. "INT_ACCOUNT" und nicht "INT_ACC").

Beachten Sie, dass AE DB Change nicht dazu verwendet werden kann, die Pre- und Postconditions von Aufgaben (bzw. ihre Werte) innerhalb eines Workflow-Objektes zu ändern.

Verwendung von REPLACE und REPLACE_PART

Für Ersetzungen, die Sie in Ihren Scripts vornehmen möchten, stehen Ihnen die beiden Script-Sprachmittel REPLACE und REPLACE_PART zur Verfügung. Die Unterschiede werden nachstehend erläutert.

REPLACE

Alter Wert wird nur bei exakter Übereinstimmung durchNeuer Wert ersetzt. Eine Ausnahme stellt das Ändern im Script eines Objektes dar. Das funktioniert wie das Suchen und Ersetzen in einem Texteditor. Es wird jede gefundene Zeichenfolge innerhalb der Textzeilen ersetzt.

Statt dem doppelten Hochkomma (") können Sie für Alter Wert und Neuer Wert auch das einfache Hochkomma (') verwenden. Das ist besonders dann notwendig, wenn in einer zu ersetzenden Zeichenfolge ein doppeltes Hochkomma vorkommt.

REACE_PART

Mit REPLACE_PART ist die Ersetzung eines Teils von Alter Wert möglich. Der angegebene Neue Wert wird anstelle dieses alten Wertes eingesetzt.

Statt dem doppelten Hochkomma (") können Sie für Teil des alten Werts und Neuer Wert auch das einfache Hochkomma (') verwenden. Das ist besonders dann notwendig, wenn in einer zu ersetzenden Zeichenfolge ein doppeltes Hochkomma vorkommt.

Bei der Verwendung des Befehls REPLACE im Zusammenhang mit dem Attribut SCRIPT können nur ganze Scriptzeilen ersetzt werden! Um nur Teile des Scripts zu ersetzen, müssen Sie REPLACE_PART verwenden. 

Ändern von Attributwerten für "Y" und "N"

Eine Besonderheit gilt für Attribute, die als erlaubten Wert "Y" und "N" aufweisen. Beide Buchstaben können dem AE DB Change nicht übergeben werden! Verwenden Sie anstelle von "Y" die Zahl "1" und für "N" die Zahl "0".

Ändern von Objektvariablen

Das Dienstprogramm ist auch in der Lage, Objektvariablen zu ändern. Geben Sie beim Parameter Attribut die Bezeichnung "VALUE" gefolgt von einem Doppelpunkt und dem Namen der Objektvariable inklusive einem führendem "&" an.

Ändern der Jobattribute für Rapid Automation

Sie haben außerdem die Möglichkeit, die spezifischen Attribute von RA-Jobs mittels AE DB Change zu ändern. Verwenden Sie in diesem Fall eine der folgenden Möglichkeiten: 

Beim Ändern der Attribute aller Rapid Automation-Jobs oder Workflows mithilfe von * als Name für die Änderungen führt das Dienstprogramm AE DB Change die Änderungen in allen Jobs und Workflows durch, welche die definierten Anforderungen erfüllen, sogar wenn die Jobs und Workflows zu anderen Agenten oder Agententypen gehören.

Viele Rapid Automation (RA)-Agenten enthalten: 

• Tooltip-Texte, welche die Attributnamen anzeigen, wenn Sie mit der Maus über ein Feld im UserInterface fahren.
• Eine Liste der Attribute in der Dokumentation des jeweiligen Agenten. Die Jobattribute der RA-Agenten sind deshalb nicht in der AE-Dokumentation beschrieben, weil die Automation Engine und die RA-Agenten unterschiedliche Versionierungs- und Releasezyklen haben.

Es gibt eine weitere Möglichkeit, die RA-Attributnamen inklusive ihrer Werte zu ermitteln. Führen Sie hierzu den folgenden Befehl in der AE-Datenbank aus (ersetzen Sie JOBNAME durch den tatsächlichen Objektnamen Ihres Jobs):

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

Ändern von Objektzuweisungen

Mit dem Parameter OBJECT_USE des Dienstprogrammes AE DB Change ist es auch möglich, Objektverwendungen zu ersetzen. Bei folgenden Objekttypen sind Ersetzungen verwendeter Objekte möglich: "CALL", "JOBS", "EVNT", "JOBP", "JOBF", "JSCH", "JOBG","SCRI", "JOBI", "JOBQ", "DOCU", "VARA", "SYNC", "FILTER", "CALE", "LOGIN", "CPIT".
Als alter Wert ist der Name des aktuell verwendeten Objektes anzugeben und als neuer Wert der Name des Objektes, der stattdessen eingetragen werden soll.

Um die Verbindung und das Login von Variablen-Objekten mit dem Typ SQL zu ändern, verwenden Sie die Schlüsselwörter "SQL_CONNECTION" und "SQL_LOGIN" für Attribut. Dabei kann entweder der komplette Wert (REPLACE) oder nur ein Teil des Wertes (REPLACE_PART) geändert werden.

 Wird dasselbe Attribut durch eine Script-Datei mehrfach geändert, muss als "Alter Wert" immer der ursprüngliche Wert angegeben werden. Bei einer Attributänderung werden die Zeilen immer aus der Quell-Transportdatei und nicht aus der Ausgabedatei gelesen.

Um das !Script von Ereignissen zu ändern, verwenden Sie das Attribut PSCRIPT.

Ändern von Ordnernamen

Das Dienstprogramm kann auch den Namen bzw. Pfad von Ordnern ändern. Dabei ist REPLACE_PART in Zusammenhang mit dem Attribut FOLDER_NAME zu verwenden und als Name der komplette Pfad des zu ändernden Ordners anzugeben. Für den alten und neuen Wert kann entweder ein einzelner Ordnername oder auch ein Teil-Pfad angegeben werden.

Ab Version 9 gibt besteht die Möglichkeit einen Titel für Ordner zu vergeben. In der Transportdatei wird der Ordnertitel innerhalb des Pfad in geschwungenen Klammern angezeigt (z.B.: \OBJECTS{TITLE}\TEST{}\).
Ist kein Titel vorhanden, so besitzen die geschwungenen Klammern neben dem Ordnernamen keinen Inhalt.

Es ist nicht möglich, den Titel von Ordnern über das Change-Programm zu ändern!

Ändern Sie einen Ordner innerhalb des Pfades durch einen oder mehrere andere Ordner, so werden die Titel pro Ordner-Ebene auch für den neuen Pfad übernommen.

Beispiel:
Alter Pfad: \OBJECTS{TITLE1}\TEST{}\JOBS{TITLE2}
Script-Anweisung: REPLACE_PART FOLD, \OBJECTS\TEST\JOBS, FOLDER_NAME, "OBJECTS", "ARCHIV\OBJ"
Neuer Pfad: \ARCHIV{TITLE1}\OBJ{}\TEST{TITLE2}\JOBS{}

Dadurch, dass die Titel und deren Position im Pfad beibehalten wird, besitzt nun der Ordner "TEST" einen Titel (TITLE), obwohl dieser ursprünglich keinen Titel hatte.

Beachten Sie, dass der vollständige Pfad (Name) in der Script-Datei ohne geschwungene Klammern anzugeben ist! Ansonsten werden keine Änderungen durchgeführt.

Beispiele

Im Job mit Namen SAP.JOB.2 wird das SAP-Zielsystem von SAP1 auf SAP2 geändert.

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

In allen FileTransfers mit Namen FT* wird der Zielhost von FSU auf FSB geändert.

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

In allen Objekten mit Namen EM* wird im Script die Zeichenkette TEST durch ECHT ersetzt.

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

In allen Objekten wird in allen änderbaren Attributen UC100T durch UC100E ersetzt.

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

Im Workflow namens "MAWI.TAG wird der Wert der Objektvariable "HOST#" von "unix01" auf "unix02" geändert.

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

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

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

In allen Benachrichtigungs-Objekten, deren Name mit MAWI* beginnt, wird der Kalender von FIRMENKALENDER_2003 auf FIRMENKALENDER_2004 geändert.

REPLACE_PART CALL, MM*, CALENDAR, "2003", "2004"

Der Name des Ordners SCHEDULE wird auf SCHEDULE_WOCHENTAGS geändert.

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

In folgendem Beispiel wird der Ordner SCHEDULE auf den Pfad TEST\JSCH umgesetzt.

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

Mit dem Parameter OBJECT_USE des Dienstprogrammes AE DB Change ist es auch möglich, Objektverwendungen zu ersetzen. In diesem Beispiel wird in allen Workflows, die das Sync-Objekt "SYNC1" verwenden, die Ersetzung durch "SYNC2" vorgenommen.

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

Folgendes Beispiel ersetzt die Verbindung und das Login eines SQL Variablen-Objektes.

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 ihn in JMS-Jobs. Die zweite Zeile überschreibt ihn, wenn JMS-Jobs als Aufgaben in Workflows enthalten sind. Diese Syntax kann für die Job von allen RA-Agenten verwendet werden, Sie müssen nur den Namen für Attribut nach "CVALUE:" und/oder "JPCVALUE:" austauschen und den korrekten Alten Wert und Neuen Wert angeben.

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 Startmodus-Parameter von 1 für Sofort auf 0 für Sobald wie möglich.

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

Siehe auch:

Genereller Ablauf - Transportkoffer
Änderung von exportierten Daten
Aufbau der INI-Datei, AE DB Change