ZeroKey Integration Suite

Verbinden Sie sich mit Submillimeter-Präzisions-Trackern, um mit Tulip und ZeroKey die Betriebseffizienz zu optimieren.

Erste Schritte mit ZeroKey

ZeroKey Inc. ist ein aufstrebendes Technologieunternehmen, das das weltweit genaueste, großflächige 3D-Echtzeit-Ortungssystem (RTLS) entwickelt, konstruiert und herstellt. ZeroKey und Tulip sind eine Partnerschaft eingegangen, um eine integrierte Lösung anzubieten, die die Quantum RTLS-Technologie von ZeroKey mit der Frontline Operations Platform von Tulip kombiniert. Herkömmliche Ortungstechnologien sind nicht in der Lage, menschenzentrierte Prozesse in großem Umfang präzise zu digitalisieren, was zu einem erheblichen ungenutzten Wert in Bezug auf Produktionseffizienz, Arbeitssicherheit, Qualitätskontrolle und mehr führt. Mit der Integration von ZeroKey und Tulip erhalten Kunden einen vollständigen Überblick über jeden Prozess, von der menschenbezogenen Fertigung bis zur werksweiten Auftragsverfolgung.

Der Zweck der ZeroKey Widgets ist es, Ihnen gebrauchsfertige Widgets zur Verfügung zu stellen, die als nutzbares Widget in einer App dienen können oder den Ausgangspunkt für weitere benutzerdefinierte Widgets bilden, die ZeroKey nutzen. Diese benutzerdefinierten Widget-Plugins sind kodierte Widgets, die auf der Tulip-Plattform aufsetzen und die räumliche Intelligenz von Zerokey nutzen, was den Einstieg in Zerokey in Tulip erleichtert.

Zerokey Standort-Widget

Das Zerokey Location Widget ist ein visueller ZeroKey Gerätestandort-Tracker. Dieses Widget wird in Echtzeit aktualisiert, um die Position der Geräte relativ zur Zeichenfläche anzuzeigen. Dieses Widget kann in einer App über ein Bild, z. B. eine Werkstattkarte, gelegt werden, um genaue reale Standortinformationen zu liefern.

Video-Durchlauf

Einrichtung

Benutzerdefinierte Widget-Plugins sind ein leistungsfähiges Werkzeug zum Hinzufügen benutzerdefinierter Widgets zu Ihrer Anwendung. Widgets erlauben es Ihnen, Javascript zu schreiben, um die Funktionalität eines Widgets zu erweitern und anzupassen. Die Zerokey-Widgets nutzen Javascript und Zerokeys APIs, um eine breite Palette von Funktionen zu bieten. Die Tulip Zerokey Widgets bieten auch ein "Mocking"-Verhalten des Systems, so dass Sie sofort mit dem Testen der Widgets beginnen können. Für Zerokey-Widgets sind folgende Voraussetzungen erforderlich:

• Ihre Zerokey Event Hub URL.
• Ihr Zerokey-API-Token
• Standortbreite in Metern
• Höhe des Standorts in Metern
• Geräte-ID-Namenskarte
• Mock-Daten

Bezüglich der Zerokey Event Hub URL und des API-Tokens verweisen wir Sie auf die Zerokey Dokumentation. Die Zerokey-Informationen werden direkt in den Code des Zerokey Event Hub eingefügt. Die Breite und Höhe des Standorts beziehen sich auf die physische Breite und Höhe des Raums, in dem Sie Ihr Zerokey-Raumsystem installiert haben. Die Zuordnung des Geräte-ID-Namens ist optional. Hier können Sie einen von Menschen lesbaren Namen angeben, der einer Geräte-ID zugeordnet wird. Zum Beispiel kann die Geräte-ID D8:FC:ED:EA:53:1C auf "Connector Widget Bin" abgebildet werden. Sie können ein JSON String-Objekt als Requisite für Ihr Widget bereitstellen, um IDs zuzuordnen. Nachfolgend ein Beispiel:{ "D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Operator X Station", }

