ZeroKey Integration Suite

Connectez-vous avec des trackers de précision sub-millimétrique pour rationaliser l'efficacité des opérations avec Tulip et ZeroKey.

Démarrer avec ZeroKey

ZeroKey Inc. est une entreprise technologique en plein essor qui conçoit, développe et fabrique le système de localisation en temps réel (RTLS) 3D le plus précis au monde. ZeroKey et Tulip se sont associés pour offrir une solution intégrée qui combine la technologie RTLS Quantum de ZeroKey avec la plateforme Frontline Operations de Tulip. Les technologies de localisation traditionnelles ne peuvent pas numériser avec précision les processus centrés sur l'homme à grande échelle, ce qui entraîne une valeur inexploitée importante en termes d'efficacité de la production, de sécurité des travailleurs, de contrôle de la qualité, etc. Grâce à l'intégration de ZeroKey et de Tulip, les clients bénéficient d'une visibilité complète de n'importe quel processus, de la fabrication centrée sur l'homme au suivi des commandes à l'échelle de l'établissement.

L'objectif des widgets ZeroKey est de vous fournir des widgets prêts à l'emploi qui peuvent servir de widget utilisable dans une application ou être le point de départ de widgets plus personnalisés qui tirent parti de ZeroKey. Ces plugins de widgets personnalisés sont des widgets codés qui se placent au-dessus de la plateforme Tulip et exploitent la plateforme d'intelligence spatiale de Zerokey, ce qui facilite l'utilisation de Zerokey dans Tulip.

Widget de localisation Zerokey

Le widget Zerokey Location est un outil visuel de suivi de la localisation des appareils ZeroKey. Ce widget se met à jour en temps réel pour afficher l'emplacement des appareils par rapport au canevas de dessin. Ce widget peut être superposé à une image, telle qu'un plan d'atelier, dans une application afin de fournir des informations précises sur l'emplacement dans le monde réel.

Vidéo de démonstration

Configuration

Les plugins Custom Widget constituent un outil puissant pour ajouter des widgets personnalisés à votre application. Les widgets vous permettent d'écrire du Javascript pour étendre et personnaliser la fonctionnalité d'un widget. Les widgets Zerokey s'appuient sur le Javascript et les API de Zerokeys pour fournir une large gamme de fonctionnalités. Les widgets Zerokey de Tulip fournissent également un comportement de "mocking" du système, de sorte que vous pouvez commencer à tester les widgets immédiatement. Les éléments suivants sont nécessaires pour les widgets Zerokey :

• L'URL de votre Hub d'événements Zerokey.
• Votre jeton API Zerokey
• Largeur de l'emplacement en mètres
• Hauteur de l'emplacement en mètres
• Carte des noms d'identification des appareils
• Données fictives

En ce qui concerne l'URL du Zerokey Event Hub et le jeton API, nous vous renvoyons à la documentation de Zerokey. Les informations Zerokey sont ajoutées directement au code du système spatial Zerokey. La largeur et la hauteur de l'emplacement font référence à la largeur et à la hauteur physiques de l'espace dans lequel vous avez déployé votre système spatial Zerokey. Le nom de la carte d'identification du dispositif est facultatif. Elle vous permet de fournir un nom lisible par l'homme pour l'associer à un identifiant de périphérique. Par exemple, le Device ID D8:FC:ED:EA:53:1C peut être associé à "Connector Widget Bin". Vous pouvez fournir un objet chaîne JSON en tant qu'élément de votre widget pour associer les identifiants. Voici un exemple :{ "D8:FC:ED:EA:53:1C" : "Connector Widget Bin", "AA:BB:CC:12:34:56" : "Station X de l'opérateur", }

Une dernière étape consiste à s'assurer que la taille du canevas du widget est définie de manière à avoir le même rapport d'aspect que votre espace physique. Cela permettra au widget d'afficher les emplacements en fonction de votre espace physique.

Dans le code Javascript du widget, vous pouvez définir la variable mock data à true pour recevoir des données fictives, ou à false pour ne recevoir que des données réelles.

Comment cela fonctionne-t-il ?

Une fois que vous avez configuré votre widget, vous pouvez le tester dans l'éditeur de widget ou l'ajouter directement à une application. Dans les deux cas, vous devrez avoir des dispositifs Zerokey actifs dans votre zone spatiale Zerokey. Tout dispositif actif dans votre zone spatiale Zerokey s'affichera dans votre widget sous la forme d'un cercle avec l'ID du dispositif ou le nom cartographié inclus. En règle générale, vous disposerez d'une image cartographiant votre espace physique sur lequel vous placerez votre widget. Dans ce cas, l'emplacement de l'appareil sera dessiné avec précision sur votre carte. Notez que l'image de votre carte doit avoir le même rapport d'aspect que votre espace physique et le canevas du widget.

Widget Zone de Zerokey

