Suite di integrazione ZeroKey

Collegatevi a tracker di precisione sub-millimetrica per ottimizzare l'efficacia delle operazioni con Tulip e ZeroKey.

Come iniziare con ZeroKey

ZeroKey Inc. è un'azienda tecnologica in rapida ascesa che progetta, ingegnerizza e produce il sistema di localizzazione in tempo reale (RTLS) 3D più preciso e su larga scala del mondo. ZeroKey e Tulip hanno collaborato per offrire una soluzione integrata che combina la tecnologia Quantum RTLS di ZeroKey con la piattaforma Frontline Operations di Tulip. Le tecnologie di localizzazione tradizionali non sono in grado di digitalizzare con precisione i processi incentrati sull'uomo su larga scala, il che comporta un significativo valore non sfruttato in termini di efficienza produttiva, sicurezza dei lavoratori, controllo della qualità e altro ancora. Con l'integrazione di ZeroKey e Tulip, i clienti ottengono una visibilità completa di qualsiasi processo, dalla produzione incentrata sull'uomo alla tracciabilità degli ordini a livello di stabilimento.

Lo scopo dei widget ZeroKey è quello di fornire widget pronti all'uso che possono servire come widget utilizzabile in un'applicazione o essere il punto di partenza per widget più personalizzati che sfruttano Zerokey. Questi widget personalizzati sono widget codificati che si appoggiano alla piattaforma Tulip e sfruttano la piattaforma di intelligenza spaziale di Zerokey, rendendo più semplice l'utilizzo di Zerokey in Tulip.

Widget Posizione di Zerokey

Il widget Zerokey Location è un tracker visivo della posizione del dispositivo ZeroKey. Questo widget si aggiorna in tempo reale per visualizzare la posizione dei dispositivi rispetto all'area di disegno. Questo widget può essere sovrapposto a un'immagine, come la mappa di un'officina, in un'app per fornire informazioni precise sulla posizione nel mondo reale.

Video guida

Configurazione

I plugin per i widget personalizzati forniscono un potente strumento per aggiungere widget personalizzati alle applicazioni. I widget consentono di scrivere Javascript per estendere e personalizzare le funzionalità di un widget. I widget di Zerokey sfruttano Javascript e le API di Zerokey per fornire un'ampia gamma di funzionalità. I widget Zerokey di Tulip forniscono anche un comportamento di "mocking" del sistema, in modo da poter iniziare a testare i widget immediatamente. Per i widget Zerokey sono necessari i seguenti elementi:

• L'URL di Zerokey Event Hub.
• Il token API di Zerokey
• Larghezza della posizione in metri
• Altezza della posizione in metri
• Mappa del nome dell'ID del dispositivo
• Dati mock

Per quanto riguarda l'URL e il token API di Zerokey Event Hub, si rimanda alla documentazione di Zerokey. Le informazioni di Zerokey vengono aggiunte direttamente al codice del sistema territoriale di Zerokey. La mappa del nome dell'ID dispositivo è facoltativa. Consente di fornire un nome leggibile dall'uomo da associare all'ID del dispositivo. Ad esempio, l'ID dispositivo D8:FC:ED:EA:53:1C può essere associato a "Connector Widget Bin". È possibile fornire un oggetto stringa JSON come prop al widget per mappare gli ID. Un esempio è il seguente:{"D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Stazione operatore X", }

Un ultimo passo consiste nell'assicurarsi che le dimensioni della tela del widget siano impostate in modo da avere lo stesso rapporto di aspetto dello spazio fisico. Questo farà sì che il widget visualizzi le posizioni in modo che corrispondano allo spazio fisico.

Nel codice Javascript del widget è possibile impostare la variabile mock data su true per ricevere dati finti o false per ricevere solo dati reali.

Come funziona

Una volta impostato il widget, è possibile testarlo nell'editor di widget o aggiungerlo direttamente a un'applicazione. In entrambi i casi è necessario che i dispositivi Zerokey siano attivi nell'area spaziale di Zerokey. Qualsiasi dispositivo attivo nell'area spaziale di Zerokey verrà visualizzato nel widget come un cerchio con l'ID del dispositivo o il nome mappato incluso. In genere, si dispone di un'immagine che mappa lo spazio fisico su cui si posiziona il widget. In questo caso, la posizione del dispositivo sarà disegnata con precisione sulla mappa. L'immagine della mappa deve avere lo stesso rapporto di aspetto dello spazio fisico e della tela del widget.

Widget Zona di Zerokey

