MODIFY_OBJECT

Verwenden Sie die Script-Funktion MODIFY_OBJECT, um ein bestehendes Kalender-, Anmelde- oder statisches VARA-Objekt zu ändern.

Hinweise:

• Sie benötigen Schreibrechte für das Objekt, das Sie ändern möchten. Weitere Informationen finden Sie unter Automation Engine-Berechtigungen gewähren.
• Das Script-Statement bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.

Tipps:

• Standardmäßig wird die Script-Verarbeitung fortgesetzt, wenn die Änderung fehlschlägt. Verwenden Sie die Script-Anweisung :ON_ERROR, um Maßnahmen zu definieren, die im Fehlerfall ergriffen werden sollen. Weitere Informationen finden Sie unter Script-Sprachmittel zur Fehlerbehandlung.
• Verwenden Sie CREATE_OBJECT, wenn Sie ein neues Kalender-, Anmelde- oder statisches VARA-Objekt erstellen möchten.

Kalenderobjekt

Verwenden Sie die Script-Funktion MODIFY_OBJECT, um die folgenden Einstellungen eines Kalenderobjekts zu ändern:

• Titel
• Startdatum eines Kalenderereignisses
• Name eines Kalenderereignisses

Weitere Informationen finden Sie unter Kalender (CALE).

Tipps:

• :SET_CALE fügt ein Datum oder einen Zeitraum in ein Kalenderobjekt ein oder löscht es/ihn.
• VALID_CALE prüft, ob ein Datum in einem Kalenderereignis enthalten ist.

Syntax

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

Parameter

• Object name
  Name des Kalenderobjekts, das Sie ändern möchten
  Format: Script-Literal oder Script-Variable

• Title
  (Optional) Titel des Kalenderobjekts
  Format: Script-Literal oder Script-Variable

• Calendar Event
  (Optional) Name des Kalenderereignisses
  Format: Script-Literal oder Script-Variable

• Date format
  (Optional) Datumsformat für das Start- oder Enddatum des Kalenderereignisses
  Weitere Informationen zu Datumsformaten finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.
  Standardwert: JJMMTT oder JJJJMMTT
  Hinweis: Verwenden Sie „:“ oder „;“ als Trennzeichen zwischen Datumsformat und Datum.

• Date1
  (Optional) jeweiliges Startdatum des Kalenderereignisses
  Format: Script-Literal oder Script-Variable

• Date2
  (Optional) jeweiliges Startdatum des Kalenderereignisses
  Format: Script-Literal oder Script-Variable

Hinweise:

• Nicht verwendete Parameter lassen bestehende Kalenderdefinitionen unverändert.
• Wenn Sie ein Datumsformat angeben, verwenden Sie dieses Format, wenn Sie das Datum angeben.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte, wenn Sie ein Kalenderobjekt ändern:

• 0
  Das Kalenderobjekt wurde erfolgreich geändert
• 20216
  Das Objekt '&01' kann nicht geändert werden, da es seit '&02‘ vom Benutzer '&03' bearbeitet wird.
• 20645
  Das angegebene Objekt existiert nicht
• 20670
  Das Enddatum für das Kalenderereignis liegt vor dem Startdatum

Beispiel

Ein Kalenderobjekt namens FIRM.CALENDAR enthält ein Kalenderereignis namens WORKDAYS. Das folgende Script ändert das Start- und Enddatum des Kalenderereignisses. Das Script lässt den Parametertitel weg, so dass der Kalendertitel unverändert bleibt.

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

Login-Objekt

Verwenden Sie die Script-Funktion MODIFY_OBJECT, um die folgenden Einstellungen eines Login-Objekts zu ändern:

• Titel
• Login-Einträge

Weitere Informationen finden Sie unter Login (LOGIN).

Mit MODIFY_OBJECT können Sie die Verwaltung von Benutzern automatisieren, wie z.B. das externe Ändern von Automation Engine-Passwörtern.

Um einen bestehenden Eintrag zu ändern, geben Sie einen Agenten (und den Agententyp) an, der bereits im Login-Objekt vorhanden ist. Wenn der von Ihnen angegebene Agent und der Agententyp nicht übereinstimmen, hat die Script-Zeile keine Wirkung.

Syntax

MODIFY_OBJECT (Object name, [Title], Agent, Agent type, Login info, [Password], [Action])

Parameter

• Object name
  Name des Login-Objekts, das Sie ändern möchten
  Format: Script-Literal oder Script-Variable

• Title
  (Optional) Titel des Login-Objektes
  Format: Script-Literal oder Script-Variable

• Agent
  Name des Agenten
  Hinweise:

  • Verwenden Sie *, um den Login-Eintrag auf alle Agenten und Systeme anzuwenden
  • Der Name des Backend-Systems wird im Login-Objekt Ihres Benutzers definiert.
  Format: Script-Literal oder Script-Variable

• Agent type
  Agenten- oder Anwendungstyp
  Erlaubte Werte:

  • BS2000
    BS2000/OSD-Agent
  • JMX
    Login-Eintrag für Java EE/JMX
  • MAIL
    Login-Eintrag für die Mail-Schnittstelle
  • MVS
    z/OS oder MVS-Agent
  • OS400
    OS/400-Agent
  • 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
    Unix-, Linux- oder z/Linux-Agent
  • VMS
    OpenVMS-Agent
  • WINDOWS
    Windows-Agent
  Hinweis: Administratoren können in den Systemeinstellungen zusätzliche Agentenplattformen definieren. Wenn in Ihrem System weitere Agentenplattformen vorhanden sind, können Sie damit den Agententyp für MODIFY_OBJECT verwenden. Weitere Informationen finden Sie unter UC_LOGIN_TYPES - Zusätzliche Plattform- und Systemtypen für Login-Objekte definieren.

