Ottieni entità per interrogazione
Usare l'azione Ottieni entità per interrogazione per recuperare i dettagli di entità metadati in base a un'interrogazione. È possibile specificare il nome o il numero dell'oggetto Windchill per recuperarne i metadati.
Per utilizzare l'azione Ottieni entità per interrogazione nel workflow, attenersi alla procedura descritta di seguito.
1. Trascinare l'azione Ottieni entità per interrogazione presente in Windchill nell'area di lavoro, posizionare il puntatore del mouse sull'azione, quindi fare clic su 
o fare doppio clic sull'azione. Viene visualizzata la finestra Ottieni entità per interrogazione.
o fare doppio clic sull'azione. Viene visualizzata la finestra Ottieni entità per interrogazione.2. Se necessario, modificare l'Etichetta. Per default, il nome dell'etichetta corrisponde al nome dell'azione.
3. Per aggiungere un tipo di connettore Windchill, fare riferimento a Tipi di connettore Windchill supportati.
Se in precedenza è stato aggiunto un tipo di connettore, selezionare il Tipo di connettore appropriato, quindi il connettore in Nome connettore.
4. Fare clic su TEST per convalidare il connettore.
5. Fare clic su MAPPA CONNETTORE per eseguire l'azione utilizzando un connettore diverso da quello utilizzato per completare i campi di input. Nel campo Connettore runtime immettere un nome valido per il connettore Windchill. Per ulteriori informazioni su MAPPA CONNETTORE, vedere la sezione relativa all'utilizzo di Mappa connettore.
6. Nell'elenco Tipo di entità selezionare il tipo di entità appropriato.
7. Utilizzare le opzioni nell'elenco Tipo di interrogazione per filtrare l'output in base alle proprietà dell'oggetto che si desidera nell'output.
A seconda del tipo di entità restituito, un'interrogazione presenta i parametri seguenti:
◦ Oggetto singolo - Seleziona proprietà, Aggiungi elementi correlati
◦ Raccolta di oggetti - Filtri, Seleziona proprietà, Aggiungi elementi correlati, Limite, Ignora
Nell'elenco Tipo di interrogazione selezionare Interrogazione basata su modulo, Interrogazione distinta o Interrogazione non elaborata per fornire i parametri di interrogazione.
Interrogazione basata su modulo a. (Disponibile solo per la raccolta di oggetti) Nel gruppo Filtra effettuare le operazioni descritte di seguito. a. Nell'elenco Unisci tramite selezionare un operatore logico che unisce le clausole di filtro. Il valore di default è and. b. In Clausole di filtro fare clic su Aggiungi per aggiungere un filtro: ▪ Proprietà - Selezionare una proprietà. ▪ Condizione corrispondenza - Selezionare una condizione. La condizione dipende dal tipo di proprietà selezionato, ad esempio stringa, booleano e così via. ▪ Valore - Immettere un valore di proprietà. Fare clic su Aggiungi per aggiungere più filtri. Fare clic su  per eliminare tutti i filtri aggiunti.Se si aggiungono le stesse proprietà e si seleziona AND nell'elenco Unisci tramite, gli attributi vengono uniti dall'operatore OR. b. In Seleziona proprietà fare clic su Aggiungi e nell'elenco Proprietà selezionare la proprietà di cui si desidera recuperare i valori. Fare clic su Aggiungi per aggiungere più proprietà. Fare clic su per eliminare tutte le proprietà aggiunte.Per default, i valori delle proprietà "chiave" vengono recuperati nell'output. c. In Aggiungi elementi correlati fare clic su Aggiungi e nell'elenco Elemento correlato selezionare l'elemento correlato per cui si desidera recuperare i valori. Fare clic su Aggiungi per aggiungere più elementi correlati. Fare clic su per eliminare tutti gli elementi correlati aggiunti.Eventuali proprietà contrassegnate come NavigationProperty vengono categorizzate come Elemento correlato. d. (Disponibile solo per la raccolta di oggetti) Nel campo Limite immettere un valore per limitare l'output a un numero specificato di entità. e. (Disponibile solo per la raccolta di oggetti) Nel campo Ignora immettere il numero di risorse che si desidera ignorare. f. Nel gruppo Ordina per effettuare le operazioni descritte di seguito. ▪ Nell'elenco Seleziona attributo selezionare l'attributo. ▪ Nell'elenco Ordine selezionare Crescente o Decrescente.
|
Interrogazione distinta a. (Disponibile solo per la raccolta di oggetti) Nel campo Filtri specificare i criteri di filtro OData nel formato propertyName operator 'value' [and | or | not]..., ad esempio number eq '0000222341' o name eq 'PTC' o startswith(name, 'PTC'). b. Nel campo Seleziona proprietà specificare un'espressione di selezione OData per fornire un elenco di nomi di proprietà separati da virgole. Per default, i valori delle proprietà "chiave" vengono recuperati nell'output. c. Nel campo Aggiungi elementi correlati specificare un'espressione di selezione OData per fornire un elenco di elementi correlati separati da virgole. Eventuali proprietà contrassegnate come NavigationProperty vengono categorizzate come Elemento correlato. d. (Disponibile solo per la raccolta di oggetti) Nel campo Limite immettere il numero di risultati della ricerca che si desidera recuperare. e. (Disponibile solo per la raccolta di oggetti) Nel campo Ignora immettere il numero dei primi risultati della ricerca che si desidera ignorare nel risultato. f. Nel campo Ordina per immettere un'espressione orderBy di OData nel formato propertyName [asc | desc]. |
Interrogazione non elaborata Nel campo Interrogazione specificare un'espressione di interrogazione OData. Ad esempio: $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' Per default, i valori delle proprietà "chiave" vengono recuperati nell'output. Eventuali proprietà contrassegnate come NavigationProperty vengono categorizzate come Elemento correlato. A seconda del tipo di entità restituito è possibile fornire filtri, limitare e ignorare i parametri nell'espressione di interrogazione. |
8. Fare clic su Mostra campi aggiuntivi per visualizzare altri campi.
◦ In Ottieni annotazioni OData selezionare true per includere le annotazioni OData nell'output. Il valore di default è false.
9. Fare clic su Fine.
Schema di output
Lo schema di output dell'azione Ottieni entità per interrogazione è uno schema dinamico. Lo schema cambia in base ai valori selezionati per i campi Tipo di entità, Proprietà ed Elementi correlati.
Se è stato selezionato Interrogazione basata su modulo per specificare i parametri di interrogazione, lo schema di output fornisce solo i dettagli delle proprietà selezionate.
Per Interrogazione distinta o Interrogazione non elaborata, lo schema di output contiene tutte le proprietà dell'oggetto restituito, tuttavia fornisce solo i valori delle proprietà selezionate.
Lo schema di output presenta una matrice di oggetti del tipo di entità selezionato e un elenco di identificatori che è un elenco di OID Windchill separati da virgole. Nella figura seguente viene mostrato lo schema di output di default:
Se si imposta Tipo di entità su Parti, lo schema di output appare come illustrato nella figura seguente:
Se si imposta Tipo di entità su Parti e Proprietà su AssemblyMode, lo schema di output appare come illustrato nella figura seguente:
 | Per AssemblyMode, l'azione restituisce un valore simile a { "Value": "separable", "Display": "Separable" }. Se si desidera mappare solo il campo Valore, aggiornare la mappatura come descritto di seguito. {{$a0.Results[0].AssemblyMode.Value}} |
Se si imposta Tipo di entità su Parti, Proprietà su AssemblyMode ed Elementi correlati su Folder, lo schema di output appare come illustrato nella figura seguente:
