Présentation
Le connecteur IO-Base permet à Seeq d'accéder aux données de votre instance IO-Base. Cela inclut les données en temps réel et les données de l'arborescence des actifs.
Prérequis
IO-base étant une solution SaaS complète, nous garantissons le bon fonctionnement de ce connecteur.
Pour pouvoir utiliser ce connecteur, deux prérequis sont nécessaires :
Compte de service :
Avant de configurer le connecteur, vous devez créer un compte de service IO-Base.
Nous utilisons une méthode d'authentification avancée pour garantir la sécurité : Device Access Proxy → veuillez suivre cette procédure pour créer un jeton d'authentification correct :
Cette méthode d'authentification garantit que personne ne peut divulguer et réutiliser ces identifiants pour se connecter à vos données.
Agent SeeQ :
Vous devez déployer un agent SeeQ sur une instance ayant accès à la fois à IO-Base et à votre instance SeeQ.
IO-Base étant une solution SaaS, vous devez ouvrir le port 443 depuis votre instance.
Veuillez consulter la documentation SeeQ sur les agents :
Une fois l'agent prêt, veuillez suivre les étapes ci-dessous pour installer le connecteur :
1 - Téléchargez le fichier du connecteur depuis l'interface IO-Base.
2 - Arrêtez l'agent distant SeeQ - exécutez seeq stop dans le CLI Seeq.
3 - Copier le fichier zip du connecteur dans le dossier plugins/connectors dans le dossier de données SeeQ. (Le dossier de données est généralement C:\ProgramData\Seeq\data)
4 - Extraire le contenu du fichier zip.
5 - Redémarrez l'agent distant Seeq - exécutez seeq start dans le CLI Seeq.
Configuration
Voici un exemple de modèle de configuration qui apparaît dans la boîte de configuration supplémentaire lorsqu'on clique sur Configurer pour une source de données existante (ou dans la fenêtre modale Créer une nouvelle connexion de source de données qui s'affiche après avoir cliqué sur Ajouter une source de données) sur la page d'administration des sources de données.
{ "IndametaUrl": 10000, "IndabaUrl": "historian-server.somecloud.server.com", "AccessToken": "exampleUsername", "RefreshToken": "examplePassword", "RefreshTokenUrl": "aaUser", "ApiKey": "pwUser", "DeviceId": 32568 } |
Configuration additionnelle IO-Base
Nom de la propriété | Valeur par défaut | Type de données | Description |
IndametaUrl | null | String | L'URL utilisée pour se connecter à l'API IO-Base pour les données de l'arborescence des actifs. Par exemple : https://exemple.meta.api.indasuite.io-base.com/v2 |
IndabaUrl | null | String | L'URL utilisée pour se connecter à l'API IO-Base pour les données en temps réel. Par exemple : |
AccessToken | null | String | Jeton d'accès généré par la demande de jeton initiale.
Utilisez le jeton d'accès généré en suivant la procédure DAP. |
RefreshToken | null | String | Jeton de rafraîchissement généré par la demande de jeton initiale. Celui-ci sera mis à jour automatiquement à chaque récupération d'un nouveau jeton de rafraîchissement.
Utilisez le jeton de rafraîchissement généré en suivant la procédure DAP. |
RefreshTokenUrl | null | String | URL de rafraîchissement du jeton API DAP
Exemple : |
ApiKey | null | String | La clé API pour la connexion à ce service. |
DeviceId | null | String | Identifiant de l'appareil tel qu'enregistré par l'API DAP (également appelé client_id dans l'API DAP) dans IO-Base.
Il s'agit du nom du compte de service configuré dans IO-Base sur cette page : https://<votre URL IO-Base>/app/devices/list |
À l'exception du jeton de rafraîchissement, toutes ces informations d'identification se trouvent dans IO-Base, sur la page Appareils :
https://<votre URL IO-Base>/app/devices/list
Problèmes connus
Aucun problème connu n’a été signalé pour le connecteur IO-Base. Veuillez signaler tout problème rencontré sur notre portail de support.
Dépannage
L'authentification peut échouer si vous avez effectué plusieurs appels API avec le même jeton de rafraîchissement. Dans ce cas, vous devez créer un nouvel appareil et suivre à nouveau la procédure DAP (Device Access Proxy).