Il cmdlet Invoke-IDQDataEntity esegue una Data Entity contenuta in un Catalog IrionEDM.

Sintassi

<# Executes a Catalog Entry in default mode #>

Invoke-IDQDataEntity [-Package] <string> [-Entity] <string> [[-Password] <securestring>]

[[-ParameterFile] <string>] [[-ParameterValues] <string>]

[-WhatIf] [-Confirm] [<CommonParameters>]

<# Executes a Catalog Entry in InputObject mode #>

Invoke-IDQDataEntity [-Entity] <string> [[-Password] <securestring>]

[[-ParameterFile] <string>] [[-ParameterValues] <string>] [-InputObject <psobject>]

[-WhatIf] [-Confirm] [<CommonParameters>]

Il cmdlet ha effetto solo se eseguito in modalità Drive.

Argomenti

Parametro	Descrizione	Richiesto
-Entity <string>	Percorso completo della Data Entity del Package.	Y
-Package <string>	Percorso completo del Package del Catalog.	Y
-InputObject <psobject>	Oggetto PowerShell corrispondente ad un Package del Catalog.	N
-ParameterFile <string>	Percorso completo del file XML contenente l'elenco dei parametri di esecuzione della Data Entiity del Package ed i relativi valori.	N
-ParameterValues <string>	Stringa XML serializzata contenente l'elenco dei parametri di esecuzione della Data Entiity del Package ed i relativi valori.	N
-Password <string>	Password di esecuzione della Data Entity	N
-Confirm	Visualizza un messaggio di conferma all’atto dell’esecuzione del comando	N
-Whatif	Simula il commandlet restituendo a video gli step di esecuzione senza effettuarli	N

Entity

Il nome della Data Entity del Package da eseguire (tipicamente un Book).

Package

Il nome del Package in cui è contenuta la Data Entity.

InputObject

Oggetto PowerShell facente riferimento ad un oggetto del Catalog. Non richiesto è nella modalità default.

ParameterFile

Percorso completo del file XML contenente l'elenco dei parametri di esecuzione della Data Entiity del Package ed i relativi valori.

Password

Stringa contenete la password opzionale di esecuzione della Data Entiity.

ESEMPI:

A.Viene eseguito il Book MyBook del Package MyPackage sul Catalog registrato MyCatalog.

cd MyCatalog:

MyCatalog:\> Invoke-IDQDataEntity -Package MyPackage -Entity MyBook

B.Viene eseguito il Book parametrico MyBook del Package MyPackage sul Catalog registrato

cd MyCatalog:

MyCatalog:\> Invoke-IDQDataEntity -Package MyPackage -Entity MyBook -ParameterValues '

<Field1> Value1 </Field1>

<Field2> Value2 </Field2>

…

<FieldN> ValueN </FieldN>

</FullNameParameter>

</Parameters>'

In alternativa, il contenuto XML può essere in un file MyParametersFile presente su file system. In tal caso, si utilizza la sintassi:

cd MyCatalog:

MyCatalog:\> Invoke-IDQDataEntity -Package MyPackage -Entity MyBook -ParameterFile MyParametersFile

C.Le DataEntity sono passate in pipeline (modalità InputObject, con l'array delle Entity contenuto nel PsObject $file) ed eseguite dall'istanza della macchina da cui si sta eseguendo il comando.

cd MyCatalog:

MyCatalog:\> $file | Invoke-IDQDataEntity

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).