Il Workflow: automazione delle esecuzioni > Le Activity > Irion Activity

La DataEntity Activity è una Activity propria della piattaforma IrionEDM che consente di lanciare un oggetto eseguibile del Package (e.g. Data Link, Data Engine e Book).

Questa Activity dispone delle seguenti proprietà configurabili mediante il riquadro delle Properties:

✓ DisplayName, nome visualizzato per questa Activity nella working area del Designer;

✓ DataEntityName, stringa contenente il full name (case-sensitive) dell'oggetto del Package da eseguire;

✓ PackageName, stringa contenente il full name (case-sensitive) del Package contenente l'oggetto da eseguire;

✓ ForceReloadCache, flag con cui invalidare eventuali cache impostate sulla DataEntity, forzandone il caricamento ad ogni nuova esecuzione;

✓ Parameters, variabile di tipo DataSet contenente gli eventuali parametri in input;

✓ Init Command, command che esegue il Book referenziato dall'Activity;

✓ Command Parameters, parameteri del command che esegue il Book referenziato dall'Activity.

L’opzione ForceReloadCache forza il caricamento di tutte le cache coinvolte nell’esecuzione e non solo quella dell’entity richiamata.

Ciò equivale a selezionare l'opzione Also all object used by current entity (recursive) dell'azione Clear Cache, richiamabile dal menù contestuale del Package Navigator.

Le proprietà PackageHandle e BookHandle vengono automaticamente ed implicitamente valorizzate dal sistema. Pertanto ogni modifica ai corrispondenti campi nel riquadro delle Properties potrebbe rendere del tutto inutilizzabile l'Activity.

Le proprietà PackageName, DataEntityName e Chapters possono essere impostate anche dalla working area del Designer mediante appositi wizard, accessibili premendo nel riquadro che espone l'Activity, rispettivamente, i box

✓ Select Package,

✓ Select DataEntity,

✓ Select Chapters.

Select Package consente di accedere ad un wizard che espone tutti i Package disponibili nel Catalog a cui il Workflow è connesso. In particolare:

✓ in caso la DataEntity Activity sia annidata in una Catalog Activity, vengono visualizzati i Package contenuti nel Catalog referenziato da quest'ultima;

✓ in caso contrario, vengono visualizzati i Package contenuti nello stesso Catalog in cui risiede il Workflow.

In caso la DataEntity Activity sia annidata in una Package Activity, il box Select Package e la corrispondente proprietà nel riquadro delle Properties sono automaticamente compilati del sistema, sulla base delle impostazioni dell'Activity più esterna.

Una DataEntity Activity dispone di due ulteriori regioni in cui è possibile annidare altre Activity:

✓ Before Execution, in cui vengono annidate Activity da eseguire prima della DataEntity;

✓ After Execution, in cui vengono annidate Activity da eseguire dopo la DataEntity.

L’inserimento di una nuova DataEntity Activity in un Workflow comporta:

✓ l’inclusione automatica di una StringToDataSet Activity, denominata Parameters, nella regione Before Execution;

✓ la creazione di una nuova Variable di tipo DataSet, denominata __parameters, associata ad eventuali oggetti del Package di tipo Parameter da cui dipende l'oggetto referenziato dall'Activity.

Il dominio di applicazione iniziale della variabile __parameters è la DataEntity.

La compilazione dei parametri può essere fatta semplicemente accedendo al relativo editor, denominato Configuration Parameter, e selezionando il pulsante di sincronizzazione .

Nella maschera sottostante al pulsante appaionoi tutti i parametri previsti per la DataEntity ed i relativi valori di default, modificabili.

In caso l'oggetto referenziato dalla DataEntity Activity non dipenda da parametri, è necessario eliminare la StringToDataSet Activity denominata Parameters, altrimenti non sarà possibile eseguire il Workflow.

Nella regione After Execution di una StringToDataSet è possibile annidare Command, ModelQueryNoResult, ModelQueryScalar, ModelQueryReader e ModelQueryDataSet Activity.