Personalizzare ThingWorx Navigate > Creare task personalizzati > Utilizzare i componenti ThingWorx Navigate in un task personalizzato > Componenti disponibili > Elenco elementi
  
Elenco elementi
Definizione e utilizzo
Il componente Elenco elementi è un mashup incorporato che consente di visualizzare un elenco di elementi da un insieme di dati in una vista griglia. Consente inoltre all'utente finale di cercare, ordinare e filtrare l'elenco, nonché di eseguire azioni sull'intero elenco o su elementi specifici dell'elenco.
Di seguito è riportata un'immagine di esempio che mostra il componente Elenco elementi:
È possibile configurare il componente Elenco elementi nei modi descritti di seguito.
Attivare o disattivare le funzionalità di ricerca e di filtro
Impostare le opzioni di filtro e di ordinamento iniziali
Impostare il numero massimo di righe nella griglia
Definire se gli elementi possono essere selezionati dall'elenco e, in caso affermativo, se è possibile selezionare uno o più elementi
Configurare le azioni disponibili nella barra delle azioni incorporata
Scegliere se visualizzare l'azione Esporta
L'utente può filtrare l'Elenco elementi o eseguirvi ricerche utilizzando la casella di filtro o la casella di ricerca. Tuttavia, se la casella di filtro e la casella di ricerca non sono attivate nella configurazione, le funzionalità di filtro e di ricerca non sono disponibili. È possibile fare clic su un titolo di colonna per ordinare l'elenco in base a tale colonna. Per invertire l'ordinamento, fare di nuovo clic sul titolo della colonna.
Il componente Elenco elementi contiene un componente Barra delle azioni incorporato. È possibile configurare la barra delle azioni per attivare funzionalità aggiuntive, ad esempio l'esecuzione di un'azione su uno o più elementi dell'elenco. Per ulteriori informazioni, vedere Barra delle azioni (BETA). Per default, Elenco elementi contiene un'azione Esporta, che consente di esportare tutti gli elementi che corrispondono ai criteri di filtro in un file CSV.
L'elenco elementi include anche un pulsante Ripristina default. Il pulsante Ripristina default ripristina le impostazioni di default per le operazioni di filtro, di ricerca e a livello di griglia, tra cui l'ordinamento, il passaggio tra elementi e la visualizzazione o meno di colonne.
Attività, Elementi interessati, Allegati e Task sono le configurazioni predefinite disponibili per il componente Elenco elementi.
Proprietà di associazione
Input
Nome proprietà
Descrizione
Tipo di proprietà
input
Utilizzato per identificare i dati da recuperare dal sistema di back-end.
Quando l'input è obbligatorio, impostare la proprietà di configurazione waitForInput su true.
JSON di esempio:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"id":{
"value":"OR:wt.workflow.work.WorkItem:1432583"
}
}
],
"objectType":"PTC.Workflow.WorkItem"
}
]
}
]
}
JSON in formato CCO
tailoringName
Identifica in modo univoco un'istanza del componente Elenco elementi. Questo valore viene utilizzato internamente per cercare informazioni di personalizzazione per la specifica istanza.
Utilizzare questa proprietà di associazione solo quando è presente una pagina di personalizzazione dedicata per il task personalizzato.
Output
Nome proprietà
Descrizione
Tipo di proprietà
totalItemsNumber
Numero di elementi di elenco che corrispondono ai criteri di ricerca e di filtro.
Integer
selectedItems
Utilizzato per identificare gli elementi della griglia selezionati e i relativi attributi. Questa proprietà può essere associata alla proprietà di associazione input di altri componenti.
JSON di esempio:
{
"timeStamp":"2019-08-25 18:53:33.476",
"data":[
{
"itemListsData":[
{
"items":[
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143921"
}
},
{
"workItem":{
"value":"OR:wt.workflow.work.WorkItem:143928"
}
}
],
"objectType":"PTC.Workflow.WorkItem"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
],
"version":"1.0.0",
"statusMessage":"OK",
"status":"200"
}
JSON in formato CCO
Proprietà di configurazione
Le tabelle riportate di seguito descrivono i campi JSON utilizzati per configurare il componente.
Per ulteriori informazioni sulla struttura della configurazione, vedere Struttura di configurazione del componente.
Per ulteriori informazioni sulle sottoproprietà, vedere Sottoproprietà e chiavi contenitore.
Nome proprietà
Descrizione
Tipo di proprietà
Valore di default
Obbligatoria o facoltativa
actionBarConfiguration
Configurazione della barra delle azioni incorporata. Per ulteriori informazioni, vedere Barra delle azioni (BETA).
N/D
Facoltativa
attributes
Attributi da visualizzare. Vengono visualizzati come titoli di colonna nella griglia.
N/D
Obbligatoria
defaultSelectedFilterValue
Il valore o i valori selezionati iniziali in base a cui filtrare. Se questa opzione è vuota, non vi sono filtri di default.
Questa proprietà è una sottoproprietà di filterFields ed è pertinente solo quando filterFields è presente nella configurazione. La chiave contenitore è itemListFilterFieldDefinition.
N/D
Facoltativa
defaultSortDirection
La direzione dell'ordinamento di default. Opzioni: asc, che indica l'ordine crescente, e dsc, che indica l'ordine decrescente. Se non viene specificata alcuna opzione, la direzione di ordinamento è crescente.
Questa proprietà è una sottoproprietà di defaultSortField ed è pertinente solo quando defaultSortField è presente nella configurazione. La chiave contenitore è itemListDefaultSortFieldDefinition.
asc
Facoltativa
defaultSortField
Colonna iniziale in base a cui ordinare. Quando questa opzione è vuota, l'elenco di elementi viene ordinato in base alla prima colonna.
N/D
Facoltativa
enableSearch
Se presentare o meno il campo di ricerca. Opzioni: true e false.
true
Facoltativa
filterFields
ID nel sistema di back-end dei campi in base ai quali filtrare i dati. Se questa opzione è vuota, non è possibile filtrare i dati.
N/D
Facoltativa
filterLabelOverride
Etichetta per il filtro che sostituisce il valore visualizzato restituito dal servizio GetItems.
Questa proprietà è una sottoproprietà di filterFields ed è pertinente solo quando filterFields è presente nella configurazione. La relativa chiave contenitore è itemListFilterFieldDefinition
N/D
Facoltativa
implementationConfigurations
Punto di entrata del generatore di applicazioni per passare i valori aggiuntivi necessari per la relativa implementazione e personalizzare ulteriormente il componente.
N/D
Facoltativa
label
Titolo dell'elenco elementi.
[[PTC.ItemList]]
Facoltativa
maxNumberOfRowsInGrid
Numero massimo di righe da visualizzare nell'area della griglia. Si consiglia di immettere un valore minore di 10.000.
500
Facoltativa
searchHintText
Testo del suggerimento visualizzato nella casella di ricerca.
Questa proprietà è una sottoproprietà di enableSearch ed è pertinente solo quando enableSearch è impostata su true. La chiave contenitore è itemListSearchDefinition.
Find Item
Facoltativa
selectionType
Determina il numero di elementi nella griglia che è possibile selezionare contemporaneamente. Opzioni:
none - Non è possibile selezionare gli elementi della griglia.
single - È possibile selezionare un elemento della griglia alla volta.
multi - È possibile selezionare uno o più elementi della griglia contemporaneamente.
multi
Facoltativa
showExportAction
Attiva o disattiva l'azione di esportazione. Opzioni: true e false.
true
Facoltativa
waitForInput
Se attendere o meno in fase di esecuzione che un valore venga passato al parametro mashup di input dell'elenco elementi prima di attivare il recupero degli elementi che completano la griglia. Opzioni: true e false.
false
Facoltativa
Configurazione di esempio
Per le configurazioni di esempio per il componente Elenco elementi, vedere Attività, Elementi interessati, Allegati e Task.
Servizi di personalizzazione
Oltre alla configurazione, ogni componente supporta l'estensione della logica aziendale per personalizzare il componente. La logica aziendale di ciascun componente include servizi ignorabili in un modello di oggetto che è possibile estendere e sostituire. I servizi ignorabili per questo componente sono descritti in dettaglio nella tabella seguente.
Per esempi di elementi restituiti e parametri per ogni servizio, vedere Esempi di input/output per i servizi di personalizzazione.
* 
Quando si restituisce un oggetto JSON in formato CCO da un componente di implementazione della logica aziendale al componente Elenco elementi, includere solo gli attributi di un singolo tipo di oggetto. Attualmente, il componente Elenco elementi non supporta l'inclusione di attributi di tipi di oggetto diversi.
Nome
Descrizione
GetConfigurations
Restituisce le configurazioni disponibili per l'implementazione del componente.
Parametri: nessuno
Restituisce: JSON
GetImplementationLabel
Restituisce il nome localizzato del componente o il token che può essere utilizzato per ottenere il nome localizzato. Il nome localizzato viene visualizzato nell'interfaccia utente di Mashup Builder.
Parametri: nessuno
Restituisce: stringa
GetItems
Restituisce l'elenco di elementi dal sistema di back-end.
Per creare un'implementazione personalizzata del componente Elenco elementi, ignorare questo servizio per recuperare i dati personalizzati.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per i dati da recuperare dal sistema di back-end e le informazioni sull'adattatore per il sistema di back-end.
Quando si utilizza questo parametro, verificare che la proprietà di configurazione waitForInput sia impostata su true.
configuration (obbligatorio) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni.
Restituisce: JSON in formato CCO
InitializeFilters
Restituisce la definizione del tipo di filtro per ciascuno dei campi di filtro nella configurazione.
Parametri:
input (facoltativo) - JSON in formato CCO che include l'ID input per i dati da recuperare dal sistema di back-end e le informazioni sull'adattatore per il sistema di back-end.
configuration (obbligatorio) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni.
Restituisce: JSON in formato CCO
DefHookImplementationConfigurationDefinitionGroup
Restituisce la definizione specifica dell'implementazione con le configurazioni personalizzate per l'implementazione.
Parametri: nessuno
Restituisce: JSON:Array
DefHookImplementationAttributesDefinition
Restituisce la definizione specifica dell'implementazione per gli attributi selezionati.
Parametri: nessuno
Restituisce: JSON:Array
DefHookMaxRowsProperties
Restituisce le proprietà per il numero massimo di righe da visualizzare nell'area della griglia.
Parametri: nessuno
Restituisce: JSON
Definizione di implementazione
Per le definizioni di implementazione per il componente Elenco elementi, vedere Attività, Elementi interessati, Allegati e Task.