Ein letzter Schritt besteht darin, sicherzustellen, dass die Größe der Widget-Leinwand auf das gleiche Seitenverhältnis wie der physische Raum eingestellt ist. Dadurch wird sichergestellt, dass das Widget die Standorte so ausgibt, dass sie mit dem physischen Raum übereinstimmen.

Im Javascript-Code des Widgets können Sie die Variable mock data auf true setzen, um Mock-Daten zu erhalten, oder false, um nur echte Daten zu erhalten.

Wie es funktioniert

Sobald Sie Ihr Widget eingerichtet haben, können Sie es im Widget-Editor testen oder es direkt zu einer App hinzufügen. In jedem Fall müssen Sie Zerokey-Geräte in Ihrem Zerokey-Raum aktiv haben. Jedes Gerät, das in Ihrem Zerokey-Raum aktiv ist, wird in Ihrem Widget als Kreis angezeigt, der die Geräte-ID oder den zugeordneten Namen enthält. In der Regel haben Sie ein Bild, das Ihren physischen Raum abbildet, über dem Sie Ihr Widget platzieren werden. In diesem Fall wird der Standort des Geräts genau auf Ihrer Karte eingezeichnet. Beachten Sie, dass Ihr Kartenbild das gleiche Seitenverhältnis haben muss wie Ihr physischer Raum und die Widget-Leinwand.

Zerokey Zone Widget

Das Zonen-Widget bietet eine visuelle Listenausgabe aller Zonen, die ein Ereignis "Zone betreten", "Zone verlassen" oder "Zone belegt" gemeldet haben. Die visuelle Liste zeigt dieselbe ID oder denselben Namen sowie die Geräte-ID oder den Namen aller mit der Zone verbundenen Geräte an.

Video-Durchgang

Einrichtung

Benutzerdefinierte Widget-Plugins bieten ein leistungsfähiges Werkzeug zum Hinzufügen von benutzerdefinierten Widgets zu Ihrer Anwendung. Widgets ermöglichen es Ihnen, Javascript zu schreiben, um die Funktionalität eines Widgets zu erweitern und anzupassen. Die Zerokey-Widgets nutzen Javascript und Zerokeys APIs, um eine breite Palette von Funktionen zu bieten. Die Tulip Zerokey Widgets bieten auch ein "Mocking"-Verhalten des Systems, so dass Sie sofort mit dem Testen der Widgets beginnen können. Für Zerokey-Widgets sind folgende Voraussetzungen erforderlich:

• Ihre Zerokey Event Hub URL.
• Ihr Zerokey-API-Token
• Zone ID-Namenszuordnung
• Geräte-ID-Namenszuordnung
• Verkabelung von Ereignissen mit einer App
• Mock-Daten

Bezüglich der Zerokey Event Hub URL und des API-Tokens verweisen wir Sie auf die Zerokey Dokumentation.

Zone und Geräte-ID-Maps

Die Zone ID Name Map ist optional. Damit können Sie einen menschenlesbaren Namen für die Zuordnung zu einer Zonen-ID angeben. Zum Beispiel kann die Geräte-ID "aae876a0-cb98-4c12-a16c-a56764aea4r" auf "Vision-Station" abgebildet werden. Sie können ein JSON-String-Objekt als Prop für Ihr Widget bereitstellen, um IDs zuzuordnen. Im Folgenden ein Beispiel:{ "ffe434a0-cb29-4d22-a16c-70f764aedbcb": "Ersatzteilraum", "aae876a0-cb98-4c12-a16c-a56764aea4r": "Sehstation", }

Die Zuordnung des Geräte-ID-Namens ist optional. Hier können Sie einen von Menschen lesbaren Namen für die Zuordnung zu einer Geräte-ID angeben. Zum Beispiel kann die Geräte-ID D8:FC:ED:EA:53:1C auf "Connector Widget Bin" abgebildet werden. Sie können ein JSON-String-Objekt als Requisite für Ihr Widget bereitstellen, um IDs zuzuordnen. Im Folgenden finden Sie ein Beispiel:

{ "D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Operator X Station", }

Ein letzter Schritt besteht darin, sicherzustellen, dass die Größe der Widget-Leinwand auf das gleiche Seitenverhältnis wie der physische Raum eingestellt ist. Dadurch wird sichergestellt, dass das Widget die Standorte so ausgibt, dass sie mit dem physischen Raum übereinstimmen.

