Votre démarrage rapide pour Mendix–Intégrations Teamcenter | Mendix

Passer au contenu principal

Votre démarrage rapide pour Mendix–Intégrations Teamcenter 

Points clés

  • L'exemple d'application d'extension Teamcenter est le meilleur endroit pour commencer votre parcours d'intégration Mendix avec Teamcenter. En utilisant l'exemple d'application, vous bénéficierez d'un bon départ car vous disposez d'un ensemble d'intégrations prêtes à l'emploi.
  • La manière de vous authentifier auprès de Teamcenter dépend de votre environnement. La configuration de l'authentification pour Teamcenter X est différente de celle pour Teamcenter traditionnel. Il est important de suivre toutes les étapes requises pour votre configuration.
  • L'exemple d'application d'extension Teamcenter est le moyen idéal pour comprendre comment les intégrations avec Teamcenter de Mendix travailler sous le capot. Vous pouvez inspecter comment les types d’intégrations les plus courants sont configurés directement dans Studio Pro.
Dans ce guide, vous allez configurer votre première application qui s'intègre à votre environnement Teamcenter. Notre objectif est de vous aider à Exemple d'application d'extension Teamcenter Nous allons le mettre en service et ajouter notre première intégration. Veuillez vous assurer d'avoir accès à un environnement Teamcenter ou Teamcenter X pour suivre toutes les étapes de ce guide.
L'exemple d'application d'extension Teamcenter inclut déjà à la fois Connecteur Teamcenter et la Extension de TeamcenterDans ce guide, vous utiliserez uniquement le connecteur Teamcenter pour vos premiers appels à Teamcenter. Dans un prochain article de blog, vous utiliserez également l'extension Teamcenter pour créer une intégration personnalisée. Pour en savoir plus sur ces modules, veuillez consulter lire notre récent article de blog sur ce sujet précis !

1 – Créer votre application

Nous allons créer une nouvelle application avec Mendix Studio Pro 10.24.2 et utilisez l'exemple d'application Teamcenter Extension v4.1.0 comme point de départ. Créez votre application selon l'une des deux méthodes suivantes.
  • Option 1 Pour ce faire, ouvrez d’abord Studio Pro et sélectionnez Créer une nouvelle application. Dans l'aperçu des applications de démarrage disponibles, sélectionnez l' Exemple d'application d'extension Teamcenter.
  • Option 2 Alternativement, accédez au Page de marché de l'exemple d'application d'extension Teamcenter et choisissez Commencez avec l'application pour suivre l'assistant de création d'application. Notez que l'application sera créée dans Mendix version 10.12.6, assurez-vous donc d'ouvrir l'application dans Studio Pro version 10.24.2 et de la mettre à niveau.
Dès que le projet est ouvert dans Studio Pro pour la première fois, vous serez invité à activer le module complémentaire Module TeamcenterExtension.mx. Assurez-vous de choisir Module de confiance et extension d'activation.
Nous accueillons maintenant notre application nouvellement créée dans Studio Pro. Commençons par résoudre l'erreur qui s'affiche dans le panneau d'erreurs. L'erreur nous invite à définir une valeur pour Clé de chiffrement, qui est nécessaire pour stocker en toute sécurité les informations d'identification dans l'application.
Double-cliquez sur l’erreur pour ouvrir la boîte de dialogue des paramètres de l’application.
Dans la boîte de dialogue des paramètres, ouvrez le Réglage par défaut configuration, allez à la Constants et définissez le Clé de chiffrement Constante avec une clé d'exactement 32 caractères. Utilisez la méthode de votre choix pour générer une clé sécurisée.
Nous sommes maintenant prêts à commencer à configurer notre application pour se connecter à Teamcenter.

2 – Connexion à Teamcenter

