MODIFY_OBJECT

Utilisez la fonction de script MODIFY_OBJECT pour modifier un objet Calendrier, Login ou VARA statique existant.

Remarques :

• Il vous faut l'accès en écriture à l'objet que vous voulez modifier. Pour plus d'informations, voir Accorder des autorisations Automation Engine.
• L'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.

Conseils :

• Par défaut, le traitement du script continue si la modification échoue. Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre dans ce cas. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.
• Utilisez CREATE_OBJECT pour créer un nouvel objet Calendrier, Login ou VARA statique.

Objet Calendrier

La fonction de script MODIFY_OBJECT vous permet de modifier les paramètres suivants d'un objet Calendrier :

• Titre
• Date de début d'un événement Calendrier
• Date de fin d'un événement Calendrier

Pour plus d'informations, voir Calendriers (CALE).

Conseils :

• :SET_CALE vous permet d'ajouter ou de supprimer une date ou une période dans un événement Calendrier.
• VALID_CALE vous permet de vérifier si une date est incluse dans un événement Calendrier.

Syntaxe

MODIFY_OBJECT (Object name, [Title], [Calendar Event] [,[Date format:]Date1] [,[Date format:]Date2]])

Paramètres

• Object name
  Nom de l'objet Calendrier à modifier
  Format : littéral de script ou variable de script

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

• Calendar Event
  (Optionnel) Nom de l'événement Calendrier
  Format : littéral de script ou variable de script

• Date format
  (Optionnel) Format de date pour la date de début ou de fin de l'événement Calendrier
  Pour plus d'informations, voir Formats de date, d'heure et de période dans les scripts.
  Défaut : AAMMJJ ou AAAAMMJJ
  Remarque : Utilisez : ou ; comme séparateur entre le format de date et la date.

• Date1
  (Optionnel) Date de début de l'événement Calendrier, respectivement
  Format : littéral de script ou variable de script

• Date2
  (Optionnel) Date de début de l'événement Calendrier, respectivement
  Format : littéral de script ou variable de script

Remarques :

• Les paramètres inutilisés laissent les définitions de calendrier existantes inchangées.
• Si vous spécifiez un format de date, utilisez ce format.

Codes retour

Lorsque vous modifiez un objet Calendrier, les codes retour de la fonction de script sont les suivants :

• 0
  L'objet Calendrier a été modifié avec succès.
• 20216
  L'objet '&01' ne peut pas être modifié car il est édité par l'utilisateur '&03' depuis le '&02'.
• 20645
  L'objet spécifié n'existe pas
• 20670
  La date de fin de l'événement Calendrier précède la date de début.

Exemple

Un objet Calendrier appelé FIRM.CALENDAR contient un événement Calendrier appelé WORKDAYS. Le script suivant modifie les dates de début et de fin de l'événement Calendrier. Le paramètre de titre n'étant pas dans le script, le titre du calendrier reste donc inchangé.

:SET &RET# = MODIFY_OBJECT("FIRM.CALENDAR",,"WORKDAYS","DD.MM.YYYY:01.05.2011","DD.MM.YYYY:01.05.2012")

Objet Login

Utilisez la fonction de script MODIFY_OBJECT pour modifier les paramètres suivants d'un objet Login :

• Titre
• Entrées de login

Pour plus d'informations, voir Login (LOGIN).

MODIFY_OBJECT vous permet d'automatiser l'administration des utilisateurs, par exemple en changeant les mots de passe Automation Engine en externe.

