Mashup Builder > Widget
Widget
I widget ThingWorx sono i componenti visivi delle pagine di mashup di ThingWorx. Un widget può essere un renderer di dati avanzato, ad esempio un grafico, o più simile a un componente di utilità, ad esempio un pulsante o un link di navigazione. I widget di rendering dei dati includono associazioni dei dati in ingresso. Quando viene eseguito un servizio dati, l'insieme di risultati dei dati viene associato al widget per il rendering. Altri widget, ad esempio un pulsante, possono non avere associazioni dei dati in ingresso, ma avere invece un'associazione di eventi in uscita. Ad esempio è possibile associare l'evento Clicked di un widget Pulsante a un servizio dati. Quando si fa clic sul pulsante, il servizio dati viene eseguito sul server.
Categorie di widget per 8.4.X
I 78 widget presenti sono classificati in tre categorie principali in ThingWorx Platform.
• Standard: sono presenti 64 widget classificati come Standard in Mashup Builder. Questi sono i widget esistenti in ThingWorx Platform.
• Beta: sono presenti 13 nuovi widget classificati come Beta. Questi widget sono disponibili anche come componenti Web che è possibile importare da un SDK.
• Legacy: solo il widget Ripetitore è classificato come Legacy. Questo widget sarà rimosso in una prossima release.
Sono presenti altri widget disponibili come estensioni. Alcune di queste sono elencate in Estensioni. Alcune estensioni sono disponibili nella pagina PTC Software Download e possono essere importate in ThingWorx e utilizzate. Le estensioni importate sono disponibili nella categoria Importati in Mashup Builder.
Categorie di widget per 8.5.X e versioni successive
I widget sono classificati in cinque categorie principali in Platform. Fare clic sulla freccia accanto a Categoria nel pannello Widget all'interno della ThingWorx pagina Progetta di Composer per selezionare una categoria di widget. Di seguito è riportata una descrizione degli elementi inclusi in ogni categoria.
• Tutti: tutti i widget.
• Standard: i widget di tipo componente Web e i widget esistenti in ThingWorx Platform che non dispongono di un componente Web come sostituzione.
* 
Alcuni widget sono denominati componenti Web perché sono disponibili in ThingWorx Platform e possono essere importati anche da un SDK.
• Con tema applicabile: widget a cui è possibile applicare temi di stile. Questi widget sono classificati come Beta nelle release precedenti.
• Legacy: widget con sostituzioni che sono widget standard. I widget legacy saranno contrassegnati come obsoleti in una release futura.
• Importati: i widget importati in ThingWorx Platform sono elencati in questa categoria. Alcune di queste estensioni sono elencate in Estensioni. Alcune estensioni sono disponibili nella pagina PTC Software Download e possono essere importate in ThingWorx e utilizzate.
Nel pannello sono presenti sottocategorie che consentono di trovare i widget in base alla relativa funzione. I widget che eseguono una funzione simile sono elencati insieme in ognuna di queste sottocategorie. Ad esempio, nella sottocategoria Grafici è visualizzato un elenco di tutti i widget che possono eseguire il rendering di un grafico. È possibile selezionare le sottocategorie seguenti per trovare il widget da utilizzare nel mashup: Grafici, Collaborazione, Comuni, Componenti, Contenitori, Dati e Navigazione
Widget Posizionamento
È possibile trascinare il widget in una posizione su un mashup. È ad esempio possibile trascinare un widget su una radice di mashup o un oggetto contenitore, come un pannello o un set di campi.
Widget Proprietà
Tutti i widget dispongono di proprietà per configurare l'istanza specifica del widget su una pagina. Le proprietà vengono modificate nel riquadro delle proprietà del widget di Mashup Builder. Le proprietà possono essere impostate manualmente oppure associate ad altri servizi dati o eventi nel mashup. Se una proprietà è associabile, accanto al nome della proprietà è presente una freccia rivolta verso l'input (il valore della proprietà può essere impostato da un'altra origine) e una feccia rivolta verso l'output (il valore della proprietà può essere l'origine del valore di un'altra proprietà o parametro) o entrambe. Le proprietà seguenti sono condivise da tutti i widget:
• Id - Identificatore univoco utilizzato internamente da ThingWorx.
• Type - Tipo di widget.
• DisplayName - Nome descrittivo definito dall'utente per identificare il widget.
• Description - Descrizione definita dall'utente.
• Top - Coordinata Y in alto per la posizione del widget.
• Left - Coordinata X a sinistra per la posizione del widget.
• Width - Larghezza in pixel.
• Height - Altezza in pixel.
• Z-index - Ordine per i widget sovrapposti. In genere, un indice Z inferiore sposta il widget dietro un altro widget con un indice Z più elevato.
• ShowDataLoading - Visualizza i dati durante il caricamento.
• Visible - Visualizza il widget durante la visualizzazione del mashup.
Se un valore di proprietà viene impostato manualmente, lo sfondo della riga della proprietà viene evidenziato. Se la proprietà ha un'associazione, viene compilata la freccia di input pertinente.
Widget Configurazione
È possibile aprire la finestra di dialogo di configurazione del widget in uno dei modi descritti di seguito.
• Posizionare il puntatore del mouse sulla freccia a discesa nell'angolo superiore sinistro del contenitore del widget, quindi scegliere Configura associazioni dall'elenco.
• Selezionare il widget, quindi fare clic sul comando nel pannello Proprietà.
La finestra di dialogo di configurazione elenca tutte le proprietà associabili del widget. È possibile visualizzare o impostare le origini e le destinazioni di associazione per ogni proprietà. Questa finestra di dialogo rappresenta un'alternativa al metodo di trascinamento della selezione standard per l'associazione. Alcuni widget, ad esempio Griglia avanzata, includono finestre di dialogo di configurazione in cui è possibile impostare opzioni specifiche per il widget.
Localizzazione per le applicazioni
Quando si fa clic sull'icona accanto a una proprietà di testo, il testo non è più impostato come statico ma viene basato sui token di localizzazione. Utilizzare la selezione avanzata, in modo da poter selezionare un token di localizzazione esistente o crearne uno nuovo. Quando si aggiunge un nuovo token di localizzazione, si aggiunge un nome token con namespace, che impedisce conflitti con i token di altre origini e consente agli sviluppatori e ai traduttori di utilizzare solo i token specifici dell'applicazione. Nel campo Valore stringa immettere il valore di testo di default. Una volta definiti tutti i token necessari per l'applicazione, è possibile esaminarli sulla pagina Token di localizzazione filtrando in base al nome del token. È consigliabile aggiungere informazioni su utilizzo e contesto per ogni token.
Per le traduzioni in altre lingue, verificare che esistano tabelle di localizzazione per tali lingue. È possibile utilizzare il menu Importazione/Esportazione per esportare le entità in un file XML. Immettere il token di localizzazione con namespace come prefisso token. Nel file di output XML le traduzioni per altre lingue devono essere aggiunte all'elemento <Rows/> vuoto. Quando le traduzioni sono pronte e dopo avere verificato che gli attributi delle tabelle di localizzazione name, description, languageCommon e languageNative sono corretti, è possibile importarle in ThingWorx. Verranno unite con le tabelle di localizzazione esistenti per la lingua.
Tenere presente quanto descritto di seguito.
• Se viene introdotta una nuova lingua, molti widget utilizzano i token della tabella di localizzazione del sistema. Questi token devono essere tradotti; tuttavia, non vi è un modo semplice per limitare il set di token a quelli utilizzati. Di conseguenza, questo è un passo di filtraggio manuale. Per le lingue esistenti, controllare se i token di sistema sono già stati tradotti.
• Durante l'esportazione e la modifica dei file XML, assicurarsi che venga mantenuta la codifica UTF-8. I problemi di codifica possono apparire come errori quando un file viene reimportato o come stringhe localizzate con punti interrogativi o altri caratteri imprevisti al posto delle lettere accentate. ThingWorx deve essere impostato per utilizzare UTF-8 come codifica file di default. Specificare l'opzione Java -Dfile.encoding=UTF-8 all'avvio.
Eventi del widget
Molti widget includono eventi in aggiunta alle proprietà. Gli eventi possono essere utilizzati per attivare i servizi dati. Se un widget include uno o più eventi, questi sono disponibili nel pannello Proprietà (con un'icona a forma di fulmine) e tramite il menu selezionabile con un clic. Dal menu selezionabile con un clic, è possibile trascinare un evento del widget in un servizio dati.
Stili dei widget
Le definizioni dello stile sono entità definite dal sistema per il controllo dell'aspetto e il rendering di un widget. Alcuni widget supportano anche le definizioni di stato, in modo da consentire di applicare dinamicamente gli stili in base ai valori dei dati. Per ulteriori informazioni, vedere le singole sezioni dei widget. Per informazioni sul pannello delle proprietà per lo stile dei widget, fare riferimento a Applicazione di temi.