Le widget Zone fournit une liste visuelle de toutes les zones qui ont signalé un événement d'entrée de zone, de sortie de zone ou d'occupation de zone. La liste visuelle affiche le même ID ou nom et l'ID ou le nom du dispositif pour tous les dispositifs associés à la zone.

Vidéo de présentation

Configuration

Custom Widget Les plugins fournissent un outil puissant pour ajouter des widgets personnalisés à votre application. Les widgets vous permettent d'écrire du Javascript pour étendre et personnaliser la fonctionnalité d'un widget. Les widgets Zerokey s'appuient sur le Javascript et les API de Zerokeys pour fournir une large gamme de fonctionnalités. Les widgets Zerokey de Tulip fournissent également un comportement de "mocking" du système, de sorte que vous pouvez commencer à tester les widgets immédiatement. Les éléments suivants sont nécessaires pour les widgets Zerokey :

• L'URL de votre Hub d'événements Zerokey.
• Votre jeton API Zerokey
• Carte des noms d'ID de zone
• Carte des noms d'identifiants d'appareils
• Connecter des événements à une application
• Données fictives

En ce qui concerne l'URL du Zerokey Event Hub et le jeton API, nous vous renvoyons à la documentation de Zerokey.

Cartes d'ID de zone et d'appareil

Le mappage du nom de l'ID de la zone est facultatif. Elle vous permet de fournir un nom lisible par l'homme pour l'associer à un ID de zone. Par exemple, le Device ID "aae876a0-cb98-4c12-a16c-a56764aea4r" peut être associé à "Vision station". Vous pouvez fournir un objet JSON sous forme de chaîne en tant qu'élément de votre widget pour mapper les ID. Voici un exemple :{"ffe434a0-cb29-4d22-a16c-70f764aedbcb" : "Salle des pièces détachées", "aae876a0-cb98-4c12-a16c-a56764aea4r" : "Station de vision", }

Le mappage du nom de l'identifiant de l'appareil est facultatif. Elle vous permet de fournir un nom lisible par l'homme pour l'associer à l'identifiant de l'appareil. Par exemple, le Device ID D8:FC:ED:EA:53:1C peut être associé à "Connector Widget Bin". Vous pouvez fournir un objet JSON sous forme de chaîne en tant qu'élément de votre widget pour associer les identifiants. Voici un exemple :

{"D8:FC:ED:EA:53:1C" : "Connector Widget Bin", "AA:BB:CC:12:34:56" : "Station X de l'opérateur", }

Une dernière étape consiste à s'assurer que la taille du canevas du widget est définie de manière à avoir le même rapport d'aspect que votre espace physique. Cela permettra au widget d'afficher les emplacements en fonction de votre espace physique.

Relier les événements à une application

Le widget Zerokey Zone déclenche des événements pour les zones entrées, les zones occupées et les zones vides. Vous pouvez créer des déclencheurs qui écoutent ces événements et y répondent dans votre application.

Données fictives

Dans le code Javascript du widget, vous pouvez définir la variable mock data à true pour recevoir des données fictives, ou à false pour recevoir uniquement des données réelles.

Comment cela fonctionne-t-il ?

Une fois que vous avez configuré votre widget, vous pouvez le tester dans l'éditeur de widget ou l'ajouter directement à une application. Dans les deux cas, vous devrez avoir des dispositifs Zerokey actifs dans votre zone spatiale Zerokey et vous devrez avoir configuré des zones. Le widget enverra des informations sur la liste des zones pour les événements de zone et enverra des événements de zone pour que votre application y réponde. Notez que vous pouvez cacher la liste des zones dans votre application soit en la recouvrant d'une forme, soit en commentant le code suivant dans le HTML du widget : ````

## Widget Request-Response de Zerokey


Le widget Zerokey Request-Reponse fournit un exemple d'utilisation d'autres éléments non-eventlistener de l'API Zerokey. Le widget obtiendra automatiquement un jeton Bearer et le rafraîchira si nécessaire. Le widget fournit une interface de tableau de bord qui permet à l'utilisateur de demander des informations sur les dispositifs vus aujourd'hui, les zones et des détails spécifiques sur les dispositifs. Bien que ce widget soit immédiatement utilisable dans une application Tulip, il est principalement utilisé à titre d'exemple et pour construire d'autres widgets personnalisés à partir de celui-ci.


### Vidéo de présentation



### Mise en place


Les plugins Custom Widget fournissent un outil puissant pour ajouter des widgets personnalisés à votre application. Les widgets vous permettent d'écrire du Javascript pour étendre et personnaliser la fonctionnalité d'un widget. Les widgets Zerokey s'appuient sur le Javascript et les API de Zerokeys pour fournir une large gamme de fonctionnalités. Les widgets Zerokey de Tulip fournissent également un comportement de "mocking" du système, de sorte que vous pouvez commencer à tester les widgets immédiatement. Les éléments suivants sont nécessaires pour les widgets Zerokey :


