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

CREATE_OBJECT

Script-Funktion: Erstellt ein 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) erstellt 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 analysiert werden. 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

CREATE_OBJECT(Object Type, Object Name, [Folder], [Title])

Syntax	Beschreibung/Format
Anwendung	Kurzbezeichnung des Objekttyps. Einzig gültiger Wert: CALE
Objektname	Name des Objektes Format: Script-Literal oder Script-Variable
Ordner	Name des Ordners, in welchem das Objekt erstellt werden soll. Format: Script-Literal oder Script-Variable
Titel	Titel des Objektes Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Das Kalender-Objekt wurde erfolgreich angelegt. "20644" - Ein Objekt mit dem angegebenen Namen existiert bereits. "20710" - Der Objektname enthält ein oder mehrere ungültige Zeichen.

Anmerkungen

Ein Kalender wird in dem angegebenen Ordner angelegt. Wird dieser Parameter nicht angegeben oder der Ordner existiert nicht, so wird das Objekt in <Kein Ordner> gespeichert.

Beispiele

Im ersten Beispiel wird das Objekt "FIRMENKALENDER2003" in <Kein Ordner> erstellt.

:SET &RET# = CREATE_OBJECT("CALE","FIRM.CALENDAR2003",,"Firm calendar for 2003")

Login

[Kalender] [Login] [Variable]

Syntax

CREATE_OBJECT(Object Type, Object Name, [Folder], [Title])

Syntax	Beschreibung/Format
Anwendung	Kurzbezeichnung des Objekttyps. Einzig gültiger Wert: LOGIN
Objektname	Name des Objektes Format: Script-Literal oder Script-Variable
Ordner	Name des Ordners, in welchem das Objekt erstellt werden soll. Format: Script-Literal oder Script-Variable
Titel	Titel des Objektes Format: Script-Literal oder Script-Variable

Rückgabewerte
"0" - Das Login-Objekt wurde erfolgreich angelegt. "20644" - Ein Objekt mit dem angegebenen Namen existiert bereits. "20710" - Der Objektname enthält ein oder mehrere ungültige Zeichen.

Anmerkungen

Ein Login-Objekt wird in dem angegebenen Ordner angelegt. Wird dieser Parameter nicht angegeben oder der Ordner existiert nicht, wird das Objekt in <Kein Ordner> gespeichert.

Beispiele

Im ersten Beispiel wird das Objekt "LOGIN.MEIER" im <Kein Ordner> erstellt.

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

Im zweiten Beispiel wird ein Login-Objekt im Order "LOGIN_STD"angelegt.

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

Variable

[Kalender] [Login] [Variable]

Syntax

CREATE_OBJECT(Object Type, Object Name, [Folder], [Title], [Error Handling], [Data Type], [Validity])

Syntax	Beschreibung/Format
Anwendung	Kurzbezeichnung des Objekttyps. Erlaubter Wert: STATISCH, XML Um ein statisches Variablen-Objekt zu erstellen, geben Sie dessen Kurzbezeichnung ein.
Objektname	Name des Objektes. Format: Script-Literal oder Script-Variable
Ordner	Name des Ordners, in welchem das Objekt erstellt werden soll. Format: Script-Literal oder Script-Variable
Titel	Titel des Objektes Format: Script-Literal oder Script-Variable
Fehlerbehandlung	Behandlung, wenn die Variable zur Laufzeit keinen Wert enthält. Erlaubte Werte: "E" oder "I" (Standardwert) "E" = Es wird eine Fehlermeldung ausgegeben. "I" = Die Variable wird entsprechend ihres Variablentyps initialisiert.
Datentyp	Variablentyp Mögliche Werte: "String" (oder "C"), "Number" (oder "F"), "Timestamp" (oder "T"), "Time" oder "Date" Erlaubte Werte: "C" (Standardwert), "F" oder "T" "String", "C"= Text "Number", "F" = Zahl "Timestamp", "T" = Zeitstempel "Time" = Zeit "Date" = Datum
Gültigkeit	Gültigkeitsbereich. Erlaubte Werte: "", "FREI" (Standardwert), "HON", "JBN", "JPN", "JPS", "USN", "USS" "" = Kein Gültigkeitsbereich "FREI" = Frei gewählt "HON" = Host - je Host-Name "JBN" = Aufgabe - je Aufgabenname "JPN" = Workflow-Name - je Workflow Name "JPS" = Workflow-Session - je Workflow Aktivierung "USN" = Benutzer - je Benutzer-Name "USS" = Benutzer-Session - je Benutzersitzung

Rückgabewerte
"0" - Das Variablen-Objekt wurde erfolgreich angelegt. "20644" - Ein Objekt mit dem angegebenen Namen existiert bereits. "20710" - Der Objektname enthält ein oder mehrere ungültige Zeichen.

Anmerkungen

Mit dieser Script-Funktion können nur statische Variablen-Objekte angelegt werden. Für mehr Informationen dazu siehe die Beschreibung der Registerkarte Attribute von Variablen-Objekten.

Eine Variable wird in dem angegebenen Ordner angelegt. Wird dieser Parameter nicht angegeben oder der Ordner existiert nicht, wird das Objekt in <Kein Ordner> gespeichert. Geben Sie alle optionalen Parameter nicht an, so werden die Standardwerte "Text" (für den Datentyp), "Frei gewählt" (für den Gültigkeitsbereich) und "Initialwerte" (für Key nicht gefunden) verwendet.

Beispiel

Im Beispiel wird eine Variable erstellt, in der die ermittelte Anzahl von Dateien gespeichert werden kann.

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

Siehe auch:

Script-Sprachmittel	Beschreibung
:ON_ERROR	Legt die Reaktion auf bestimmte Fehler bzw. Meldungen von Script-Sprachmitteln fest.
REMOVE_OBJECT	Löscht ein vorhandenes Objekt.
MODIFY_OBJECT	Ändert ein vorhandenes Objekt (nur Kalender, Login und Variable).
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