ZeroKey Integration Suite

Połącz się z precyzyjnymi trackerami submilimetrowymi, aby usprawnić efektywność operacji dzięki Tulip i ZeroKey.

Rozpoczęcie pracy z ZeroKey

ZeroKey Inc. to szybko rozwijająca się firma technologiczna, która projektuje, konstruuje i produkuje najdokładniejszy na świecie, wielkoskalowy system lokalizacji 3D w czasie rzeczywistym (RTLS). ZeroKey i Tulip nawiązały współpracę, aby zaoferować zintegrowane rozwiązanie, które łączy technologię Quantum RTLS firmy ZeroKey z platformą Frontline Operations firmy Tulip. Tradycyjne technologie lokalizacyjne nie są w stanie precyzyjnie zdigitalizować procesów zorientowanych na człowieka na dużą skalę, co skutkuje znaczną niewykorzystaną wartością w zakresie wydajności produkcji, bezpieczeństwa pracowników, kontroli jakości i nie tylko. Dzięki integracji ZeroKey i Tulip klienci zyskują pełną widoczność dowolnego procesu, od produkcji zorientowanej na człowieka po śledzenie zamówień w całym zakładzie.

Celem widżetów ZeroKey jest zapewnienie gotowych do użycia widżetów, które mogą służyć jako użyteczny widżet w aplikacji lub być miejscem początkowym dla bardziej dostosowanych widżetów, które wykorzystują ZeroKey. Te niestandardowe wtyczki widżetów to zakodowane widżety, które znajdują się na platformie Tulip i wykorzystują platformę inteligencji przestrzennej Zerokey, ułatwiając rozpoczęcie pracy z Zerokey w Tulip.

Widżet lokalizacji Zerokey

Widżet lokalizacji Zerokey to wizualny moduł śledzenia lokalizacji urządzenia ZeroKey. Widżet ten aktualizuje się w czasie rzeczywistym, wyświetlając lokalizację urządzeń względem obszaru roboczego rysunku. Widżet ten można umieścić na obrazie, takim jak mapa hali produkcyjnej, w aplikacji, aby zapewnić dokładne informacje o lokalizacji w świecie rzeczywistym.

Przewodnik wideo

Konfiguracja

Wtyczki Custom Widget zapewniają potężne narzędzie do dodawania niestandardowych widżetów do aplikacji. Widżety umożliwiają pisanie skryptów JavaScript w celu rozszerzenia i dostosowania funkcjonalności widżetu. Widżety Zerokey wykorzystują Javascript i interfejsy API Zerokey, aby zapewnić szeroki zakres funkcji. Widżety Tulip Zerokey zapewniają również zachowanie "mockowania" systemu, dzięki czemu można natychmiast rozpocząć testowanie widżetów. W przypadku widżetów Zerokey wymagane są następujące elementy:

• Adres URL Zerokey Event Hub.
• Twój token API Zerokey
• Szerokość lokalizacji w metrach
• Wysokość lokalizacji w metrach
• Mapa nazw identyfikatorów urządzeń
• Dane makiety

W odniesieniu do adresu URL Zerokey Event Hub i tokenu API odsyłamy do dokumentacji Zerokey. Informacje Zerokey są dodawane bezpośrednio do kodu aplikacji Szerokość i wysokość lokalizacji odnoszą się do fizycznej szerokości i wysokości przestrzeni, w której został wdrożony system przestrzenny Zerokey. Mapa nazw identyfikatorów urządzeń jest opcjonalna. Umożliwia to podanie czytelnej dla człowieka nazwy do mapowania na identyfikator urządzenia. Na przykład identyfikator urządzenia D8:FC:ED:EA:53:1C można zmapować na "Connector Widget Bin". Możesz dostarczyć obiekt łańcuchowy JSON jako właściwość widżetu do mapowania identyfikatorów. Poniżej znajduje się przykład:{"D8:FC:ED:EA:53:1C": "Connector Widget Bin", "AA:BB:CC:12:34:56": "Operator X Station", }

