Il modulo Irion Batch è un modulo applicativo della piattaforma, privo di una propria UI che permette di effettuare, mediante apposite linee di comando, le seguenti operazioni:
✓ eseguire un oggetto di un Package;
✓ lanciare un Workflow;
✓ esportare su file XML la documentazione relativa ad un Package.
A decorrere dal rilascio di IrionEDM 2016 Update 10, l'uso di IrionEDM Batch è deprecato. Si consiglia l'uso di cmdlet Powershell omologhi che possono essere richiamati attraverso la IrionEDM Automation Console. Tali cmdlet sono descritti nel paragrafo Execution. |
Il modulo IrionEDM Batch può essere utilizzato solo se l'installazione è associata ad una licenza Workflow. |
Esso è accessibile solamente lanciando da prompt dei comandi il corrispondente eseguibile, IrionDQ.Batch.exe.
Gli eseguibili dei moduli applicativi di IrionEDM si trovano nel percorso di istallazione della piattaforma, tipicamente C:\Program Files (x86)\Irion\IrionDQ\[<nome_istanza>] |
Per eseguire un oggetto di un Package, la linea di comando opportuna è:
IrionDQ.Batch [/C:<CatalogName>] <PackageFullName> <EntityOrBookName>
[/A:<ExportOrActionName>] [/P:<parameterValue>|/F:<parameterFile>]
la quale richiede di specificare
✓ il Catalog ed il Package in cui si trova l'oggetto;
✓ il nome dell'oggetto da eseguire;
✓ gli eventuali Command in caso l'oggetto da eseguire sia un Book;
✓ gli eventuali parametri di esecuzione.
APPROFONDIMENTO: PASSAGGIO DI PARAMETRI AL PACKAGE Il passaggio di parametri di esecuzione ad un Package dal modulo IrionEDM Batch avviene attraverso una stringa (/P:) o un file (/F:) XML, così strutturati: <Parameters> <FullNameParameter> <Field1> Value1 </Field1> <Field2> Value2 </Field2> … <FieldN> ValueN </FieldN> </FullNameParameter> </Parameters> In caso di parametri multi-valore (o matrici di valori) è necessario replicare il nodo <FullNameParameter>. Il full name di un oggetto di tipo Parameter contiene il carattere \ (backslash), riservato in XML. Pertanto occorre sostituirlo con la sua rappresentazione esadecimale _x005C_ (e.g. il full name di un oggetto Parameter non annidato in alcun folder diventa _x005C_Parameter). |
Per lanciare un Workflow, la linea di comando corretta è:
IrionDQ.Batch [/C:<CatalogName>] <WorkflowName> [/T:<Timeout in seconds>]
[/X:<Password>] [/A:<Async Mode>] [/P:<parameterValue>|/F:<parameterFile>]
dove è necessario specificare
✓ il Catalog in cui si trova il Workflow;
✓ il nome del Workflow da eseguire;
✓ l'eventuale Timeout e l'eventuale password di esecuzione;
✓ la modalità (sincrona o asincrona) di esecuzione;
✓ eventuali parametri di esecuzione.
APPROFONDIMENTO: PASSAGGIO DI PARAMETRI AL WORKFLOW Il passaggio di parametri di esecuzione ad un Workflow dal modulo IrionEDM Batch avviene attraverso una stringa (/P:) o un file (/F:) XML, così strutturati: <Parameters> <Parameter> <Name> ArgumentName </Name> <Type> dotNETtype </Type> <Value> DefaultValue </Value> </Parameter> </Parameters> Ogni nodo <Parameter> rappresenta la serializzazione XML di uno degli Argument che condizionano l'esecuzione del Workflow. In particolare, per dotNETtype si intende il tipo .NET (e.g. System.String o System.Int32) con cui viene caratterizzato l'Argument stesso. |