Configurazione di Windchill Digital Product Traceability Extension
1. Importare l'estensione e verificare le entità ThingWorx e gli esempi di riferimento.
a. Windchill_Digital_Product_Traceability-extension - Importare questo file ZIP in ThingWorx Platform. Verificare che le seguenti entità esistano in ThingWorx Composer dopo l'importazione dell'estensione DPT:
 |
La versione del prodotto Windchill nell'estensione importata viene visualizzata nel seguente formato:
xx.x.xxx
In questo caso, le prime quattro cifre rappresentano la release di Windchill e le ultime due cifre rappresentano il numero di release del set di patch critiche (CPS).
Ad esempio, una release CPS 03 di Windchill release 12.0.0 è rappresentata come 12.0.003 nell'estensione.
|
|
Entità
|
Descrizione
|
Tipo
|
||
|---|---|---|---|---|
|
OslcDataServicesThing
|
Questo oggetto contiene i servizi per le risorse OSLC richiamate da Windchill.
|
Thing
|
||
|
OslcFlowsThing
|
Questo oggetto contiene i servizi di flusso che recuperano i dati dal sistema OSLC remoto utilizzando ThingWorx Flow.
|
Thing
|
||
|
OslcValidationFlowThing
|
Questo oggetto contiene l'oggetto flusso di convalida di default.
|
Thing
|
||
|
OslcValidationServicesThing
|
Questo oggetto contiene i servizi di convalida per le risorse OSLC richiamate da Windchill.
|
Thing
|
||
|
PTC-PLM
|
• Il tag modello PTC-PLM:TRACELINKS viene utilizzato per contrassegnare tutte le entità disponibili nell'estensione. Per ulteriori informazioni, vedere l'argomento della guida Tag in ThingWorx Platform Help Center.
• Il tag modello PTC-PLM:TRACELINKS-DPT-EXTENSION-PROPERTIES, per default, consente a Windchill Digital Product Traceability Extension di utilizzare DPTExtensionPropertiesExampleConfigThing.
• Quando il tag modello PTC-PLM:TRACELINKS ROOT SELECTION DIALOG è aggiunto all'oggetto di configurazione, la radice viene visualizzata nella tabella Seleziona contesto. Quando il tag non viene aggiunto, nella tabella Seleziona contesto viene visualizzata la struttura ad albero completa. Questo tag è specifico di PTC Modeler.
• Il tag modello PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH, se aggiunto all'oggetto di configurazione, utilizza il selettore di ricerca delle risorse esterne per visualizzare la risorsa OSLC esterna. Quando questo tag non viene aggiunto, la finestra di dialogo Selezione visualizza la risorsa OSLC esterna. Per impostazione predefinita, il tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH viene aggiunto a ModelerExampleConfigThing e CodebeamerExampleThing.
• Il tag modello PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL deve essere specificato per l'oggetto di configurazione di esempio IBM Rational Doors NG quando si utilizza il tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH.
|
ModelTagVocabulary
|
||
|
PTC-PLM-VALIDATION-FLOWS
|
Il tag modello PTC-PLM-VALIDATION:modeler viene utilizzato per identificare un oggetto flusso di convalida per riferimento. Per ulteriori informazioni, vedere l'argomento della guida Tag in ThingWorx Platform Help Center.
|
ModelTagVocabulary
|
||
|
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
|
Questa data shape viene utilizzata in OSLCResourceAttributeMappingConfigTable per la mappatura degli attributi.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
|
Contiene le proprietà di configurazione per Windchill_Digital_Product_Traceability-extension.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingShape
|
Questa thing shape contiene il contratto di servizio definito per Windchill.
|
ThingShape
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
|
Questo modello di oggetto contiene i servizi di dati definiti per Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcFlowsTemplate
|
Questo modello di oggetto contiene i servizi di flusso.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
|
Questo modello di oggetto viene utilizzato per creare l'oggetto di configurazione per ciascun sistema esterno.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
|
Questo modello di oggetto contiene i servizi di convalida per Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
|
Questa data shape viene utilizzata in OSLCResourceShapeConfigTable per la mappatura degli attributi.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
|
Questa data shape viene utilizzata in OSLCSearchResultConfigTable per la mappatura degli attributi.
|
DataShape
|
||
|
TRACELINKS
|
TRACELINKS: il tag modello OSLC-FLOWS viene utilizzato per contrassegnare tutte le entità disponibili nell'estensione. Per ulteriori informazioni, vedere l'argomento della guida Tag in ThingWorx Platform Help Center.
|
ModelTagVocabulary
|
||
|
Windchill_Digital_Product_Traceability-xx.x.xxx.jar
|
Questa risorsa fa parte di Windchill_Digital_Product_Traceability-extension.
|
Resource
|
|
|
Verificare che i permessi corretti siano attivati nelle entità elencate in precedenza. Vedere la sezione Permessi per le entità di ThingWorx Platform.
|
|
|
Un tag modello è costituito da vocabolario e termini. Ad esempio, nel tag PTC-PLM-ValidationFlows:modeler, PTC-PLM-ValidationFlows è il vocabolario e modeler è il valore per termini. Il valore di un tag modello è univoco per un oggetto.
|
b. Windchill_Digital_Product_Traceability_Config_Things - Estrarre la cartella, quindi importare ogni file XML in ThingWorx Platform. Utilizzare gli oggetti dell'esempio di riferimento come riferimento per la configurazione di oggetti. Verificare che i seguenti file XML siano stati importati:
|
Entità
|
Descrizione
|
||||||
|---|---|---|---|---|---|---|---|
|
DoorsExampleConfigThing
|
Questo oggetto di esempio contiene la configurazione di riferimento per IBM Rational Doors NG.
|
||||||
|
ModelerExampleConfigThing
|
Questo oggetto di esempio contiene la configurazione di riferimento per PTC Modeler.
|
||||||
|
WRVSExampleConfigThing
|
Questo oggetto di esempio contiene la configurazione di riferimento per PTC RV&S.
|
||||||
|
CodebeamerExampleThing
|
Questo oggetto di esempio contiene la configurazione di riferimento per Codebeamer.
|
||||||
|
DPTExtensionPropertiesExampleConfigThing
|
Se contrassegnato con il tag modello TRACELINKS-DPT-EXTENSION-PROPERTIES, Windchill Digital Product Traceability Extension può utilizzare le proprietà definite di seguito riportate.
• CACHE-EXPIRY - Determina la validità delle voci della cache. L'impostazione di default è 5 minuti.
• SCHEDULER-INTERVAL - Determina la frequenza con cui le voci della cache vengono eliminate automaticamente. L'impostazione di default è 30 minuti.
• CACHE-USERS - Determina il numero di utenti nelle voci della cache. L'impostazione di default è 200.
• CACHE-RESOURCES - Determina il numero di risorse che è possibile memorizzare nella cache per ogni utente. L'impostazione di default è 100.
• LARGE-PREVIEW-SHOW-DIMENSIONS - Determina se mostrare l'anteprima grande in una nuova scheda. Se impostata su No, il valore di default, l'anteprima grande viene visualizzata in una nuova scheda. Se impostata su Yes, l'anteprima si apre in una finestra popup.
• OSLC-QUERY-PAGESIZE - Determina il numero di oggetti remoti che devono essere visualizzati per pagina. Per impostazione predefinita, questa proprietà è impostata su 50.
• DEFINE-RESOURCETYPE-ATTRIBUTE - Specifica il nome dell'attributo del server OSLC di PTC Modeler che restituisce il valore del tipo di risorsa. Il valore di default è impostato su ptc_im_am:dynamicUmlClassName.
|
||||||
|
ModelerValidationFlowThing
|
Questo oggetto di esempio contiene riferimenti per la personalizzazione del flusso di convalida per PTC Modeler. Un amministratore può personalizzare un oggetto flusso di convalida in base al requisito aziendale.
|
2. In ThingWorx Flow, utilizzare le istruzioni riportate di seguito e creare una nuova connessione per il sistema OSLC con cui è necessaria l'integrazione. Vedere l'argomento Creazione e gestione di connessioni in ThingWorx Platform Help Center.
a. Creare una Connessione per il sistema OSLC.
▪ Per l'autenticazione di base, selezionare il tipo di connessione OSLC di base.
▪ Per la configurazione SSO, creare una connessione OAuth.
|
|
È necessario accettare l'approvazione della concessione per l'oggetto di connessione alla sessione OAuth di OSLC. Per ulteriori informazioni, vedere Creazione della connessione client OAuth per ThingWorx.
|
b. Immettere le seguenti informazioni nella finestra Aggiungi connessione:
▪ Etichetta connessione - Digitare un nome per la connessione. Il nome della connessione specificato qui viene utilizzato nell'oggetto di configurazione.
▪ URL catalogo - Digitare l'URL catalogo del server OSLC del sistema esterno. Fare riferimento alla guida PTC RV&S OSLC Client, a partire da 12.3.0.0, disponibile nella pagina Documentazione di riferimento, OSLC integration with Integrity Modeler e OSLC integration with IBM Rational DOORS Next Generation in PTC Modeler Help Center.
|
|
Fare riferimento alla documentazione relativa alla versione supportata delle applicazioni PTC RV&S e PTC Modeler.
|
▪ Credenziali di accesso all'account di servizio del sistema esterno per accedere al server OSLC.
▪ Richieste simultanee - Specificare il numero di richieste di risorse simultanee richiamate da ThingWorx Flow. Il valore di default è 5.
Gli amministratori possono modificare il numero di richieste in base alla configurazione del server.
c. Salvare la connessione.
d. Fare clic su Chiudi.
3. Configurare ThingWorx Platform per l'integrazione con i server OSLC del sistema esterno. In ThingWorx Platform, creare un oggetto di configurazione e convalida.
a. Per creare un oggetto di configurazione, attenersi alla procedura descritta di seguito.
i. Accedere a > e specificare i valori degli attributi. Selezionare PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate come Modello di oggetto di base.
ii. Nella scheda Configurazione, configurare le mappature come descritto nelle tabelle riportate di seguito. È possibile fare riferimento a WRVSExampleConfigThing come un esempio e immettere i dettagli per il sistema OSLC.
▪ OSLCServerMappingConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
Server
|
Nome del server OSLC esterno.
|
|
BaseUrl
|
URL di base del server OSLC esterno.
|
|
ConnectionObject
|
Nome della connessione creata per il server OSLC esterno.
|
|
Tag
|
Valore di Termini definito nel vocabolario del tag modello PTC-PLM-Validation-Flows per identificare il server remoto.
Questo passo è facoltativo. Questo passo è obbligatorio solo quando si utilizza un flusso di convalida.
Per ulteriori informazioni sull'aggiunta di tag, vedere l'argomento della guida Tag in ThingWorx Platform Help Center.
|
▪ OSLCResourceMappingConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
WindchillType
|
Nome interno della risorsa requisito o della risorsa architettura nella gestione dei tipi in Windchill. Il link di traccia viene creato per questa risorsa.
|
|
OSLCResourceType
|
Tipo di risorsa requisito, risorsa architettura o relativi sottotipi definiti nel server OSLC esterno. Il valore di OSLCResourceType corrisponde al nome delle risorse e dei relativi sottotipi configurati nel server OSLC esterno. Ad esempio, in PTC Modeler, l'attività è definita come sottotipo di risorsa del dominio dell'architettura. Un utente può definire il nome come Risorsa|Attività dove Attività è il sottotipo per la Risorsa di tipo OSLC appartenente al dominio dell'architettura. Il nome specificato per un tipo di risorsa architettura deve essere separato da barra verticale.
|
Per informazioni sul nome interno della risorsa requisito o della risorsa architettura, vedere Tipi e attributi in Compatibilità e requisiti del sistema.
 |