Il widget Zona fornisce un elenco visivo di tutte le zone che hanno segnalato un evento di entrata, uscita o occupazione di una zona. L'elenco visivo visualizza lo stesso ID o nome e l'ID o il nome del dispositivo per qualsiasi dispositivo associato alla zona.

Guida video

Configurazione

I plugin per i widget personalizzati forniscono un potente strumento per aggiungere widget personalizzati all'applicazione. I widget consentono di scrivere Javascript per estendere e personalizzare le funzionalità di un widget. I widget di Zerokey sfruttano Javascript e le API di Zerokey per fornire un'ampia gamma di funzionalità. I widget Zerokey di Tulip forniscono anche un comportamento di "mocking" del sistema, in modo da poter iniziare a testare i widget immediatamente. Per i widget Zerokey sono necessari i seguenti elementi:

• L'URL di Zerokey Event Hub.
• Il token API di Zerokey
• Mappa dei nomi degli ID di zona
• Mappa dei nomi degli ID dei dispositivi
• Collegare gli eventi a un'app
• Dati mock

Per quanto riguarda l'URL di Zerokey Event Hub e il token API, vi rimandiamo alla documentazione di Zerokey.

Mappe ID zona e ID dispositivo

La mappa del nome dell'ID zona è opzionale. Consente di fornire un nome leggibile dall'uomo da mappare a un ID di zona. Ad esempio, l'ID dispositivo "aae876a0-cb98-4c12-a16c-a56764aea4r" può essere mappato a "Vision station". È possibile fornire un oggetto stringa JSON come prop al widget per mappare gli ID. Un esempio è il seguente:{"ffe434a0-cb29-4d22-a16c-70f764aedbcb": "Sala parti", "aae876a0-cb98-4c12-a16c-a56764aea4r": "Stazione di visione", }

La mappa del nome dell'ID dispositivo è facoltativa. Consente di fornire un nome leggibile dall'uomo da associare a un ID dispositivo. Ad esempio, l'ID dispositivo D8:FC:ED:EA:53:1C può essere mappato a "Connector Widget Bin". È possibile fornire un oggetto stringa JSON come prop al widget per mappare gli ID. Un esempio è il seguente:

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

Un ultimo passo consiste nell'assicurarsi che le dimensioni della tela del widget siano impostate in modo da avere lo stesso rapporto di aspetto dello spazio fisico. Questo farà sì che il widget visualizzi le posizioni in modo che corrispondano allo spazio fisico.

Collegare gli eventi a un'applicazione

Il widget Zerokey Zone genera eventi per le zone inserite, occupate e vuote. È possibile creare trigger che ascoltano questi eventi e rispondono nella propria applicazione.

Dati di simulazione

Nel codice Javascript del widget è possibile impostare la variabile mock data su true per ricevere dati finti o su false per ricevere solo dati reali.

Come funziona

Una volta impostato il widget, è possibile testarlo nell'editor di widget o aggiungerlo direttamente a un'applicazione. In entrambi i casi è necessario che i dispositivi Zerokey siano attivi nell'area spaziale di Zerokey e che le zone siano configurate. Il widget invierà le informazioni sull'elenco delle zone per gli eventi di zona e invierà gli eventi di zona per la risposta dell'applicazione. Si noti che è possibile nascondere l'elenco delle zone nella propria applicazione coprendolo con una forma o commentando il seguente codice nell'HTML del widget: ```

## Widget Richiesta-Risposta di Zerokey


Il widget Richiesta-Risposta di Zerokey fornisce un esempio di utilizzo di altri elementi dell'API di Zerokey diversi dagli eventlistener. Il widget ottiene automaticamente un token Bearer e lo aggiorna se necessario. Il widget fornisce un'interfaccia grafica che consente all'utente di richiedere informazioni sui dispositivi visti oggi, sulle zone e su dettagli specifici dei dispositivi. Sebbene questo widget sia immediatamente utilizzabile in un'applicazione Tulip, è usato principalmente come esempio e per costruire altri widget personalizzati a partire da esso.


### Video guida



### Configurazione


I plugin per i widget personalizzati forniscono un potente strumento per aggiungere widget personalizzati alla vostra applicazione. I widget consentono di scrivere Javascript per estendere e personalizzare le funzionalità di un widget. I widget di Zerokey sfruttano Javascript e le API di Zerokey per fornire un'ampia gamma di funzionalità. I widget Zerokey di Tulip forniscono anche un comportamento di "mocking" del sistema, in modo da poter iniziare a testare i widget immediatamente. Per i widget Zerokey sono necessari i seguenti elementi:


