Configuration de Windchill Digital Product Traceability Extension
1. Importez l'extension avec les objets de configuration de référence PTC requis et vérifiez les entités ThingWorx.
a. Windchill_Digital_Product_Traceability-extension : importez ce fichier ZIP dans ThingWorx Platform. Vérifiez que les entités suivantes existent dans ThingWorx Composer après l'importation de Digital Product Traceability Extension :
 |
La version du produit Windchill dans l'extension importée s'affiche au format suivant : xx.x.xxx. Les quatre premiers chiffres représentent la version de Windchill, et les deux derniers chiffres correspondent au numéro de version du groupe de correctifs critiques (CPS).
Par exemple, une version 03 du CPS de Windchill 12.0.0 est représentée sous la forme 12.0.003 dans l'extension.
|
|
Entité
|
Description
|
Type
|
||
|---|---|---|---|---|
|
DPTAdminConfigThing
|
Cet objet de configuration inclut le service permettant de créer les groupes DPTEndUserGroup et DPTConfiguratorGroup, et d'affecter les permissions nécessaires aux entités ThingWorx Platform.
|
ConfigThing
|
||
|
OslcDataServicesThing
|
Cet objet contient les services de la ressource OSLC qui sont appelés à partir de Windchill.
|
Thing
|
||
|
OslcFlowsThing
|
Cet objet contient les services de flux qui récupèrent des données du système OSLC distant à l'aide de ThingWorx Flow.
|
Thing
|
||
|
OslcValidationFlowThing
|
Cet objet contient l'objet de flux de validation par défaut.
|
Thing
|
||
|
OslcValidationServicesThing
|
Cet objet contient les services de validation pour les ressources OSLC qui sont appelées à partir de Windchill.
|
Thing
|
||
|
PTC-PLM
|
• Le tag de modèle PTC-PLM:TRACELINKS est utilisé pour marquer toutes les entités disponibles dans l'extension. Pour plus d'informations, consultez la rubrique d'aide Tags dans le Centre d'aide ThingWorx Platform.
• Le tag de modèle PTC-PLM: TRACELINKS-DPT-EXTENSION-PROPERTIES permet par défaut à Windchill Digital Product Traceability Extension d'utiliser l'objet DPTExtensionPropertiesConfigThing.
• Le tag de modèle PTC-PLM:TRACELINKS ROOT SELECTION DIALOG permet, une fois ajouté à l'objet de configuration, d'afficher la racine dans le tableau Sélectionner un contexte. Faute d'ajouter ce tag, la structure arborescente complète est affichée dans le tableau Sélectionner un contexte. Ce tag est spécifique à PTC Modeler.
• Une fois ajouté à l'objet de configuration, le tag de modèle PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH utilise le sélecteur de recherche de ressource externe pour afficher la ressource OSLC externe. Faute d'ajouter ce tag, la boîte de dialogue de sélection affiche la ressource OSLC externe. Par défaut, le tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH est ajouté à l'objet PTCModelerConfigThing. PTC recommande de ne pas ajouter le tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH à l'objet PTCPolarionConfigThing.
• Le tag de modèle PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL doit être spécifié pour l'objet de configuration de référence IBM Rational Doors NG lors de l'utilisation du tag PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH.
|
ModelTagVocabulary
|
||
|
PTC-PLM-VALIDATION-FLOWS
|
Le tag de modèle PTC-PLM-VALIDATION:modeler est utilisé pour identifier un objet de flux de validation. Pour plus d'informations, consultez la rubrique Tags dans le Centre d'aide ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
|
Cette forme de données est utilisée dans OSLCResourceAttributeMappingConfigTable pour le mappage des attributs.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
|
Ce modèle d'objet contient les propriétés de configuration de Windchill_Digital_Product_Traceability-extension.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingShape
|
Cette forme d'objet contient le contrat de service défini pour Windchill.
|
ThingShape
|
||
|
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
|
Ce modèle d'objet contient les services de données définis pour Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcFlowsTemplate
|
Ce modèle d'objet contient les services de flux.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
|
Ce modèle d'objet est utilisé pour créer un objet de configuration pour chaque système externe.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
|
Ce modèle d'objet contient des services de validation pour Windchill.
|
ThingTemplate
|
||
|
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
|
Cette forme de données est utilisée dans OSLCResourceShapeConfigTable pour le mappage des attributs.
|
DataShape
|
||
|
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
|
Cette forme de données est utilisée dans OSLCSearchResultConfigTable pour le mappage des attributs.
|
DataShape
|
||
|
TRACELINKS
|
Le tag de modèle TRACELINKS:OSLC-FLOWS est utilisé pour marquer toutes les entités disponibles dans l'extension. Pour plus d'informations, consultez la rubrique Tags dans le Centre d'aide ThingWorx Platform.
|
ModelTagVocabulary
|
||
|
Windchill_Digital_Product_Traceability-xx.x.xxx.jar
|
Cette ressource fait partie de Windchill_Digital_Product_Traceability-extension.
|
Resource
|
|
|
Assurez-vous que les permissions correctes sont activées sur les entités listées ci-dessus. Pour plus d'informations, consultez la rubrique Permissions par défaut pour les entités ThingWorx Platform.
|
|
|
Un tag de modèle est constitué de vocabulaire et de termes. La valeur d'un tag de modèle est unique pour un objet.
|
b. Windchill_Digital_Product_Traceability_Config_Things : extrayez le dossier et importez l'objet de configuration de référence PTC requis avec l'objet DPTExtensionPropertiesConfigThing dans ThingWorx Platform. Utilisez les objets de configuration de référence importés comme référence pour les configurations prises en charge et validées en standard.
|
Entités
|
Description
|
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
PTCDoorsConfigThing
|
Cet objet de configuration contient des configurations de référence pour IBM Rational Doors NG, y compris tous les mappages et configurations de données Windchill vers IBM Rational Doors NG OSLC.
|
||||||||
|
PTCModelerConfigThing
|
Cet objet de configuration contient des configurations de référence pour PTC Modeler, y compris tous les mappages et configurations de données Windchill vers PTC Modeler OSLC.
|
||||||||
|
PTCRVSConfigThing
|
Cet objet de configuration contient des configurations de référence pour PTC RV&S, y compris tous les mappages et configurations de données Windchill vers PTC RV&S OSLC.
|
||||||||
|
PTCCodebeamerConfigThing
|
Cet objet de configuration contient des configurations de référence pour Codebeamer, y compris tous les mappages et configurations de données Windchill vers Codebeamer OSLC.
|
||||||||
|
PTCPolarionConfigThing
|
Cet objet de configuration contient des configurations de référence pour Siemens Polarion, y compris tous les mappages et configurations de données Windchill vers Siemens Polarion OSLC.
|
||||||||
|
PTCJiraConfigThing
|
Cet objet de configuration contient des configurations de référence pour Jira (SodiusWillert), y compris tous les mappages et configurations de données Windchill vers Jira OSLC.
|
||||||||
|
PTCCatiaConfigThing
|
Cet objet de configuration contient des configurations de référence pour CATIA Magic Collaboration Studio, y compris tous les mappages et configurations de données Windchill vers CATIA Magic Collaboration Studio OSLC.
|
||||||||
|
DPTExtensionPropertiesConfigThing
|
Lorsque le tag de modèle TRACELINKS-DPT-EXTENSION-PROPERTIES lui est appliqué, Windchill Digital Product Traceability Extension peut utiliser les propriétés définies suivantes :
• CACHE-EXPIRY : détermine la validité des entrées du cache. La valeur par défaut est 5 minutes.
• SCHEDULER-INTERVAL : détermine la fréquence de purge automatique des entrées du cache. La valeur par défaut est 30 minutes.
• CACHE-USERS : détermine le nombre d'utilisateurs dans les entrées du cache. La valeur par défaut est 200.
• CACHE-RESOURCES : détermine le nombre de ressources pouvant être mises en cache par utilisateur. La valeur par défaut est 100.
• LARGE-PREVIEW-SHOW-DIMENSIONS : détermine s'il convient d'afficher un aperçu de grande taille dans un nouvel onglet. Lorsque cette option est définie sur No (valeur par défaut), l'aperçu de grande taille s'ouvre dans un nouvel onglet. Lorsque cette option est définie sur Yes, l'aperçu s'ouvre dans une fenêtre contextuelle.
• OSLC-QUERY-PAGESIZE : détermine le nombre d'objets distants à afficher par page. En standard, cette propriété est définie sur 50.
• DEFINE-RESOURCETYPE-ATTRIBUTE : spécifie le nom de l'attribut du serveur OSLC PTC Modeler qui renvoie la valeur du type de ressource. La valeur par défaut est définie sur ptc_im_am:dynamicUmlClassName.
|
c. Exécutez le service DPTAdminConfigThing en procédant comme suit :
i. Connectez-vous à ThingWorx Platform en tant qu'administrateur.
ii. Accédez à > > > .
iii. Cliquez sur Exécuter.
Une fois le service correctement exécuté, le message suivant s'affiche : "Permissions applied successfully".
iv. Vérifiez que les groupes DPTEndUserGroup et DPTConfiguratorGroup sont créés dans > . Assurez-vous que les permissions nécessaires sont affectées aux entités ThingWorx Platform.
Pour plus d'informations, consultez la rubrique Permissions par défaut pour les entités ThingWorx Platform.
|
|
• Le service PostDPTExtensionImport ne peut être exécuté que par un administrateur ThingWorx.
• Les membres et permissions existants des groupes DPTEndUserGroup et DPTConfiguratorGroup sont conservés après l'exécution du service.
|
2. Dans ThingWorx Flow, suivez les instructions suivantes et créez une nouvelle connexion pour le système OSLC avec lequel l'intégration est requise. Consultez la rubrique Création de connexions et gestion des connexions dans le Centre d'aide ThingWorx Platform :
a. Créez une Connexion pour le système OSLC.
▪ Pour l'authentification de base, sélectionnez le type de connexion OSLC de base.
▪ Pour la configuration SSO, créez une connexion OAuth.
Avant de créer une connexion OAuth, assurez-vous qu'un fournisseur OAuth a été configuré dans ThingWorx Flow. Pour plus d'informations, consultez les rubriques Création et gestion des fournisseurs OAuth et Configuration et chargement d'OAuths du Centre d'aide ThingWorx Flow.
|
|
Vous devez accepter l'approbation d'octroi pour l'objet de connexion de session OAuth OSLC. Pour plus d'informations, consultez la rubrique Création d'une connexion client OAuth pour ThingWorx.
|
b. Saisissez les informations suivantes dans la fenêtre Ajouter connexion :
▪ Etiquette de connexion : entrez le nom de la connexion. Le nom de connexion spécifié ici est utilisé dans l'objet de configuration.
▪ URL catalogue : entrez l'URL catalogue du serveur OSLC du système externe. Reportez-vous guide anglais PTC RV&S OSLC Client (Client OSLC de Windchill RV&S) (versions 12.3.0.0 et plus récentes) dans les Documents de référence, OSLC integration with Integrity Modeler et OSLC integration with IBM Rational DOORS Next Generation dans le Centre d'aide PTC Modeler.
|
|
Reportez-vous à la documentation relative à votre version de PTC RV&S et à vos applications PTC Modeler prises en charge.
|
▪ Informations d'identification du compte du service du système externe, pour accéder au serveur OSLC.
▪ Requêtes simultanées : spécifiez le nombre de requêtes de ressource simultanées appelées à partir de ThingWorx Flow. La valeur par défaut est 5.
Les administrateurs peuvent modifier le nombre de requêtes en fonction de la configuration du serveur.
c. Enregistrez la connexion.
d. Cliquez sur Fermer.
 |