Ostatnim krokiem jest upewnienie się, że rozmiar płótna widżetu ma taki sam współczynnik proporcji jak przestrzeń fizyczna. Zapewni to, że widżet wyświetli lokalizacje pasujące do przestrzeni fizycznej.

W kodzie Javascript widżetu można ustawić zmienną mock data na true, aby otrzymywać dane mock, lub false, aby otrzymywać tylko prawdziwe dane.

Jak to działa

Po skonfigurowaniu widżetu można go przetestować w edytorze widżetów lub dodać bezpośrednio do aplikacji. W obu przypadkach urządzenia Zerokey muszą być aktywne w obszarze przestrzennym Zerokey. Każde urządzenie, które jest aktywne w obszarze przestrzennym Zerokey, będzie wyświetlane w widżecie jako okrąg z identyfikatorem urządzenia lub zmapowaną nazwą. Zazwyczaj masz obraz, który mapuje Twoją fizyczną przestrzeń, nad którą umieścisz widżet. W takim przypadku lokalizacja urządzenia zostanie dokładnie narysowana na mapie. Należy pamiętać, że obraz mapy musi mieć takie same proporcje jak przestrzeń fizyczna i kanwa widżetu.

Widżet strefy Zerokey

Widżet strefy zapewnia wizualną listę wszystkich stref, które zgłosiły zdarzenie wejścia do strefy, wyjścia ze strefy lub zajętości strefy. Lista wizualna wyświetla ten sam identyfikator lub nazwę oraz identyfikator lub nazwę urządzenia dla wszystkich urządzeń powiązanych ze strefą.

Przewodnik wideo

Konfiguracja

Wtyczki niestandardowych widżetów zapewniają potężne narzędzie do dodawania niestandardowych widżetów do aplikacji. Widżety umożliwiają pisanie skryptów JavaScript w celu rozszerzenia i dostosowania funkcjonalności widżetu. Widżety Zerokey wykorzystują Javascript i interfejsy API Zerokey, aby zapewnić szeroki zakres funkcji. Widżety Tulip Zerokey zapewniają również zachowanie "mockowania" systemu, dzięki czemu można natychmiast rozpocząć testowanie widżetów. W przypadku widżetów Zerokey wymagane są następujące elementy:

• Adres URL Zerokey Event Hub.
• Twój token API Zerokey
• Mapa nazw identyfikatorów stref
• Mapa nazw identyfikatorów urządzeń
• Przesyłanie zdarzeń do aplikacji
• Makiety danych

W odniesieniu do adresu URL Zerokey Event Hub i tokenu API odsyłamy do dokumentacji Zerokey.

Mapy identyfikatorów stref i urządzeń

Mapa nazw identyfikatorów stref jest opcjonalna. Umożliwia to podanie czytelnej dla człowieka nazwy do mapowania na identyfikator strefy. Na przykład Device ID "aae876a0-cb98-4c12-a16c-a56764aea4r" można zmapować na "Vision station". Możesz dostarczyć obiekt ciągu JSON jako właściwość do widżetu, aby zmapować identyfikatory. Poniżej znajduje się przykład:{ "ffe434a0-cb29-4d22-a16c-70f764aedbcb": "Pomieszczenie z częściami", "aae876a0-cb98-4c12-a16c-a56764aea4r": "Vision station", }

Mapa nazw identyfikatorów urządzeń jest opcjonalna. Umożliwia to podanie czytelnej dla człowieka nazwy do mapowania na identyfikator urządzenia. Na przykład identyfikator urządzenia D8:FC:ED:EA:53:1C można zmapować na "Connector Widget Bin". Możesz dostarczyć obiekt ciągu JSON jako właściwość widżetu do mapowania identyfikatorów. Poniżej znajduje się przykład:

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

Ostatnim krokiem jest upewnienie się, że rozmiar płótna widżetu ma taki sam współczynnik proporcji jak przestrzeń fizyczna. Zapewni to, że widżet wyświetli lokalizacje pasujące do przestrzeni fizycznej.

