Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte bearbeiten > MODIFY_OBJECT

MODIFY_OBJECT

Script-Funktion: Ändert ein vorhandenes Objekt (nur Kalender, Login und Variable).

Allgemeine Informationen

Mit der Script-Funktion können ausschließlich Objekte der Objekttypen "Kalender", "Login" und "Variable" (nur statisch) geändert werden.
Definieren Sie mit der Script-Anweisung :ON_ERROR die Reaktion auf auftretende Fehler. Wie bisher können diese mit den Script-Funktionen zur Fehlerbehandlung analysieren. Standardmäßig wird das Script wird weiter prozessiert. Es besteht aber auch die Möglichkeit, die Prozessierung des Scripts abzubrechen.
Sie benötigen ein Schreibrecht auf die Objekttypen Kalender, Login und Variable, damit Sie diese anlegen können.
Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Kalender

Syntax

MODIFY_OBJECT(Object name, [Title], [Calendar keyword], [[Date format:]Date1], [[Date format:]Date2]])

Syntax	Beschreibung/Format
Objektname	Name des Kalender-Objektes. Format: Script-Literal oder Script-Variable
Titel	Titel des Kalender-Objektes. Format: Script-Literal oder Script-Variable
Kalenderbegriff	Name des Kalenderbegriffes Format: Script-Literal oder Script-Variable
Datumsformat	Formatvorgabe für das angegebene Datum.
: oder ;	Trennzeichen zwischen dem Datumsformat und Datum.
Datum1	Anfangsdatum des Gültigkeitszeitraums vom Kalenderbegriff. Angabe eines Datums, welches dem Datumsformat entspricht.
Datum2	Endedatum des Gültigkeitszeitraums vom Kalenderbegriff. Angabe eines Datums, welches dem Datumsformat entspricht.
[Datumsformat:]Datum1 und [Datumsformat:]Datum2	Beginn und Ende der Gültigkeit des Kalenderbegriffes. Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Das Kalender-Objekt wurde erfolgreich geändert. "20216" - Das Objekt '&01' kann nicht geändert werden, da es seit '&02' von dem Benutzer '&03' bearbeitet wird. "20645" - Das Objekt existiert nicht. "20670" - Das Endedatum für den Kalenderbegriff liegt vor dem Anfangsdatum.

Anmerkungen

Mit der Script-Funktion können Sie den Titel des Kalender-Objektes, sowie das Anfangs- und Endedatum eines Kalenderbegriffs ändern. Nicht verwendete Parameter lassen bestehende Kalenderdefinitionen unverändert.

Für die Behandlung von Kalenderbegriffen existieren noch folgende Script-Sprachmittel:

:SET_CALE - Fügt einem Kalenderbegriff ein Datum oder einen Zeitraum hinzu oder entfernt diese.
VALID_CALE - Prüft, ob ein Datum in einem Kalenderbegriff enthalten ist.

Beispiele

Im Beispiel wird der Gültigkeitszeitraum des Kalenderbegriffes"ARBEITSTAGE" geändert. Der Titel des Kalenders bleibt unverändert.

:SET &RET# = MODIFY_OBJECT("FIRM.CALENDAR",,"WORKDAYS","DD.MM.YYYY:01.05.2011","DD.MM.YYYY:01.05.2012")

Login

[Kalender] [Login] [Variable]

Syntax

MODIFY_OBJECT(Object name, [Title], Name, Type, Login info, [Password], [Action])

Syntax	Beschreibung/Format
Objektname	Name des Login-Objektes. Format: Script-Literal oder Script-Variable
Titel	Titel des Login-Objektes. Format: Script-Literal oder Script-Variable
Name	Name eines Agenten bzw. Backend-Systems. Format: Script-Literal oder Script-Variable Geben Sie "*" an, so gilt der Login-Eintrag für alle Agenten bzw. Systeme. Der Name von Backend-Systemen wird im Login-Objekt vom Benutzer definiert.
Typ	Hosttyp bzw. Applikation. Format: Script-Literal oder Script-Variable Erlaubte Werte: "BS2000" = Host vom Typ BS2000/OSD "GCOS8" = Host vom Typ Bull GCOS 8 "JMX" = Login-Eintrag für Java EE/JMX "MAIL" = Login-Eintrag die Mail-Schnittstelle "MPE" = Host vom Typ MPE "MVS" = Host vom Typ z/OS, MVS, z/OS "OA" = Login-Eintrag für Oracle Applications "OS400" = Host vom Typ OS/400 "PS" = Login-Eintrag für PeopleTools "R3" = Login-Eintrag für SAP "SIEBEL" = Login-Eintrag für Siebel "SQL" = Login-Eintrag für Datenbanken "UNIX" = Host vom Typ Unix, Linux, z/Linux "VMS" = Host vom Typ OpenVMS "WINDOWS" = Host vom Typ Windows Neben den aufgelisteten Plattformen der Agenten können auch alle Typen angegeben werden, die vom Administrator in der Variable UC_LOGIN_TYPES definiert wurden.
Login Info	Login-Informationen, mit denen eine Anmeldung erfolgen soll. Format: Script-Literal oder Script-Variable Das Format der Login Info ist Plattform- und Anwendungsspezifisch. Details dazu finden Sie im Kapitel "Login-Objekt".
Passwort	Passwort für die Plattform der Anwendung. Format: Script-Literal oder Script-Variable Es erfolgt keine Plausibilitätsprüfung beim Ausführen der Script-Funktion MODIFY_OBJECT.
Aktion	Aktion die ausgeführt werden soll. Erlaubte Werte: "ADD" (Standardwert), "DEL" "ADD" = Fügt den angegebenen Benutzereintrag am Ende der Liste hinzu, bzw. überschreibt einen bestehenden, mit identischen Daten für Host, Hosttyp und Login Info. "DEL" = Entfernt den angegebenen Benutzereintrag aus der Liste. Ist der Benutzereintrag in der Liste nicht vorhanden, wird dennoch kein Fehlercode erzeugt. Die Angabe eines Passwortes ist beim Löschen des Eintrages nicht relevant.