Exécutez le projet et visualisez l'application. Connectez-vous en tant que MxAdmin utilisateur.
Cette page de configuration pour l'administrateur s'affiche. Cliquez sur Configurer Teamcenter.
Sur cette page, vous trouverez la liste de toutes nos configurations Teamcenter. Une configuration Teamcenter est requise pour chaque instance à laquelle vous souhaitez vous connecter. La liste étant actuellement vide, nous allons créer notre configuration.
La suite dépend de votre environnement Teamcenter. Si votre environnement est Teamcenter (traditionnel) et configuré pour l'authentification avec identifiants, passez à la section 2.1. Si votre environnement est Teamcenter (traditionnel) mais utilise l'authentification unique (SSO), passez à la section 2.2. Si vous avez accès à un environnement Teamcenter X Premium, passez à la section 2.3.

2.1 – Se connecter à l’aide des identifiants

Poursuivez cette section si votre environnement vous permet de vous authentifier à l'aide d'identifiants. Sur la page « Configurations Teamcenter », cliquez sur New et configurez votre instance Teamcenter. Dans ce cas, vous n'avez besoin que de Adresse de l'hôte Teamcenter et la URL de Teamcenter FMS, comme ci-dessous. Si votre domaine commence par https, vous devrez peut-être importer le certificat client de votre instance Teamcenter conformément à la documentation sur cette page.
Enregistrez la configuration. Utilisez le sélecteur de démonstration à droite de la page et passez à utilisateur_demo.
Nous voici accueillis par le tableau de bord utilisateur. Nous sommes actuellement connectés à notre Mendix application, mais pas encore à notre instance Teamcenter. Appuyez sur Connexion à Teamcenter.
Entrez votre nom d'utilisateur et votre mot de passe et connectez-vous. Le Groupe et Rôle certains champs pourraient être obligatoires, mais ce n'est souvent pas le cas.
Si tout s'est bien passé, vous êtes maintenant accueilli par le tableau de bord utilisateur. La vignette à droite indique que l'utilisateur dispose d'une session Teamcenter valide. Vous pouvez alors passer à la section trois pour passer votre premier appel. Mendix à Teamcenter.

2.2 – Se connecter au SSO

Poursuivez cette section si vous utilisez un environnement Teamcenter traditionnel avec authentification unique (SSO). Revenons d'abord à Studio Pro. Accédez à Paramètres de l'applicationet sur le Runtime onglet définir le Après le démarrage microflux vers Gestionnaires de requêtes d'enregistrement SSO du Connecteur Tc module. Redémarrez l'application et revenez à la page de configuration de Teamcenter.
Sur la page Configurations de Teamcenter, cliquez sur New et configurez votre instance Teamcenter. Définir SSO activé à OuiLes valeurs ci-dessous s'appliquent à l'environnement utilisé comme exemple dans ce guide, mais vos points de terminaison peuvent différer.
Si vous ne savez pas comment configurer ces champs, veuillez vous référer à la section 6b de la page de documentation de Teamcenter Connector Configurer pour se connecter à Teamcenter, et assurez-vous de contacter votre administrateur Teamcenter.
Si vous n'avez pas encore ajouté votre Mendix candidature à la Tableau du registre des applications, se référer à cette page de documentationVotre domaine commence probablement par https. Si c'est le cas, vous devrez peut-être importer le certificat client de votre instance Teamcenter. ceci. Mendix page de documentation.
Enregistrez la configuration. Utilisez le sélecteur de démonstration à droite de la page et passez à utilisateur_demo.
Nous voici accueillis par le tableau de bord utilisateur. Nous sommes actuellement connectés à notre Mendix application, mais pas encore à notre instance Teamcenter. Appuyez sur Connexion à Teamcenter et authentifiez-vous sur votre page de connexion SSO.
Après vous être connecté avec succès, vous devriez être redirigé vers votre Mendix application, où vous êtes connecté en tant que utilisateur_demo et vous êtes accueilli par le tableau de bord utilisateur. La vignette à droite indique que l'utilisateur dispose d'une session Teamcenter valide. Vous êtes alors prêt à passer à la section trois : passer votre premier appel Teamcenter depuis Mendix.
Si votre rappel vous renvoie à une page d'erreur de navigateur comme celle ci-dessous (la page exacte diffère selon le navigateur), il y a trois considérations importantes à garder à l'esprit :
  • Confirmez que votre demande est enregistrée en utilisant uid as Attribut de nom d'utilisateur LDAP dans le Tableau du registre des applications.
  • Lors de l'enregistrement de votre application, vous avez besoin d'enregistrements d'application distincts pour le rappel vers localhost (à des fins de développement/test local) et le rappel vers votre application hébergée dans le cloud.
  • Confirmez que vous avez ajouté les certificats TLS/SSL requis dans les paramètres du projet de votre application
  • Confirmez que le port de l'URL de rappel est identique au port d'exécution du projet

