Attributi
Definizione e utilizzo
Il componente Attributi è un widget che visualizza coppie nome-valore. Il valore viene sempre visualizzato sotto il nome. È possibile visualizzare i valori di tipi di dati diversi. Un insieme di attributi può essere presentato come gruppo utilizzando un nome del gruppo.
Di seguito sono riportate le immagini di esempio che mostrano il componente Attributi.
Gli attributi per la parte o il documento selezionato vengono visualizzati nel riquadro di anteprima sul lato destro dello schermo, come illustrato nell'immagine seguente.
È possibile configurare il componente Attributi nei modi descritti di seguito.
• Definire gli attributi da visualizzare.
• Impostare il layout e le impostazioni di visualizzazione correlate.
• Definire il titolo per un gruppo di attributi. Questa impostazione è disponibile solo per i gruppi di attributi con layout verticale.
• Aggiungere un link a uno dei task predefiniti su un attributo utilizzando un elemento Decorator. Al momento è supportato solo il primo elemento Decorator trovato nell'elenco degli elementi Decorator.
Per aggiungere un link a un attributo, nella configurazione in uso aggiungere l'elemento Decorator comprensivo di appId e thingName (PTC.Nav.LinkToAppDecoratorThing) all'attributo. Ad esempio:
 | A partire da Windchill Navigate 9.4.0, la chiave decoratedType è stata spostata sotto la chiave decoration nella sezione metadata della configurazione. |
metadata: {
Number: {
"label": "Number",
"type": "STRING",
"decoration": {
"decoratedType": "HTML",
"decorators": [{
"thingName": "PTC.Nav.LinkToAppDecoratorThing",
"parameters": {
"appId": "PTC.Nav.ViewDesignFiles"
}
}]
}
Number: {
"label": "Number",
"type": "STRING",
"decoration": {
"decoratedType": "HTML",
"decorators": [{
"thingName": "PTC.Nav.LinkToAppDecoratorThing",
"parameters": {
"appId": "PTC.Nav.ViewDesignFiles"
}
}]
}
È possibile accedere ai task seguenti utilizzando i rispettivi ID app elencati di seguito:
Task | ID app |
|---|---|
RACCOLTA DI TASK PER LE PARTI | |
Visualizza file di progetto | PTC.Nav.ViewDesignFiles |
Visualizza disegno | PTC.Nav.ViewDrawing |
Visualizza e misura in 3D | PTC.Nav.ViewAndMeasureIn3D |
Visualizza proprietà parte | PTC.Nav.ViewPartProperties |
Visualizza elenco parti | PTC.Nav.ViewPartList |
Visualizza struttura parti | PTC.Nav.ViewPartStructure |
RACCOLTA DI TASK PER I DOCUMENTI | |
Visualizza documento | PTC.Nav.ViewDocument |
Visualizza struttura documento | PTC.Nav.ViewDocumentStructure |
Attributi generici è una configurazione predefinita generica disponibile per il componente Attributi.
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 Attributi. 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 |
SubComponentConfiguration | Associa la configurazione a questa proprietà quando il componente viene utilizzato come sottocomponente all'interno di un altro componente o all'interno di un mashup incorporato. JSON di esempio: { "implementationThingName":"PTC.Nav.AttributesGenericBusinessLogicThing", "configuration":{ "layout":{ "selectedKey":"horizontal", "additionalData":{ }, "version":"1.0.0" }, "attributes":{ "sets":[ { "data":{ "selectedValues":{ "data":[ { "itemListsData":[ { "items":[ { "id":"Role#Display", "ordinal":0 }, { "id":"Activity|Deadline", "ordinal":5 }, { "id":"Status#Display", "ordinal":4 } ], "objectType":"PTC.Workflow.WorkItem" }, { "items":[ { "id":"Category#Display", "ordinal":1 }, { "id":"RequestPriority#Display", "ordinal":3 } ], "objectType":"PTC.ChangeMgmt.ChangeRequest" } ], "adapter":{ "instanceName":"windchill", "thingName":"PTC.WCAdapter" } } ] } } } ] } } } | JSON |
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 | |
|---|---|---|---|---|---|
attributes | Elenco di attributi per cui devono essere recuperati i dati dal sistema di back-end. Per Windchill, questi nomi delle proprietà devono coincidere con quelli definiti da Windchill REST Services EDM. Accetta inoltre l'attributo DefaultPDFRepresentation, che ha il tipo di oggetto PTC.DocMgmt.DocStructure:PTC.Visualization.Representation.Custom.Adapter. Quando l'attributo DefaultPDFRepresentation è incluso nella configurazione, include un attributo Rappresentazione. L'attributo Rappresentazione contiene un link per visualizzare la rappresentazione dell'elemento, se disponibile. | N/D | Obbligatoria | ||
isMultiLine | Determina se il contenuto deve essere racchiuso. Opzioni: true e false. Questa proprietà è una sottoproprietà di layout ed è pertinente solo quando layout è impostata su vertical. La chiave contenitore è isMultilineDefinition. | N/D | Obbligatoria | ||
layout | Determina la modalità di disposizione degli attributi nell'interfaccia utente. Sono disponibili le opzioni riportate di seguito. • vertical: gli attributi sono impilati. • horizontal: gli attributi sono affiancati. Le sottoproprietà disponibili per layout variano a seconda che sia selezionato vertical o horizontal. Per ulteriori informazioni, vedere le configurazioni di esempio di Attributi generici. | N/D | Obbligatoria | ||
maxHeight | Altezza massima per il nome e il valore dell'attributo nell'interfaccia utente. Se il contenuto supera il valore della proprietà maxHeight, è disponibile il link o pulsante "mostra di più/mostra di meno". Questa proprietà è pertinente solo per i due casi riportati di seguito. • Quando layout è impostata su horizontal. In questo caso si tratta di una sottoproprietà di layout. • Quando layout è impostata su vertical e isMultiLine su true. In questo caso si tratta di una sottoproprietà di isMultiLine. La chiave contenitore è dimensionDefinition. | N/D | Obbligatoria | ||
maxWidth | Larghezza massima per il nome e il valore di un attributo nell'interfaccia utente. Questa proprietà è pertinente solo per i due casi riportati di seguito. • Quando layout è impostata su horizontal. In questo caso si tratta di una sottoproprietà di layout. • Quando layout è impostata su vertical e isMultiLine su false. In questo caso si tratta di una sottoproprietà di isMultiLine. La chiave contenitore è dimensionDefinition. | N/D | Obbligatoria | ||
messageWhenNoAttributes | Consente di visualizzare un messaggio quando non sono disponibili attributi. Questo valore può essere lasciato vuoto. In questo caso, non viene visualizzato alcun messaggio e non viene mantenuto alcun segnaposto speciale. | N/D | Facoltativo | ||
hideLabel | Controlla la visibilità delle etichette degli attributi. • Impostare la proprietà su true per nascondere l'etichetta dell'attributo. • Impostare la proprietà su false per visualizzare l'etichetta dell'attributo. | false | Facoltativo | ||
Configurazione di esempio
Per una configurazione di esempio per il componente Attributi, vedere la configurazione Attributi 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 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 |
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 |
UpdateAvailableAttributes | Aggiorna uno o più attributi dall'elenco di attributi e restituisce l'elenco finale. Parametri: attributes (obbligatorio) - JSON con l'elenco di attributi predefiniti e attributi aggiuntivi. Restituisce: JSON |
Definizione di implementazione
Per la definizione di implementazione per il componente Attributi, vedere la configurazione Attributi generici.