Ne modifiez pas le connecteur PTC Modeler par défaut dans ThingWorx Flow.
|
3. Configurez ThingWorx Platform pour une intégration avec les serveurs OSLC du système externe. Dans ThingWorx Platform, créez un objet de configuration.
Pour créer un objet de configuration :
a. Naviguez jusqu'à > et spécifiez les valeurs des attributs. Sélectionnez PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate comme Modèle d'objet de base.
b. Dans l'onglet Configuration, configurez les mappages comme expliqué dans les tableaux suivants. Vous pouvez faire référence à l'objet de configuration de référence PTC en tant que référence et entrer les détails du système OSLC.
▪ OSLCServerMappingConfigTable
|
Attribut
|
Description
|
||
|---|---|---|---|
|
Server
|
Nom du serveur OSLC externe.
|
||
|
BaseUrl
|
L'URL de base du serveur OSLC externe.
|
||
|
ConnectionObject
|
Nom de la connexion créée pour le serveur OSLC externe.
|
||
|
Tag
|
Valeur de Termes définie dans le vocabulaire du tag de modèle PTC-PLM-Validation-Flows pour identifier le serveur distant.
Cette étape est facultative. Cette étape n'est requise que lorsque vous utilisez un flux de validation.
Pour plus d'informations sur l'ajout de tags, consultez la rubrique Tags dans le Centre d'aide ThingWorx Platform.
|
▪ Mappage des attributs pour OSLCResourceMappingConfigTable
|
Attribut
|
Description
|
|---|---|
|
WindchillType
|
Nom interne de la ressource d'exigence ou d'architecture de la gestion des types dans Windchill. Le lien de suivi est créé vers la ressource.
|
|
OSLCResourceType
|
Type de la ressource d'exigence, de la ressource d'architecture ou de leurs sous-types définis dans le serveur OSLC externe. La valeur de OSLCResourceType est le nom des ressources et de leurs sous-types tel qu'il a été configuré dans le serveur OSLC externe. Par exemple, dans PTC Modeler, l'activité est définie comme sous-type de la ressource de domaine d'architecture. Un utilisateur peut définir le nom comme ressource|activité, où l'activité est le sous-type de la ressource de type OSLC qui appartient au domaine d'architecture. Le nom spécifié pour un type de ressource d'architecture doit être séparé par le caractère de filtre.
|
Pour plus d'informations sur le nom interne de la ressource d'exigence ou d'architecture, consultez la section "Types et attributs" dans la rubrique Compatibilité et exigences du système.
|
|
Ne remappez pas un type de ressource OSLC au type d'objet Windchill si le type de ressource OSLC est déjà mappé à un type d'objet Windchill. Le remappage du type d'objet Windchill au type de ressource OSLC, initialement défini dans ThingWorx, une fois que l'objet a été suivi dans Windchill, peut entraîner la corruption des données.
|
▪ OSLCResourceAttributeMappingConfigTable
|
Attribut
|
Description
|
|---|---|
|
WindchillTableId
|
L'ID de tableau dans Windchill qui affiche les données du serveur OSLC externe.
Pour ajouter plusieurs valeurs d'ID de tableau, utilisez une liste d'éléments séparés par des virgules.
|
|
WindchillType
|
Nom interne de la ressource d'exigence ou d'architecture de la Gestion d'attributs et de types dans Windchill.
|
▪ Mappage des attributs pour OSLCResourceAttributeMappingConfigTable
|
Attribut
|
Description
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nom de l'attribut Windchill à afficher dans le tableau Windchill.
|
||
|
OSLCResourceAttribute
|
Nom de l'attribut de ressource OSLC.
|
||
|
WindchillAttributeDataType
|
Type de données de l'attribut Windchill. Les types de données pris en charge en standard sont Chaîne, Horodatage et Texte enrichi.
|
||
|
IsPreview
|
Lorsque IsPreview est sélectionné pour un attribut, il affiche la représentation HTML de l'objet distant suivi, telle qu'elle apparaît sur le serveur OSLC externe.
Sélectionnez la case à cocher IsPreview pour afficher des aperçus de petite ou grande taille.
IsPreview est disponible sur les attributs des données de type Chaîne et Texte enrichi. Un aperçu de petite taille s'affiche pour les deux types de données. Toutefois, l'aperçu de grande taille s'affiche uniquement pour les attributs des données de type Chaîne.
|
▪ OSLCResourceShapeConfigTable
|
Attribut
|
Description
|
|---|---|
|
OSLCResourceType
|
Types de ressources pris en charge pour le domaine d'exigence, le domaine d'architecture ou le domaine de changement, tels que définis dans le serveur OSLC externe. La valeur d'OSLCResourceType est le nom des ressources, tel qu'il a été configuré dans le serveur OSLC externe.
|
|
OSLCResourceShapeURI
|
URI de la forme de ressource OSLC pour les serveurs OSLC qui n'exposent pas la forme de ressource avec le service de requête OSLC, mais avec un autre service. Par exemple, le serveur OSLC IBM Rational Doors NG expose la forme de ressource avec le service Creation Factory.
|
▪ Mappage des attributs pour OSLCResourceShapeConfigTable
|
Attribut
|
Description
|
|---|---|
|
WindchillAttribute
|
Nom de l'attribut Windchill à afficher dans le volet Critères de filtrage du sélecteur de recherche de ressource externe.
|
|
OSLCResourceAttribute
|
Pour ajouter une valeur pour un attribut OSLC, suivez la convention de désignation prefix:propertyName. Ici, prefix correspond à l'affixe ajouté avant le nom de la propriété et propertyName correspond au nom d'attribut défini par le serveur OSLC. Par exemple, pour un attribut state exposé par le serveur OSLC PTC RV&S, la valeur OSLCResourceAttribute est dcterms:state.
|
|
OSLCAttributeDataType
|
Type de données de la ressource OSLC. String, LangString, XMLLiteral, Boolean, DateTime, Decimal, Double, Float et Integer sont les valeurs de type de données OSLC prises en charge.
|
▪ OSLCSearchResultConfigTable
|
Attribut
|
Description
|
|---|---|
|
WindchillType
|
Types de ressources Windchill pris en charge pour le domaine d'exigence, le domaine d'architecture ou le domaine de changement.
|
▪ Mappage des attributs pour OSLCSearchResultConfigTable
|
Attribut
|
Description
|
||
|---|---|---|---|
|
WindchillAttribute
|
Nom de l'attribut Windchill à afficher dans le volet Tableau des résultats de la recherche du sélecteur de recherche de ressource externe.
|
||
|
OSLCResourceAttribute
|
Nom de l'attribut de ressource OSLC.
|
||
|
WindchillAttributeDataType
|
Type de données de l'attribut Windchill. Les types de données pris en charge en standard sont Chaîne, Horodatage et Texte enrichi.
|
▪ OSLCRemoteConfigTable
|
Attribut
|
Description
|
||
|---|---|---|---|
|
ReverseLookupURL
|
URL relative du service de recherche inversée pour les serveurs OSLC externes. Par exemple, pour Codebeamer, spécifiez /cb/api/oslc/links/traceLinkResources.
|
||
|
Méthode
|
Méthode de requête HTTP prise en charge par le service de recherche inversée. Les valeurs valides sont GET et POST.
|
||
|
TraceableUrlPrefix
|
Préfixe utilisé avec l'URL de l'article ou de l'objet traçable. Par exemple, pour Codebeamer, spécifiez cb:traceLinkTargetURI.
|
||
|
PageSize
|
Détermine le nombre maximal d'éléments distants pouvant être récupérés en un seul appel par le service de recherche inversée OSLC.
La limite par défaut est de 200 pour PTC RV&S et 500 pour Codebeamer.
Si la valeur configurée dépasse la limite par défaut, la fonctionnalité de recherche inversée échoue.
|
|
|
La fonctionnalité de recherche inversée est prise en charge pour les serveurs OSLC PTC Modeler, PTC RV&S et Codebeamer. Assurez-vous que les valeurs d'attribut mentionnées ci-dessus sont définies uniquement dans les fichiers de configuration de référence des serveurs OSLC pris en charge.
|
c. Cliquez sur Enregistrer et continuer.