2.3 – Se connecter à Teamcenter X SSO

Continuez avec cette section si vous avez un environnement Teamcenter X. Tout d'abord, nous devons retourner à Studio Pro. Accédez à Paramètres de l'applicationet sur le Runtime onglet définir le Après le démarrage microflux vers OIDC.ASU_OIDC_Startup. Redémarrez l’application et revenez à la page de configuration de Teamcenter.
Sur la page Configurations de Teamcenter, cliquez sur New et configurez votre instance Teamcenter. Définir Est-ce que TcX Environment à OuiLes valeurs ci-dessous s'appliquent à l'environnement utilisé comme exemple dans ce guide, mais vos terminaux peuvent différer. Si vous ne savez pas comment configurer ces champs, veuillez contacter votre Siemens Équipe CApS. Votre domaine commence probablement par https. Si c'est le cas, vous devrez peut-être importer un certificat par ceci. Mendix page de documentation.
Après avoir rempli tous les champs requis, enregistrez votre configuration Teamcenter. Retournez à la page de configuration de l'administrateur. Deux nouveaux boutons devraient alors apparaître. Cliquez sur Configurer MxModelReflection.
Vérifiez la Administration, MxModelReflection, OIDCet Module système et cliquez sur Synchroniser les modules et toutes les entités et microflux des modules vérifiés.
Une fois cela fait, revenez à la page de configuration de l'administrateur et cliquez sur Configurer OIDC.
Sur le Configuration du fournisseur OIDC incroyablement réaliste effect. New pour créer une nouvelle configuration OIDC.
Entrer le Alias, identité du clientet Secret client. Entrer le URL de configuration automatique et cliquez sur Importer la configuration. Si vous ne savez pas comment configurer ces champs, veuillez contacter votre Siemens Équipe CApS. Presse Enregistrer tout en bas de la page avant de pouvoir passer à l’étape suivante.
Ouvrez à nouveau la même configuration OIDC et ajoutez les étendues suivantes : ouvert, profil, ou a nous envoyer un courriel, compte_sam, samauth.ten. Enregistrez à nouveau la configuration.
Ouvrez à nouveau la même configuration OIDC et accédez à la Provisionnement des utilisateurs onglet. Définissez le L'attribut dans lequel le principal de l'utilisateur est stocké à Courriel Sous Cartographie d'attributs Définissez les mappages comme indiqué sur la capture d'écran. Enregistrez à nouveau la configuration.
Déconnectez-vous de l'application et cliquez sur le bouton SSO TcX se connecter .
Connectez-vous en tant qu'utilisateur authentifié sur l'instance Teamcenter X. Une fois connecté avec succès, vous êtes redirigé vers votre Mendix application. Actuellement, l'utilisateur est connecté à Mendix mais pas encore à Teamcenter, comme indiqué par la vignette à droite. Cliquez Connexion à Teamcenter.
Après un instant, la vignette de droite indique que l'utilisateur dispose d'une session Teamcenter valide. Vous pouvez alors passer à la section trois pour passer votre premier appel. Mendix à Teamcenter.
Si votre rappel vous renvoie à une page d'erreur de navigateur comme celle ci-dessous (la page exacte diffère selon le navigateur), il y a trois considérations importantes à garder à l'esprit :
  • Confirmez que vous disposez des certificats TLS/SSL requis dans les paramètres de votre projet
  • Confirmez que le port de l'URL de rappel est identique au port d'exécution du projet
  • Lors de l'enregistrement de votre application, vous avez besoin d'enregistrements d'application distincts pour le rappel vers localhost et le rappel vers votre application hébergée dans le cloud