* L'URL API di Zerokey
* Nome utente e password di Zerokey per l'autenticazione API
* Dati mock


*Per quanto riguarda l'URL dell'Event Hub di Zerokey e il token API si rimanda alla [documentazione di Zerokey](https://api.zerokey.com/).*


### Dati finti


Nel codice Javascript del widget è possibile impostare la variabile mock data su true per ricevere dati finti, o false per ricevere solo dati reali. 


### Come funziona


Una volta impostato il widget, è possibile testarlo nell'editor di widget o aggiungerlo direttamente a un'applicazione. In entrambi i casi, se non si tratta di dati mock, è necessario che i dispositivi Zerokey siano attivi nella propria area territoriale Zerokey e che siano state configurate delle zone. La dashboard dell'interfaccia utente del widget fornisce pulsanti che consentono di richiedere i dispositivi visti oggi, lo stato della zona e informazioni specifiche sul dispositivo. Se ci sono risultati, questi vengono elencati sotto i pulsanti. 


## Widget Inseguitore di strumenti Zerokey


Il widget Zerokey Tool Tracker (inseguitore di dispositivi Zerokey) controlla se un dispositivo specifico si trova in una posizione definita dall'utente. Questo è simile al controllo della presenza di un dispositivo in una zona definita dall'utente. L'utente può definire la zona tramite i props del widget. Questo potrebbe essere usato per tracciare l'uso più recente di un driver di coppia con un dispositivo Zerokey collegato. In questo caso si potrebbe verificare che sia stata avvitata la vite "giusta". Quando il torsiometro segnala "fatto" a un'applicazione Tulip, utilizziamo questo segnale per controllare la posizione del dispositivo e assicurarci che la vite "giusta" sia stata appena avvitata.


### Video guida



### Configurazione


I plugin di widget personalizzati forniscono un potente strumento per aggiungere widget personalizzati alla vostra applicazione. I widget consentono di scrivere Javascript per estendere e personalizzare le funzionalità di un widget. I widget di Zerokey sfruttano Javascript e le API di Zerokey per fornire un'ampia gamma di funzionalità. I widget Zerokey di Tulip forniscono anche un comportamento di "mocking" del sistema, in modo da poter iniziare a testare i widget immediatamente. Per i widget Zerokey sono necessari i seguenti elementi:


* L'URL API di Zerokey
* Nome utente e password di Zerokey per l'autenticazione API
* Centro x della zona definita dall'utente
* Centro y della zona definita dall'utente
* Larghezza della zona definita dall'utente
* Altezza della zona definita dall'utente
* Collegare gli eventi a un'applicazione
* Dati di simulazione


*Per quanto riguarda l'URL e il token API di Zerokey Event Hub, si rimanda alla [documentazione di Zerokey](https://api.zerokey.com/).*


### Zona definita dall'utente


Il widget Zerokey Tool Tracker consente di creare una zona bidimensionale tramite gli oggetti di scena del widget. È necessario conoscere la posizione centrale x,y e la larghezza e l'altezza della zona in metri. È possibile ottenere la posizione centrale x,y utilizzando un dispositivo Zerokey e posizionandolo nella posizione centrale desiderata. Una volta configurata la zona definita dall'utente, è possibile verificare se un dispositivo Zerokey si trova all'interno dell'area della zona. 


### Collegare gli eventi a un'applicazione


Per l'utilizzo in un'applicazione Tulip si desidera che un dispositivo hardware o una macchina attivi un evento. Su tale evento deve scrivere la stringa dell'**ID del dispositivo** in una variabile. Questa variabile deve essere l'input del widget "device\_id" di Zerokey Tool Tracker.


### Dati di simulazione


Nel codice Javascript del widget è possibile impostare la variabile mock data su true per ricevere dati finti o false per ricevere solo dati reali.


### Come funziona


Una volta configurato il widget, è possibile testarlo nell'editor di widget o aggiungerlo direttamente a un'applicazione. Dopo aver configurato il widget in un'applicazione, si potrà attivare il widget aggiornando il suo prop "device\_id". In genere questo avviene tramite un trigger con un dispositivo (strumento fisico). L'attivazione del dispositivo scriverà l'ID del dispositivo in una variabile assegnata al prop "device\_id" del widget. In questo modo il widget richiederà le informazioni sull'ID del dispositivo all'API di Zerokey. Se le informazioni sulla posizione del dispositivo rientrano nell'area definita dall'utente, viene inviato l'evento "valid\_tool\_location", vero se rientra nell'area definita dall'utente e falso altrimenti.