Non rimappare un tipo di risorsa OSLC al tipo di oggetto Windchill se il tipo di risorsa OSLC è già mappato a un tipo di oggetto Windchill. Una nuova mappatura del tipo di oggetto Windchill al tipo di risorsa OSLC, definita inizialmente in ThingWorx, dopo che l'oggetto è stato tracciato in Windchill, può causare il danneggiamento dei dati.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
WindchillTableId
|
ID di tabella in Windchill, che visualizza i dati provenienti dal server OSLC esterno.
|
|
WindchillType
|
Nome interno della risorsa requisito o della risorsa architettura specificato in Gestione tipi e attributi in Windchill.
|
▪ Mappatura degli attributi per OSLCResourceAttributeMappingConfigTable
|
Attributo
|
Descrizione
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nome dell'attributo di Windchill da visualizzare nella tabella di Windchill.
|
||
|
OSLCResourceAttribute
|
Nome dell'attributo della risorsa OSLC.
|
||
|
WindchillAttributeDataType
|
Tipo di dati dell'attributo di Windchill. String, Timestamp e RichText sono i valori dei tipi di dati supportati per impostazione predefinita.
|
||
|
IsPreview
|
Quando l'opzione IsPreview è selezionata per un attributo, visualizza la rappresentazione HTML dell'oggetto remoto tracciato come esposto dal server OSLC esterno.
Selezionare la casella di controllo IsPreview per visualizzare anteprime piccole e grandi.
IsPreview è disponibile negli attributi del tipo di dati String e RichText. L'anteprima piccola viene visualizzata per entrambi i tipi di dati mentre l'anteprima grande viene visualizzata solo per gli attributi del tipo di dati String.
|
▪ OSLCResourceShapeConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
OSLCResourceType
|
Tipi di risorsa supportati per dominio Requisito, Architettura o Cambio definiti nel server OSLC esterno. Il valore di OSLCResourceType corrisponde al nome delle risorse configurate nel server OSLC esterno.
|
|
OSLCResourceShapeURI
|
URI della resource shape OSLC per i server OSLC che non espongono la resource shape con il servizio di interrogazione OSLC, ma espongono la resource shape con un altro servizio. Ad esempio, il server OSLC di IBM Rational Doors NG espone la resource shape con il servizio Creation Factory.
|
▪ Mappatura degli attributi per OSLCResourceShapeConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
WindchillAttribute
|
Nome dell'attributo Windchill da visualizzare nel riquadro Criteri filtro del selettore di ricerca delle risorse esterne.
|
|
OSLCResourceAttribute
|
Per aggiungere un valore per un attributo OSLC, attenersi alla convenzione di denominazione prefix:propertyName. In questo caso, prefix è l'affisso aggiunto prima del nome della proprietà e propertyName è il nome dell'attributo definito dal server OSLC. Ad esempio, per un attributo state esposto dal server OSLC di PTC RV&S, il valore OSLCResourceAttribute è dcterms:state.
|
|
OSLCAttributeDataType
|
Tipo di dati della risorsa OSLC. String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float e Integer sono i valori dei tipi di dati supportati da OSLC.
|
▪ OSLCSearchResultConfigTable
|
Attributo
|
Descrizione
|
|---|---|
|
WindchillType
|
Tipi di risorsa Windchill supportati per dominio Requisito, Architettura o Cambio.
|
▪ Mappatura degli attributi per OSLCSearchResultConfigTable
|
Attributo
|
Descrizione
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nome dell'attributo Windchill da visualizzare nel riquadro Tabella risultati della ricerca del selettore di ricerca delle risorse esterne.
|
||
|
OSLCResourceAttribute
|
Nome dell'attributo della risorsa OSLC.
|
||
|
WindchillAttributeDataType
|
Tipo di dati dell'attributo di Windchill. String, Timestamp e RichText sono i valori dei tipi di dati supportati per impostazione predefinita.
|
iii. Fare clic su Salva e continua.
b. Un oggetto flusso di convalida comprende i servizi di flusso che confermano se un tipo di risorsa selezionato in Windchill corrisponde al tipo di risorsa OSLC selezionato nella finestra di dialogo delegata OSLC. Il tipo di risorsa Windchill è disponibile nel menu Tipo nella finestra Aggiungi tracce. ModelerValidationFlowThing è un oggetto flusso di esempio disponibile per impostazione predefinita. La figura seguente illustra il workflow di convalida:
Per creare un oggetto flusso di convalida, attenersi alla procedura descritta di seguito. L'importazione dell'oggetto di esempio ModelerValidationFlowThing è un prerequisito per la creazione di un oggetto flusso di convalida
i. Selezionare ModelerValidationFlowThing e fare clic su Duplica.
ii. Nella scheda Informazioni generali, specificare il valore degli attributi Nome e Tag.
Il tag prende il valore di Termini creato nel vocabolario del tag modello PTC-PLM-Validation-Flows per identificare il server esterno. Nel tag PTC-PLM-Validation-Flows, specificare un valore in Termini per il server esterno con cui si desidera eseguire l'integrazione. Specificare lo stesso valore di Termini nel campo Tag in OSLCServerMappingConfigTable.
iii. Fare clic su Salva.
Per ulteriori informazioni sui prerequisiti necessari per la configurazione dell'estensione DPT in ThingWorx Platform, vedere Prerequisiti.
Per ulteriori informazioni sui permessi richiesti dai profili utente di ThingWorx, vedere Permessi per le entità di ThingWorx Platform.