Si vous avez besoin d'aide pour enregistrer le Mendix application et URL de rappel, intégration des utilisateurs ou besoin de confirmer que vous avez le bon niveau de Teamcenter X, veuillez contacter votre Siemens Équipe CApS.

3 – Tester l’application

Maintenant que nous sommes connectés à Mendix et Teamcenter, l'application d'exemple nous propose une sélection d'appels déjà implémentés. Chacune de ces intégrations a été générée par l'extension Teamcenter et implémentée dans l'application d'exemple. Dans le prochain article de cette série, nous allons implémenter une intégration nouvellement générée. Pour l'instant, examinons quelques-unes des intégrations déjà générées. Commencez par cliquer sur Révision de l'élément de recherche pour commencer à rechercher des révisions d'articles.
La page suivante implémente le Révision de l'article… recherche de requête enregistrée depuis Teamcenter. Dans cette implémentation, Nom, ID de l'articleet Type de révision de l'élément Des champs sont disponibles. Recherchez une révision d'élément dont le nom est présent dans votre environnement Teamcenter.
Vous pouvez effectuer une recherche avec un simple astérisque pour trouver toutes les révisions d'éléments et les types d'objets dérivés. Attention cependant, car cette recherche renverra tous les objets correspondants ; l'appel peut donc être très long. Des paramètres de recherche plus précis accéléreront les recherches.
Cette page affiche les résultats de la recherche une fois l'appel à Teamcenter terminé. Cliquez sur l'un des éléments suivants : Révision de l'article Pour plus de détails, consultez la section « Outre cette fonctionnalité, l'exemple d'application inclut l'implémentation de : Mises à jour et Réviser la révision de l'article sélectionné ; afficher une structure (par exemple une nomenclature) avec une configuration par défaut ou personnalisée ; gérer les ensembles de données attachés à la révision de l'article ; ou créer un Nouveau rapport de problème pour la révision de l'article.
De retour sur la page d’accueil, il y a trois boutons supplémentaires. Rechercher un objet d'espace de travail est une implémentation de la Général… recherche de requête enregistrée. Rechercher des ensembles de données est une implémentation de la Ensemble de données… recherche de requête enregistrée. Créer un élément crée un nouvel élément avec sa première révision d'élément.
L'exemple d'application de l'extension Teamcenter présente ces intégrations existantes et vous aide également à comprendre leur mise en œuvre avec l'extension Teamcenter. Si l'on examine le microflux, DS_ItemRevisionSearchCriteria_GetDemoItemRevisions, l'annotation nous informe que le sous-microflux DemoItemRevision_SavedQueryItemRevision est généré par l'extension Teamcenter. Ce microflux, implémenté dans l'exemple d'application, fonctionne actuellement tel quel. Cependant, nous pourrions également le remplacer par un autre microflux généré par l'extension Teamcenter, ce qui sera abordé dans un prochain article de blog.
Je vous encourage à explorer cette fonctionnalité par vous-même. N'hésitez pas à explorer et à expérimenter !

Terminer votre premier Mendix–Intégration Teamcenter

Félicitations pour la configuration de cette application intégrant Mendix avec Teamcenter ! L'application d'exemple d'extension Teamcenter offre une base solide, des fonctionnalités prêtes à l'emploi et des informations sur MendixInteractions Teamcenter. Grâce à différentes méthodes de connexion (identifiants, SSO ou Teamcenter X), vous disposez désormais des outils nécessaires pour étendre vos intégrations. N'hésitez pas à explorer et à tester les fonctionnalités de l'application dans Studio Pro, et n'hésitez pas à consulter la documentation et les ressources communautaires si vous avez besoin d'aide.

Foire aux questions (FAQ)

Choisissez votre langue