CREATE_OBJECT

Utilisez la fonction de script CREATE_OBJECT pour créer des objets. Cette fonction vous permet de spécifier le type d'objet, le nom de l'objet et le dossier de création de l'objet. Cette fonction de script vous permet de créer les types d'objets suivants :

• Calendriers (CALE)
• Login (LOGIN)
• Objets VARA STATIC

Syntaxe

Objets Calendrier et Login :

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

Objets Variable statiques :

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

Paramètres

• CREATE_OBJECT
  Crée l'objet spécifié

• Object Type
  Description courte du type d'objet à créer
  Valeurs autorisées : CALE, LOGIN ou VARA

• Object Name
  Nom de l'objet.
  Format : littéral de script ou variable de script

• Folder
  (Optionnel) Nom du dossier de création de l'objet
  Format : littéral de script ou variable de script
  Remarque : Si vous ne spécifiez pas de dossier ou si le dossier spécifié n'existe pas, l'objet est créé dans <défaut>.

• Title
  (Optionnel) Titre de l'objet
  Format : littéral de script ou variable de script

• Error Handling
  (Optionnel, objets Variable statique uniquement) Action à entreprendre lorsque la variable ne contient pas de valeur à l'exécution
  Valeurs autorisées :

  • E
    Envoie un message d'erreur
  • I
    Initialise l'objet Variable selon le type de variable (défaut)

• Data Type
  (Optionnel, objets Variable statique uniquement) Type de variable de l'objet Variable
  Valeurs autorisées :

  • C
    Chaîne de caractères (par défaut)
  • F
    Nombre
  • T
    Horodatage

• Validity
  (Optionnel, objets Variable statique uniquement) Plage de validité de l'objet Variable
  Pour plus d'informations : Objets VARA STATIC
  Valeurs autorisées :

  • *
    Pas de plage de validité
  • FREE
    Sélection libre (par défaut)
  • HON
    Hôte : chaque nom d'hôte
  • JBN
    Job : chaque nom de job
  • JPN
    Workflow : chaque nom de workflow
  • JPS
    Session de Workflow : chaque activation de workflow
  • USN
    Utilisateur : chaque nom d'utilisateur
  • USS
    Session utilisateur : chaque session d'utilisateur

Remarques :

• Pour créer des objets Calendrier, Login ou Variable, il vous faut les privilèges d'écriture (W) pour les types d'objets correspondants.
• Cette instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.
• (Objets Variable uniquement) Si vous ne spécifiez pas ces paramètres optionnels, ce sont les valeurs par défaut pour Traitement des erreurs, Type de données et Validité qui sont utilisées. Pour plus d'informations sur les attributs d'objets Variable, voir Objets VARA.

Conseil : Incluez des lignes dans votre script pour définir les actions à entreprendre en cas d'erreur et vous permettre d'analyser les erreurs. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.

Codes retour

Cette fonction de script a les codes retour suivants :

• 0
  Objet créé avec succès.
• 20644
  Il existe déjà un objet avec le nom spécifié.
• 20710
  Le nom de l'objet contient des caractère non autorisés.

Exemples

L'exemple suivant illustre la création d'un objet Calendrier nommé FIRM.CALENDAR2020 dans <Défaut> :

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

L'exemple suivant illustre la création d'un objet Login nommé LOGIN.SMITH dans <Défaut> :

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

L'exemple suivant illustre la création d'un objet Login dans un dossier nommé LOGIN_DIR.

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

L'exemple suivant illustre la création d'un objet Variable pour stocker le nombre de fichiers extraits :

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

Voir aussi :