Elenco attività istanza

Modifica in linea

Utilizzare Elenco attività istanza per visualizzare un elenco di attività per un'istanza del processo o del caso.

La vista utilizza la messaggistica web CometD per aggiornare automaticamente il contenuto della vista. Per ulteriori informazioni, consultare Configurazione del comportamento di notifica e aggiornamento.

Restrizioni e limitazioni

Limitazioni
  • Questa vista supporta solo le proprietà di visibilità Required, Hiddene None .
  • Per attivare le azioni di esplorazione per la vista in un dashboard personalizzato, aggiungere anche il controllo del controller di navigazione al dashboard personalizzato. Per ulteriori informazioni, consultare Controllo controller di navigazione.
  • In alcune situazioni, l'amministratore di sistema potrebbe disabilitare la messaggistica Web cometD . Se si utilizza questa vista in un dashboard personalizzato, accertarsi che il dashboard contenga un meccanismo di aggiornamento alternativo, come ad esempio Aggiorna controller o Aggiorna pulsante. Per ulteriori informazioni, consultare Controllo controller di aggiornamento e Controllo pulsante di aggiornamento.
Limitazioni
Nessuno

Proprietà di configurazione

Impostare o modificare la configurazione della vista nella scheda delle proprietà Configurazione .
Tabella 1. Proprietà di Configurazione della sezione Attività istanza
Proprietà di configurazione Variabile proprietà Descrizione
Altezza height (Integer) L'altezza della vista in pixel. Se l'elenco attività supera l'altezza specificata, viene visualizzata una barra di scorrimento. Per visualizzare l'elenco completo senza una barra di scorrimento, immettere 0.

Valore predefinito: quando non viene specificato alcun valore, l'altezza del controllo è 600 pixels.
Id istanza instanceId (String) L'ID istanza filtra l'elenco di attività. Questa proprietà è obbligatoria.

Impostazione predefinita: nessuno
Categoria selezionata selectedCategory (String) Visualizza le attività nella categoria selezionata. È possibile associare questa proprietà ad un controllo di selezione, ad esempio il controllo Selezione categoria. In alternativa, è possibile impostarlo su un valore statico in modo che il controllo mostri sempre lo stesso sottoinsieme di attività, ad esempio tutte le attività.

Valore predefinito: La prima voce nell'elenco di categorie definite per la proprietà di configurazione Definisci categorie selezionabili . Se non viene definita alcuna categoria selezionabile, vengono visualizzate le attività pronte.
Definisci categorie selezionabili categories (List of String) Definisce la serie di categorie di selezione e l'ordine in cui vengono visualizzate in un'interfaccia utente. Una categoria rappresenta un sottoinsieme di attività, ad esempio, le attività pronte e i criteri di ordinamento.

Le categorie possono essere una combinazione di categorie predefinite e definite dall'utente.

Valore predefinito: Ready, InProgress, Completed, All
Categorie definite dall'utente userDefinedCategories (List of ActivityListCategory) Un elenco di categorie definite dall'utente. I nomi di queste categorie devono essere univoci e non uno dei nomi di categoria predefiniti: Ready, InProgress, Completedo All.

Impostazione predefinita: nessuno
Categorie di selezione generate categoriesSelectionList (List of NameValuePair) Il sottoinsieme di categorie selezionabili che si desidera includere nell'interfaccia utente.

L'elenco viene generato dal valore della proprietà di configurazione Definisci categorie selezionabili . È composto da oggetti della coppia nome-valore, la proprietà nome è il nome di visualizzazione della categoria e la proprietà valore è il valore della categoria.

È possibile collegare questa proprietà di configurazione ad una vista di selezione, ad esempio, la vista Selezione categoria per fornire categorie di selezione a schede all'inizio dell'elenco.

Valore predefinito: Ready, InProgress, Completed, All
Filtro testo textFilter (String) Filtra l'elenco di attività in base al nome dell'attività in base al testo immesso dall'utente.

Impostazione predefinita: nessuno
Trigger di aggiornamento refreshTrigger (Boolean) Consente di aggiornare il contenuto della vista. Eseguire il bind di questa proprietà alla variabile privata utilizzata da Refresh Controller, Refresh Button o entrambi.

Quando il valore della variabile associata viene modificato in true, la vista viene aggiornata. Una volta aggiornata la vista, il valore della variabile ritorna a false.

Valore predefinito: false (nessun aggiornamento in sospeso)
Richiama attività retrieveActivityListService Il servizio che richiama l'elenco di attività.

Predefinito: Default Instance Activities List Service
Attività activities (List of ActivityListItem) L'elenco di attività visualizzate. Questa proprietà di configurazione è di sola lettura.

Impostazione predefinita: nessuno
Richiamare dettagli di una attività retrieveActivityDetailsService Il servizio che richiama i dettagli di un'attività.

Predefinito: Default Activity Details Service
Esegui azione sull'attività activityActionService Il servizio che esegue un'azione su una attività.

Predefinito: Default Activity Action Service
Servizio di localizzazione localizationService Il servizio utilizzato per recuperare le stringhe globalizzate da utilizzare con questa vista

Dashboards Localized Messages Loader

categorie predefinite

La seguente tabella mostra come le categorie predefinite si associano agli stati dell'attività.

