Integration für einfache Eingaben
Hinweis: Dies ist ein hoch technischer Artikel. Wir empfehlen daher, beim Lesen Ihre IT‑Abteilung einzubeziehen. Sollten Sie Fragen oder Wünsche haben, kontaktieren Sie uns bitte über support@azumuta.com - wir helfen Ihnen gerne weiter.
Was ist Simple Entry Integration?
Ein häufiger Anwendungsfall der Simple Entry Integration ist die automatische Navigation zu Produktionsaufträgen. Ein Bediener kann den Barcode eines Produktionsauftrags scannen, und der Bildschirm wird automatisch zu diesem Produktionsauftrag weitergeleitet, sodass sofort auf dem Gerät mit der Arbeit an diesem Auftrag begonnen werden kann.
Um dies zu ermöglichen, haben wir eine generische Simple Entry Integration erstellt, die im Bereich „Integrationen“ Ihrer Unternehmenseinstellungen verfügbar ist. So gelangen Sie dorthin.
- Klicken Sie auf „Einstellungen“ unter „Verwaltung“.
- Klicken Sie auf „Integrationen“ unter „Integrationen“.
Die vorausgefüllte URL /api/integrations/generic/v1/getOrderByBarcode ist eine generische Implementierung des Simple Entry‑Prozesses. Diese Konfiguration ermöglicht einen einfachen Ablauf, bei dem das Scannen und Eingeben einer Auftragskennung einen bestehenden Produktionsauftrag öffnet.
Hinweis: Dies funktioniert nur, wenn der Produktionsauftrag bereits existiert und der gescannte Code genau mit der Produktkennung in Azumuta übereinstimmt.
Wenn Sie erweiterte Funktionen benötigen, wie z. B. das automatische Erstellen eines noch nicht vorhandenen Produktionsauftrags, lesen Sie bitte diesen Abschnitt.
Nachdem Sie eine Simple Entry Integration in Ihren Unternehmenseinstellungen eingerichtet haben, aktualisieren Sie die Geräteeinstellungen, auf denen Sie sie verwenden möchten. Navigieren Sie zur Registerkarte Produktionsaufträge und prüfen Sie sorgfältig die unten hervorgehobenen Einstellungen:
So erstellen Sie eine benutzerdefinierte Simple Entry Integration
Wenn Sie diesen Prozess mit eigener Geschäftslogik erweitern möchten, können Sie eine benutzerdefinierte Integration erstellen.
Wenn ein Gerät für Simple Entry konfiguriert ist, sendet es eine Anfrage an die in dem Feld „simpleEntryEndpoint“ angegebene URL. Das Konfigurationsfeld kann leer gelassen werden.
Nach dem Scannen eines Barcodes auf dem konfigurierten Gerät sendet unser Service eine GET‑Anfrage an die im Feld simpleEntryEndpoint angegebene URL.
Die Anfrage enthält einen Query‑Parameter namens barcode , der den gescannten Code oder die Eingabe auf dem Gerät repräsentiert.
Hinweis: Der Barcode wird URL‑kodiert
Zusätzlich enthält der Anfrage‑Header einen x-api-key, mit dem Sie sich bei der Azumuta REST API authentifizieren können.
Anfragebeispiel
Anfrage:
url:
headers: { x-api-key:
Nach der Verarbeitung Ihrer eigenen Logik sollte die Integration mit einem JSON‑Objekt antworten, das das Feld identifier enthält. Der Content-Type der Antwort sollte application/json sein.
Antwortbeispiel
{ identifier: “
Wie Sie automatisch einen Produktionsauftrag erstellen
Eine häufige Anfrage von Kunden ist die Möglichkeit, automatisch einen Produktionsauftrag für den gescannten Code zu erstellen (falls der Produktionsauftrag noch nicht existiert).
Dies kann einfach durch einen einzelnen Aufruf der Products Create REST API erreicht werden. Öffnen Sie Hilfe (das Fragezeichen in der oberen rechten Ecke) → API docs, und öffnen Sie dann den Products Create‑Endpunkt. Authentifizieren Sie sich mit einem API‑Schlüssel von einem Api Device. Mehr zum Zugriff auf die Dokumentation: Azumuta’s REST API.
Sie können eine POST‑Anfrage an den Create‑Product‑Endpunkt stellen und die folgenden Parameter verwenden:
returnExisting: true — Dadurch wird kein neues Produkt erstellt; stattdessen wird das vorhandene Produkt zurückgegeben, falls der Produktionsauftrag bereits existiert.
activate: true — Aktiviert den Produktionsauftrag bei der Erstellung automatisch. Die Aktivierung macht den Produktionsauftrag in der Bedieneroberfläche sichtbar. Diese Aktion stellt sicher, dass die zugehörigen Arbeitsanweisungen auf ihre zuletzt genehmigten Versionen gesperrt werden.