Variables implicites et explicites
Les variables implicites et explicites constituent une caractéristique importante du scriptage. Les variables explicites sont explicitement définies et liées dans l'onglet Variables de l'application Scripts d'automatisation. Les variables implicites ne sont pas explicitement définies dans l'onglet Variables et sont fournies par l'infrastructure de scriptage.
Les variables implicites suivent la convention sur le modèle de configuration où l'infrastructure injecte intelligemment des variables lors de l'exécution qui auraient pu avoir besoin d'un codage Java pour les extraire et les définir. Certaines variables implicites sont injectées en fonction de la façon dont les variables explicites sont définies et d'autres sont injectées indépendamment. Le tableau suivant répertorie et décrit les variables implicites.
| Nom | Type | Description | Applicabilité |
|---|---|---|---|
| application | Chaîne | Nom de l'application Maximo qui a lancé l'exécution du script. | Tous les points de lancement traitant d'un objet métier Maximo (MBO) ou MBOSET |
| utilisateur | Chaîne | userid de l'utilisateur dont l'action a lancé l'exécution du script. |
Tous les points de lancement traitant d'un MBO ou MBOSET |
| MBO | psdi.mbo.Mbo | Objet MBO en cours dans le contexte du script en cours d'exécution. Par exemple, dans le cas du point de lancement de l'objet, il s'agit du MBO, qui génère les événements pour l'infrastructure de scriptage. Pour le point de lancement de l'attribut, il s'agit du MBO du propriétaire de l'attribut. Pour le point de lancement d'action, il peut s'agir de l'escalade ou des flux de travaux MBO. | Tous les points de lancement traitant d'un MBO ou MBOSET |
| MBONAME | Chaîne | Nom de l'objet MBO en cours dans le contexte du script en cours d'exécution. | Tous les points de lancement traitant d'un MBO ou MBOSET |
| clé d'erreur | Chaîne | Cette variable permet d'émettre des exceptions MXExceptions à partir du script sans avoir à importer explicitement ou à faire référence à cette API. Il s'agit de la clé d'erreur dans l'exception MXException. Il fonctionne avec le groupe d'erreurs et les variables implicites params. L'API MXExceptions est la méthode standard pour émettre des exceptions à partir de composants Maximo. Le message d'exception est traduit, ce qui constitue le principal avantage de l'utilisation de cette API à la place d'une exception Java standard, qui n'est pas traduite. Son utilisation est obsolète et remplacée par la fonction error(..) de la variable service |
Tous les points de lancement |
| groupe_erreurs | Chaîne | Son utilisation est identique à celle de la clé d'erreur. Il pointe vers le groupe d'erreurs de l'exception MXException. Associé à la clé d'erreur, il permet de pointer de manière unique vers un message d'erreur dans le référentiel de messages Maximo. Son utilisation est obsolète et remplacée par la fonction error(..) de la variable service |
Tous les points de lancement |
| interactif | Booléen | Il s'agit d'une variable booléenne indiquant si le script est exécuté dans une session interactive ou d'interface utilisateur [ valeur true ] ou dans une session d'arrière-plan [ par exemple, Intégration ]. Cela reflète la valeur de userInfo.isInteractive(). |
Tous les points de lancement |
| résultat d'évaluation | Booléen | Il s'agit d'une variable booléenne de type OUT pour indiquer le résultat de l'évaluation de condition. | Filtres d'événements de point de lancement de condition et de canal de publication |
| onadd | Booléen | Cette variable booléenne indique si le MBO du script est ajouté [ new MBO-value true ] ou non. Le développeur de script peut l'utiliser pour des actions conditionnelles ou des validations basées sur l'état du MBO. | Tous les points de lancement ou rappels où MBO/MBOSET est impliqué. Surtout utile pour les points de lancement d'objet |
| mise à jour | Booléen | La variable booléenne indique où l'objet MBO du script est mis à jour [ sortie de MBO-value true ] ou non. Le développeur de script peut l'utiliser pour des actions conditionnelles ou des validations basées sur l'état de l'objet MBO. | Tous les points de lancement ou rappels où MBO/MBOSET est impliqué. Surtout utile pour les points de lancement d'objet |
| ondelete | Booléen | Variable booléenne indiquant si l'objet MBO dans le contexte de script est supprimé [ valeur true ] ou non. | Tous les points de lancement ou les rappels où mbo / mboset est impliqué. Surtout utile pour le point de lancement d'objet |
| action | Chaîne | Nom de l'action qui a été générée à partir de l'interface utilisateur du point de lancement d'action. | Point de lancement d'action |
| scriptName | Chaîne | Nom du script exécuté. | Tous les points de lancement |
| launchPoint | Chaîne | Nom du point de lancement pour lequel le script est exécuté. | Tous les points de lancement |
| scriptHome | psdi.mbo.Mbo | Il s'agit de la même variable que la variable implicite MBO. Il permet la compatibilité avec les versions antérieures avec les scripts ICD. |
Points de lancement d'action |
| WFINSTANCE | psdi.workflow.WFInstance | Objet MBO de l'instance de flux de travaux. | Point de lancement de l'action. Uniquement lorsque l'action est lancée à partir d'un flux de travaux. |
| client | com.ibm.tivoli.maximo.script.ScriptService | Variable implicite globale disponible pour tous les scripts. | Tous les points de lancement et tous les rappels |
| listMboSet | psdi.mbo.MboSetRemote | Permet de définir le MBOSET de recherche à partir d'un script de recherche dans un point de lancement d'attribut. | Points de lancement des attributs --lookup scripts. |
| srcKeys | Chaîne [ ] | Utilisé pour mapper la clé MBO de recherche à la clé MBO cible targetKeys. |
Points de lancement d'attribut: scripts de recherche. |
| targetKeys | Chaîne [ ] | Utilisé pour le mappage de la clé MBO cible à la clé MBO de recherche srcKeys. |
Points de lancement d'attribut: scripts de recherche. |
Certaines variables implicites sont injectées dans le script en fonction des variables explicitement définies. Le tableau suivant décrit les variables implicites basées sur des variables explicitement définies dont le type de liaison est un attribut MBO. Il n'existe pas de variables implicites pour les variables explicitement définies d'autres types de liaison, tels que les littéraux, maxvars et les propriétés système. L'hypothèse est que "var" est la variable explicitement définie qui se lie à un attribut MBO.
| Nom | Type | Description | Applicabilité |
|---|---|---|---|
| var_required | Booléen | Indicateur obligatoire de l'attribut MBO auquel la variable est liée. | Tous les points de lancement. Le script peut le modifier si la variable est OUT ou INOUT. |
| var_readonly | Booléen | Indicateur en lecture seule de l'attribut MBO auquel la variable est liée. | Tous les points de lancement. Le script peut le modifier si la variable est OUT ou INOUT. |
| var_masqué | Booléen | Indicateur masqué de l'attribut MBO auquel la variable est liée. | Tous les points de lancement. Le script peut être modifié si la variable est OUT ou INOUT. |
| var_interne | Même type que l'attribut MBO auquel la variable est liée. | Pour le type de domaine synonyme des attributs MBO [ like status ], cela représente la valeur interne [ maxvalue ] de l'attribut MBO. | Tous les points de lancement. Applicable uniquement si var est lié à un attribut MBO qui se lie à un domaine synonyme. Le script ne peut pas le modifier. |
| var_précédent | Booléen | Valeur précédente de l'attribut MBO, c'est-à-dire la valeur juste avant la modification de la valeur de l'attribut. | Points de lancement d'attribut-applicable uniquement à l'attribut qui a généré l'événement. Le script ne peut pas le modifier. |
| var_initial | Booléen | Valeur initiale de l'attribut MBO, c'est-à-dire la valeur affectée à cet attribut lors de l'initialisation du MBO. | Tous les points de lancement. Le script ne peut pas le modifier. |
| var_modifié | Booléen | Indique si l'attribut MBO auquel la variable est liée a été modifié ou non. | Tous les points de lancement. Le script ne peut pas le modifier. |