Pour modifier une entrée existante, spécifiez un agent (et le type d'agent) qui est déjà disponible dans l'objet Login. Si l'agent et le type d'agent que vous spécifiez ne correspondent pas, la ligne de script n'a aucun effet.

Syntaxe

MODIFY_OBJECT (Object name, [Title], Agent, Agent type, Login info, [Password], [Action])

Paramètres

• Object name
  Nom de l'objet Login à modifier
  Format : littéral de script ou variable de script

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

• Agent
  Nom de l'agent
  Remarques :

  • Utilisez * pour appliquer l'entrée de login à tous les agents et systèmes
  • Le nom des systèmes Backend est défini dans l'objet Login de votre utilisateur.
  Format : littéral de script ou variable de script

• Agent type
  Type d'agent ou d'application
  Valeurs autorisées :

  • BS2000
    Agent BS2000/OSD
  • JMX
    Entrée de login pour Java EE/JMX
  • MAIL
    Entrée de login pour l'interface de messagerie
  • MVS
    Agent z/OS ou MVS
  • OS400
    Agent OS/400
  • PS
    Entrée de login pour PeopleTools
  • R3
    Entrée de login pour SAP
  • SIEBEL
    Entrée de login pour Siebel
  • SQL
    Entrée de login pour les bases de données
  • UNIX
    Agent Unix, Linux ou z/Linux
  • VMS
    Agent OpenVMS
  • WINDOWS
    Agent Windows
  Remarque : Les administrateurs peuvent définir des plateformes d'agents supplémentaires dans les paramètres système. Si des plateformes d'agents supplémentaires sont disponibles dans votre système, vous pouvez les utiliser pour spécifier le type d'agent pour MODIFY_OBJECT. Pour plus d'informations, voir UC_LOGIN_TYPES - Définir des types de systèmes et de plateformes supplémentaires pour les objets Login.

• Infos login
  Informations de connexion à stocker dans l'objet Login
  Remarque : Les informations de connexion sont spécifiques à la plateforme et à l'application. Pour plus d'informations, voir Login (LOGIN).
  Format : littéral de script ou variable de script

• Password
  (Optionnel) Mot de passe pour la plateforme de l'application
  Remarque : La plausibilité n'est pas vérifiée lors de l'exécution de la fonction de script MODIFY_OBJECT.
  Format : littéral de script ou variable de script

• Action
  (Optionnel) Action à traiter
  Une action peut modifier jusqu'à trois mots de passe par identifiant de connexion.
  Format : littéral de script ou variable de script
  Valeurs autorisées :

  • ADD
    Ajoute entre un et trois mots de passe séparés par des virgules
    Remarque : Utilisez ADD1, ADD2 et ADD3 pour ajouter des mots de passe incluant des virgules.
  • ADD1, ADD2, et ADD3
    Ajoute la première, la deuxième et la troisième entrée de mot de passe, respectivement, pour l'utilisateur spécifié, ou remplace une entrée existante par des données identiques pour l'agent, le type d'agent et les informations de connexion.
  • DEL1, DEL2, et DEL3
    Supprime la première, la deuxième ou la troisième entrée du mot de passe, respectivement, pour l'utilisateur spécifié.
    Remarques :
    • Le mot de passe n'est pas nécessaire pour supprimer l'entrée.
    • Lorsque le dernier mot de passe d'un identifiant de connexion est supprimé, toute l'entrée de l'identifiant de connexion est supprimée
    • Si l'entrée utilisateur n'est pas dans la liste, il n'y a pas de code d'erreur.

Codes retour

Lorsque vous modifiez un objet Login, les codes retour de la fonction de script sont les suivants :

• 0
  L'objet Login a été modifié avec succès
• 20645
  L'objet spécifié n'existe pas

Exemples

Un objet Login appelé LOGIN.SMITH contient les informations de connexion d'un utilisateur appelé Smith. Le script suivant définit deux mots de passe pour un agent UNIX pour cet utilisateur. Si l'objet Login contient déjà ces entrées, les mots de passe sont actualisés en apple et ninja, respectivement.

:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","apple","uc4","ADD1")
:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","ninja","uc4","ADD2")

L'exemple suivant illustre la suppression les données de connexion pour Smith dans le client 012 d'un système SAP appelé SAP01. S'il s'agit du dernier mot de passe de l'identifiant de connexion, toute l'entrée de l'identifiant de connexion est supprimée.

:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"SAP01","R3","012,smith","","DEL1")

Objet VARA statique

Utilisez la fonction de script MODIFY_OBJECT pour modifier les paramètres suivants d'un objet VARA statique :

• Titre
• Error Handling
• Type de données

Pour plus d'informations, voir Objets VARA.

Important !

• Vous ne pouvez modifier le type de données que lorsque l'objet VARA ne contient aucune valeur.
• Cette fonction de script ne permet pas de modifier les objets VARA dynamiques.

Syntaxe

MODIFY_OBJECT (Object name, [Title], [Error handling], [Data type])

Paramètres

• Object name
  Nom de l'objet VARA à modifier
  Format : littéral de script ou variable de script

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

• Error Handling
  (Optionnel) Action à entreprendre lorsque l'objet VARA n'inclut pas de valeur au moment de l'exécution
  Pour plus d'informations, voir Accès au script.
  Format : littéral de script ou variable de script
  Valeurs autorisées :

  • E
    Envoie un message d'erreur
  • I
    Initialise l'objet VARA en fonction du type de variable

• Data type
  (Optionnel) Type de données Variable
  Pour plus d'informations sur les types de données, voir Formats et types de données.
  Valeurs autorisées :

  • C
    Texte
    Important ! Le type de données des objets XML VARA ne peut être que C.
  • N
    Nombre
  • TS
    Horodatage
  • TI
    Heure
  • D
    Date

Codes retour

Lorsque vous modifiez un objet VARA statique, les codes retour de la fonction de script sont les suivants :

• 0
  L'objet VARA a été modifié avec succès
• 20640
  La valeur du type de données spécifié n'est pas valide
• 20645
  L'objet spécifié n'existe pas
• 20651
  Le type de données ne peut pas être modifié car l'objet VARA contient des valeurs

Exemple

Le script suivant lit le numéro d'erreur après l'exécution d'un objet XML VARA et consigne l'erreur dans le rapport d'activation :

: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

Voir aussi :