Overslaan en naar hoofdcontent gaan

Een webhook randapparaat verbinden

Opmerking: Dit artikel is technisch van aard, dus we raden aan iemand met de juiste technische expertise in te schakelen. Als u vragen heeft, kunt u ons te contacteren op support@azumuta.com.

Een webhook randapparaat stelt een extern systeem in staat het antwoord van een productcheck in te vullen. Wanneer de operator de stap bereikt, roept Azumuta uw webhook aan, leest de waarde uit het antwoord en gebruikt deze als het antwoord. Een meetservice kan bijvoorbeeld de gemeten waarde van een onderdeel retourneren, zodat de operator deze niet hoeft in te typen.

De servers van Azumuta roepen de webhook aan, dus u hebt de Hub of andere software op het werkstation niet nodig.

Wat u nodig hebt

  • Een webhook-eindpunt dat de servers van Azumuta kunnen bereiken. Het moet bereikbaar zijn via het internet, niet alleen van de computer van de operator. Om een antwoord in te vullen, moet het JSON retourneren.
  • De rechten om randapparatuur en devices onder Management te beheren en werkinstructies te bewerken.
  • Een ondersteunde check. Een webhook randapparaat werkt met de OK/NOK-, Getal-, Enkele lijn- en Meerdere lijnen-checks. De Procedure-check kan er ook een gebruiken, of zijn eigen webhook-actie. Zie Procedure-check.

Het randapparaat maken

  1. Klik op Randapparaten onder Management.
  2. Klik op de gele plus-knop.
  3. Typ een Naam en selecteer of maak de Randapparaatgroep aan.
  4. Selecteer onder Hoe te verbinden? de optie Webhook
  5. Vul de webhook-velden in.
  6. Klik wanneer u klaar bent op Toevoegen.

Webhook-velden

  • Webhook URL: het volledige http- of https-adres van uw eindpunt.
  • Methode: POST, GET, PUT of PATCH.
  • Authenticatie: hoe Azumuta zich aan uw eindpunt identificeert: Geen, Header, Basis of OAuth-clientgegevens. Deze werken op dezelfde manier voor webhook-triggers. Zie Authenticatie.
  • Payload-formaat en Webhook payload: Met Azumuta-formaat wordt uw payload verzonden in de JSON-body van Azumuta, naast de gebeurtenisvelden. Met JSON, XML, CSV of Tekst wordt alleen uw payload verzonden, met het overeenkomstige inhoudstype. U kunt parameters in de payload gebruiken.
  • Wanneer de webhook moet worden uitgevoerd:
    • Automatisch bij eerste bezoek: de eerste keer dat de operator de stap opent.
    • Automatisch bij elk bezoek: elke keer dat de operator de stap opent.
    • Handmatig: de operator drukt op een knop.
  • Antwoordformaat: JSON.
  • Webhook-resultaatparameter: waar Azumuta het antwoord in het JSON-antwoord vindt, bijvoorbeeld data.result.value voor een antwoord zoals { "data": { "result": { "value": 17.3 } } }. Laat het leeg om het hele antwoord te gebruiken.
  • Webhook-opmerkingsparameter: waar Azumuta een opmerking in het JSON-antwoord vindt.

Azumuta voegt het productordernummer en de werkinstructie- en recording-ID's (indien van toepassing) toe aan de aanroep: als URL-parameters voor GET en in de JSON-body voor het Azumuta-formaat.

Het randapparaat aan een device toevoegen

Een check vindt zijn randapparaat via het device en de randapparaatgroep. Voeg het randapparaat toe aan elk device waar operators de werkinstructie uitvoeren:

  1. Klik op Devices onder Management.
  2. Klik op het ⋮ (drie-puntjes)-pictogram naast het device en klik op Device bewerken.
  3. Klik op het tabblad Randapparaten.
  4. Selecteer onder Randapparatuur voor instructie-checks het webhook randapparaat.
  5. Klik op Opslaan.

Het randapparaat op een check gebruiken

  1. Open de instructiestap en klik op het tabblad Check.
  2. Selecteer een ondersteunde check.
  3. Selecteer onder Randapparatuur-opties de Randapparaatgroep van uw webhook randapparaat. U kunt ook een randapparaat-preset toepassen.
  4. Pas de opties indien nodig aan:
    • Payload: vervangt de payload die op het randapparaat is ingesteld voor deze check. Laat het leeg om die van het randapparaat te gebruiken. Schrijf het in het payload-formaat van het randapparaat.
    • Automatisch antwoord versturen na: verzendt het antwoord 0 tot 10 seconden nadat het is ingevuld. Niet beschikbaar voor de OK/NOK-check.
    • Toestaan dat antwoord manueel wordt ingevoerd: stelt de operator in staat het antwoord in te typen of te wijzigen. Dit is standaard ingeschakeld.

Voorbeeld

Een kwaliteitsservice retourneert de gemeten waarde van een onderdeel. Uw eindpunt is https://qc.example.com/api/measurement en antwoordt met:

{
  "data": {
    "value": 17.3,
    "remark": "Within tolerance"
  }
}

Om het op een Getal-check te gebruiken:

  1. Maak een randapparaatgroep voor de Getal-check, bijvoorbeeld "Externe meting".
  2. Maak een webhook randapparaat in die groep, met Methode POST, Webhook-resultaatparameter data.value, Webhook-opmerkingsparameter data.remark en Wanneer de webhook moet worden uitgevoerd ingesteld op Automatisch bij eerste bezoek.
  3. Voeg het randapparaat toe aan het device dat operators gebruiken.
  4. Voeg een Getal-check toe aan de instructiestap en selecteer de groep onder Randapparatuur-opties.

Wanneer de operator de stap opent, roept Azumuta het eindpunt aan en vult 17.3 in als het antwoord.

Als uw eindpunt niet beschikbaar is

Om operators in staat te stellen door te gaan terwijl uw eindpunt niet beschikbaar is, vink Randapparaat tijdelijk uitschakelen op het randapparaat aan. Operators kunnen de antwoorden dan handmatig invoeren. Zie Een randapparaat gebruiken.

Kies de juiste webhook

  • Om het antwoord van een check van een extern systeem in te vullen, gebruikt u een webhook randapparaat, zoals hier beschreven.
  • Om een stap te valideren, gebruikt u de webhook-actie van een Procedure-check.
  • Om een ander systeem op de hoogte te stellen wanneer iets gebeurt, gebruikt u een webhook-trigger.

Turn manufacturing into a limitless engine of progress