ConnectCLOUDDocs

Appearance

Zielgruppe & Rolle

Rolle: Mandanten-Administrator / IT-Admin | Voraussetzung: microtech ERP Basis-Anbindung vorhanden (immer 1. Schritt der Mandantenkonfiguration)

microtech Komponente im Portal konfigurieren ​

Unterstützung durch MBCOM

Auf Wunsch kann die vollständige Einrichtung der microtech-Konfiguration im Portal durch MBCOM übernommen werden.

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.

Je nach Organisationsstruktur kann die Anbindung auf zwei Arten erfolgen:

  • Zentral verwaltet (Empfohlen): Der Server und die Zugangsdaten sind in der Kunden-Administration hinterlegt und diesem Mandanten zugewiesen.
  • Individuell verwaltet: Die Zugangsdaten werden direkt in diesem Mandanten eingepflegt.

Zentral verwaltete Anbindung ​

Wurde Ihr Mandant in der Kunden-Administration einem zentralen microtech-Server zugeordnet (z. B. über die automatische NetBird-Anbindung), wird in der Mandanten-Administration ein Informationsbanner angezeigt:

Verbindung wird zentral verwaltet

Dieser Mandant ist dem Server »[Server-Name]« (Mandant [MandNr]) zugeordnet. Zugangsdaten und URL können nur in der Kundenverwaltung geändert werden.

In diesem Modus gilt:

  • Die Verbindungsfelder (Client ID, Client Secret, GraphQL URL und TLS-Zertifikat) sind schreibgeschützt.
  • Änderungen an Endpunkten, Zugangsdaten oder Zertifikaten können ausschließlich von Kunden-Administratoren (CUSTOMER_ADMIN) unter Kunden-Administration -> microtech vorgenommen werden.
  • Als Mandanten-Administrator können Sie weiterhin:
    • Den integrierten Verbindungstest durchführen.
    • Das Modul für Ihren Mandanten aktivieren oder deaktivieren.
    • Die Indizierung von ERP-Daten steuern.

Individuelle Konfiguration (Zugangsdaten) ​

Wird der Mandant nicht zentral verwaltet, tragen Sie die Zugangsdaten im Bereich Zugang manuell 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../
TLS-Zertifikat (PEM)Optional: Öffentliches Zertifikat im PEM-Format. Erforderlich bei selbstsignierten Zertifikaten oder internen VPN-Endpunkten (z. B. NetBird).-----BEGIN CERTIFICATE-----...

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 bzw. über das NetBird-Netzwerk erreichbar?
  • Stimmen Client ID und Client Secret mit den Werten aus der microtech-Anwendungsverwaltung überein?
  • Bei NetBird- oder selbstsignierten Zertifikaten: Ist das passende Zertifikat im Feld TLS-Zertifikat (PEM) hinterlegt?
  • 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 & Einstellungen ​

Nach erfolgreichem Verbindungstest können folgende Optionen konfiguriert werden:

  • Aktiviert: Schaltet die microtech-Komponente für diesen Mandanten ein. Sie ist Voraussetzung für alle weiteren Komponenten (ConnectINVOICE, ConnectELO, ConnectWORKFLOW).
  • Indizierung aktiv: Aktiviert die automatische Indizierung von ERP-Stammdaten (z. B. Artikel, Adressen, Belege) für Such- und Vorschlagsfunktionen im Portal.

Klicken Sie nach Änderungen auf Speichern, um die Einstellungen zu übernehmen.

Abschluss der Basiskonfiguration & nächste Schritte

Die microtech-Mandantenkonfiguration schließt die Basiskonfiguration ab. Konfigurieren Sie nun die weiteren produktbezogenen Komponenten Ihres Mandanten (Reihenfolge beliebig):

Fahren Sie anschließend mit der produktbezogenen Systemkonfiguration fort oder kehren Sie zur Basiskonfiguration Übersicht zurück.