* L'URL de votre API Zerokey
* Votre nom d'utilisateur et votre mot de passe Zerokey pour l'authentification de l'API
* Données fictives


*En ce qui concerne l'URL du Zerokey Event Hub et le jeton API, nous vous renvoyons à la [documentation de Zerokey](https://api.zerokey.com/).*


### Données fictives


Dans le code Javascript du widget, vous pouvez définir la variable mock data à true pour recevoir des données fictives, ou à false pour ne recevoir que des données réelles. 


### Comment cela fonctionne-t-il ?


Une fois que vous avez configuré votre widget, vous pouvez le tester dans l'éditeur de widget ou l'ajouter directement à une application. Dans les deux cas, si vous ne simulez pas les données, vous devrez avoir des dispositifs Zerokey actifs dans votre zone spatiale Zerokey et vous devrez avoir configuré des zones. Le tableau de bord de l'interface widget fournit des boutons qui vous permettent de demander les dispositifs vus aujourd'hui, l'état de la zone et des informations spécifiques sur les dispositifs. S'il y a des résultats, ils seront listés sous les boutons. 


## Widget de suivi des outils Zerokey


Le widget Zerokey Tool Tracker (Zerokey device tracker) vérifie si un dispositif spécifique se trouve à un endroit défini par l'utilisateur. Cela revient à vérifier si un dispositif se trouve dans une zone définie par l'utilisateur. L'utilisateur peut définir la zone via les accessoires du widget. Ce widget pourrait être utilisé pour suivre l'utilisation la plus récente d'un moteur de couple auquel est attaché un dispositif Zerokey. Dans ce cas, vous pouvez vérifier que la "bonne" vis a été serrée. Lorsque la clé dynamométrique signale "fait" à une application Tulip, nous utilisons ce signal pour vérifier l'emplacement du dispositif afin de nous assurer que la "bonne" vis vient d'être serrée.


### Vidéo de démonstration



### Configuration


Custom Widget Les plugins fournissent un outil puissant pour ajouter des widgets personnalisés à votre application. Les widgets vous permettent d'écrire du Javascript pour étendre et personnaliser la fonctionnalité d'un widget. Les widgets Zerokey s'appuient sur le Javascript et les API de Zerokeys pour fournir une large gamme de fonctionnalités. Les widgets Zerokey de Tulip fournissent également un comportement de "mocking" du système, de sorte que vous pouvez commencer à tester les widgets immédiatement. Les éléments suivants sont nécessaires pour les widgets Zerokey :


* L'URL de votre API Zerokey
* Votre nom d'utilisateur et votre mot de passe Zerokey pour l'authentification API
* Centre x de la zone définie par l'utilisateur
* Centre y de la zone définie par l'utilisateur
* Largeur de la zone définie par l'utilisateur
* Hauteur de la zone définie par l'utilisateur
* Connecter des événements à une application
* Données fictives


*En ce qui concerne l'URL de Zerokey Event Hub et le jeton API, nous vous renvoyons à la [documentation de Zerokey](https://api.zerokey.com/).*


### Zone définie par l'utilisateur


Le widget Zerokey Tool Tracker vous permet de créer une zone bidimensionnelle via les accessoires du widget. Vous aurez besoin de connaître l'emplacement du centre x,y et la largeur et la hauteur de la zone en mètres. Vous pouvez obtenir l'emplacement x,y du centre en utilisant un dispositif Zerokey et en le plaçant à l'emplacement central souhaité. Une fois que vous avez configuré la zone définie par l'utilisateur, vous pouvez vérifier si un dispositif Zerokey se trouve dans la zone. 


### Transmettre des événements à une application


Pour une utilisation dans une application Tulip, vous voudrez qu'un dispositif matériel ou une machine déclenche un événement. Lors de cet événement, la chaîne d'**identification de l'appareil** doit être écrite dans une variable. Cette variable doit être l'entrée du widget Zerokey Tool Tracker prop "device\_id".


### Données fictives


Dans le code Javascript du widget, vous pouvez définir la variable "mock data" à true pour recevoir des données fictives, ou à false pour recevoir uniquement des données réelles.


### Comment cela fonctionne-t-il ?


Une fois que vous avez configuré votre widget, vous pouvez le tester dans l'éditeur de widget ou l'ajouter directement à une application. Après avoir configuré votre widget dans une application, vous pourrez déclencher le widget en mettant à jour sa propriété "device\_id". Typiquement, cela se fait par le biais d'un déclencheur avec un appareil (outil physique). Lors du déclenchement de l'appareil, l'ID de l'appareil sera écrit dans une variable assignée à la propriété "device\_id" du widget. Le widget demandera alors les informations relatives à l'ID de l'appareil à l'API Zerokey. Si les informations relatives à l'emplacement de l'appareil se trouvent dans la zone définie par l'utilisateur, l'événement "valid\_tool\_location" sera envoyé, avec la valeur true si l'appareil se trouve dans la zone définie par l'utilisateur, et false dans le cas contraire.