Tabella 2. Modalità di associazione delle categorie predefinite agli stati dell'attività
Categoria Descrizione
Pronto Mostra le attività che possono essere avviate. Queste attività si trovano nello stato READY o nello stato WAITING .
In corso Mostra le attività in corso. Queste attività si trovano nello stato WORKING o nello stato WAITING .
Completato Mostra le attività che si trovano in uno dei seguenti stati finali: COMPLETED, FAILEDo SKIPPED.
Tutti Mostra le attività in uno dei seguenti stati: READY, WAITING, WORKING, COMPLETED, FAILEDo SKIPPED

Le categorie predefinite sono implementate con il metodo getPredefinedCategories JavaScript . Per visualizzare l'implementazione, in Process Designer, nella scheda Comportamento per la vista, selezionare Inline JavaScript.

Personalizzazione della vista Coach Elenco attività istanza

È possibile personalizzare la vista coach Elenco attività istanza nei seguenti modi:
  • Personalizzare le categorie utilizzate per filtrare le attività modificando i valori delle proprietà di configurazione corrispondenti. Per ulteriori informazioni, consultare Personalizzazione delle categorie.
  • Sovrascrivere i servizi predefiniti forniti dal controllo.
    • Servizio di elenco delle attività dell'istanza: modificare le proprietà della query, ad esempio, sortCriteria, filters, includeHidden o modificare il risultato della query, ad esempio, per rimuovere le azioni disponibili
    • Servizio dettagli attività: ad esempio, per modificare il resoconto
    • Servizio azione attività: ad esempio, per attivare altre azioni, come le notifiche o l'aggiornamento dei dati
  • Modificare le stringhe di risorsa nel file di risorsa del servizio di localizzazione, ad esempio, per cambiare le etichette delle categorie di selezione
  • Modificare le impostazioni di stile nel file .css

Personalizzazione delle categorie

La proprietà di configurazione categories determina quali categorie vengono visualizzate per la selezione da parte dell'utente. Ad esempio, il seguente esempio di codice illustra come escludere la categoria In Progress predefinita.
// Define categories to be available
tw.local.categories = new tw.object.listOf.String();
tw.local.categories[0] = "Ready";
tw.local.categories[1] = "Completed";
tw.local.categories[2] = "All";
Utilizzare l'oggetto aziendale ActivityListCategory per definire le variabili che rappresentano le categorie definite dall'utente. È quindi possibile utilizzare la proprietà di configurazione userDefinedCategories per aggiungere nuove categorie o sostituire le categorie predefinite con categorie definite dall'utente. Ad esempio, il seguente esempio di codice illustra come sostituire la categoria Ready predefinita con una categoria definita dall'utente che non include le attività in attesa. Per le attività in attesa viene definita una nuova categoria definita dall'utente.
tw.local.userDefinedCategories = new tw.object.listOf.ActivityListCategory();

// define a user-defined category to replace the predefined ready category, no waiting activies
tw.local.userDefinedCategories[0] = new tw.object.ActivityListCategory();
tw.local.userDefinedCategories[0].name = "ReadyOnly"; 
tw.local.userDefinedCategories[0].label = tw.resource.MyResource.category.ready;
tw.local.userDefinedCategories[0].sortCriteria = new tw.object.listOf.String();
tw.local.userDefinedCategories[0].sortCriteria[0] = "NAME_ASC";
tw.local.userDefinedCategories[0].filters = new tw.object.listOf.ActivityListFilter();
tw.local.userDefinedCategories[0].filters[0] = new tw.object.ActivityListFilter();
tw.local.userDefinedCategories[0].filters[0].executionStateFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[0].filters[0].executionStateFilter[0] = "READY";
tw.local.userDefinedCategories[0].filters[0].activityTypeFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[0].filters[0].executionTypeFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[0].filters[0].executionTypeFilter[0] = "MANUAL";
tw.local.userDefinedCategories[0].filters[0].optionTypeFilter = new tw.object.listOf.String();

// define a new user-defined category for waiting activities
tw.local.userDefinedCategories[1] = new tw.object.ActivityListCategory();
tw.local.userDefinedCategories[1].name = "Waiting";
tw.local.userDefinedCategories[1].label = tw.resource.MyResource.category.waiting;
tw.local.userDefinedCategories[1].sortCriteria = new tw.object.listOf.String();
tw.local.userDefinedCategories[1].sortCriteria[0] = "NAME_ASC";
tw.local.userDefinedCategories[1].filters = new tw.object.listOf.ActivityListFilter();
tw.local.userDefinedCategories[1].filters[0] = new tw.object.ActivityListFilter();
tw.local.userDefinedCategories[1].filters[0].executionStateFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[1].filters[0].executionStateFilter[0] = "WAITING";
tw.local.userDefinedCategories[1].filters[0].activityTypeFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[1].filters[0].executionTypeFilter = new tw.object.listOf.String();
tw.local.userDefinedCategories[1].filters[0].executionTypeFilter[0] = "MANUAL";
tw.local.userDefinedCategories[1].filters[0].optionTypeFilter = new tw.object.listOf.String();

// Define categories to be available
tw.local.categories = new tw.object.listOf.String();
tw.local.categories[0] = "ReadyOnly"; // user-defined
tw.local.categories[1] = "Waiting"; // user-defined
tw.local.categories[2] = "All"; // predefined

// Define initially selected category
tw.local.selectedCategory = "All";