Manuel des Scripts Automation Engine > Organisation fonctionnelle > Modification d'objets > CREATE_OBJECT

CREATE_OBJECT

Fonction de script : Crée un objet (uniquement Calendrier, Login et Variable).

Informations générales

Seuls les objets de type calendrier, Login et variable (uniquement statique) peuvent être créés avec cette fonction de script.
Utilisez l'instruction de script :ON_ERROR pour définir la réaction en cas d'erreur. Il est également possible d'analyser les messages d'erreur avec les fonctions de script pour traiter des erreurs (reportez-vous aux liens en bas de page). Toutefois, vous avez également la possibilité de l'interrompre.
Vous avez besoin d'un droit d'écriture sur les types d'objet Calendrier, Login et Variable pour les créer.
L'instruction de script permet d'écrire les transactions ouvertes dans la base de données AE.

Calendrier

Syntaxe

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

Syntaxe	Description / format
Type d'objet	Description courte du type d'objet. Valeur autorisée : CALE
Nom d'objet	Nom de l'objet. Format : littéral de script ou variable de script
Dossier	Nom du dossier dans lequel l'objet doit être créé. Format : littéral de script ou variable de script
Titre	Titre de l'objet. Format : littéral de script ou variable de script

Codes retour
"0" - L'objet Calendrier a été créé. "20644" - Un objet du même nom existe déjà. "20710" - Le nom de l'objet contient au moins un caractère non autorisé.

Commentaires

Un calendrier est créé dans le dossier indiqué. Si ce paramètre n'est pas indiqué ou que le dossier n'existe pas, l'objet est enregistré dans <défaut>.

Exemples

Dans le premier exemple, l'objet "AGENDA_ENTREPRISE2003" est créé dans <défaut>.

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

Login

[[Calendrier][Login][Variable]

Syntaxe

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

Syntaxe	Description / format
Type d'objet	Description courte du type d'objet. Valeur autorisée : LOGIN
Nom d'objet	Nom de l'objet. Format : littéral de script ou variable de script
Dossier	Nom du dossier dans lequel l'objet doit être créé. Format : littéral de script ou variable de script
Titre	Titre de l'objet. Format : littéral de script ou variable de script

Codes retour
"0" - L'objet Login a été créé. "20644" - Un objet du même nom existe déjà. "20710" - Le nom de l'objet contient au moins un caractère non autorisé.

Commentaires

Un objet Login est créé dans le dossier indiqué. Si ce paramètre n'est pas indiqué ou que le dossier n'existe pas, l'objet est enregistré dans <défaut>.

Exemples

Dans le premier exemple, l'objet "LOGIN.DUPONT" est créé dans <défaut>.

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

Dans le deuxième exemple, un objet Login est créé dans le dossier "LOGIN_STD".

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

Variable

[Calendrier] [Login] [Variable]

Syntaxe

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

Syntaxe	Description / format
Type d'objet	Description courte du type d'objet. Valeur autorisée : STATIQUE, XML Pour créer un objet Variable statique du type XML, saisissez son abréviation.
Nom d'objet	Nom de l'objet. Format : littéral de script ou variable de script
Dossier	Nom du dossier dans lequel l'objet doit être créé. Format : littéral de script ou variable de script
Titre	Titre de l'objet. Format : littéral de script ou variable de script
Traitement des erreurs	Traitement lorsque la variable ne contient pas de valeur pour le temps d'exécution. Valeurs autorisées : "E" ou "I" (par défaut) "E" = Un message d'erreur est émis. "I" = La variable va être initialisée en fonction de son type.
Type de données	Type de variable Valeurs possibles : "String" (ou "C"), "Number" (ou "F"), "Timestamp" (ou "T"), "Time" ou "Date" Valeurs autorisées : "C" (par défaut), "F" ou "T" "String", "C"= Texte "Number", "F" = Nombre "Timestamp", "T" = Marque horaire ''Heure" = Heure "Date" = Date
Validité	Plage de validité. Valeurs autorisées : "", "LIBRE" (par défaut), "HON", "JBN", "JPN", "JPS", "USN", "USS" "" = Pas de clé "FREI" = Au choix "HON" = Hôte - pour chaque nom d'hôte "JBN" = job - chaque nom de job "JPN" = Nom de workflow - pour chaque nom de workflow "JPS" = Session de Workflow - pour chaque activation de workflow "USN" : utilisateur : pour chaque nom d'utilisateur "USS" : Session utilisateur : pour chaque session utilisateur

Codes retour
"0" - L'objet Variable a été créé. "20644" - Un objet du même nom existe déjà. "20710" - Le nom de l'objet contient au moins un caractère non autorisé.

Commentaires

Cette fonction de script permet de créer uniquement des objets variable statiques. Reportez-vous à la description de l'onglet Attributs des objets variable.

Une variable est créée dans le dossier indiqué. Si ce paramètre n'est pas indiqué ou que le dossier n'existe pas, l'objet est enregistré dans <défaut>. N'indiquez pas tous les paramètres facultatifs pour utiliser les valeurs par défaut "Texte" (pour le type de données), "Index libre" (pour la plage de validité) et "Valeur initiale" (pour Clé introuvable).

Exemple

L'exemple créé une variable dans laquelle le nombre de fichiers déterminé peut être enregistré.

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

Rubriques connexes :

Elément de script	Description
:ON_ERROR	Détermine la réaction à certaines erreurs ou messages d'éléments de script.
REMOVE_OBJECT	Supprime un objet disponible.
MODIFY_OBJECT	Modifie un objet disponible (uniquement Calendrier, Login et Variable).
MOVE_OBJECT	Déplace un objet dans un dossier.
ACTIVATE_UC_OBJECT	Active un objet.

Eléments de script - Traitement des objets
Eléments de script - Traitement des erreurs et messages

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle