Intégration de saisie simple
Remarque : Cet article est très technique. Nous vous recommandons donc d’associer votre service informatique lors de sa lecture. Si vous avez des questions ou des demandes, contactez-nous via support@azumuta.com — nous nous ferons un plaisir de vous aider.
Qu'est-ce que Simple Entry Integration ?
Un cas d’usage courant de Simple Entry Integration est la navigation automatique vers des ordres de production. Un opérateur peut scanner le code-barres d’un ordre de production, et son écran sera automatiquement redirigé vers cet ordre, afin qu’il puisse immédiatement commencer à travailler dessus depuis son appareil.
Pour activer cela, nous avons créé une Simple Entry Integration générique, disponible dans la section “Integrations” des paramètres de votre entreprise. Voici comment y accéder.
- Cliquez sur “Settings” sous “Management”.
- Cliquez sur “Integrations” sous “Integrations”.
L’URL préremplie /api/integrations/generic/v1/getOrderByBarcode est une implémentation générique du processus de simple entry. Cette configuration permet un flux simple où le scan et la saisie d’un identifiant d’ordre de production ouvrira un ordre de production existant.
Remarque : cela ne fonctionne que si l’ordre de production existe déjà et que le code scanné correspond exactement à l’identifiant du produit dans Azumuta.
Si vous avez besoin d’une fonctionnalité plus avancée, par exemple créer automatiquement un ordre de production qui n’existe pas encore, veuillez vous référer à cette section.
Après avoir configuré une Simple Entry Integration dans les paramètres de votre entreprise, mettez à jour les paramètres de l’appareil sur lequel vous souhaitez l’utiliser. Rendez-vous dans l'onglet Ordres de production et vérifiez attentivement les paramètres mis en évidence ci‑dessous :
Comment créer une Simple Entry Integration personnalisée
Si vous souhaitez étendre ce processus avec votre propre logique métier, vous pouvez créer une intégration personnalisée.
Lorsqu’un appareil est configuré pour utiliser le simple entry, il enverra une requête à l’URL spécifiée dans le champ “simpleEntryEndpoint”. Ce champ de configuration peut être laissé vide.
Après le scan d’un code-barres sur l’appareil configuré, notre service enverra une requête GET vers l’URL fournie dans le champ simpleEntryEndpoint.
La requête inclura un paramètre de requête nommé barcode, qui représente le code scanné ou la saisie réalisée sur l’appareil.
Remarque : le barcode sera encodé dans l’URL
De plus, les en‑têtes de la requête contiendront un x-api-key que vous pouvez utiliser pour vous authentifier auprès de l’API REST Azumuta.
Exemple de requête
Requête :
url:
headers: { x-api-key:
Après traitement de votre logique personnalisée, l’intégration doit répondre par un objet JSON contenant le champ identifier. Le content-type de la requête doit être application/json.
Exemple de réponse
{ identifier: “
Comment créer automatiquement un ordre de production
Une demande fréquente de nos clients est la possibilité de créer automatiquement un ordre de production pour le code scanné (si l’ordre de production n’existe pas encore).
Cela peut facilement être réalisé en appelant l’API REST Products Create. Ouvrez Help (le point d’interrogation en haut à droite) → API docs, puis ouvrez l’endpoint Products Create. Authentifiez‑vous avec une clé API depuis un Api Device. Pour plus d’informations : Azumuta’s REST API.
Vous pouvez effectuer une requête POST vers l’endpoint de création de produit en utilisant les paramètres suivants :
returnExisting: true — Cela n’écrasera pas un produit existant ; la requête retournera le produit existant si l’ordre de production existe déjà.
activate: true — Active automatiquement l’ordre de production lors de sa création. L’activation rend l’ordre visible dans l’interface opérateur. Cette action garantit que les instructions de travail associées sont verrouillées sur leurs dernières versions approuvées.