Rückgabewerte
"0" - Das Login-Objekt wurde erfolgreich geändert. "20645" - Das Objekt existiert nicht.

Kommentare

Mit der Script-Funktion können Sie den Titel, sowie die Login-Einträge eines Login-Objektes ändern.

Die Verwendung der Funktion MODIFY_OBJECT für das Login-Objekt dient vorwiegend zur automatisierten Benutzerverwaltung um z.B. extern Passwortänderungen in der Automation Engine durchzuführen.

Wird ein Agent inklusive Typ angegeben, der im Login-Objekt bereits vorhanden ist, so wird der bestehende Eintrag geändert. Stimmt Agent und Typ dabei nicht überein, so hat die Scriptzeile keine Auswirkung.

Beispiele

Im ersten Beispiel werden im Login-Objekt "LOGIN.MEIER" die Anmeldedaten für den Benutzer "meier" auf dem Host "UNIX01" gesetzt und dabei das Passwort "uc4" vergeben. Existiert der Benutzereintrag bereits, wird dabei nur das Passwort auf "uc4" gesetzt.

:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","smith","uc4","ADD")

Im folgenden Beispiel werden im Login-Objekt "LOGIN.MEIER" die Anmeldedaten für den Benutzer "meier" im Mandant "012" des SAP-Systems "SAP01" gelöscht.

:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"SAP01","R3","012,smith","","DEL")

Variable

[Kalender] [Login] [Variable]

Syntax

MODIFY_OBJECT(Object name, [Title], [Error Handling], [Data Type])

Syntax	Beschreibung/Format
Objektname	Name des Variablen-Objekts. Format: Script-Literal oder Script-Variable
Titel	Titel des Variablen-Objekts. Format: Script-Literal oder Script-Variable
Fehlerbehandlung	Behandlung wenn die Variable zur Laufzeit keinen Wert enthält. Erlaubte Werte: "E" oder "I" "E" = Es wird eine Fehlermeldung ausgegeben. "I" = Die Variable wird entsprechend ihres Variablentyps initialisiert.
Datentyp	Variablentyp. Erlaubte Werte: "String" (oder "C"), "Number" (oder „F"), "Timestamp" (oder "T"), "Time" oder "Date" "String", "C"= Text "Number", "F" = Zahl "Timestamp", "T" = Zeitstempel "Time" = Zeit "Date" = Datum Für das Variablen-Objekt XML haben nur die Spezifikationen des Datentyps "String", "C" Gültigkeit.

Rückgabewerte
"0" - Das Variable-Objekt wurde erfolgreich geändert. "20640" - Beim Datentyp wurde ein ungültiger Wert angegeben. "20645" - Das Objekt existiert nicht. "20651" - Der Datentyp kann nicht geändert werden, da sich Werte in der Variable befinden.

Anmerkungen

Mit der Script-Funktion können Sie den Titel, sowie die Fehlerbehandlung und den Datentyp eines statischen Variable-Objektes ändern.

Soll der Datentyp geändert werden, dürfen keine Werte in der Variablen gespeichert sein.

Dynamische Variablen-Objekte können mit der Script-Funktion nicht geändert werden.

Beispiele

Im Beispiel wird eine Variable geändert, so dass darin die ermittelte Anzahl von Dateien gespeichert werden kann.

:SET &RET# = MODIFY_OBJECT("OUTPUT.WEBHELP.VARA","Number of Help files with frames",,"F")

In diesem Beispiel wird die Fehlernummer nach der Ausführung des Variablen-Objekts XML ausgelesen und als Report ausgegeben:

:SET &HND# = MODIFY_OBJECT(VARA.XML.NEW.1, "TEST TITLE", E, C)
:SET &ERRNR# = SYS_LAST_ERR_NR()
:PRINT ">&ERRNR#<"
:IF &ERRNR# <> "0"
: SET &ERRINS# = SYS_LAST_ERR_INS()
: SET &MESSAGE# = GET_MSG_TXT (&ERRNR# ,&ERRINS#)
: PRINT &MESSAGE#
:ENDIF

Siehe auch:

Script-Sprachmittel	Beschreibung
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.
CREATE_OBJECT	Erstellt ein Objekt (nur Kalender, Login und Variable).
REMOVE_OBJECT	Löscht ein vorhandenes Objekt.
MOVE_OBJECT	Verschiebt ein Objekt in einen Ordner.
ACTIVATE_UC_OBJECT	Aktiviert ein Objekt.

Script-Sprachmittel - Objekte bearbeiten
Script-Sprachmittel - Fehlerbehandlung und Meldungen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

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