Przesyłanie zdarzeń do aplikacji

Widżet Strefa Zerokey uruchamia zdarzenia dla strefy wprowadzonej, strefy zajętej i strefy pustej. Można utworzyć wyzwalacze, które nasłuchują tych zdarzeń i reagują na nie w aplikacji.

Makiety danych

W kodzie Javascript widżetu można ustawić zmienną mock data na true, aby otrzymywać dane mock, lub false, aby otrzymywać tylko prawdziwe dane.

Jak to działa

Po skonfigurowaniu widżetu można go przetestować w edytorze widżetów lub dodać bezpośrednio do aplikacji. W obu przypadkach musisz mieć aktywne urządzenia Zerokey w obszarze przestrzennym Zerokey i musisz mieć skonfigurowane strefy. Widżet uruchomi informacje o strefie listy dla zdarzeń strefy i uruchomi zdarzenia strefy, aby aplikacja mogła zareagować. Należy pamiętać, że listę stref można ukryć w aplikacji, zakrywając ją kształtem lub komentując następujący kod w kodzie HTML widżetu: ```

## Widżet żądanie-odpowiedź Zerokey


Widżet Zerokey Request-Reponse stanowi przykład użycia innych elementów interfejsu API Zerokey niebędących listą zdarzeń. Widżet automatycznie pobiera token Bearer i odświeża go w razie potrzeby. Widżet zapewnia interfejs pulpitu nawigacyjnego, który pozwala użytkownikowi zażądać informacji o urządzeniach widzianych dzisiaj, strefach i określonych szczegółach urządzenia. Chociaż widżet ten można natychmiast wykorzystać w aplikacji Tulip, jest on używany głównie do przykładów i tworzenia na jego podstawie innych niestandardowych widżetów.


### Przewodnik wideo



### Konfiguracja


Wtyczki niestandardowych widżetów zapewniają potężne narzędzie do dodawania niestandardowych widżetów do aplikacji. Widżety umożliwiają pisanie skryptów JavaScript w celu rozszerzenia i dostosowania funkcjonalności widżetu. Widżety Zerokey wykorzystują Javascript i interfejsy API Zerokey, aby zapewnić szeroki zakres funkcji. Widżety Tulip Zerokey zapewniają również zachowanie "mockowania" systemu, dzięki czemu można natychmiast rozpocząć testowanie widżetów. Następujące elementy są wymagane dla widżetów Zerokey:


* Adres URL API Zerokey
* Nazwa użytkownika i hasło Zerokey do uwierzytelniania API
* Dane makiety


*W odniesieniu do adresu URL Zerokey Event Hub i tokena API odsyłamy do [dokumentacji Zerokey](https://api.zerokey.com/).*


### Dane pozorne


W kodzie Javascript widżetu można ustawić zmienną mock data na true, aby otrzymywać dane mock, lub false, aby otrzymywać tylko prawdziwe dane. 


### Jak to działa


Po skonfigurowaniu widżetu można go przetestować w edytorze widżetów lub dodać bezpośrednio do aplikacji. W obu przypadkach, jeśli nie makietujesz danych, musisz mieć aktywne urządzenia Zerokey w swoim obszarze przestrzennym Zerokey i musisz mieć skonfigurowane strefy. Pulpit nawigacyjny interfejsu użytkownika widżetu udostępnia przyciski umożliwiające żądanie urządzeń widzianych dzisiaj, stanu strefy i określonych informacji o urządzeniu. Jeśli istnieją wyniki, zostaną one wyświetlone poniżej przycisków. 


## Widżet Zerokey Tool Tracker


Widżet Zerokey Tool Tracker (Zerokey device tracker) sprawdza, czy określone urządzenie znajduje się w lokalizacji zdefiniowanej przez użytkownika. Jest to podobne do sprawdzania, czy urządzenie znajduje się w strefie zdefiniowanej przez użytkownika. Użytkownik może zdefiniować strefę za pomocą właściwości widżetu. Można to wykorzystać do śledzenia ostatniego użycia sterownika momentu obrotowego z podłączonym do niego urządzeniem Zerokey. W takim przypadku można sprawdzić, czy dokręcona została "właściwa" śruba. Gdy sterownik momentu obrotowego zgłasza "gotowe" do aplikacji Tulip, używamy tego sygnału do sprawdzenia lokalizacji urządzenia, aby upewnić się, że "właściwa" śruba została właśnie dokręcona.


### Przewodnik wideo



### Konfiguracja


Wtyczki niestandardowych widżetów zapewniają potężne narzędzie do dodawania niestandardowych widżetów do aplikacji. Widżety umożliwiają pisanie skryptów JavaScript w celu rozszerzenia i dostosowania funkcjonalności widżetu. Widżety Zerokey wykorzystują Javascript i interfejsy API Zerokey, aby zapewnić szeroki zakres funkcji. Widżety Tulip Zerokey zapewniają również zachowanie "mockowania" systemu, dzięki czemu można natychmiast rozpocząć testowanie widżetów. Następujące elementy są wymagane dla widżetów Zerokey:


* Adres URL API Zerokey
* Nazwa użytkownika i hasło Zerokey do uwierzytelniania API
* Środek x strefy zdefiniowanej przez użytkownika
* Środek y strefy zdefiniowanej przez użytkownika
* Szerokość strefy zdefiniowanej przez użytkownika
* Wysokość strefy zdefiniowanej przez użytkownika
* Przesyłanie zdarzeń do aplikacji
* Makiety danych


*W odniesieniu do adresu URL Zerokey Event Hub i tokenu API odsyłamy do [dokumentacji Zerokey](https://api.zerokey.com/).*


### Strefa zdefiniowana przez użytkownika


Widżet Zerokey Tool Tracker umożliwia utworzenie dwuwymiarowej strefy za pomocą właściwości widżetu. Będziesz musiał znać środkową lokalizację x,y oraz szerokość i wysokość strefy w metrach. Środkową lokalizację x,y można uzyskać za pomocą urządzenia Zerokey i umieszczając je w żądanej lokalizacji środkowej. Po skonfigurowaniu strefy zdefiniowanej przez użytkownika można sprawdzić, czy urządzenie Zerokey znajduje się w obszarze strefy. 


### Przesyłanie zdarzeń do aplikacji


Do użytku w aplikacji Tulip będziesz chciał mieć urządzenie sprzętowe lub maszynę wyzwalającą zdarzenie. Zdarzenie to powinno zapisywać ciąg **ID urządzenia** do zmiennej. Ta zmienna powinna być wejściem do widżetu Zerokey Tool Tracker prop "device\_id".


### Mock Data


W kodzie Javascript widżetu można ustawić zmienną mock data na true, aby otrzymywać dane mock, lub false, aby otrzymywać tylko prawdziwe dane.


### Jak to działa


Po skonfigurowaniu widżetu można go przetestować w edytorze widżetów lub dodać bezpośrednio do aplikacji. Po skonfigurowaniu widżetu w aplikacji będziesz mógł uruchomić widżet, aktualizując jego właściwość "device\_id". Zazwyczaj odbywa się to za pomocą wyzwalacza z urządzeniem (narzędziem fizycznym). Wyzwalacz urządzenia zapisze identyfikator urządzenia do zmiennej przypisanej do właściwości "device\_id" widżetu. Spowoduje to, że widżet zażąda informacji o identyfikatorze urządzenia z interfejsu API Zerokey. Jeśli informacje o lokalizacji urządzenia znajdują się w obszarze strefy zdefiniowanej przez użytkownika, wyśle zdarzenie "valid\_tool\_location", prawdziwe, jeśli znajduje się w obszarze zdefiniowanym przez użytkownika i fałszywe w przeciwnym razie.