Identificativo elemento
Definizione e utilizzo
Il componente Identificativo elemento è un widget che consente di visualizzare informazioni di base, note anche come informazioni di identificativo, su un elemento specifico. Le informazioni vengono visualizzate in un pannello, in genere nella parte superiore della pagina dell'elemento. Il pannello contiene l'immagine, il titolo principale, il titolo secondario, l'icona secondaria e vari attributi di identificativo dell'elemento. L'icona secondaria indica il tipo di elemento e può essere configurata per l'utilizzo delle icone di Windchill. Il componente Identificativo elemento contiene inoltre una barra delle azioni incorporata con azioni che è possibile eseguire per l'elemento.
Di seguito è riportata un'immagine di esempio che mostra il componente Identificativo elemento:
È possibile configurare il componente Identificativo elemento nei modi descritti di seguito.
• Definire i titoli principale e secondario
• Configurare le azioni disponibili nella barra delle azioni incorporata
• Definire gli attributi di identificativo da visualizzare
• Scegliere se visualizzare un'immagine e definire un percorso predefinito dell'immagine
• Scegliere se visualizzare un'icona secondaria
• Scegliere se il pannello può essere compresso
Identificativo task, Identificativo parte e Identificativo documento sono le configurazioni predefinite disponibili per il componente Identificativo elemento.
Proprietà di associazione
Input | ||||
|---|---|---|---|---|
Nome proprietà | Descrizione | Tipo di proprietà | ||
Input | Utilizzato per identificare i dati da recuperare dal sistema di back-end. Di seguito è riportato un esempio: 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 Identificativo elemento. 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
La tabella e le immagini 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 | |||
|---|---|---|---|---|---|---|---|
actionBarConfiguration | Azioni da visualizzare nella barra delle azioni nell'interfaccia utente. Per ulteriori informazioni, vedere il componente Barra delle azioni. | N/D | Facoltativa | ||||
attributes | Elenco di attributi per i quali vengono recuperati i dati dal sistema di back-end.
| N/D | Facoltativa | ||||
defaultImagePath | Percorso di default per il recupero dell'immagine. Questa proprietà è una sottoproprietà di showImage ed è pertinente solo quando showImage è impostata su true. La chiave contenitore è itemIdentityShowImageDefinition. | N/D | Obbligatoria quando showImage è impostata su true. | ||||
enableExpandCollapse | Determina se il pannello Identificativo elemento può essere compresso ed espanso nell'interfaccia utente. Se impostata su true, il pannello può essere espanso per mostrare tutte le informazioni o compresso per mostrare solo il titolo principale e, quando pertinente, la barra delle azioni. Se impostata su false, il pannello non può essere espanso o compresso. Il pannello appare espanso o compresso a seconda del valore impostato per la proprietà expanded. | true | Obbligatoria | ||||
expanded | Determina se lo stato di default del pannello Identificativo elemento è espanso o compresso. Se impostata su true, il pannello è espanso per default. Se impostata su false, il pannello è compresso per default. | true | Obbligatoria | ||||
primaryTitle | Titolo principale che viene visualizzato nella parte superiore del pannello Identificativo elemento. | N/D | Obbligatoria | ||||
secondaryTitle | Titolo secondario, che viene visualizzato sotto il titolo principale nel pannello Identificativo elemento. | N/D | Obbligatoria | ||||
showImage | Determina se visualizzare un'immagine nel pannello Identificativo elemento. Opzioni: true e false. Se impostata su true, nel pannello viene visualizzata un'immagine. Definire il percorso dell'immagine utilizzando la proprietà defaultImagePath. Se impostata su false, non viene visualizzata alcuna immagine. | N/D | Obbligatoria | ||||
showSecondaryIcon | Scegliere se visualizzare un'icona secondaria. Opzioni: true e false. Se impostata su true, nel pannello viene visualizzata un'icona secondaria. Se impostata su false, non viene visualizzata alcuna icona secondaria. | false | Obbligatoria | ||||
Configurazione di esempio
Per le configurazioni di esempio per il componente Identificativo elemento, vedere Identificativo task, Identificativo parte e Identificativo documento.
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. Il componente Identificativo elemento non supporta l'utilizzo di soli attributi con tipo di oggetto che termina in .Custom.Implementation. Assicurarsi di utilizzare almeno un attributo con un tipo di oggetto diverso. 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 |
GetItemIdentityAttributes | Controlla la configurazione e aggiunge tutti gli attributi aggiuntivi necessari, quindi chiama GetAttributeValues per recuperare tutti i valori di attributo dal sistema di back-end. 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, come definito nella configurazione o impostato tramite personalizzazione. Restituisce: JSON |
GetAttributesValues | Restituisce un JSON con attributi e i relativi valori. 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 |
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 le definizioni di implementazione per il componente Identificativo elemento, vedere Identificativo task, Identificativo parte e Identificativo documento.