Beschreibung und Vorteile

moveIT CONBOX ist eine innovative Lösung, die es ermöglicht, eine für moveIT konfigurierte Umgebung nahtlos in ein externes System (Fremdsystem) zu integrieren und Daten effizient zu übermitteln sowie zu kommunizieren.

moveIT CONBOX besteht aus einer leistungsstarken Frontend-Webanwendung, in dein der die Konfiguration der Industrie durchgeführt werden kann, und einer robusten WebService-API, die spezialisierte Funktionen (Actions) für den Datenaustausch bereitstellt. Sowohl das Frontend als auch der WebService werden direkt von der Industrie betrieben, was höchste Kontrolle gewährleistet.

Eine moveIT CONBOX-Installation wird über den WebDataExchangeType CONBOXDefault und die dazugehörige Lizenz im Backend definiert, was eine einfache und flexible Implementierung ermöglicht.

Das System ist dabei so flexibel, dass unterschiedlichste Anforderungen von Fremdsystemen unterstützt werden:

1. Synchron halten der Systeme

   Zum Beispiel ist es möglich, dass die Belegsysteme beider Applikationen (Fremdsystem und moveIT CONBOX) kontinuierlich synchron gehalten werden.

2. Belegunabhängig
   Ein alternativer Ansatz erlaubt die Interaktion mit moveIT CONBOX ohne direkten Belegbezug (bis auf Action Purchase). Dabei wird für jede Konfiguration ein generischer Beleg erstellt und verwendet. Die GUID einer Position spielt hierbei eine zentrale Rolle und dient dem Fremdsystem als Referenz für Interaktionen bei Actions.

Dabei gibt es zwei unterschiedliche Typen von Actions:

Aktive Actions (schlussendlich Browser-Interaktion)

Aktive (Interaktive) Actions: Initialisiert wird eine aktive Action immer zuerst über den passiven Weg. Schlussendlich gibt es für aktive Actions aber immer eine Benutzerinteraktion in einem Browser oder iFrame.

Actions mit Browser-Interaktion werden aus einem Web-Browser-Control (z.B. WebView2 oder CEF unter Windows) aufgerufen.

• Frontend URL für aktive Actions

  https://<FRONTENDURL>/index.html?ConfCatalog&UsrCde=<USRCDE>&ActionToken=

• WebService URL zum initiieren von aktiven Actions

  https://<WEBSERVICEURL>

Passive Actions (reine WebService Interaktion)

Passive Actions werden von moveIT CONBOX als WebService bereitgestellt. Es gibt keine Benutzeroberfläche seitens moveIT CONBOX für den Endnutzer. Die Kommunikation zwischen den Systemen erfolgt vollständig im Hintergrund und ist für den Benutzer nicht sichtbar.

Die erforderlichen Parameter werden als JSON im Payload Body der HTTP-Anfrage übermittelt. Die Antworten werden ebenfalls im JSON-Format im HTTP-Response zurückgegeben. Der Content-Type der Nachrichten muss dabei stets application/json sein. In diesem Szenario werden die im Fremdsystem benötigten Informationen synchron direkt im Response des WebService-Calls zurückgegeben.

Passive Actions: Diese interagieren ausschließlich im Hintergrund mit einem WebService.

• WebService URL für passive Actions bzw. zum initiieren von aktiven Actions

  https://<WEBSERVICEURL>

Authentifizierung

Die Authentifizierung der passiven Actions erfolgt per BasicAuth oder DigestAuth.

Der Benutzername und das Passwort wird je Mandant/Organisation vom Betreiber der moveIT CONBOX Installation (normlerweise die Industrie) definiert und vergeben.