Présentation de l’intégration Aras

Prev Next

Optimisez le PLM et la gestion globale du cycle de vie des produits grâce à l’intégration Aras

Additional Configuration Required

This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Aras to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.

Contexte

Aras Innovator est une solution PLM complète. Elle dispose d’un modèle de données auto-descriptif qui permet des personnalisations à grande échelle pour répondre à vos besoins. Cet article explique comment configurer votre instance pour qu’elle se connecte via Tulip. Si vous souhaitez obtenir plus d’informations sur Aras Innovator, veuillez consulter notre site web.

Contexte

Aras Innovator est une application basée sur IIS qui peut être exécutée sur site ou dans le cloud. La seule condition importante pour vous connecter à votre instance via Tulip est que votre serveur accepte les requêtes provenant des serveurs de Tulip. Pour cette démonstration, nous partons du principe que votre serveur est configuré pour une connexion ouverte.

Configuration

Connecteur

Lorsque vous créez un nouveau connecteur, vous devez indiquer, dans la section « Hôte » des détails de connexion, l’URL de base de votre machine hôte. Il est important de noter que vous accédez généralement à votre URL Innovator via [URL de base]/InnovatorAlias.
image.png

Authentification

Pour authentifier notre application Tulip, nous devons obtenir un jeton à transmettre à toutes nos fonctions de connecteur. Pour ce faire, nous disposerons d’une fonction de connecteur qui transmettra un jeton de réponse à toutes les autres. Voici un exemple de ce à quoi ressemble cette fonction d’authentification :
image.png

Nous envoyons ici une requête pour utiliser notre nom d’utilisateur et notre mot de passe haché afin de recevoir un jeton. Nous remplissons le corps de la requête avec toutes les informations nécessaires. Pour plus d’informations sur l’obtention d’un jeton depuis Aras Innovator, consultez l’article de blog correspondant sur le site d’Aras :

Cette fonction renvoie une variable appelée access_token. Toutes nos autres fonctions disposeront d’une entrée pour cette variable. En général, nous appelons cette fonction « Get Token » au début de chaque exécution de notre application. De cette manière, nous disposons du jeton pour tous les appels restants.

Utilisation des fonctions de connecteur dans les applications

Voici un exemple de déclencheur pouvant s’exécuter au début de votre application :image.png

Comme nous enregistrons la sortie de notre première fonction dans une variable, celle-ci sera accessible depuis toutes nos étapes et fonctions suivantes. À partir de là, vous pouvez effectuer toutes les opérations souhaitées via notre API. Il est généralement recommandé de récupérer des données depuis Innovator et de les afficher dans Tulip, mais notre API permet également de créer des données dans Innovator à partir d’un appel REST.

Voici un exemple rapide illustrant comment récupérer toutes les pièces de notre système. Nous disposons d’une API basée sur OData qui permet d’effectuer des requêtes flexibles en fonction de votre URL.
image.png

Comme vous pouvez le constater, nous n’avons qu’un seul en-tête de requête qui utilise notre variable access_token. Puisque nous allons récupérer plusieurs pièces dans cette requête, nous enregistrerons le résultat sous forme de tableau et définirons ci-dessous les différentes propriétés de nos pièces. Grâce à l’API OData, vous pouvez demander n’importe quel élément spécifique en transmettant un paramètre supplémentaire, ce qui permet d’identifier l’élément que vous recherchez.
image.png

Dans cet exemple, vous pouvez voir que nous ajoutons un paramètre de requête supplémentaire qui définit un filtre. Ici, nous utilisons le numéro d’élément d’une pièce spécifique dans Aras et l’intégrons à notre filtre. Vous pouvez filtrer sur n’importe quelle propriété dans Aras, y compris les propriétés personnalisées que vous avez définies dans votre système.

Les requêtes peuvent s’avérer légèrement plus complexes lorsqu’il s’agit de parcourir différentes relations au sein d’Aras. Par exemple, dans une configuration Innovator par défaut, il existe une relation « un-à-plusieurs » entre les pièces et les documents. Chaque pièce peut être associée à plusieurs documents, et nous souhaitons afficher tous les documents liés à une pièce donnée. La requête ressemblerait alors à ceci :
image.png

Ce que nous faisons ici, c’est spécifier une pièce précise et rechercher toutes les instances de « Pièce Document » (un élément de liaison entre la pièce et le document) qui y sont associées. Ensuite, nous développons le champ related\_id de l’élément « Pièce-Document » pour accéder à l’élément « Document » lui-même. Si vous examinez les résultats, vous constaterez que nous récupérons les informations pertinentes à partir du champ related\_id.

Cette méthode peut être utilisée pour parcourir n’importe quelle relation au sein d’Aras Innovator. Pour plus d’informations sur la manière d’exploiter pleinement le potentiel de notre API REST, veuillez consulter la documentation officielle

Conclusion

Il existe de nombreuses autres connexions puissantes que vous pouvez établir entre Aras Innovator et Tulip. L’intégralité de notre API OData est disponible. Grâce à cette API, vous pouvez faire bien plus que simplement récupérer des données. Vous pouvez envoyer des données vers Innovator, voire exécuter une logique personnalisée via des méthodes, ou effectuer des requêtes complexes via des définitions de requêtes ! Il existe une multitude de possibilités que vous pouvez exploiter pour tirer le meilleur parti de cette connexion. Si vous avez des questions concernant Aras Innovator, n’hésitez pas à les poser sur les forums de la communauté Aras. Si vous recherchez plus d’informations sur notre API en particulier, consultez la documentation correspondante ici.