Fonction de script : Modifie un objet existant (uniquement Calendrier, Login et Variable).
Informations générales
[Calendrier] [Login] [Variable]
MODIFY_OBJECT(Object name, [Title], [Calendar keyword], [[Date format:]Date1], [[Date format:]Date2]])
Syntaxe |
Description / format |
---|---|
Nom d'objet |
Nom de l'objet Calendrier. |
Titre |
Titre de l'objet Calendrier. |
Règle de calendrier |
Nom de la règle de calendrier. |
Format de date |
Format prédéfini de la date indiquée. |
: ou ; |
Séparateur entre le format de date et la date. |
Date1 |
Date de début de la période de validité de l'entrée de calendrier. |
Date2 |
Date de fin de la période de validité de l'entrée de calendrier. |
[Format date:]Date1 |
Début et fin de la validité de l'entrée de calendrier. |
Codes retour |
---|
"0" - L'objet Calendrier a été modifié. |
La fonction de script permet de modifier le titre de l'objet calendrier ainsi que la date de début et de fin d'une règle de calendrier.Les paramètres inutilisés laissent les définitions de calendrier existantes inchangées.
Les règles de calendrier peuvent être gérées à l'aide des éléments de script suivants :
:SET_CALE - Ajoute ou supprime une règle de calendrier, une date ou une période.
VALID_CALE - Vérifie si une date est contenue dans une règle de calendrier.
Dans l'exemple, la période de validité de la règle de calendrier"JOURS_OUVRES" est modifiée. Le titre du calendrier reste inchangé.
:SET &RET# = MODIFY_OBJECT("FIRM.CALENDAR",,"WORKDAYS","DD.MM.YYYY:01.05.2011","DD.MM.YYYY:01.05.2012")
[[Calendrier][Login][Variable]
MODIFY_OBJECT(Object name, [Title], Name, Type, Login info, [Password], [Action])
Syntaxe |
Description / format |
---|---|
Nom d'objet |
Nom de l'objet Login. |
Titre |
Titre de l'objet Login. |
Nom |
Nom d'un Agent ou d'un système Backend. Si vous indiquez "*", la saisie de login s'applique à tous les agents ou systèmes. Le nom des systèmes Backend est défini par l'utilisateur dans l'objet Login. |
Type |
Type d'hôte ou application. Valeurs autorisées : "BS2000" = Hôte de type BS2000/OSD Outre les plateformes des agents listées, tous les types qui ont été définis par l'administrateur dans la variable UC_LOGIN_TYPES peuvent aussi être indiqués. |
Info. Login |
Informations de Login avec lesquelles la connexion doit avoir lieu. Le format du login est propre à la plateforme et à l'application. Vous trouverez des détails à ce sujet au chapitre "Objet Login". |
Mot de passe |
Mot de passe pour la plateforme de l'application. La plausibilité n'est pas vérifiée lors de l'exécution de la fonction de script MODIFY_OBJECT. |
Action |
Action qui doit être effectuée. Valeurs autorisées : "ADD" (valeur par défaut), "DEL" "ADD" = Ajoute la saisie d'utilisateur indiquée à la fin de la liste ou remplace celle qui existe par des données identiques pour l'hôte, le type d'hôte et les infos de login. "DEL" = Supprime la saisie d'utilisateur indiquée de la liste. Si la saisie d'utilisateur ne se trouve pas dans la liste, aucun code d'erreur n'est généré. L'indication d'un mot de passe ne s'applique pas à la suppression de la saisie. |
Codes retour |
---|
"0" - L'objet Login a été modifié. |
La fonction de script permet de modifier le titre ainsi que les valeurs de connexion d'un objet Login.
L'utilisation de la fonction MODIFY_OBJECT pour l'objet Login sert principalement à la gestion automatisée des utilisateurs, par exemple pour effectuer des modifications externes de mot de passe dans Automation Engine.
Si un agent indiqué avec son type est déjà disponible dans l'objet Login, l'entrée existante est modifiée. Si l'agent et le type ne correspondent pas, la ligne de script n'a aucun effet.
Dans le premier exemple, les données de connexion pour l'utilisateur "henri" sont définies dans l'objet Login "LOGIN.HENRI" sur l'hôte "UNIX01" et le mot de passe "uc4" est attribué. Si la saisie d'utilisateur existe déjà, seul le mot de passe est défini sur "uc4".
:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"UNIX01","UNIX","smith","uc4","ADD")
Dans l'exemple suivant, les données de connexion dans l'objet Login "LOGIN.HENRI" pour l'utilisateur "henri" sont supprimées dans le client "012" du système SAP "SAP01".
:SET &RET# = MODIFY_OBJECT("LOGIN.SMITH",,"SAP01","R3","012,smith","","DEL")
[Calendrier] [Login] [Variable]
MODIFY_OBJECT(Object name, [Title], [Error Handling], [Data Type])
Syntaxe |
Description / format |
---|---|
Nom d'objet |
Nom de l'objet Variable. |
Titre |
Titre de l'objet Variable. |
Traitement des erreurs |
Traitement lorsque la variable ne contient pas de valeur pour le temps d'exécution. Valeurs autorisées : "E" ou "I" "E" = Un message d'erreur est émis. |
Type de données |
Type de variable. Valeurs autorisées : ''Chaîne" (ou "C"), ''Nombre" (ou "N"), ''Marque horaire" (ou "T"), ''Heure" ou "Date" ''Chaîne", "C"= Texte Seule l'indication du type de données ''Chaîne'', ''C'' est autorisée pour l'objet Variable XML. |
Codes retour |
---|
"0" - L'objet Variable a été modifié. |
La fonction de script permet de modifier le titre ainsi que la gestion des erreurs et le type de données d'un objet variable statique.
Si le type de données doit être modifié, aucune valeur ne doit être enregistrée dans la Variable.
Les objets variable dynamiques ne peuvent pas être modifiés avec cette fonction de script.
Dans l'exemple, une variable est modifiée pour que le nombre de fichiers déterminé puisse y être enregistré.
:SET &RET# = MODIFY_OBJECT("OUTPUT.WEBHELP.VARA","Number of Help files with frames",,"F")
Dans cet exemple, le nombre d'erreurs après l'exécution d'un objet Variable XML est lu et imprimé dans un rapport :
: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
Rubriques connexes :
Elément de script | Description |
---|---|
Détermine la réaction à certaines erreurs ou messages d'éléments de script. |
|
Crée un objet (uniquement Calendrier, Login et Variable). |
|
REMOVE_OBJECT | Supprime un objet disponible. |
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