MODIFY_OBJECT

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

Hinweise:

  • Sie benötigen Schreibrechte für das Objekt, das Sie ändern möchten. Weitere Informationen finden Sie unterAutomation Engine-Berechtigungen gewähren.
  • Die Script-Anweisung 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-Elemente zur Fehlerbehandlung.
  • Verwenden Sie CREATE_OBJECT, wenn Sie ein neues Kalender-, Login- 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 ermöglicht Ihnen, ein Datum oder einen Zeitraum in ein Kalenderereignis einzutragen oder daraus zu löschen.
  • VALID_CALE prüft, ob ein Datum in einem Kalenderereignis enthalten ist.

Syntax

MODIFY_OBJECT (Objektname, [Titel], [Kalenderereignis] [,[Datumsformat:]Datum1] [,[Datumsformat:]Datum2]])

Parameter

  • Objektname
    Name des zu ändernden Kalenderobjekts
    Format: Script-Literal oder Script-Variable

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

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

  • Datumsformat
    (Optional) Datumsformat für das Start- oder Enddatum für das Kalenderereignis
    Weitere Informationen über Datumsformate finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.
    Standard: YYMMDD oder YYYYMMDD
    Hinweis: Verwenden Sie : oder ; als Trennzeichen zwischen Datumsformat und Datum.

  • Datum1
    (Optional) Jeweiliges Startdatum des Kalenderereignisses
    Format: Script-Literal oder Script-Variable

  • Datum2
    (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, sodass 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 Kalenderobjekts zu ändern:

  • Titel
  • Login-Einträge

Weitere Informationen finden Sie unter Login (LOGIN).

MODIFY_OBJECT ermöglicht Ihnen, die Verwaltung von Benutzern zu automatisieren, wie z. B. das externe Ändern von Automation Engine-Passwörtern.

Syntax

MODIFY_OBJECT (Objektname, [Titel], Agent, Agententyp, Login-Info, [Passwort], [Aktion])

Parameter

  • Objektname
    Name des zu ändernden Login-Objekts
    Format: Script-Literal oder Script-Variable

  • Titel
    (Optional)Titel des Login-Objekts
    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

  • Agententyp
    Typ des Agenten oder der Anwendung
    Zulässige 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
    • SQL
      Login-Eintrag für Datenbanken
    • UNIX
      Unix, Linux oder z/Linux Agent
    • VMS
      OpenVMS Agent
    • WINDOWS
      Windows Agent
    Hinweise:

    • Aus technischer Sicht ist es möglich, ungültige Werte für den Agententyp einzufügen. Stellen Sie als Benutzer oder Designer dieser Script-Funktion sicher, dass dieser Wert gültig ist.
    • Um einen bestehenden Eintrag zu ändern, geben Sie einen Agenten (und den entsprechenden 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. Dies kann beispielsweise vorkommen, wenn Sie einen WINDOWS-Agenten verwenden, aber den Agententyp UNIX in dieser Script-Funktion definieren.
    • Die Login-Informationen werden nicht aktualisiert, wenn sie sich von einem vorhandenen Eintrag unterscheiden.
    • 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 angeben. Weitere Informationen finden Sie unter UC_LOGIN_TYPES – Definition zusätzlicher Plattform- und Systemtypen für Login-Objekte.

  • Login-Info
    Anmeldeinformationen, die im Login-Objekt gespeichert werden
    Hinweis: Login-Informationen sind spezifisch für Plattform und Anwendung. Weitere Informationen finden Sie unter Login (LOGIN).
    Format: Script-Literal oder Script-Variable

  • Passwort
    (Optional) Passwort für die Plattform der Anwendung
    Hinweis: Bei der Ausführung der Script-Funktion MODIFY_OBJECT gibt es keine Plausibilitätsprüfung.
    Format: Script-Literal oder Script-Variable

  • Aktion
    (Optional) Zu verarbeitende Aktion
    Eine Aktion kann bis zu drei Passwörter pro Login-Daten ändern.
    Format: Script-Literal oder Script-Variable
    Zulässige Werte:

    • ADD
      Fügt zwischen einem und drei kommagetrennte Passwörter hinzu
      Hinweis: Verwenden Sie ADD1, ADD2 und ADD3, um Passwörter hinzuzufügen, die Kommas enthalten.
    • ADD1, ADD2 und ADD3
      Fügt den ersten, zweiten und dritten Passworteintrag für den angegebenen Benutzer hinzu oder überschreibt einen bestehenden Eintrag mit identischen Daten für Agent, Agententyp und Login-Informationen.
    • 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" , "uc4" , "apple" , "ADD1" )
:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","uc4","ninja","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 Benutzerdefinierte 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 (Objektname, [Titel], [Fehlerbehandlung], [Datentyp])

Parameter

  • Objektname
    Name des zu ändernden VARA-Objekts
    Format: Script-Literal oder Script-Variable

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

  • Fehlerbehandlung
    (Optional) Aktion, die ergriffen wird, wenn das VARA-Objekt zur Laufzeit keinen Wert enthält
    Weitere Informationen finden Sie unter Script-Zugriff.
    Format: Script-Literal oder Script-Variable
    Zulässige Werte:

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

  • Datentyp
    (Optional) Variablendatentyp
    Weitere Informationen über Datentypen finden Sie unter Datentypen und Formatierung.
    Zulässige 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:

Related Script Elements

CREATE_OBJECT

MODIFY_UC_OBJECT