- Drucken
OpenBOM-Konnektor
Integrieren Sie Tulip mit OpenBOM unter Verwendung des HTTP-Connectors von Tulip
Einführung
OpenBOM ist eine Cloud-basierte Echtzeit-Zusammenarbeits- und Datenverwaltungstechnologie, die die Verwaltung von Teilen, Katalogen, Stücklisten, Beständen und Bestellungen in Netzwerken von Ingenieuren, Supply Chain Managern und Vertragsherstellern ermöglicht. Das Ziel dieses Konnektors ist die Integration von OpenBOM mit Tulip unter Verwendung der HTTP-Konnektoren von Tulip und die Bereitstellung eines sofort einsatzbereiten OpenBOM-Konnektors, der in Ihre Instanz importiert werden kann.
Zweck
- Wir werden verschiedene HTTP-Connector-Funktionen hervorheben, die durch HTTP-Aufrufe an die Endpunkte von OpenBOM erstellt werden können, um Informationen über konfigurierte Stücklisten (BOMs), gepflegte Kataloge und Informationen über in OpenBOM freigegebene Produktionsauftrags-Stücklisten zu erhalten.
- Tulip-Anwendungen können erstellt werden, um Arbeitsanweisungen für Bediener in der Werkstatt anzupassen, die Informationen über Produktionsaufträge abrufen und die Teile hervorheben, die die Bediener für die Montage von Produkten und die Fertigstellung des Produktionsauftrags in der Werkstatt benötigen. Durch die Nutzung von Katalogen in OpenBOMs werden wir zeigen, wie Manager in der Werkstatt ein Echtzeit-Inventar der verschiedenen Teile, die für die Montage des Produkts in der Werkstatt benötigt werden, verwalten können.
API-Dokument
Die folgenden, in diesem Dokument hervorgehobenen Konnektor-Funktionen haben die API Docs von OpenBOM genutzt
Vorraussetzungen
- Erstellen Sie ein Konto bei OpenBOM und konfigurieren Sie OpenBOM-Kataloge und -Stücklisten für das Produkt, das in Ihrer Werkstatt zusammengebaut werden soll.
- Sie müssen einen API-Schlüssel generieren, der in Tulip-Konnektoren verwendet wird, um Verbindungen mit OpenBOM herzustellen.
- Mit Hilfe der Basisauthentifizierung (Benutzername und Passwort) erhalten Sie das Access Token (siehe unten), das als Request Header in allen Connector-Funktionen übergeben wird.
Tulip-Verbindungsdetails
Die folgenden Informationen müssen auf dem HTTP-Konnektor von Tulip konfiguriert werden.
- Läuft auf: Cloud Connector Host
- Rechner: developer-api.openbom.com
- Anschluss:443
- TLS: Ja
- Authentifizierung: Keine Authentifizierung
- Kopfzeilen: x-openbom-appkey
Konnektor-Funktionen
Zugriffstoken erhalten
Zweck
- Abrufen des Zugriffstokens, der in allen nachfolgenden Connector-Funktionen als Anfragekopf verwendet wird.
- Das Zugriffstoken läuft alle 24 Stunden ab. Nach der Ausführung dieser Konnektorfunktion gibt OpenBOM das Zugriffstoken zurück, das in einer Tulip-Variablen gespeichert werden kann, die von allen nachfolgenden Konnektorfunktionen dynamisch als Anfragekopf verwendet werden kann.
Endpunkt & Kopfzeilen
- Ein POST-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/login
- Anfrage-Header: x-openbom-appkey
- Request Body : ContentType: JSON Benutzername & Passwort als Schlüssel
Erforderlicher Output-Extraktor
- Access Token - Das zurückgegebene Access Token wird in allen Sub-Connector-Funktionen verwendet.
Abrufen einer Liste von Katalogen
Zweck
- Dieser Endpunkt liefert eine Liste der im OpenBOM-Profil des Benutzers verfügbaren Kataloge.
- Die Liste kann verwendet werden, um die Katalog-IDs zu extrahieren, die verwendet werden können, um bestimmte Kataloge für das Abrufen des aktuellen Bestands für verschiedene Materialien und das Aktualisieren verschiedener Eigenschaften innerhalb des Katalogs in Echtzeit zu nutzen.
Endpunkt & Kopfzeilen
- Ein GET-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/catalogs
- Anfrage-Header: x-openbom-appkey, x-openbom-accesstoken
Erforderliche Eingabe
- Access Token, das durch eine Variable übergeben werden muss, die als Request Header für den HTTP-Aufruf an den oben genannten Endpunkt erforderlich ist.
Erforderliche Output-Extraktoren
- CatalogId - Kann verwendet werden, um bestimmte Kataloge von Interesse aufzurufen
Abrufen einer Liste von BOMs
Zweck
- Dieser Endpunkt liefert eine Liste der im OpenBOM-Profil des Benutzers verfügbaren Stücklisten.
- Die Liste kann verwendet werden, um die Stücklisten-IDs oder die Namen der Stücklisten zu extrahieren, die verwendet werden können, um bestimmte Stücklisten für das Abrufen von Informationen über verschiedene Teile zu nutzen, die für die Montage einer Einheit in der Werkstatt benötigt werden.
Endpunkt und Kopfzeilen
- Ein GET-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/boms
- Anfrage-Header x-openbom-appkey, x-openbom-accesstoken
Erforderliche Eingabe
- Access Token, das von einer Variablen übergeben werden muss, die als Request Header für den HTTP-Aufruf an den oben genannten Endpunkt erforderlich ist.
Erforderliche Output-Extraktoren
- BOMId - Kann verwendet werden, um bestimmte Stücklisten von Interesse aufzurufen.
- Name - Kann verwendet werden, um eine POST zum Aufrufen einer bestimmten Stückliste durch Übergabe der Eigenschaft Name durchzuführen.
Produktionsauftragsstückliste abrufen
Zweck
- Diese Funktion ruft die Produktionsauftragsstückliste ab, wenn die spezifische Stückliste für die Montage einer Einheit auf OpenBOM für die Produktion freigegeben wird.
- Diese Konnektorfunktion extrahiert wichtige Details (Name, BOMID, Anzahl der Einheiten) über den Produktionsauftrag, die dynamisch übergeben werden, um eine bestimmte Stücklisten-ID aufzurufen, die alle Informationen über die Gesamtzahl der Teile enthält, die der Bediener für die Fertigstellung des gesamten Produktionsauftrags benötigt.
Endpunkt & Kopfzeilen
- Ein GET-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/orderboms
- Anfrage-Header: x-openbom-appkey, x-openbom-accesstoken
Erforderliche Eingabe
- Access Token, das von einer Variablen übergeben werden muss, die als Request Header für den HTTP-Aufruf an den oben genannten Endpunkt erforderlich ist.
Erforderliche Ausgabe-Extraktoren
- Name - Dies kann verwendet werden, um die Details für eine bestimmte Produktionsstückliste zu erhalten, indem der Name an den stücklistenspezifischen Endpunkt übergeben wird.
- BOMID - Diese Eigenschaft wird verwendet, um alle Details für eine bestimmte Produktionsstückliste zu erhalten, indem die ID an den stücklistenspezifischen Endpunkt übergeben wird.
- numUnits - Diese Eigenschaft kann verwendet werden, um die Anzahl der Einheiten anzugeben, die in der Werkstatt für einen einzelnen Produktionsauftrag hergestellt werden sollen.
Spezifische Stückliste abrufen
Zweck
- Diese Funktion ruft die Eigenschaften für alle verschiedenen Materialien ab, die in einer bestimmten Stückliste für die Montage einer Einheit enthalten sind.
- Die von OpenBOM zurückgegebenen Zeilen können in Tulip geparst werden, um die Menge der verschiedenen Rohmaterialien anzuzeigen, die für die Fertigstellung des Produktionsauftrags benötigt werden, zusätzlich zu allen anderen von OpenBOM zurückgegebenen Stücklisteneigenschaften, je nachdem, wie die Stückliste konfiguriert ist.
Endpunkt & Kopfzeilen
- Ein GET-Aufruf an den Endpunkt: https: //developer-api.openbom.com:443/bom/{bomid}
- Anfrage-Header: x-openbom-appkey, x-openbom-accesstoken
- URL-Parameter: {bomid} - Dieser wird als Eingabe übergeben.
Erforderliche Eingaben
- Access Token, das von einer Variablen übergeben wird, die als Request Header für den HTTP-Aufruf an den oben genannten Endpunkt erforderlich ist.
- BOMID - Zum Abrufen der Informationen über die spezifische Stückliste von Interesse.
Erforderliche Ausgaben
- Von OpenBOM zurückgegebene Zeilen für eine bestimmte Stückliste, die die Eigenschaften für verschiedene Materialien enthalten, die Teil der Stückliste sind
- Die Benutzer können die von OpenBOM zurückgegebenen spezifischen Details je nach Anwendungsfall analysieren.
Bestimmte Stückliste nach Name abrufen
Zweck
- Diese Funktion ruft die Eigenschaften für alle verschiedenen Materialien ab, die in einer bestimmten Stückliste enthalten sind, um eine Einheit zusammenzustellen, indem der Name der Stückliste anstelle einer ID übergeben wird.
- Die von OpenBOM zurückgegebenen Zeilen können in Tulip geparst werden, um die Menge der verschiedenen Rohmaterialien anzuzeigen, die für die Fertigstellung des Produktionsauftrags benötigt werden, zusätzlich zu allen anderen von OpenBOM zurückgegebenen Stücklisteneigenschaften, je nachdem, wie die Stückliste konfiguriert ist.
Endpunkt & Kopfzeilen
- Ein POST-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/boms/byparams
- Anfrage-Header x-openbom-appkey, x-openbom-accesstoken
- Request Body Content-Type:JSON , Name als der im JSON übergebene Schlüssel
Erforderliche Eingaben
- Zugriffstoken
- BOM NAME - Übergeben als Wert für den Schlüssel "name" im Anfragekörper.
Erforderliche Ausgaben
- Von OpenBOM zurückgegebene Zeilen für eine bestimmte Stückliste, die die Eigenschaften für verschiedene Materialien enthalten, die Teil der Stückliste sind
- Benutzer können je nach Anwendungsfall bestimmte von OpenBOM zurückgegebene Details analysieren.
Spezifischen Katalog abrufen
Zweck
- Zusätzlich zu verschiedenen anderen vordefinierten oder benutzerdefinierten Eigenschaften verwaltet der Katalog in OpenBOM den Bestand der vorhandenen Teile, der zur Anzeige/Aktualisierung des Echtzeitbestands in Tulip verwendet werden kann
- Mit dieser Funktion erhalten Sie Informationen über alle in OpenBOMs Catalogs verfügbaren Eigenschaften.
Endpunkt & Kopfzeilen
- Ein GET-Aufruf an den Endpunkt: https://developer-api.openbom.com:443/bom/{bomid}
- Anfrage-Header x-openbom-appkey, x-openbom-accesstoken
- URL-Parameter : {catid} - Dieser wird als Input übergeben.
Erforderliche Eingabe
- Zugriffstoken
- CATID: Zum Abrufen der Informationen über die spezifische Stückliste von Interesse.
Erforderliche Ausgabe
- Je nach Anwendungsfall können die Benutzer verschiedene Katalogeigenschaften extrahieren, die von OpenBOM zurückgegeben werden, wobei die Bestandsmenge eine Eigenschaft ist, die für die Verwaltung des Inventars in Tulip und die Aktualisierung in Echtzeit verwendet werden kann.
Aktualisierung der Katalogeigenschaften
Zweck
- Der Katalog in OpenBOM verwaltet das Inventar der vorhandenen Teile, das zur Anzeige/Aktualisierung des Echtzeit-Inventars dieser Teile in den Tulip-Anwendungen, die in der Werkstatt laufen, verwendet werden kann.
- Diese Funktion wird verwendet, um die Eigenschaften im Katalog in Echtzeit zu aktualisieren. Ein Beispiel dafür ist der Bestand an Materialien, die für den Zusammenbau des Produkts in der Werkstatt verwendet werden. Da die Materialien in Echtzeit verbraucht werden, können wir diese Funktion nutzen, um die Menge in Echtzeit zu aktualisieren, während der Bediener mit dem Zusammenbau einer Einheit mit Hilfe der Arbeitsanweisungs-App in Tulip fortfährt.
Endpunkt & Kopfzeilen
- Ein POST-Aufruf zum Endpunkt: https: //developer-api.openbom.com:443/catalog/{catid}/propertyvalue
- Anfrage-Header x-openbom-appkey, x-openbom-accesstoken
- Request Body Inhaltstyp : JSON
- 4 Schlüssel müssen in einem JSON übergeben werden - partNumberPropertyName, partNumber, propertyName, propertyValue
Erforderliche Eingabe
- Zugriffs-Token
- CATID: URL-Parameter
- TeilNummerEigenschaftsName: Wert für den im Request Body übergebenen Schlüssel
- TeilNummer: Wert für den im Request Body übergebenen Schlüssel
- Eigenschaftsname: Wert für den im Request Body übergebenen Schlüssel
- EigenschaftWert: Wert für den im Request Body übergebenen Schlüssel
OpenBOM gibt bei einer erfolgreichen "Property Updated"-Antwort einen Status von 200 zurück.
Video
Ein kleines Video, das erklärt, wie Sie OpenBOM mit einer Tulip App verwenden können.