• Login info
  Login-Informationen, die im Login-Objekt gespeichert werden sollen
  Hinweis: Die Login-Informationen sind plattform- und anwendungsspezifisch. Weitere Informationen finden Sie unter Login (LOGIN).
  Format: Script-Literal oder Script-Variable

• Password
  (Optional) Passwort für die Plattform der Anwendung
  Hinweis: Es erfolgt keine Plausibilitätsprüfung beim Ausführen der Script-Funktion MODIFY_OBJECT.
  Format: Script-Literal oder Script-Variable

• Action
  (Optional) Aktion zur Verarbeitung
  Eine Aktion kann bis zu drei Passwörter pro Login-Anmeldung ändern.
  Format: Script-Literal oder Script-Variable
  Erlaubte Werte:

  • ADD
    Fügt zwischen einem und drei kommagetrennten Passwörtern hinzu
    Hinweis: Verwenden Sie ADD1, ADD2 und ADD3, um Passwörter mit Kommas hinzuzufügen.
  • ADD1, ADD2 und ADD3
    Fügt den ersten, zweiten und dritten Passworteinträge für den angegebenen Benutzer hinzu oder überschreibt einen bestehenden Eintrag mit identischen Daten für Agent, Agententyp und Anmeldeinformationen.
  • DEL1, DEL2 und DEL3
    Löscht den ersten, zweiten oder dritten Passworteintrag für den angegebenen Benutzer.
    Hinweise:
    • Die Angabe eines Passwortes ist beim Löschen des Eintrages nicht relevant.
    • Wenn das letzte Passwort in einer Berechtigung gelöscht wird, wird der gesamte Berechtigungseintrag gelöscht
    • Wenn der Benutzereintrag in der Liste nicht vorhanden ist, gibt es keinen Fehlercode.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte, wenn Sie das Login-Objekt ändern:

• 0
  Das Login-Objekt wurde erfolgreich geändert
• 20645
  Das angegebene Objekt existiert nicht

Beispiele

Ein Anmeldeobjekt namens LOGIN.SMITH enthält Anmeldeinformationen eines Benutzers namens Smith. Das folgende Script setzt zwei Passwörter für einen UNIX-Agenten für diesen Benutzer. Wenn das Login-Objekt diese Einträge bereits enthält, werden die Passwörter auf apple bzw. ninja aktualisiert.

:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","apple","uc4","ADD1")
:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","ninja","uc4","ADD2")

In dem folgenden Beispiel werden die Anmeldedaten für Smith im Mandanten 012 eines SAP-Systems namens SAP01 gelöscht. Wenn dies das letzte Passwort in der Berechtigung ist, wird der gesamte Berechtigungseintrag gelöscht.

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

Statisches VARA-Objekt

Verwenden Sie die Script-Funktion MODIFY_OBJECT, um die folgenden Einstellungen eines statischen VARA-Objekts zu ändern:

• Titel
• Fehlerbehandlung
• Datentyp

Weitere Informationen finden Sie unter VARA-Objekte.

Wichtig!

• Sie können den Datentyp nur ändern, wenn das VARA-Objekt keine Werte enthält.
• Sie können mit dieser Script-Funktion keine dynamischen VARA-Objekte ändern.

Syntax

MODIFY_OBJECT (Object name, [Title], [Error handling], [Data type])

Parameter

• Object name
  Name des VARA-Objekts, das Sie ändern möchten
  Format: Script-Literal oder Script-Variable

• Title
  (Optional) Titel des VARA-Objekts
  Format: Script-Literal oder Script-Variable

• Error handling
  (Optional) Zu ergreifende Maßnahmen, wenn das VARA-Objekt zur Laufzeit keinen Wert enthält
  Weitere Informationen finden Sie unter Scriptzugriff.
  Format: Script-Literal oder Script-Variable
  Erlaubte Werte:

  • E
    Gibt eine Fehlermeldung aus
  • I
    Initialisiert das VARA-Objekt entsprechend dem Variablentyp

• Data type
  (Optional) Variable Datentypen
  Weitere Informationen zu Datentypen finden Sie unter Datentypen und Formatierung.
  Erlaubte Werte:

  • C
    Text
    Wichtig! XML-VARA-Objekte können nur den Datentyp C haben.
  • N
    Zahl
  • TS
    Zeitstempel
  • TI
    Zeit
  • D
    Datum

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte, wenn Sie ein statisches VARA-Objekt ändern:

• 0
  Das VARA-Objekt wurde erfolgreich geändert
• 20640
  Der angegebene Wert des Datentyps ist ungültig
• 20645
  Das angegebene Objekt existiert nicht
• 20651
  Der Datentyp kann nicht geändert werden, da das VARA-Objekt Werte enthält

Beispiel

Das folgende Script liest die Fehlernummer nach der Ausführung eines XML-VARA-Objekts aus und gibt den Fehler im Aktivierungsreport aus:

: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: