Windchill DPT Extension konfigurieren
1. Importieren Sie die Erweiterung und die erforderlichen PTC Referenz-Konfigurationsdinge, und überprüfen Sie die ThingWorx Entitäten.
a. Windchill_Digital_Product_Traceability-extension – Importieren Sie diese ZIP-Datei in die ThingWorx Platform. Stellen Sie nach dem Import der DPT-Erweiterung sicher, dass die folgenden Entitäten in ThingWorx Composer vorhanden sind:
 |
Die Windchill Produktversion in der importierten Erweiterung wird im folgenden Format angezeigt: xx.x.xxx. Die ersten vier Stellen stehen für die Windchill Version und die letzten beiden Stellen für die Versionsnummer des kritischen Patch-Sets (CPS, Critical Patch Set).
Beispielsweise wird eine Version CPS 03 von Windchill 12.0.0 in der Erweiterung als 12.0.003 dargestellt.
|
|
Entität
|
Beschreibung
|
Typ
|
||
|---|---|---|---|---|
|
DPTAdminConfigThing
|
Dieses Konfigurationsding enthält den Dienst zum Erstellen der "DPTEndUserGroup" und "DPTConfiguratorGroup" sowie zum Zuweisen der erforderlichen Berechtigungen zu den ThingWorx Platform Entitäten.
|
ConfigThing
|
||
|
OslcDataServicesThing
|
Dieses Ding enthält die Dienste für die OSLC-Ressourcen, die von Windchill aus aufgerufen werden.
|
Thing
|
||
|
OslcFlowsThing
|
Dieses Ding enthält die Flow Dienste, die mithilfe von ThingWorx Flow Daten aus dem Remote-OSLC-System abrufen.
|
Thing
|
||
|
OslcValidationFlowThing
|
Dieses Ding enthält das Standard-Validierungs-Flow-Ding.
|
Thing
|
||
|
OslcValidationServicesThing
|
Dieses Ding enthält Validierungsdienste für OSLC-Ressourcen, die von Windchill aus aufgerufen werden.
|
Thing
|
||
|
PTC-PLM
|
• Mit dem Modell-Tag "PTC-PLM:TRACELINKS" werden alle in der Erweiterung verfügbaren Entitäten gekennzeichnet. Weitere Informationen finden Sie im Hilfethema "Tags" im ThingWorx Platform Hilfe-Center.
• Mit dem Modell-Tag "PTC-PLM:TRACELINKS-DPT-EXTENSION-PROPERTIES" wird standardmäßig die Windchill DPT-Erweiterung für die Verwendung des DPTExtensionPropertiesConfigThing aktiviert.
• Wenn das Modell-Tag "PTC-PLM:TRACELINKS ROOT SELECTION DIALOG" dem Konfigurationsding hinzugefügt wird, wird der Stamm in der Tabelle Kontext auswählen angezeigt. Wird das Tag nicht hinzugefügt, so wird die vollständige Baumstruktur in der Tabelle Kontext auswählen angezeigt. Dieses Tag ist spezifisch für PTC Modeler.
• Wenn das Modell-Tag "PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH" dem Konfigurationsding hinzugefügt wird, verwendet es die Suchauswahl für externe Ressourcen, um externe OSLC-Ressourcen anzuzeigen. Wenn dieses Tag nicht hinzugefügt wird, zeigt das Auswahldialogfenster die externe OSLC-Ressource an. Standardmäßig wird dem PTCModelerConfigThing das Tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH hinzugefügt. PTC empfiehlt nicht, das Tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH zu PTCPolarionConfigThing hinzuzufügen.
• Bei Verwendung des Tags "PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH" sollte für das IBM Rational Doors NG Referenz-Konfigurationsding das Modell-Tag "PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL" festgelegt werden.
|
ModelTagVocabulary
|
||
|
PTC-PLM-VALIDATION-FLOWS
|
Mit dem Modell-Tag "PTC-PLM-VALIDATION:modeler" wird ein Validierungs-Flow-Ding identifiziert. Weitere Informationen finden Sie im Thema "Tags" im ThingWorx Platform Hilfe-Center.
|
ModelTagVocabulary
|
||
|
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
|
Dieser Data Shape wird in OSLCResourceAttributeMappingConfigTable für die Attributzuordnung verwendet.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
|
Diese Dingvorlage enthält die Konfigurationseigenschaften für Windchill_Digital_Product_Traceability-extension.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingShape
|
Diese Dingform enthält den für Windchill definierten Servicevertrag.
|
ThingShape
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
|
Diese Dingvorlage enthält für Windchill definierte Datendienste.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcFlowsTemplate
|
Diese Dingvorlage enthält die Flow Dienste.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
|
Mit dieser Dingvorlage wird das Konfigurationsding für jedes externe System erstellt.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
|
Diese Dingvorlage enthält Validierungsdienste für Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
|
Dieser Data Shape wird in OSLCResourceShapeConfigTable für die Attributzuordnung verwendet.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
|
Dieser Data Shape wird in OSLCSearchResultConfigTable für die Attributzuordnung verwendet.
|
DataShape
|
||
|
TRACELINKS
|
Mit dem Modell-Tag "TRACELINKS:OSLC-FLOWS" werden alle in der Erweiterung verfügbaren Entitäten gekennzeichnet. Weitere Informationen finden Sie im Thema "Tags" im ThingWorx Platform Hilfe-Center.
|
ModelTagVocabulary
|
||
|
Windchill_Digital_Product_Traceability-xx.x.xxx.jar
|
Diese Ressource ist ein Teil der Datei Windchill_Digital_Product_Traceability-extension.
|
Ressource
|
|
|
Stellen Sie sicher, dass Sie für die vorstehenden Entitäten über die erforderlichen Berechtigungen verfügen. Weitere Informationen finden Sie im Abschnitt Standardberechtigungen für ThingWorx Platform Entitäten.
|
|
|
Ein Modell-Tag besteht aus Vokabular und Ausdrücken. Der Wert eines Modell-Tags ist für ein Ding eindeutig.
|
b. Windchill_Digital_Product_Traceability_Config_Things – Extrahieren Sie den Ordner, und importieren Sie dann das erforderliche PTC Referenz-Konfigurationsding zusammen mit dem DPTExtensionPropertiesReferenceConfigThing in die ThingWorx Platform. Verwenden Sie die importierten Referenz-Konfigurationsdinge als Referenz für standardmäßige unterstützte und validierte Konfigurationen.
|
Entitäten
|
Beschreibung
|
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
PTCDoorsConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für IBM Rational Doors NG, einschließlich aller Windchill zu IBM Rational Doors NG OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCModelerConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für PTC Modeler, einschließlich aller Windchill zu PTC Modeler OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCRVSConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für PTC RV&S, einschließlich aller Windchill zu PTC RV&S OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCCodebeamerConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für Codebeamer, einschließlich aller Windchill zu Codebeamer OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCPolarionConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für Siemens Polarion, einschließlich aller Windchill zu Siemens Polarion OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCJiraConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für Jira (SodiusWillert), einschließlich aller Windchill zu Jira OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
PTCCatiaConfigThing
|
Dieses Konfigurationsding enthält Referenzkonfigurationen für CATIA Magic Collaboration Studio, einschließlich aller Windchill zu CATIA Magic Collaboration Studio OSLC-Datenzuordnungen und Konfigurationen.
|
||||||||
|
DPTExtensionPropertiesConfigThing
|
Ist dieses Ding mit dem Modell-Tag TRACELINKS-DPT-EXTENSION-PROPERTIES gekennzeichnet, so kann die Windchill DPT Extension die folgenden definierten Eigenschaften verwenden.
• CACHE-EXPIRY – Bestimmt die Gültigkeit von Cache-Einträgen. Die Standardeinstellung ist 5 Minuten.
• SCHEDULER-INTERVAL – Bestimmt, wie häufig die Cache-Einträge automatisch bereinigt werden. Die Standardeinstellung ist 30 Minuten.
• CACHE-USERS – Bestimmt die Anzahl der Benutzer in den Cache-Einträgen. Die Standardeinstellung ist 200.
• CACHE-RESOURCES – Bestimmt die Anzahl der Ressourcen, die pro Benutzer zwischengespeichert werden können. Die Standardeinstellung ist 100.
• LARGE-PREVIEW-SHOW-DIMENSIONS – Bestimmt, ob eine große Vorschau in einer neuen Registerkarte angezeigt wird. Bei Einstellung auf No (Standardvorgabe) wird die große Vorschau in einer neuen Registerkarte geöffnet. Bei Einstellung auf Yes wird die Vorschau in einem Popup-Fenster geöffnet.
• OSLC-QUERY-PAGESIZE – Bestimmt die Anzahl der Remote-Objekte, die pro Seite angezeigt werden sollen. Standardmäßig ist sie auf 50 festgelegt.
• DEFINE-RESOURCETYPE-ATTRIBUTE – Gibt den Attributnamen des PTC Modeler OSLC-Server an, der den Wert des Ressourcentyps zurückgibt. Der Standardwert ist auf ptc_im_am:dynamicUmlClassName festgelegt.
|
c. Führen Sie den Dienst DPTAdminConfigThing gemäß den folgenden Schritten aus:
i. Melden Sie sich bei der ThingWorx Plattform als Administrator an.
ii. Navigieren Sie zur Registerkarte > > > .
iii. Klicken Sie auf Ausführen.
Nach erfolgreicher Ausführung des Diensts wird die folgende Meldung angezeigt: "Berechtigungen erfolgreich angewendet".
iv. Vergewissern Sie sich, dass "DPTEndUserGroup" und "DPTConfiguratorGroup" in > erstellt wurden. Stellen Sie sicher, dass den ThingWorx Plattformentitäten die erforderlichen Berechtigungen zugewiesen werden.
Weitere Informationen finden Sie im Abschnitt Standardberechtigungen für ThingWorx Platform Entitäten.
|
|
• Der Dienst PostDPTExtensionImport kann nur von einem ThingWorx Administrator ausgeführt werden.
• Bestehende Mitglieder und Berechtigungen von "DPTEndUserGroup" und "DPTConfiguratorGroup" werden nach Ausführung des Dienstes beibehalten.
|
2. Gehen Sie in ThingWorx Flow nach den folgenden Anweisungen vor, und erstellen Sie eine neue Verbindung mit dem OSLC-System, in das integriert werden soll. Siehe das Thema "Verbindungen erstellen und verwalten" im ThingWorx Platform Hilfe-Center.
a. Erstellen Sie eine Verbindung für das OSLC-System.
▪ Wählen Sie für die Standardauthentifizierung den Verbindungstyp OSLC Basic aus.
▪ Erstellen Sie für die SSO-Konfiguration eine OAuth-Verbindung.
Bevor Sie eine OAuth-Verbindung erstellen, stellen Sie sicher, dass ein OAuth-Anbieter in ThingWorx Flow konfiguriert wurde. Weitere Informationen finden Sie unter OAuth-Anbieter erstellen und verwaltenund OAuths konfigurieren und laden im ThingWorx Flow Hilfe-Center.
|
|
Sie müssen die erteilte Genehmigung für das Verbindungsobjekt der OSLC-OAuth-Sitzung annehmen. Weitere Informationen finden Sie unter OAuth-Client-Verbindung für ThingWorx erstellen.
|
b. Geben Sie im Fenster Verbindung hinzufügen die folgenden Informationen ein:
▪ Verbindungsbeschriftung – Geben Sie einen Namen für die Verbindung ein. Der hier angegebene Verbindungsname wird im Konfigurationsding verwendet.
▪ Katalog-URL – Geben Sie die Katalog-URL des OSLC-Servers des externen Systems ein. Weitere Informationen finden Sie im PTC RV&S OSLC-Client Handbuch (ab 12.3.0.0) unter Referenzdokumente sowie unter "OSLC integration with Integrity Modeler" und "OSLC integration with IBM Rational DOORS Next Generation" im PTC Modeler Hilfe-Center.
|
|
Die unterstützte Version von PTC RV&S und PTC Modeler Anwendungen finden Sie in der Dokumentation.
|
▪ Anmeldeinformationen für das Dienstkonto des externen Systems, um auf den OSLC-Server zuzugreifen
▪ Gleichzeitige Anforderungen – Geben Sie die Anzahl der gleichzeitig von ThingWorx Flow aufgerufenen Ressourcenanforderungen an. Der Standardwert ist 5.
Administratoren können die Anzahl der Anforderungen basierend auf der Konfiguration des Servers ändern.
c. Speichern Sie die Verbindung.
d. Klicken Sie auf Schließen.
 |
Ändern Sie nicht den PTC Modeler Standard-Connector in ThingWorx Flow.
|
3. Konfigurieren Sie ThingWorx Platform für die Integration in die OSLC-Server des externen Systems. Erstellen Sie in ThingWorx Platform ein Konfigurationsding.
So erstellen Sie ein Konfigurationsding:
a. Navigieren Sie zu > , und geben Sie die entsprechenden Attributwerte an. Wählen Sie PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate als Basis-Dingvorlage aus.
b. Konfigurieren Sie die Zuordnungen auf der Registerkarte Konfiguration entsprechend den nachfolgenden Tabellen. Verwenden Sie die PTC Referenz-Konfigurationsdinge als Referenz, und geben Sie die Details für das OSLC-System ein.
▪ OSLCServerMappingConfigTable
|
Attribut
|
Beschreibung
|
||
|---|---|---|---|
|
Server
|
Name des externen OSLC-Servers
|
||
|
BaseUrl
|
Basis-URL des externen OSLC-Servers
|
||
|
ConnectionObject
|
Name der für den externen OSLC-Server erstellten Verbindung
|
||
|
Tag
|
Wert für den Ausdruck, der im Modell-Tag-Vokabular PTC-PLM-Validation-Flows definiert ist, um den Remote-Server zu kennzeichnen.
Dieser Schritt ist optional. Dieser Schritt ist nur erforderlich, wenn Sie einen Validierungs-Flow verwenden.
Weitere Informationen zum Hinzufügen von Tags finden Sie im Thema "Tags" im ThingWorx Platform Hilfe-Center.
|
▪ Attributzuordnung für OSLCResourceMappingConfigTable
|
Attribut
|
Beschreibung
|
|---|---|
|
WindchillType
|
Interner Name der Anforderungs- bzw. Architekturressource von der Typverwaltung in Windchill. Der Ablaufverfolgungs-Link wird für die Ressource erstellt.
|
|
OSLCResourceType
|
Typ der Anforderungsressource, Architekturressource oder ihrer Untertypen, die im externen OSLC-Server definiert sind. Bei dem Wert von OSLCResourceType handelt es sich um den Namen der Ressourcen und ihrer Untertypen gemäß der Konfiguration auf dem externen OSLC-Server. Beispielsweise ist in PTC Modeler "Activity" als Untertyp der Ressource der Architektur-Domäne definiert. Ein Benutzer kann den Namen "Resource|Activity" festlegen, wobei "Activity" der Untertyp für den OSLC-Ressourcentyp ist, die der Architektur-Domäne zugehörig ist. Der für einen Architektur-Ressourcentyp angegebene Name sollte durch einen senkrechten Strich getrennt werden.
|
Informationen zum internen Namen der Anforderungs- bzw. Architekturressource finden Sie in "Typen und Attribute" unter System-Kompatibilität und -anforderungen.
|
|
Ordnen Sie einen OSLC-Ressourcentyp nicht erneut dem Windchill Objekttyp zu, wenn der OSLC-Ressourcentyp bereits einem Windchill Objekttyp zugeordnet ist. Das erneute Zuordnen des Windchill Objekttyps zum OSLC-Ressourcentyp, der anfänglich in ThingWorx definiert wurde, nachdem das Objekt in Windchill verfolgt wurde, kann zu Datenbeschädigungen führen.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Attribut
|
Beschreibung
|
|---|---|
|
WindchillTableId
|
ID der Tabelle in Windchill, in der die Daten aus dem externen OSLC-Server angezeigt werden
Verwenden Sie eine kommagetrennte Liste, um mehrere Tabellen-ID-Werte hinzuzufügen.
|
|
WindchillType
|
Interner Name der Anforderungs- bzw. Architekturressource von der Typ- und Attributverwaltung in Windchill
|
▪ Attributzuordnung für OSLCResourceAttributeMappingConfigTable
|
Attribut
|
Beschreibung
|
||
|---|---|---|---|
|
WindchillAttribute
|
Name des Windchill Attributs, der in der Windchill Tabelle angezeigt werden soll.
|
||
|
OSLCResourceAttribute
|
Name des OSLC-Ressourcenattributs.
|
||
|
WindchillAttributeDataType
|
Der Datentyp des Windchill Attributs. String, Timestamp und RichText sind standardmäßig unterstützte Datentypwerte.
|
||
|
IsPreview
|
Wenn IsPreview für ein Attribut ausgewählt ist, wird die HTML-Darstellung des verfolgten Remote-Objekts angezeigt, die vom externen OSLC-Server verfügbar gemacht wird.
Aktivieren Sie das Kontrollkästchen IsPreview, um kleine und große Vorschauen anzuzeigen.
IsPreview ist für die Attribute des Datentyps String und RichText verfügbar. Für beide Datentypen wird eine kleine Vorschau angezeigt. Eine große Vorschau wird nur für Attribute des Datentyps String angezeigt.
|
▪ OSLCResourceShapeConfigTable
|
Attribut
|
Beschreibung
|
|---|---|
|
OSLCResourceType
|
Unterstützte Ressourcentypen der Anforderungs-, Architektur- oder Änderungsdomäne wie im externen OSLC-Server definiert. Bei dem Wert von OSLCResourceType handelt es sich um den Namen der Ressourcen gemäß der Konfiguration auf dem externen OSLC-Server.
|
|
OSLCResourceShapeURI
|
URI der OSLC-Resource Shape für die OSLC-Server, die eine Ressource Shape nicht mit dem OSLC-Abfragedienst sondern mit einem anderen Dienst verfügbar machen. Beispiel: Der IBM Rational Doors NG OSLC-Server macht die Resource Shape mit dem Dienst "Creation Factory" verfügbar.
|
▪ Attributzuordnung für OSLCResourceShapeConfigTable
|
Attribut
|
Beschreibung
|
|---|---|
|
WindchillAttribute
|
Name des Windchill Attributs, das im Fensterbereich Filterkriterien der Suchauswahl für externe Ressourcen angezeigt werden soll
|
|
OSLCResourceAttribute
|
Befolgen Sie die Benennungskonvention prefix:propertyName, um einen Wert für ein OSLC-Attribut hinzuzufügen. Dabei ist das prefix der Zusatz vor dem Eigenschaftsnamen und propertyName ist der vom OSLC-Server definierte Attributname. Beispiel: Für einen Attributstatus, der von einem PTC RV&S OSLC-Server verfügbar gemacht wird, lautet der Wert für OSLCResourceAttributedcterms:state.
|
|
OSLCAttributeDataType
|
Datentyp der OSLC-Ressource. String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float und Integer sind die unterstützten Werte für den OSLC-Datentyp.
|
▪ OSLCSearchResultConfigTable
|
Attribut
|
Beschreibung
|
|---|---|
|
WindchillType
|
Unterstützte Windchill Ressourcentypen für Anforderungs-, Architektur- oder Änderungsdomänen
|
▪ Attributzuordnung für OSLCSearchResultConfigTable
|
Attribut
|
Beschreibung
|
||
|---|---|---|---|
|
WindchillAttribute
|
Name des Windchill Attributs, das im Fensterbereich Suchergebnis-Tabelle der Suchauswahl für externe Ressourcen angezeigt werden soll
|
||
|
OSLCResourceAttribute
|
Name des OSLC-Ressourcenattributs.
|
||
|
WindchillAttributeDataType
|
Der Datentyp des Windchill Attributs. String, Timestamp und RichText sind standardmäßig unterstützte Datentypwerte.
|
▪ OSLCRemoteConfigTable
|
Attribut
|
Beschreibung
|
||
|---|---|---|---|
|
ReverseLookupURL
|
Relative URL des Reverse-Lookup-Dienstes für externe OSLC-Server Geben Sie beispielsweise für Codebeamer /cb/api/oslc/links/traceLinkResources an.
|
||
|
Methode
|
Vom Reverse-Lookup-Dienst unterstützte HTTP-Anforderungsmethode. Gültige Werte sind GET und POST.
|
||
|
TraceableUrlPrefix
|
Präfix, das zusammen mit der URL des Teils oder des nachverfolgbaren Objekts verwendet wird Geben Sie beispielsweise für Codebeamer cb:traceLinkTargetURI an.
|
||
|
Seitengröße
|
Bestimmt die maximale Anzahl von Remote-Elementen, die in einem einzelnen Aufruf vom OSLC-Reverse-Lookup-Dienst abgerufen werden können.
Der Standardgrenzwert ist 200 für PTC RV&S und 500 für Codebeamer.
Wenn der konfigurierte Wert den Standardgrenzwert überschreitet, schlägt die Reverse-Lookup-Funktion fehl.
|
|
|
Die Reverse-Lookup-Funktion wird für PTC Modeler, PTC RV&S und Codebeamer OSLC-Server unterstützt. Stellen Sie sicher, dass die oben erwähnten Attributwerte nur in den Referenzkonfigurationsdateien der unterstützten OSLC-Server definiert sind.
|
c. Klicken Sie auf Speichern und Weiter.