Verkabelung von Ereignissen mit einer App

Das Zerokey Zone Widget feuert Ereignisse für betretene, belegte und leere Zonen ab. Sie können Auslöser erstellen, die auf diese Ereignisse hören und in Ihrer App reagieren.

Daten simulieren

Im Javascript-Code des Widgets können Sie die Variable "mock data" auf "true" setzen, um "mock data" zu empfangen, oder auf "false", um nur echte Daten zu empfangen.

Wie es funktioniert

Sobald Sie Ihr Widget eingerichtet haben, können Sie es im Widget-Editor testen oder es direkt zu einer App hinzufügen. In jedem Fall müssen Zerokey-Geräte in Ihrem Zerokey-Raum aktiv sein und Sie müssen Zonen konfiguriert haben. Das Widget wird Zoneninformationen für Zonenereignisse auflisten und Zonenereignisse auslösen, auf die Ihre App reagieren kann. Beachten Sie, dass Sie die Zonenliste in Ihrer Anwendung ausblenden können, indem Sie sie entweder mit einer Form abdecken oder den folgenden Code im HTML-Code des Widgets auskommentieren: ```

## Zerokey Anfrage-Antwort Widget


Das Zerokey Request-Reponse Widget bietet ein Beispiel für die Verwendung anderer Nicht-Eventlistener-Elemente der Zerokey API. Das Widget erhält automatisch ein Bearer-Token und aktualisiert es bei Bedarf. Das Widget bietet eine Dashboard-Benutzeroberfläche, die es dem Benutzer ermöglicht, Informationen über heute gesehene Geräte, Zonen und spezifische Gerätedetails abzufragen. Obwohl dieses Widget sofort in einer Tulip-Applikation verwendet werden kann, wird es in erster Linie für Beispiele und die Erstellung anderer benutzerdefinierter Widgets verwendet.


### Video-Durchlauf



### Einrichtung


Benutzerdefinierte Widget-Plugins sind ein leistungsstarkes Werkzeug, um Ihrer Anwendung benutzerdefinierte Widgets hinzuzufügen. Widgets erlauben es Ihnen, Javascript zu schreiben, um die Funktionalität eines Widgets zu erweitern und anzupassen. Die Zerokey-Widgets nutzen Javascript und Zerokeys APIs, um eine breite Palette von Funktionen zu bieten. Die Tulip Zerokey Widgets bieten auch ein "Mocking"-Verhalten des Systems, so dass Sie sofort mit dem Testen der Widgets beginnen können. Für Zerokey-Widgets sind folgende Angaben erforderlich:


* Ihre Zerokey API URL
* Ihr Zerokey-Benutzername und Passwort für die API-Authentifizierung
* Mock-Daten


*Bezüglich der Zerokey Event Hub URL und des API-Tokens verweisen wir Sie auf die [Zerokey Dokumentation](https://api.zerokey.com/).*


### Mock-Daten


Im Javascript-Code des Widgets können Sie die Variable mock data auf true setzen, um Mock-Daten zu erhalten, oder false, um nur echte Daten zu erhalten. 


### Wie es funktioniert


Sobald Sie Ihr Widget eingerichtet haben, können Sie es im Widget-Editor testen oder es direkt zu einer App hinzufügen. In jedem Fall müssen Sie, wenn Sie keine Mocking-Daten empfangen, Zerokey-Geräte in Ihrem Zerokey-Raum aktiv haben und Zonen konfiguriert haben. Das Widget UI Dashboard bietet Schaltflächen, mit denen Sie heute gesehene Geräte, den Zonenstatus und spezifische Geräteinformationen abfragen können. Wenn es Ergebnisse gibt, werden diese unter den Schaltflächen aufgelistet. 


## Zerokey Tool Tracker Widget


Das Widget Zerokey Tool Tracker (Zerokey-Gerätetracker) prüft, ob sich ein bestimmtes Gerät an einem benutzerdefinierten Ort befindet. Dies ist vergleichbar mit der Überprüfung, ob sich ein Gerät in einer benutzerdefinierten Zone befindet. Der Benutzer kann die Zone über die Props des Widgets definieren. Dies könnte verwendet werden, um die letzte Verwendung eines Drehmomentantriebs mit einem daran angeschlossenen Zerokey-Gerät zu verfolgen. In diesem Fall könnte man überprüfen, ob die "richtige" Schraube angezogen wurde. Wenn der Drehmomentschrauber "fertig" an eine Tulip-App meldet, verwenden wir dieses Signal, um die Position des Geräts zu überprüfen und sicherzustellen, dass die "richtige" Schraube gerade angezogen wurde.


### Video-Durchlauf



### Einrichtung


Benutzerdefinierte Widget-Plugins sind ein leistungsfähiges Werkzeug zum Hinzufügen benutzerdefinierter Widgets zu Ihrer Anwendung. Widgets erlauben es Ihnen, Javascript zu schreiben, um die Funktionalität eines Widgets zu erweitern und anzupassen. Die Zerokey-Widgets nutzen Javascript und Zerokeys APIs, um eine breite Palette von Funktionen zu bieten. Die Tulip Zerokey Widgets bieten auch ein "Mocking"-Verhalten des Systems, so dass Sie sofort mit dem Testen der Widgets beginnen können. Für Zerokey-Widgets sind folgende Angaben erforderlich:


* Ihre Zerokey API URL
* Ihr Zerokey-Benutzername und -Passwort für die API-Authentifizierung
* Zentrum x der benutzerdefinierten Zone
* Zentrum y der benutzerdefinierten Zone
* Breite der benutzerdefinierten Zone
* Höhe der benutzerdefinierten Zone
* Verkabelung von Ereignissen mit einer App
* Mock-Daten


*Bezüglich der Zerokey Event Hub URL und des API Tokens verweisen wir auf die [Zerokey Dokumentation](https://api.zerokey.com/).*


### Benutzerdefinierte Zone


Mit dem Zerokey Tool Tracker Widget können Sie eine zweidimensionale Zone über die Props des Widgets erstellen. Dazu müssen Sie den Mittelpunkt (x, y) sowie die Breite und Höhe der Zone in Metern angeben. Sie können die zentrale x,y-Position ermitteln, indem Sie ein Zerokey-Gerät verwenden und es an der gewünschten zentralen Position platzieren. Sobald Sie die benutzerdefinierte Zone konfiguriert haben, können Sie prüfen, ob sich ein Zerokey-Gerät innerhalb des Zonenbereichs befindet. 


### Ereignisse an eine App weiterleiten


Für die Verwendung in einer Tulip-App möchten Sie, dass ein Hardware-Gerät oder eine Maschine ein Ereignis auslöst. Bei diesem Ereignis sollte der String der **Geräte-ID** in eine Variable geschrieben werden. Diese Variable sollte die Eingabe für das Zerokey Tool Tracker Widget prop "device\_id" sein.


### Mock-Daten


Im Javascript-Code des Widgets können Sie die Variable "mock data" auf "true" setzen, um "mock data" zu empfangen, oder auf "false", um nur echte Daten zu empfangen.


### Wie es funktioniert


Sobald Sie Ihr Widget eingerichtet haben, können Sie es im Widget-Editor testen oder es direkt zu einer App hinzufügen. Nachdem Sie Ihr Widget in einer App konfiguriert haben, können Sie das Widget auslösen, indem Sie seine "device\_id"-Eigenschaft aktualisieren. Normalerweise wird dies über einen Trigger mit einem Gerät (physisches Werkzeug) gemacht. Beim Auslösen des Geräts wird die Geräte-ID in eine Variable geschrieben, die der "device\_id"-Eigenschaft des Widgets zugewiesen ist. Dies veranlasst das Widget, die Geräte-ID-Informationen von der Zerokey-API anzufordern. Wenn die Standortinformationen für das Gerät innerhalb des benutzerdefinierten Bereichs liegen, sendet es das Ereignis "valid\_tool\_location", true, wenn es innerhalb des benutzerdefinierten Bereichs liegt, andernfalls false.