# Partner-Apps Gen. 24 Core & Enterprise ## Was sind Partner-Apps? Mit Partner-Apps binden Sie zertifizierte Lösungen von microtech-Partnern direkt an Ihre microtech ERP an. Die Kommunikation erfolgt sicher über die GraphQL-Schnittstelle und OAuth 2.0. Sie profitieren von zusätzlichen Funktionen, die von Partnern für individuelle Anforderungen und Spezialgebiete entwickelt wurden. Partner-Apps sind ab Build **7120** in Gen. 24 Core und Gen. 24 Enterprise verfügbar. ### Verfügbare Partner-Apps | Partner-App | Partner | Beschreibung | | ---------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **MBCOM ConnectELO** | MBCOM IT-Systemhaus GmbH | Anbindung der microtech ERP an das ELO Dokumentenmanagement-System

**Externer Link**:
[https://www.mbcom.de/business-solutions/connectsuite/connectelo](https://www.mbcom.de/business-solutions/connectsuite/connectelo/) | !!! info "Info" Weitere Partner-Apps werden sukzessive verfügbar gemacht. Informationen zu neuen Partner-Apps erhalten Sie über Ihren microtech-Vertriebskontakt. ## Voraussetzungen für Partner-Apps * microtech Gen. 24 **Core** oder **Enterprise** (ab Build **7120**) * **Gültiger Aktivierungsschlüssel** für die jeweilige Partner-App * Aktivierter **GraphQL-Zugriff** für den Mandanten (fester GraphQL-Endpunkt) * **HTTPS-fähiger Server** mit gültigem SSL-Zertifikat * **Gültiger Domain-Name** (keine IP-Adressen) !!! warning "Beachten Sie" In der **Gen. 24 Core** lassen sich **ausschließlich Partner-Apps** (vertrauliche Clients) anbinden. ## Einrichtung einer Partner-App ### Schritt 1: Aktivierungsschlüssel eintragen Nach dem Erwerb einer Partner-App erhalten Sie einen Aktivierungsschlüssel. Diesen tragen Sie zunächst in der Software ein, wie in der Hilfe beschrieben: **[Aktivierung der Programmsoftware](../02_installation/aktivierung%20der%20programmsoftware/index.md)** * Wechseln Sie zu **Registerkarte: HILFE** → **LIZENZ** → **AKTIVIERUNGEN**. ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_1.png) * Klicken Sie auf die Schaltfläche: **HINZUFÜGEN**. ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_2.png) * Aktivieren Sie das Kennzeichen: **„Aktivierungsschlüssel manuell erfassen"** * Tragen Sie den Aktivierungsschlüssel für die Partner-App ein * Bestätigen Sie mit **WEITER** ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_3.png) Nach erfolgreicher Aktivierung steht Ihnen die entsprechende Partner-App im Bereich "Anwendungen verwalten" als Anwendungsart zur Verfügung. Wie Sie dies dort auswählen, zeigen wir Ihnen in den nächsten Schritten. ### Schritt 2: GraphQL-Zugriff aktivieren (falls noch nicht aktiviert) Partner-Apps sollten den festen, automatisch bereitgestellten GraphQL-Endpunkt des Mandanten verwenden. Ein manueller Automatisierungsdienst ist dafür nicht erforderlich. Wie Sie den GraphQL-Zugriff aktivieren und die URL des Endpunkts ermitteln, ist beschrieben unter: **[GraphQL-Endpunkt - Einrichtung und Betrieb](../18_graphql/graphqlendpunkteinrichten.md)** !!! tip "Tipp" Verwenden Sie für Partner-Apps immer den festen GraphQL-Endpunkt anstelle eines manuell eingerichteten Automatisierungsdienstes. ??? info "Alternative: Automatisierungsdienst (nicht empfohlen für Partner-Apps)" Falls bereits ein Automatisierungsdienst vom Typ „GraphQL-Server" eingerichtet ist, kann dieser weiterhin genutzt werden. Für neue Partner-App-Anbindungen wird jedoch der feste GraphQL-Endpunkt empfohlen. * Navigieren Sie zu **MEINE FIRMA** → **ÜBERBLICK** → Register: **AUTOMATISIERUNGS-DIENSTE**. * Legen Sie einen neuen Dienst an mit der Art: **„GraphQL-Server"**. * Konfigurieren Sie die erforderlichen Einstellungen (HTTPS, Domain, SSL-Zertifikat). * Starten Sie den Dienst. Detaillierte Informationen finden Sie in der **[GraphQL Entwickler Dokumentation - Abfragen (Queries)](../18_graphql/graphqldoku.md)**. ### Schritt 3: Benutzer für GraphQL berechtigen Damit ein Benutzer über die Partner-App auf Daten zugreifen kann, muss die GraphQL-Berechtigung aktiviert sein: * Wechseln Sie zu **Registerkarte: INFORMATIONEN** → **BENUTZER** → **BENUTZER VERWALTEN**. * Öffnen Sie den gewünschten Benutzer-Datensatz. * Wechseln Sie auf das Register: **FIRMENVORGABEN** und aktivieren Sie das Kennzeichen: **„Zugriff über GraphQL erlaubt"**. ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_4.png) !!! info "Info" Mit dem Setzen des Kennzeichens „Zugriff über GraphQL erlaubt" wird automatisch auch das Kennzeichen „Benutzer kann sich immer anmelden" aktiviert. ### Schritt 4: Anwendung anlegen Nun legen Sie die Anwendung für die Partner-App an: * Navigieren Sie zu **MEINE FIRMA** → **ÜBERBLICK** → Register: **ÜBERBLICK** → Gruppe: **SYSTEMEINSTELLUNGEN** → **ANWENDUNGEN VERWALTEN** ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_5.png) * Klicken Sie auf **Neu** im Menüband. ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_6.png) * Konfigurieren Sie nun die Anwendung wie folgt: | Feld | Eingabe | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Bezeichnung** | Aussagekräftiger Name (z. B. „MBCOM ConnectELO") | | **Anwendungsart** | Wählen Sie die entsprechende Partner-App aus der Liste, z. B. „MBCOM IT-Systemhaus GmbH - MBCOM ConnectELO (Partner-App)".
(Durch Eintragen des Aktivierungsschlüssels freigeschaltet). | | **Client-Typ** | Vertraulich (wird automatisch gesetzt) | | **Benutzer** | Wählen Sie den microtech-Benutzer für die Verbindung | Konfigurieren Sie die Redirect URI entsprechend den Vorgaben des Partner-App-Anbieters. Aktivieren Sie die erforderlichen Scopes (mindestens: GraphQL-API Zugriff). ![Alt-Text](https://assets.hilfe.microtech.de/bilder/18_graphql/graphqlpartnerapps_7.png) !!! danger "Achtung" **Client-ID** und **Client-Secret** werden automatisch generiert. **Kopieren Sie beide Werte mit den Kopier-Buttons vor dem Speichern**! Das Secret wird danach nur als Hash gespeichert und kann nicht wiederhergestellt werden. Klicken Sie nun auf **Speichern & schließen** ### Schritt 5: Zugangsdaten an die Partner-App übermitteln Die Partner-App benötigt drei Informationen, um sich mit Ihrem microtech ERP-System zu verbinden: * **URL** des GraphQL-Endpunkts (siehe [GraphQL-Endpunkt - URL-Struktur](../18_graphql/graphqlendpunkteinrichten.md#3-url-struktur); bei Nutzung eines Automatisierungsdienstes aus dessen Ereignisprotokoll) * **Client-ID** (aus der Anwendungskonfiguration) * **Client-Secret** (aus der Anwendungskonfiguration – nur beim Erstellen sichtbar!) Diese Daten geben Sie in der Partner-App ein, wenn diese Sie zur Eingabe auffordert. !!! warning "Beachten Sie" Die URL muss ein gültiger Domain-Name mit HTTPS sein (z. B. ```https://erp.ihrefirma.de```). IP-Adressen funktionieren nicht. ## Unterschiede zwischen Core und Enterprise | Funktion | Gen. 24 Core | Gen. 24 Enterprise | | --------------------------------------- | ---------------------------------- | ---------- | | Partner-Apps (vertrauliche Clients) | ✓ | ✓ | | Eigene Anwendungen erstellen | ✗ | ✓ | | Öffentliche Clients | ✗ | ✓ | | Interaktive Web-Oberfläche (Playground) | ✗ | ✓ | ## Fehlerbehebung **Aktivierungsschlüssel wird nicht akzeptiert:** * Prüfen Sie, ob Sie mindestens Build 7120 installiert haben * Stellen Sie sicher, dass Sie eine Gen. 24 Core- oder Enterprise-Version nutzen * Kontaktieren Sie den microtech-Support **Verbindung zur Partner-App schlägt fehl:** * Prüfen Sie, ob der GraphQL-Server läuft * Stellen Sie sicher, dass HTTPS und ein gültiger Domain-Name verwendet werden * Überprüfen Sie, ob Client-ID und Client-Secret korrekt übertragen wurden * Prüfen Sie, ob der zugewiesene Benutzer die GraphQL-Berechtigung hat **Partner-App erscheint nicht in der Auswahl:** * Stellen Sie sicher, dass der Aktivierungsschlüssel erfolgreich eingetragen wurde * Starten Sie die Software neu ## Weiterführende Informationen * **[OAuth 2.0 API-Dokumentation](../18_graphql/oauthapidoku.md)** * **[GraphQL Entwickler-Dokumentation](../18_graphql/graphqldoku.md)** * **[Aktivierung der Programmsoftware](../02_installation/aktivierung%20der%20programmsoftware/index.md)**