Variabili implicite ed esplicite
Una caratteristica importante dello script è rappresentata dalle variabili implicite ed esplicite. Le variabili esplicite sono definite esplicitamente e associate nella scheda Variabili nell'applicazione Script di automazione. Le variabili implicite non vengono definite esplicitamente nella scheda Variabile e vengono fornite dal framework degli script.
Le variabili implicite seguono la convenzione sul modello di configurazione in cui il framework inserisce in modo intelligente le variabili al runtime che potrebbero altrimenti aver richiesto la codifica Java per recuperare e impostare. Alcune variabili implicite vengono inserite in base a come sono definite le variabili esplicite e alcune vengono inserite in modo non appropriato. La seguente tabella elenca e descrive le variabili implicite.
| Nome | Tipo | Descrizione | Applicabilità |
|---|---|---|---|
| applicazione | Stringa | Il nome dell'applicazione Maximo che ha avviato l'esecuzione dello script. | Tutti i punti di avvio che si occupano di un MBO (Maximo business object) o MBOSET |
| utente | Stringa | userid dell'utente la cui azione ha avviato l'esecuzione dello script. |
Tutti i punti di lancio che si occupano di MBO o MBOSET |
| MBO | psdi.mbo.Mbo | L'MBO corrente nel contesto dello script in esecuzione. Ad esempio, nel caso del punto di avvio dell'oggetto, si tratterà dell'MBO, che genera gli eventi per il framework di script. Per il punto di avvio attributo, questo è l'MBO del proprietario degli attributi. Per il punto di avvio dell'azione può essere l'escalation o l'MBO dei flussi di lavoro. | Tutti i punti di lancio che si occupano di MBO o MBOSET |
| NOMEMBO | Stringa | Il nome dell'MBO corrente nel contesto dello script in esecuzione. | Tutti i punti di lancio che si occupano di MBO o MBOSET |
| chiave errore | Stringa | Questa variabile è per generare MXExceptions dallo script senza dover importare esplicitamente o fare riferimento a tale API. Si riferisce alla chiave di errore in MXException. Funziona insieme alle variabili implicite errorgroup e params. L'API MXExceptions è il modo standard per generare eccezioni da componenti basati su Maximo. Il messaggio di eccezione è tradotto, che è il principale vantaggio di utilizzare questa API invece di un'eccezione Java standard, che non è tradotta. Il suo utilizzo è obsoleto e viene sostituito dalla funzione error(..) della variabile service |
Tutti i punti di avvio |
| gruppo di errori | Stringa | Il suo utilizzo è lo stesso di errorkey. Punta al gruppo di errori di MXException. Insieme alla chiave di errore, consente di puntare in maniera univoca a un messaggio di errore nel repository dei messaggi Maximo. Il suo utilizzo è obsoleto e viene sostituito dalla funzione error(..) della variabile service |
Tutti i punti di avvio |
| interattivo | Booleano | È una variabile booleana che indica se lo script viene eseguito in una sessione interattiva o UI [ valore true] o in una sessione in background [ ad esempio, Integrazione]. Ciò riflette il valore di userInfo.isInteractive(). |
Tutti i punti di avvio |
| risultato di valutazione | Booleano | È una variabile booleana di tipo OUT per indicare il risultato della valutazione della condizione. | Filtri evento punto di avvio condizione e canale di pubblicazione |
| onadd | Booleano | Questa variabile booleana indica se l'MBO nello script è aggiunto [ nuovo MBO - valore true] o meno. Lo sviluppatore di script può utilizzarlo per azioni condizionali o convalide in base allo stato dell'MBO. | Tutti i punti di avvio o callback in cui è coinvolto MBO/MBOSET. Utile soprattutto per i punti di avvio degli oggetti |
| onupdate | Booleano | La variabile booleana indica dove viene aggiornato l'MBO nello script [ uscita da MBO - value true] o meno. Lo sviluppatore dello script può utilizzarlo per azioni condizionali o convalide basate sullo stato dell'MBO. | Tutti i punti di avvio o callback in cui è coinvolto MBO/MBOSET. Utile soprattutto per i punti di avvio degli oggetti |
| ondelete | booleano | Variabile booleana che indica se l'MBO nel contesto dello script è eliminato [ valore true] o meno. | Tutti i punti di avvio o callback in cui è coinvolto mbo / mboset. Più utile per il punto di avvio dell'oggetto |
| azione | Stringa | Il nome dell'azione generata dall'interfaccia utente del punto di avvio dell'azione. | Punto di avvio azione |
| scriptName | Stringa | Il nome dello script eseguito. | Tutti i punti di avvio |
| launchPoint | Stringa | Il nome del punto di avvio per cui viene eseguito lo script. | Tutti i punti di avvio |
| scriptHome | psdi.mbo.Mbo | È uguale alla variabile implicita MBO. Consente la compatibilità retroattiva con gli script ICD. |
Punti di avvio dell'azione |
| WFINSTANCE | psdi.workflow.WFInstance | L'MBO dell'istanza del workflow. | Punto di avvio azione. Solo quando l'azione viene avviata da un workflow. |
| servizio | com.ibm.tivoli.maximo.script.ScriptService | La var implicita globale disponibile per tutti gli script. | Tutti i punti di avvio e i callback |
| listMboSet | psdi.mbo.MboSetRemote | Viene utilizzato per impostare l'MBOSET di ricerca da uno script di ricerca in un punto di avvio attributo. | Punti di lancio degli attributi --lookup script. |
| srcKeys | Stringa [] | Utilizzato per associare la chiave MBO di ricerca alla chiave MBO di destinazione targetKeys. |
Punti di avvio attributo -- script di ricerca. |
| targetKeys | Stringa [] | Utilizzato per associare la chiave MBO di destinazione alla chiave MBO di ricerca srcKeys. |
Punti di avvio attributo -- script di ricerca. |
Alcune variabili implicite vengono inserite nello script in base alle variabili definite esplicitamente. La seguente tabella descrive le variabili implicite che si basano su variabili definite esplicitamente il cui tipo di collegamento è un attributo MBO. Non ci sono variabili implicite per le variabili definite esplicitamente di altri tipi di binding come valori letterali, maxvar e proprietà di sistema. Il presupposto è che "var" sia la variabile definita esplicitamente che si collega a un attributo MBO.
| Nome | Tipo | Descrizione | Applicabilità |
|---|---|---|---|
| var_richiesto | Booleano | Indicatore obbligatorio dell'attributo MBO a cui è collegata la var. | Tutti i punti di avvio. Lo script può modificarlo se la var è OUT o INOUT. |
| var_readonly | Booleano | Indicatore di sola lettura dell'attributo MBO a cui è collegata la var. | Tutti i punti di avvio. Lo script può modificarlo se la var è OUT o INOUT. |
| var_nascosto | Booleano | Flag nascosto dell'attributo MBO a cui è collegata la var. | Tutti i punti di avvio. Lo script può essere modificato se la var è OUT o INOUT. |
| var_interno | Stesso tipo dell'attributo MBO a cui si collega la var. | Per il tipo di dominio dei sinonimi degli attributi MBO [ come lo stato] rappresenta il valore interno [ maxvalue] per l'attributo MBO. | Tutti i punti di avvio. Applicabile solo se la var è collegata a un attributo MBO che si collega a un dominio di sinonimi. Lo script non può modificarla. |
| var_precedente | Booleano | Il valore precedente dell'attributo MBO, ovvero il valore appena prima che il valore dell'attributo venisse modificato. | Punti di avvio attributo - applicabili solo per l'attributo che ha generato l'evento. Lo script non può modificarla. |
| var_iniziale | Booleano | Il valore iniziale dell'attributo MBO, ovvero il valore assegnato a tale attributo quando l'MBO è stato inizializzato. | Tutti i punti di avvio. Lo script non può modificarla. |
| var_modified | Booleano | Indica se l'attributo MBO a cui si collega la variabile var è stato modificato o meno. | Tutti i punti di avvio. Lo script non può modificarla. |