Skip to content

microtech Komponente im Portal konfigurieren

Die microtech-Konfiguration im ConnectCLOUD Portal verbindet Ihren Mandanten mit Ihrer microtech-Instanz über die GraphQL-API. Diese Konfiguration ist die Grundlage für alle weiteren Module.

Voraussetzung ist, dass die Basis-Konfiguration in microtech abgeschlossen wurde und Ihnen die Zugangsdaten (Client ID, Client Secret und GraphQL URL) vorliegen.

Zugang

Im Bereich Zugang tragen Sie die Zugangsdaten für die microtech GraphQL-API ein:

FeldBeschreibungBeispiel
Client IDDie Client-ID aus der microtech-Anwendungsverwaltung.a1b2c3d4-...
Client SecretDas zugehörige Client-Secret.••••••••
GraphQL URLDie Basis-URL Ihrer microtech-Instanz inkl. Mandantennummer.https://server.domain/microtech/erp/mand/0EC0../

URL-Format

Die GraphQL URL folgt dem Schema https://<server.domain>/microtech/erp/mand/<MandNr>/. Die Mandantennummer finden Sie in Ihrer microtech-Installation unter Mandant bearbeiten.

Verbindungstest

Bevor Sie die Konfiguration aktivieren, sollten Sie den integrierten Verbindungstest durchführen. Der Test prüft:

  1. OAuth-Token: Es wird ein echtes OAuth-Token von Ihrer microtech-Instanz angefordert.
  2. GraphQL-API: Anschließend wird eine Testabfrage gegen die GraphQL-API ausgeführt.

Starten Sie den Test über die Schaltfläche Zugang testen. Bei einem erfolgreichen Test werden beide Prüfungen grün markiert.

Fehlerbehebung

Falls der Test fehlschlägt, prüfen Sie:

  • Ist die microtech-Instanz von außen über HTTPS erreichbar?
  • Stimmen Client ID und Client Secret mit den Werten aus der microtech-Anwendungsverwaltung überein?
  • Ist GraphQL im Mandanten aktiviert?
  • Hat der zugeordnete Benutzer die Berechtigung Zugriff über GraphQL erlaubt?

Details zur Einrichtung finden Sie in der Basis-Konfiguration.

Aktivierung

Nach einem erfolgreichen Verbindungstest kann die microtech-Komponente über den Aktivierungsschalter eingeschaltet werden. Speichern Sie anschließend die Konfiguration.

Die microtech-Komponente ist Voraussetzung für alle weiteren Komponenten (ConnectINVOICE, ConnectELO, ConnectWorkflow).