Implizite und explizite Variablen
Ein wichtiges Merkmal von Scripting sind implizite und explizite Variablen. Explizite Variablen werden auf der Registerkarte Variablen der Anwendung "Automationsscripts" explizit definiert und gebunden. Implizite Variablen werden nicht explizit auf der Registerkarte Variablen definiert und werden vom Scripting-Framework bereitgestellt.
Implizite Variablen folgen der Konvention vor dem Konfigurationsmuster, bei dem das Framework Variablen zur Laufzeit intelligent einfügt, die möglicherweise Java-Codierung zum Abrufen und Festlegen benötigt haben. Einige implizite Variablen werden basierend darauf injiziert, wie die expliziten Variablen definiert sind, und einige werden unabhängig injiziert. In der folgenden Tabelle werden implizite Variablen aufgelistet und beschrieben.
| Name | Typ | Beschreibung | Anwendbarkeit |
|---|---|---|---|
| App | Zeichenfolge | Der Name der Maximo-Anwendung, die die Ausführung des Scripts eingeleitet hat. | Alle Startpunkte, die sich auf ein Maximo-Geschäftsobjekt (MBO) oder MBOSET beziehen |
| Benutzer | Zeichenfolge | userid des Benutzers, dessen Aktion die Scriptausführung eingeleitet hat. |
Alle Startpunkte, die sich mit einem MBO oder MBOSET befassen |
| MBO | psdi.mbo.Mbo | Das aktuelle MBO im Kontext des ausgeführten Scripts Im Falle des Objektstartpunkts ist dies beispielsweise das MBO, das die Ereignisse für das Scripting-Framework generiert. Beim Attributstartpunkt ist dies das Attributeigner-MBO. Für den Aktionsstartpunkt kann dies das MBO für Eskalation oder Workflows sein. | Alle Startpunkte, die sich mit einem MBO oder MBOSET befassen |
| MBONAME | Zeichenfolge | Der Name des aktuellen MBO im Kontext des aktiven Scripts. | Alle Startpunkte, die sich mit einem MBO oder MBOSET befassen |
| Fehlerschlüssel | Zeichenfolge | Diese Variable wird verwendet, um MXExceptions aus dem Script auszulösen, ohne explizit importieren oder auf diese API verweisen zu müssen. Dies bezieht sich auf den Fehlerschlüssel in der MXException. Es arbeitet mit den impliziten Variablen errorgroup und params zusammen. Die API "MXExceptions" ist die Standardmethode zum Auslösen von Ausnahmen von Maximo-basierten Komponenten. Die Ausnahmebedingungsnachricht wird übersetzt. Dies ist der Hauptvorteil der Verwendung dieser API anstelle einer Java-Standardausnahmebedingung, die nicht übersetzt ist. Seine Verwendung ist veraltet und wird durch die Funktion error(..) der Variablen service ersetzt. |
Alle Startpunkte |
| Fehlergruppe | Zeichenfolge | Seine Verwendung entspricht der des Fehlerschlüssels. Zeigt auf die Fehlergruppe der MXException. Zusammen mit dem Fehlerschlüssel hilft es, eindeutig auf eine Fehlernachricht im Maximo-Nachrichtenrepository zu verweisen. Seine Verwendung ist veraltet und wird durch die Funktion error(..) der Variablen service ersetzt. |
Alle Startpunkte |
| interaktiv | Boolesch | Dies ist eine boolesche Variable, die angibt, ob das Script in einer interaktiven Sitzung oder in einer Benutzerschnittstellensitzung (Wert 'true') oder einer Hintergrundsitzung (z. B. Integration) ausgeführt wird. Dies spiegelt den Wert von userInfo.isInteractive()wider. |
Alle Startpunkte |
| evalresult (Ergebnis) | Boolesch | Dies ist eine boolesche Variable des Typs OUT, die das Ergebnis der Bedingungsauswertung angibt. | Filter für Bedingungsstartpunkt und Veröffentlichungskanalereignis |
| Hinzufügen | Boolesch | Diese boolesche Variable gibt an, ob das MBO im Script hinzugefügt wird [neuer MBO-Wert 'true'] oder nicht. Der Scriptentwickler kann dies für bedingte Aktionen oder Validierungen verwenden, die auf dem Status des MBO basieren. | Alle Startpunkte oder Callbacks, an denen MBO/MBOSET beteiligt ist Am meisten nützlich für Objektstartpunkte |
| Bei Aktualisierung | Boolesch | Boolesche Variable gibt an, wo das MBO im Script aktualisiert wird [beendet MBO-Wert 'true'] oder nicht. Der Scriptentwickler kann sie für bedingte Aktionen oder Validierungen basierend auf dem Status des MBO verwenden. | Alle Startpunkte oder Callbacks, an denen MBO/MBOSET beteiligt ist Am meisten nützlich für Objektstartpunkte |
| Bei Löschen | Boolescher Wert | Boolesche Variable, die angibt, ob das MBO im Scriptkontext gelöscht wird [Wert true] oder nicht. | Alle Startpunkte oder Callbacks, an denen mbo/mboset beteiligt ist. Am meisten nützlich für den Objektstartpunkt |
| Aktion | Zeichenfolge | Der Name der Aktion, die über die Benutzerschnittstelle des Aktionsstartpunkts generiert wurde | Aktionsstartpunkt |
| scriptName | Zeichenfolge | Der Name des ausgeführten Scripts. | Alle Startpunkte |
| launchPoint | Zeichenfolge | Der Name des Startpunkts, für den das Script ausgeführt wird. | Alle Startpunkte |
| scriptHome | psdi.mbo.Mbo | Dies entspricht der impliziten Variablen MBO. Er ermöglicht die Abwärtskompatibilität mit ICD-Scripts. |
Aktionsstartpunkte |
| WFINSTANCE | psdi.workflow.WFInstance | Das MBO der Workflowinstanz. | Aktionsstartpunkt. Nur wenn die Aktion über einen Workflow gestartet wird. |
| Dienst | com.ibm.tivoli.maximo.script.ScriptService | Die globale implizite Variable, die für alle Scripts verfügbar ist. | Alle Startpunkte und Callbacks |
| listMboSet | psdi.mbo.MboSetRemote | Wird zum Festlegen des Lookup-MBOSET aus einem Suchscript in einem Attributstartpunkt verwendet. | Attributeinstiegspunkte – --lookup kripte. |
| srcKeys | String[] | Wird für die Zuordnung des Such-MBO-Schlüssels zum Ziel-MBO-Schlüssel targetKeysverwendet |
Attributstartpunkte -- Suchscripts. |
| targetKeys | String[] | Wird für die Zuordnung des Ziel-MBO-Schlüssels zum Such-MBO-Schlüssel srcKeysverwendet |
Attributstartpunkte -- Suchscripts. |
Einige implizite Variablen werden basierend auf den explizit definierten Variablen in das Script eingefügt. In der folgenden Tabelle werden die impliziten Variablen beschrieben, die auf explizit definierten Variablen basieren, deren Bindungstyp ein MBO-Attribut ist. Es gibt keine impliziten Variablen für explizit definierte Variablen anderer Bindungstypen wie Literale, maxvars und Systemeigenschaften. Die Annahme ist, dass "var" die explizit definierte Variable ist, die an ein MBO-Attribut gebunden ist.
| Name | Typ | Beschreibung | Anwendbarkeit |
|---|---|---|---|
| var_erforderlich | Boolesch | Erforderliches Flag des MBO-Attributs, an das die Variable gebunden wird. | Alle Startpunkte. Das Script kann es ändern, wenn die Variable OUT oder INOUT ist. |
| 'var_readonly' | Boolesch | Schreibgeschütztes Flag des MBO-Attributs, an das die Variable gebunden wird | Alle Startpunkte. Das Script kann es ändern, wenn die Variable OUT oder INOUT ist. |
| Var_hidden | Boolesch | Verdecktes Flag des MBO-Attributs, an das die Variable gebunden wird | Alle Startpunkte. Das Script kann ändern, wenn die Variable OUT oder INOUT ist. |
| Var_intern | Derselbe Typ wie das MBO-Attribut, an das var gebunden ist. | Bei Synonymdomänen des Typs MBO-Attribute [wie Status] stellt dies den internen Wert [maxvalue] für das MBO-Attribut dar. | Alle Startpunkte. Nur anwendbar, wenn var an ein MBO-Attribut gebunden ist, das an eine Synonymdomäne gebunden ist. Das Script kann sie nicht ändern. |
| var_vorheriges | Boolesch | Der vorherige Wert des MBO-Attributs, d. h. der Wert unmittelbar vor Änderung des Attributwerts. | Attributstartpunkte-gilt nur für das Attribut, das das Ereignis generiert hat Das Script kann sie nicht ändern. |
| Var_initial | Boolesch | Der Anfangswert des MBO-Attributs, d. h. der Wert, der diesem Attribut bei der Initialisierung des MBO zugeordnet wurde. | Alle Startpunkte. Das Script kann sie nicht ändern. |
| var_geändert | Boolesch | Gibt an, ob das MBO-Attribut, an das die Variablenvariable gebunden ist, geändert wurde. | Alle Startpunkte. Das Script kann sie nicht ändern. |