CREATE_OBJECT

Verwenden Sie die Script-Funktion CREATE_OBJECT, um Objekte zu erstellen. Mit der Funktion können Sie den Objekttyp, den Namen des Objekts und den Ordner angeben, in dem das Objekt angelegt werden soll. Mit dieser Script-Funktion können Sie folgende Objekttypen erstellen:

• Kalender (CALE)
• Login (LOGIN)
• STATIC VARA-Objekte

Syntax

Kalender- und Login-Objekte:

CREATE_OBJECT (Objekttyp, Objektname, [Ordner], [Titel] )

Statische VARA-Objekte:

CREATE_OBJECT (Objekttyp, Objektname, [Ordner], [Titel], [Fehlerbehandlung], [Datentyp], [Gültigkeit] )

Parameter

• CREATE_OBJECT
  Erstellt das angegebene Objekt

• Objekttyp
  Kurzbezeichnung des Objekttyps, den Sie erstellen möchten
  Zulässige Werte: CALE, LOGIN oder VARA

• Objektname
  Name des Objekts
  Format: Script-Literal oder Script-Variable

• Ordner
  (Optional) Name des Ordners, in dem Sie das Objekt erstellen
  Format: Script-Literal oder Script-Variable
  Hinweis: Wenn Sie keinen Ordner angeben, oder wenn der angegebene Ordner nicht existiert, wird das Objekt in <No folder> erstellt.

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

• Fehlerbehandlung
  (Optional, nur statische VARA-Objekte) Aktion, die ausgeführt wird, wenn das VARA-Objekt zur Laufzeit keinen Wert enthält
  Zulässige Werte:

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

• Datentyp
  (Optional, nur statische VARA-Objekte) Variablentyp des VARA-Objekts
  Zulässige Werte:

  • C
    String (Standard)
  • F
    Zahl
  • T
    Zeitstempel

• Gültigkeit
  (Optional, nur statische VARA-Objekte) Gültigkeitsbereich des VARA-Objekts
  Weitere Informationen:STATIC VARA-Objekte
  Zulässige Werte:

  • *
    Kein Gültigkeitsbereich
  • FREE
    Frei gewählt (Standard)
  • HON
    Host - je Host-Name
  • JBN
    Job - je Jobname
  • JPN
    Workflow - je Workflow-Name
  • JPS
    Workflow-Session - je Workflow-Aktivierung
  • USN
    Benutzer - je Benutzer-Name
  • USS
    Benutzer-Session - je Benutzer-Session

Hinweise:

• Um Kalender-, Login- oder VARA-Objekte zu erstellen, benötigen Sie Schreibrechte (W) für die jeweiligen Objekttypen.
• Diese Script-Anweisung bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.
• (Nur VARA-Objekte) Standardwerte für Fehlerbehandlung, Datentyp und Gültigkeit werden verwendet, wenn Sie diese optionalen Parameter nicht angeben. Weitere Informationen über die Attribute von VARA-Objekten finden Sie unter Benutzerdefinierte VARA-Objekte.

Tipp: Fügen Sie Zeilen in Ihr Script ein, um zu definieren, was im Fehlerfall passiert, und um Ihnen bei der Fehleranalyse zu helfen. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• 0
  Das Objekt wurde erfolgreich erstellt.
• 20644
  Ein Objekt mit dem angegebenen Namen existiert bereits.
• 20710
  Der Objektname enthält ungültige Zeichen.

Beispiele

Das folgende Beispiel erstellt ein Kalenderobjekt mit dem Namen FIRM.CALENDAR2020 in <Kein Ordner>:

:SET &RET# = CREATE_OBJECT("CALE","FIRM.CALENDAR2020",,"Company calendar for 2020")

Das folgende Beispiel erstellt ein Login-Objekt mit dem Namen LOGIN.SMITH in <Kein Ordner>:

:SET &RET# = CREATE_OBJECT("LOGIN","LOGIN.SMITH",,"Standard-Logins")

Das folgende Beispiel erstellt ein Login-Objekt in einem Ordner mit dem Namen LOGIN_DIR.

:SET &NEW# = CREATE_OBJECT("LOGIN","LOGIN.SMITH","LOGIN_DIR",)

Das folgende Beispiel erstellt ein VARA-Objekt zum Speichern der abgerufenen Anzahl von Dateien:

:SET &RET# = CREATE_OBJECT("VARA","OUTPUT.WEBHELP.VARA","VARIABLE/STATS","Number of Help Files","I","F","FREE")

Siehe auch: