Connecter un périphérique webhook – Azumuta

Remarque : Cet article est technique, nous vous recommandons donc de faire intervenir quelqu'un ayant les compétences techniques appropriées. Si vous avez des questions, contactez-nous à support@azumuta.com.

Un périphérique webhook permet à un système externe de remplir la réponse d'une vérification de produit. Lorsque l'opérateur atteint l'étape, Azumuta appelle votre webhook, lit la valeur de la réponse et l'utilise comme réponse. Par exemple, un service de mesure peut retourner la valeur mesurée d'une pièce, de sorte que l'opérateur n'a pas besoin de la saisir.

Les serveurs d'Azumuta appellent le webhook, vous n'avez donc besoin ni du Hub ni d'aucun logiciel sur la station de travail.

Ce dont vous avez besoin

Un point de terminaison webhook que les serveurs d'Azumuta peuvent atteindre. Il doit être accessible depuis Internet, pas seulement depuis l'ordinateur de l'opérateur. Pour remplir une réponse, il doit retourner du JSON.
Les droits de gérer les périphériques et les appareils sous Gestion, et de modifier les instructions de travail.
Une vérification prise en charge. Un périphérique webhook fonctionne avec les vérifications OK/NOK, Nombre, Ligne unique et Paragraphe. La vérification Procédure peut également en utiliser une, ou sa propre action webhook. Voir Vérification Procédure.

Créer le périphérique

Cliquez sur Périphériques sous Gestion.
Cliquez sur le bouton plus jaune.
Tapez un Nom et sélectionnez ou créez le Groupe périphérique.
Sous Comment se connecter ?, sélectionnez Webhook
Remplissez les champs du webhook.
Quand vous avez terminé, cliquez sur Ajouter.

Champs du webhook

URL du webhook : l'adresse http ou https complète de votre point de terminaison.
Méthode : POST, GET, PUT ou PATCH.
Authentification : comment Azumuta s'identifie auprès de votre point de terminaison : Aucune, En-tête, De base ou Identifiants client OAuth. Ceux-ci fonctionnent de la même manière pour les déclencheurs webhook. Voir Authentification.
Format de la charge utile et Charge utile du webhook : Avec le Format Azumuta, votre charge utile est envoyée dans le corps JSON d'Azumuta, à côté des champs d'événement. Avec JSON, XML, CSV ou Texte, seule votre charge utile est envoyée, avec le type de contenu correspondant. Vous pouvez utiliser des paramètres dans la charge utile.
Quand exécuter le webhook :
- Automatique lors de la première visite : la première fois que l'opérateur ouvre l'étape.
- Automatique à chaque visite : chaque fois que l'opérateur ouvre l'étape.
- Manuel : l'opérateur appuie sur un bouton.
Format de réponse : JSON.
Paramètre de résultat du webhook : où Azumuta trouve la réponse dans la réponse JSON, par exemple data.result.value pour une réponse comme { "data": { "result": { "value": 17.3 } } }. Laissez-le vide pour utiliser la réponse entière.
Paramètre de remarque Webhook : où Azumuta trouve un message de remarque dans la réponse JSON.

Azumuta ajoute le numéro de commande du produit et les identifiants d'instruction de travail et d'enregistrement (le cas échéant) à l'appel : en tant que paramètres d'URL pour GET, et dans le corps JSON pour le Format Azumuta.

Ajouter le périphérique à un appareil

Une vérification trouve son périphérique via l'appareil et le groupe périphérique. Ajoutez le périphérique à chaque appareil où les opérateurs exécutent l'instruction de travail :

Cliquez sur Appareils sous Gestion.
Cliquez sur l'icône ⋮ (trois points) à côté de l'appareil, puis cliquez sur Modifier le périphérique.
Cliquez sur l'onglet Périphériques.
Sous Périphériques pour les vérifications d'instructions, sélectionnez le périphérique webhook.
Cliquez sur Enregistrer.

Utiliser le périphérique sur une vérification

Ouvrez l'étape d'instruction et cliquez sur l'onglet Vérification.
Sélectionnez une vérification prise en charge.
Sous Options périphériques, sélectionnez le Groupe périphérique de votre périphérique webhook. Vous pouvez également appliquer un préréglage périphérique.
Ajustez les options si nécessaire :
- Charge utile : remplace la charge utile définie sur le périphérique pour cette vérification. Laissez-le vide pour utiliser celui du périphérique. Écrivez-le au format de charge utile du périphérique.
- Soumettre automatiquement la réponse après : soumet la réponse 0 à 10 secondes après sa saisie. Non disponible pour la vérification OK/NOK.
- Autoriser la saisie manuelle de la réponse : permet à l'opérateur de saisir ou de modifier la réponse. C'est activé par défaut.

Exemple

Un service de qualité retourne la valeur mesurée d'une pièce. Votre point de terminaison est https://qc.example.com/api/measurement et répond avec :

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

Pour l'utiliser sur une vérification Nombre :

Créez un groupe périphérique pour la vérification Nombre, par exemple « Mesure externe ».
Créez un périphérique webhook dans ce groupe, avec la Méthode POST, le Paramètre de résultat du webhook data.value, le Paramètre de remarque Webhook data.remark, et Quand exécuter le webhook défini sur Automatique lors de la première visite.
Ajoutez le périphérique à l'appareil que les opérateurs utilisent.
Ajoutez une vérification Nombre à l'étape d'instruction, et sélectionnez le groupe sous Options périphériques.

Quand l'opérateur ouvre l'étape, Azumuta appelle le point de terminaison et remplit 17.3 comme réponse.

Si votre point de terminaison n'est pas disponible

Pour permettre aux opérateurs de continuer pendant que votre point de terminaison est hors ligne, cochez Désactiver temporairement le périphérique sur le périphérique. Les opérateurs peuvent alors saisir les réponses manuellement. Voir Utiliser un périphérique.

Choisir le bon webhook

Pour remplir la réponse d'une vérification à partir d'un système externe, utilisez un périphérique webhook, comme décrit ici.
Pour valider une étape, utilisez l'action webhook d'une vérification Procédure.
Pour notifier un autre système quand quelque chose se produit, utilisez un déclencheur webhook.

Turn manufacturing into a limitless engine of progress