Exécution des services Info*Engine avec le connecteur OData
ThingWorx Navigate prend désormais en charge le connecteur OData pour exécuter des tâches Info*Engine. Si vos tâches personnalisées utilisent des tâches Info*Engine, appelez-les à l'aide du connecteur OData.
Pour obtenir les informations les plus à jour sur la prise en charge du connecteur OData avec
Windchill, consultez la
matrice de support des plateformes de ThingWorx Navigate.
|
|
Dans les prochaines versions de ThingWorx Navigate, la prise en charge des connecteurs Windchill, ptc-windchill-connector et ptc-windchill-swagger-connector sera abandonnée. Pour une transition transparente vers une version qui ne dispose pas de prise en charge des anciens connecteurs Windchill, exécutez désormais vos tâches Info*Engine avec ptc-windchill-OData-connector, en respectant la procédure décrite dans cette rubrique.
|
Pour utiliser le connecteur OData afin d'exécuter des tâches Info*Engine, configurez d'abord ptc-windchill-OData-connector pour la connexion aux services REST OData Windchill du domaine Info*Engine. Vous pourrez alors utiliser les services REST OData Windchill pour exécuter des tâches Info*Engine.
|
|
• Lorsque vous configurez le connecteur ptc-windchill-OData-connector, toutes les personnalisations précédentes effectuées sur le ptc-windchill-OData-connector standard doivent ensuite être recréées.
|
1. Dans ThingWorx Composer, recherchez le connecteur ptc-windchill-OData-connector, puis ouvrez-le. La page Informations générales s'ouvre.
2. Cliquez sur Configuration. La page Configuration s'affiche.
Votre configuration dépend de votre méthode d'authentification : authentification unique, authentification Windchill ou authentification fixe.
Authentification unique
Si vous êtes configuré en mode d'authentification unique, procédez comme suit :
1. Sous Paramètres de connexion au connecteur générique, en regard de Type d'authentification, sélectionnez SSO.
2. Sous ID du serveur d'autorisation, saisissez la valeur AuthorizationServerSettingsID que vous avez fournie dans sso-settings.json, PingFed1 par exemple.
3. Sous Paramètres d'étendue du serveur d'autorisation, cliquez sur Ajouter. La fenêtre AuthorizationServerScopesSettings s'ouvre.
4. Sous Etendue, entrez l'étendue Windchill que vous enregistrée dans PingFederate, WINDCHILL par exemple.
5. Cliquez sur Ajouter.
6. Sous Paramètres CSRF, entrez les informations suivantes :
◦ URL relative pour requête Get CSRF : /servlet/odata
◦ Nom de jeton CSRF : CSRF_NONCE
7. Sous Paramètres de connexion au connecteur HTTP, entrez les informations voulues :
◦ URL de base : URL de Windchill. L'URL doit se terminer par /oauth. Utilisez ce format :
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
Ce format spécifie que la connexion utilise le standard OAuth et active les demandes de données dans le fournisseur de ressources.
◦ URL relative : /servlet/odata
Il n'est pas nécessaire de renseigner le nom d'utilisateur et le mot de passe.
8. Cliquez sur Enregistrer. Le connecteur OData est désormais configuré pour opérer dans votre environnement en mode d'authentification unique.
A présent, passez à la section "Exécution de tâches Info*Engine".
Authentification Windchill
Si vous êtes configuré en mode d'authentification Windchill procédez comme suit :
1. Sous Paramètres de connexion au connecteur générique, en regard de Type d'authentification, sélectionnez None.
2. Sous Paramètres CSRF, entrez les informations suivantes :
◦ URL relative pour requête Get CSRF : /servlet/odata
◦ Nom de jeton CSRF : CSRF_NONCE
3. Sous Paramètres de connexion au connecteur HTTP, entrez les informations voulues :
◦ URL de base : serveur Windchill qui reçoit la demande Info*Engine du connecteur OData. Utilisez ce format :
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ URL relative : /servlet/odata
◦ URL de connexion : /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
Il n'est pas nécessaire de renseigner le nom d'utilisateur et le mot de passe.
4. Cliquez sur Enregistrer.
A présent, passez à la section "Exécution de tâches Info*Engine".
Authentification fixe
Si vous êtes configuré en mode d'authentification fixe, procédez comme suit configurer le connecteur OData :
1. Sous Paramètres de connexion au connecteur générique, en regard de Type d'authentification, sélectionnez Fixed.
2. Sous Paramètres CSRF, entrez les informations suivantes :
◦ URL relative pour requête Get CSRF : /servlet/odata
◦ Nom de jeton CSRF : CSRF_NONCE
3. Sous Paramètres de connexion au connecteur HTTP, entrez les informations voulues :
◦ Nom d'utilisateur : votre nom d'utilisateur d'administrateur Windchill
◦ Mot de passe : votre mot de passe administrateur Windchill
◦ URL de base : serveur Windchill qui reçoit la demande Info*Engine du connecteur OData. Utilisez ce format :
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ URL relative : /servlet/odata
4. Cliquez sur Enregistrer. Le connecteur OData est désormais configuré pour opérer dans votre environnement en mode d'authentification fixe.
Poursuivez avec la section "Exécution de tâches Info*Engine".
Exécution de tâches Info*Engine
A présent, exécutez les tâches Info*Engine avec le service :
1. Cliquez sur Services. La page Services s'affiche.
2. Pour
RefreshEndpointCache, cliquez sur l'élément
. La fenêtre
Exécuter le service s'ouvre.
3. Cliquez sur Exécuter. Vous recevez le message : Succès. Votre service a été exécuté avec succès.
4. Cliquez sur Terminé.
5. Pour
InvokeIETask, cliquez sur l'élément
.
6. Dans la fenêtre Entrée, ajoutez les informations suivantes au format JSON :
◦ Task : fichier XML de la tâche Info*Engine. Le fichier se trouve ici : <Windchill Installation>/<Windchill_Home>/tasks/.
| Assurez-vous que la tâche est activée pour exécution. Pour ce faire, vérifiez que les annotations suivantes apparaissent au début du fichier XML : <%@page language="java" access="http"%> |
◦ Params : (facultatif) tableau JSON contenant des paires nom-valeur à transmettre en tant que paramètre à la tâche Info*Engine.
Exemple :
{
"Task": "wt/federation/delegates/windchill/QueryObjects.xml",
"Params": [
{ "Name": "type", "Value": "wt.part.WTPart" },
{ "Name": "where", "Value": "name=SOME_PART_NAME" }
]
}
7. Cliquez sur Exécuter pour démarrer la tâche Info*Engine. La sortie du service est au format JSON et contient les propriétés suivantes :
◦ @odata.context : URL de contexte pour le champ de données.
◦ Value : tableau JSON contenant des objets JSON avec les propriétés Groupname et Element.
8. Pour exécuter une autre tâche Info*Engine, répétez les étapes 1 à 7.
| Les points de terminaison du connecteur OData peuvent ne pas fonctionner correctement dans ThingWorx Navigate. Des modifications seront par conséquent peut-être nécessaires. Pour obtenir des informations et des instructions sur la configuration de services OData sur les données Windchill, consultez le manuel anglais Windchill REST Services User's Guide (Guide de l'utilisateur de Windchill REST Services). |
