ConnectCLOUDDocs

Appearance

Basis Konfiguration ​

Die microtech-Schnittstelle bildet das Herzstück der ConnectCLOUD und ermöglicht die nahtlose Kommunikation zwischen Ihrem microtech büro+ und den verschiedenen Connect-Produkten.

Die hier beschriebene Basis-Konfiguration bildet das Fundament für alle Anbindungen an microtech. Während die GraphQL-Anbindung eine zwingende Voraussetzung für alle ConnectCloud Produkte darstellt, gibt es darüber hinaus modulspezifische microtech Anpassungen:

Unabhängig von den gewählten Zusatzmodulen sind für eine funktionierende Anbindung die folgenden grundlegenden Punkte umzusetzen:

Versionsanforderungen an microtech ​

Für den Einsatz von ConnectCLOUD ist eine aktuelle microtech-Version erforderlich.

  • Unterstützt werden nur microtech-Versionen in den Paketen Gen. 24 Core und Gen. 24 Enterprise.
  • Grundsätzlich ist die jeweils aktuellste stabile Version von microtech einzusetzen.
  • Bevorzugt wird die microtech-Version, mit der das jeweilige ConnectCLOUD-Produkt getestet wurde. Maßgeblich ist hierzu das jeweilige Changelog.
  • Veraltete Versionen sowie Express-Updates werden nicht unterstützt.

GraphQL-Anbindung ​

Checkliste der zu übermittelnden Daten

Diese Checkliste ersetzt nicht die Anleitung, sondern fasst nur die an MBCOM weiterzugebenden Daten im Bezug auf GraphQL zusammen.

1. Partner-App aktivieren oder Schlüssel eintragen ​

  • Partner-App-Schlüssel oder einen passenden Enterprise-microtech-Schlüssel eintragen.
  • Prüfen, dass unsere Partner-App danach in Anwendungen verwalten als Anwendungsart auswählbar ist.
  • Alternativ kann eine eigene App angelegt werden.

2. HTTP/2 vorbereiten ​

  • BpConfig.exe auf dem Server öffnen.
  • HTTP/2 aktivieren.
  • Den HTTP/2 Port im Standard auf 443 setzen/lassen. Wenn ein anderer Port verwendet wird, diesen bitte an MBCOM mitteilen.
  • Firewall, Portfreigabe, Reverse Proxy und externe Erreichbarkeit müssen zum verwendeten Port passen.
  • Ein gültiges Zertifikat hinterlegen.
  • Das Zertifikat muss hierfür als .pfx vorliegen und auf dem microtech-Server im Zertifikatsspeicher Eigene Zertifikate installiert sein.
  • Das Zertifikat muss von einer vertrauenswürdigen Stammzertifizierungsstelle stammen.
  • Das Zertifikat muss zur verwendeten Domain passen.
  • Der Server muss über diese Domain von außen per HTTPS erreichbar sein.

Hilfe: HTTPS- und Domain-Anforderungen

3. GraphQL im Mandanten aktivieren ​

  • In den gewünschten Mandanten wechseln.
  • Mandant bearbeiten öffnen.
  • In das Register Weitere Angaben wechseln.
  • Prüfen, ob GraphQL aktiviert bereits gesetzt ist.
  • Falls nicht, GraphQL aktiviert aktivieren.

4. Benutzer freischalten oder anlegen ​

  • Informationen -> Benutzer -> Benutzer verwalten öffnen.
  • Einen bestehenden Benutzer öffnen oder einen neuen Benutzer anlegen. Dieser benötigt die Berechtigung Supervisor.
  • Ein Benutzer wie ConnectCLOUD mit der Benutzernummer 301 ist sinnvoll und empfohlen, damit Änderungen leichter zugeordnet werden können.
  • In Firmenvorgaben das Kennzeichen Zugriff über GraphQL erlaubt aktivieren.

5. Anwendung anlegen ​

  • Meine Firma -> Überblick -> Systemeinstellungen -> Anwendungen verwalten öffnen.
  • Eine neue Anwendung anlegen.
  • Als Anwendungsart unsere Partner-App oder eigene App auswählen.
  • Den Client-Typ auf Vertraulicher Client (Confidential Client) setzen.
  • Den passenden Benutzer auswählen.
  • GraphQL-API Zugriff aktivieren.
  • Client ID und Client Secret direkt sichern, da das Client Secret später nicht erneut angezeigt wird.

6. URLs ​

Im Standard:

  • Base URL: https://<server.domain>/microtech/erp/mand/<MandNr>/
  • Token URL: https://<server.domain>/microtech/erp/mand/<MandNr>/token
  • GraphQL URL: https://<server.domain>/microtech/erp/mand/<MandNr>/graphql/v1
  • Anschließend baseUrl, clientId und clientSecret an MBCOM übermitteln.

Manueller GraphQL-Endpunkt ​

Sollte bereits ein manueller GraphQL-Endpunkt eingerichtet sein, kann dieser weiterhin verwendet werden. In diesem Fall unterscheidet sich lediglich die URL-Struktur.

microtech DMS ​

Das microtech DMS muss vorhanden sein. Diese Voraussetzung gilt für ConnectINVOICE und ConnectELO. Ist das DMS noch nicht vorhanden, ist dies ein weiterer Umsetzungsteil vor der Anbindung von ConnectCLOUD. Für ConnectELO werden zusätzlich bestimmte DMS-Einstellungen in microtech benötigt.

Unterstützung durch MBCOM

Auf Wunsch kann die vollständige Einrichtung der ConnectCLOUD-Schnittstelle durch MBCOM übernommen werden.