Avanzamento
Definizione e utilizzo
Il componente Avanzamento è un widget che visualizza lo stato di avanzamento graficamente. Il componente visualizza lo stato di avanzamento generale come barra di avanzamento orizzontale e i singoli dettagli sullo stato di avanzamento sotto la barra.
Di seguito è riportata un'immagine di esempio che mostra il componente Avanzamento:
È possibile configurare il componente Avanzamento nei modi descritti di seguito.
• Definire il titolo
• Configurare il messaggio sotto la barra di avanzamento
Avanzamento task è una configurazione predefinita disponibile per il componente Avanzamento.
Proprietà di associazione
Input | ||
|---|---|---|
Nome proprietà | Descrizione | Tipo di proprietà |
Input | Utilizzato per identificare i dati da recuperare dal sistema di back-end. JSON di esempio: { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.Workflow.WorkItem", "items":[ { "id":{ "value":"OR:wt.workflow.work.WorkItem:566231" } } ] } ] } ] } | JSON in formato CCO |
Proprietà di configurazione
Le tabella e l'immagine riportate di seguito descrivono le proprietà JSON utilizzate 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 | ||
|---|---|---|---|---|---|---|
title | Stringa visualizzata come titolo nel componente. | N/D | Facoltativa | |||
progressBarMessage | Stringa che viene visualizzata sotto la barra di avanzamento. Si tratta di un messaggio che indica l'avanzamento, come misurato dall'attività. I segnaposto esposti nel messaggio della barra di avanzamento sono %0 e %1. Nel componente predefinito, questi valori vengono sostituiti rispettivamente dagli elementi in sospeso e completati. %total è inoltre disponibile come segnaposto che viene sostituito dal numero totale di elementi. Ad esempio, se 5 elementi su 7 elementi totali sono stati completati e 2 elementi sono ancora in sospeso, la stringa "%1/% elementi totali sono stati completati" viene visualizzata nell'interfaccia utente come "5/7 elementi sono stati completati". La stringa "%0/% elementi totali in sospeso" viene visualizzata nell'interfaccia utente come "2/7 elementi in sospeso". Si tenga presente che la barra di avanzamento blu riflette sempre la percentuale di task completati, indipendentemente dalla stringa. | N/D | Facoltativa | |||
Configurazione di esempio
Per le configurazioni di esempio per il componente Avanzamento, vedere Avanzamento 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.
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 |
CalculateProgress | Calcola e restituisce i dati di avanzamento. Durante la creazione di un'implementazione personalizzata, sostituire questo servizio con la logica personalizzata. Per un esempio di logica personalizzata che può essere utilizzata per questo servizio, vedere Avanzamento task. Parametri: input (obbligatorio) - 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 (facoltativo) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni. Restituisce: JSON |
Definizione di implementazione
Per la definizione di implementazione per il componente Avanzamento, vedere Avanzamento task.