Riquadri
Definizione e utilizzo
Il componente Riquadri è un widget che consente di visualizzare coppie nome-valore, note anche come attributi, in un formato di riquadro. Lo scopo del componente Riquadri consiste nell'evidenziare le principali informazioni in modo che gli utenti possano vederle in modo immediato. Il valore dell'attributo viene visualizzato nella metà superiore del riquadro e il nome dell'attributo viene visualizzato nella metà inferiore del riquadro. Il valore può richiedere fino a due righe e il nome può occupare fino a una riga. Se il valore o il nome è troppo lungo per adattarsi al riquadro, viene troncato e in questo caso sono presenti puntini di sospensione. I riquadri sono generalmente disposti su una singola riga. Se sono presenti troppi riquadri per una singola riga, le dimensioni dei riquadri si riducono in modo da adattarsi alla riga. Se i riquadri sono ancora troppi per una singola riga, vengono visualizzati anche su una seconda riga.
Di seguito è riportata un'immagine di esempio che mostra il componente Riquadri:
È possibile configurare il componente Riquadri nei modi descritti di seguito.
• Impostare il numero massimo di riquadri da visualizzare
• Aggiungere un attributo aggiuntivo
Riquadri generici è una configurazione predefinita generica disponibile per il componente Riquadri.
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.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] } | JSON in formato CCO |
TailoringName | Identifica in modo univoco un'istanza del componente Riquadri. 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. | Stringa |
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 | ||
|---|---|---|---|---|---|---|
attributes | Nomi delle proprietà per cui si prevedono dati dal sistema di back-end. Questi attributi possono essere recuperati dal sistema di back-end o essere aggiuntivi. | N/D | Obbligatoria | |||
maxTileCount | Numero massimo di attributi da visualizzare come riquadri. Se impostata su una stringa vuota, non vi sono vincoli sul numero di riquadri visualizzati. | N/D | Facoltativa | |||
Configurazioni di esempio
Per una configurazione di esempio per il componente Riquadri, vedere la configurazione Riquadri generici.
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 |
ProcessAttributesConfiguration | Elabora la configurazione degli attributi e divide gli attributi in predefiniti e aggiuntivi. Restituisce un JSON con coppie di valori chiave nel formato seguente: • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON Gli attributi vengono divisi in predefiniti e aggiuntivi in base al tipo di oggetto. Gli attributi con tipo di oggetto che termina con .Custom.Adapter o Custom.Implementation vengono trattati come attributi aggiuntivi. Tutti gli altri attributi sono considerati attributi predefiniti. Parametri: attributes (obbligatorio) - JSON con l'elenco di attributi predefiniti e attributi aggiuntivi. configuration (facoltativo) - JSON con la configurazione unita finale ottenuta dalla risorsa per la gestione delle personalizzazioni. Restituisce: JSON in formato CCO |
GetAttributesValues | Restituisce un JSON con attributi e il relativo valore. 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. attributes (obbligatorio) - JSON con l'elenco di attributi predefiniti e attributi aggiuntivi. Restituisce: JSON in formato CCO |
GetAdditionalAttributesValues | Restituisce un JSON con valori per attributi aggiuntivi. Questo servizio deve essere implementato tramite implementazione del componente. 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. attributes (obbligatorio) - JSON con l'elenco di attributi aggiuntivi. OOTBAttributesValues (facoltativo) - JSON in formato CCO con i valori degli attributi predefiniti restituiti da GetAttributesValues. Questi valori possono essere utilizzati per calcolare i valori per gli attributi aggiuntivi. Restituisce: JSON in formato CCO |
GetAdditionalAttributes | Restituisce l'elenco di attributi aggiuntivi che devono essere aggiunti all'elenco di attributi predefiniti disponibili. Parametri: nessuno Restituisce: JSON |
Definizione di implementazione
Per la definizione di implementazione per il componente Riquadri, vedere la configurazione Riquadri generici.