Mit diesem Formular können Sie fehlende, unklare oder fehlerhafte Inhalte in der Dokumentation melden und Verbesserungsvorschläge machen. Ihr Feedback hilft uns, die Qualität und Vollständigkeit kontinuierlich zu verbessern.
Verbindungseinrichtung
Die Verbindungseinrichtung ist der erste und wichtigste Schritt bei der Konfiguration der MDE 5.0 App. Sie legt fest, mit welcher Business Central-Instanz die App kommuniziert und wie die Authentifizierung erfolgt.
Übersicht Verbindungsbildschirm
Wenn Sie die MDE 5.0 App öffnen und noch keine Verbindung eingerichtet ist oder keine Standardverbindung aktiv ist, sehen Sie den Verbindungsbildschirm.
Elemente des Verbindungsbildschirms
| Verbindungsliste | Zeigt alle eingerichteten Verbindungen an, falls vorhanden. |
| Verbindungsdetails | Für jede Verbindung werden Name, Mandant und Webservice-Pfad angezeigt. |
| Bearbeiten-Symbol | Stift-Symbol zum Bearbeiten einer Verbindung. |
| Löschen-Symbol | Mülleimer-Symbol zum Entfernen einer Verbindung. |
| Neue Verbindung | Button zum Erstellen einer neuen Verbindung (nur im Admin-Modus sichtbar). |
Hinweis
Um Verbindungen zu verwalten, müssen Sie sich im Admin-Modus anmelden.
Neue Verbindung erstellen
Voraussetzungen
Bevor Sie eine Verbindung einrichten können, benötigen Sie folgende Informationen aus Business Central:
- Webservice-URL (SOAP)
- Mandantenname
- Authentifizierungsmethode und entsprechende Zugangsdaten
- Optional: URL-Suffix (Query-Parameter)
Schritt-für-Schritt-Anleitung
Öffnen Sie die MDE 5.0 App.
Melden Sie sich im Admin-Modus an.
Klicken Sie auf den Button "Neue Verbindung".
Der Dialog "Neue Verbindung" öffnet sich.
1. Verbindungsname vergeben
Geben Sie einen eindeutigen Namen für die Verbindung ein.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Bezeichnung | Frei wählbare Bezeichnung für diese Verbindung | "Produktion", "Test-System", |
Tipp
Der Name sollte aussagekräftig sein, da er später in der Verbindungsliste angezeigt wird. Bei mehreren Verbindungen hilft ein guter Name bei der Unterscheidung.
2. Webservice-Pfad ermitteln
Der Webservice-Pfad ist die URL, über die die App mit Business Central kommuniziert.
So finden Sie den Webservice-Pfad in Business Central:
Öffnen Sie Business Central.
Öffnen Sie über die Suche Webdienste.
Filtern Sie die Liste nach der "Objektart" = "Codeunit".
Suchen Sie nach der Codeunit "unitop MDE Service".
Die SOAP-URL dieser Codeunit ist der benötigte Webservice-Pfad. Dieser muss zunächst angepasst werden.
Folgende Werte sind immer gleich:
- Objektart: Codeunit
- Objekt-ID: 5324041
- Onjektname: GOB MDE Service
- Servicename: MdeService
Hinweis
Der Webdienst muss veröffentlicht sein. Andernfalls kann die App keine Anfragen an BC schicken und der Designerprozess kann nicht gestartet werden
Webservice-Pfad für die MDE-App anpassen:
Die SOAP-URL aus Business Central muss für die Eingabe in der MDE-App gekürzt werden. Die App setzt die vollständige URL später automatisch zusammen. Entfernen Sie folgende Bestandteile aus der kopierten URL:
Start-URL: https://bleedingedge.unitop.engineering:7047/BC/WS/CRONUS%20DE/Codeunit/MdeService?tenant=default
Query-Parameter:
?tenant=default(falls vorhanden)Pfad zum Service:
Codeunit/MdeServiceMandantenangabe: z. B.
CRONUS%20DE
Beispiel:
Vollständige SOAP-URL aus BC:
https://server.domain.de:7047/BC/WS/CRONUS%20DE/Codeunit/MdeService?tenant=default
Gekürzter Webservice-Pfad für MDE-App:
https://server.domain.de:7047/BC/WS/
Die App kombiniert diesen Basis-Pfad später automatisch mit dem URL-Suffix und dem ausgewählten Mandanten, um die vollständige Verbindung herzustellen.
Tipp
Diagnose-Möglichkeit: Am Ende der Verbindungseinrichtung finden Sie zwei Buttons zum Kopieren der vollständigen URLs in die Zwischenablage:
- Button 1: Kopiert den MDE-Webservice-Pfad (z. B.
https://server.domain.de:7047/BC/WS/CRONUS DE/Codeunit/MdeService?tenant=default) - Button 2: Kopiert den BC-System-Webservice-Pfad (z. B.
https://server.domain.de:7047/BC/WS/SystemService?tenant=default)
Sie können diese URLs in einem Browser testen, um Verbindungsprobleme unabhängig von der App zu diagnostizieren. Mehr dazu lesen Sie unter Verbindung testen.
3. URL-Suffix (Optional)
Das URL-Suffix ist eigentlich ein Query-Parameter, der an die URL angehängt wird. Der Name ist historisch bedingt.
| Feld | Beschreibung | Wann notwendig? |
|---|---|---|
| URL-Suffix | Query-Parameter für spezielle Konfigurationen | Sollten Sie die Mandanten nicht korrekt laden können, ergänzen und prüfen Sie das URL-Suffix. |
Hinweis
In den meisten Fällen bleibt dieses Feld leer. Ihr unitop Berater informiert Sie, wenn ein URL-Suffix notwendig ist.
4. Authentifizierungsmethode wählen
Wählen Sie die Authentifizierungsmethode aus, die Ihrer Business Central-Umgebung entspricht. Je nach Methode, ändert sich die darauffolgende Eingabemasken und benötigten Informationen.
| Methode | Beschreibung | Verwendung |
|---|---|---|
| Standard | Legacy-Authentifizierung mit Benutzername und Passwort | Nur On-Premises |
| OAuth2 | Ressource-Owner-Password-Flow | SaaS (nicht empfohlen) |
| Interactive | Modern Authentication mit Azure AD | SaaS (empfohlen) |
Warnung
Die OAuth2-Methode gilt als unsicher und sollte nicht mehr verwendet werden. Nutzen Sie stattdessen die Interactive-Methode.
Mehr Informationen zu den Authentifizierungsmethoden finden Sie hier:
5. Zugangsdaten eingeben (Standard-Authentifizierung, OAuth)
Wenn Sie die Standard-Authentifizierung (oder OAuth) gewählt haben, geben Sie die Zugangsdaten eines Business Central-Benutzers ein.
| Feld | Beschreibung | Hinweise |
|---|---|---|
| Benutzername | BC-Benutzername | Meist ein Super-User |
| Passwort | BC-Passwort | Wird abhängig vom Betriebssystem sicher gespeichert |
Hinweis
Der verwendete Benutzer dient nur zum Herstellen der Verbindung. Es ist üblicherweise ein Super-User.
Warnung
Diese Zugangsdaten sind sensitiv und sollten nicht allen Mitarbeitern zugänglich sein. Sie befinden sich im passwortgeschützten Admin-Bereich.
6. Standardverbindung festlegen oder wechseln (Optional)
Mit der Checkbox "Standardverbindung" legen Sie fest, ob diese Verbindung beim App-Start automatisch ausgewählt werden soll. Es kann immer nur eine Verbindung als Standard markiert sein.
| Option | Verhalten |
|---|---|
| Standardverbindung aktiviert | App stellt beim Start automatisch eine Verbindung her und zeigt die Anmeldemaske. Lesen Sie hier mehr Informationen, um in der App vor- und zurück zu navigieren. |
| Standardverbindung deaktiviert | App zeigt beim Start den Verbindungsbildschirm, Sie müssen die Verbindung manuell auswählen. |
Sobald Sie eine Standardverbindung aktivieren wird die Markierung bei der vorherigen Standardverbindung automatisch entfernt, nachdem Sie die Änderung gespeichert haben.
Tipp
Aktivieren Sie die Standardverbindung, wenn Sie nur mit einer Business Central-Instanz arbeiten. Dies beschleunigt den Arbeitsablauf für Lagermitarbeiter.
7. Verbindung speichern
Klicken Sie auf den Button "Speichern", um die Verbindung zu sichern. Die App validiert die eingegebenen Daten und speichert die Verbindung.
Hinweis
Passwörter werden NICHT in der Verbindungsdatei gespeichert, sondern im sicheren Speicherbereich des Betriebssystems.
8. Mandant laden
Nachdem Sie die Authentifizierungsdaten eingegeben haben, können Sie die verfügbaren Mandanten laden. Das erfolgreiche Laden des Mandanten ist ein erster Indikator dafür, dass die Verbindung funktioniert.
Die Mandantenliste wird nicht lokal gespeichert, sondern bei jedem Zugriff dynamisch von Business Central abgerufen. Dies gilt sowohl beim Erstellen einer neuen Verbindung als auch beim Bearbeiten einer bestehenden Verbindung. Die Verfügbarkeit der Mandanten hängt von der gewählten Authentifizierungsmethode ab. Je nach Authentifizierung kann es sein, dass Sie sich erneut autorisieren müssen.
Klicken Sie auf den Button "Mandant laden".
Die App stellt eine Testverbindung her und lädt die verfügbaren Mandanten.
Wählen Sie den gewünschten Mandanten aus der Dropdown-Liste aus.
Hinweis
Wenn der Button "Mandant laden" nicht funktioniert, überprüfen Sie die Verbindungsparameter und Zugangsdaten. Die App muss eine gültige Verbindung herstellen können, um die Mandanten abzurufen.
Verbindung testen
Das erfolgreiche Laden des Mandanten ist ein erster Indikator dafür, dass die Verbindung funktioniert. Es ist jedoch empfehlenswert, die Verbindung zu testen, bevor Sie sie produktiv einsetzen.
Test über Browser
Sie können die Verbindung unabhängig von der App testen, indem Sie die Webservice-URL in einem Browser öffnen.
Kopieren Sie die Webservice-URL (Button "URL kopieren" in der Verbindungseinrichtung).
Öffnen Sie einen Webbrowser.
Fügen Sie die URL in die Adresszeile ein.
Drücken Sie Enter.
Geben Sie bei Aufforderung die Authentifizierungsdaten ein.
Erwartetes Ergebnis:
Sie sollten eine XML- oder WSDL-Seite sehen, die die verfügbaren Webservice-Funktionen auflistet.
Tipp
Wenn Sie die Seite im Browser sehen können, funktioniert die Verbindung grundsätzlich. Probleme in der App liegen dann meist an falschen Authentifizierungsdaten oder Einstellungen.
Häufige Fehlermeldungen beim Test
| Fehlermeldung | Bedeutung | Lösungsansatz |
|---|---|---|
| Keine Verbindung | Netzwerkproblem oder Server nicht erreichbar | Netzwerk und Server-Verfügbarkeit prüfen |
| Zertifikatsfehler (495, 496, 497) | SSL/TLS-Zertifikat fehlt, ist abgelaufen oder ungültig. Der Fehler tritt während der Handshake-Phase auf, bevor die HTTP-Kommunikation beginnt. | Zertifikat im Browser prüfen, BC-Administrator oder Infrastruktur-Team kontaktieren. Grundsätzlich muss das Zertifikat auf dem Android-Gerät installierbar sein. |
| Zertifikatsfehler falsches Datum | Datum und Uhrzeit des Gerätes müssen stimmen, damit das Zertifikat erfolgreich validiert werden kann. | |
| 401 Unauthorized | Authentifizierung fehlgeschlagen (Benutzername oder Passwort falsch) | Zugangsdaten in BC überprüfen, Benutzer-Sperrung ausschließen |
| 404 Not Found | Webservice-URL ist falsch oder der Dienst existiert nicht | Webservice-URL aus BC erneut kopieren und auf Tippfehler prüfen |
| 500 Internal Server Error | Interner Serverfehler in Business Central. Möglicherweise ist Bussiness Central bislang nicht vollständig gestartet. | BC-Administrator kontaktieren, Server-Logs prüfen |
Verbindung bearbeiten
Bestehende Verbindungen können jederzeit geändert werden.
Melden Sie sich im Admin-Modus an.
Klicken Sie auf das Stift-Symbol bei der gewünschten Verbindung.
Der Bearbeitungsdialog öffnet sich mit den aktuellen Werten.
Nehmen Sie die gewünschten Änderungen vor.
Klicken Sie auf "Speichern".
Hinweis
Alle Felder können nachträglich geändert werden, einschließlich der Authentifizierungsmethode.
Verbindung löschen
Nicht mehr benötigte Verbindungen können entfernt werden.
Melden Sie sich im Admin-Modus an.
Klicken Sie auf das Mülleimer-Symbol bei der gewünschten Verbindung.
Bestätigen Sie die Löschung.
Warnung
Gelöschte Verbindungen können nicht wiederhergestellt werden. Alle Einstellungen gehen verloren und müssen bei Bedarf neu eingerichtet werden.
QR-Code-Scan für schnelle Einrichtung
Eine schnelle und einfache Methode zur Einrichtung ist das Scannen eines QR-Codes.
Hinweis
Diese Funktion steht in der App bereits zur Verfügung. Die Generierung des QR-Codes in Business Central ist noch nicht implementiert und wird in einer zukünftigen Version nachgeliefert.
Funktionsweise
Ein Administrator generiert in Business Central einen QR-Code mit allen Verbindungsparametern.
Der QR-Code sollte ausgedruckt sein oder auf einem Bildschirm angezeigt werden.
Sobald Sie sich mit dem Gerät in der Geräteeinrichtung befinden, halten Sie das Gerät so, dass der QR-Code gescannt wird und drücken Sie am Gerät den dafür vorgesehenen Knopf. Bei Nutzung eines Android-Gerätes aktivieren Sie zunächst in der Benutzeroberfläche die Kamera.
Alle Parameter werden daraufhin automatisch eingetragen.
Sicherheitshinweis
Warnung
Der QR-Code kann auch das Passwort enthalten. In diesem Fall ist es unverschlüsselt im Code enthalten. Achten Sie darauf, QR-Codes mit Passwort nicht öffentlich zugänglich zu machen oder auszuhängen.
Verbindungsdateien
Verbindungsdaten werden als Dateien im JSON-Format gespeichert. Diese Dateien können zwischen Geräten ausgetauscht werden.
Speicherort der Verbindungsdateien
Windows:
C:\Users\[Benutzername]\AppData\Local\Packages\[App-Package]\LocalState\
Android:
- Öffnen Sie den Ordner "Download" und "unitop MDE".
Verbindungsdatei vom Quellgerät übertragen
Öffnen Sie die Geräteinformationen und wählen Sie "In Datei exportieren".
Wählen Sie "unitop MDE Ordner öffnen" und kopieren Sie die gewünschte
.mdecon-Datei.
- Übertragen Sie die Datei auf das Zielgerät.
Die Verbindungsdateien sind im JSON-Format und haben die Dateiendung .mdecon.
Verbindungsdatei in Zielgerät importieren
Kopieren Sie die
.mdecon-Datei in das Arbeitsverzeichnis (="Geräteinformationen" → "unitop MDE Ordner öffnen") der App auf dem Zielgerät.Starten Sie die MDE-App neu.
Die Verbindung erscheint automatisch in der Verbindungsliste.
Bearbeiten Sie die Verbindung und geben Sie das Passwort neu ein.
Hinweis
Passwörter werden aus Sicherheitsgründen nicht in der Datei gespeichert und müssen nach dem Import neu eingegeben werden.
Troubleshooting und häufige Probleme
Verbindungsangaben unvollständig
Wenn eine Verbindung unvollständig angelegt und gespeichert wurde, kann keine Verbindung zu Business Central hergestellt werden. Die App kennzeichnet solche Verbindungen visuell im Hauptbildschirm durch eine rote Hinterlegung und den Status "UNVOLLSTÄNDIG". Dies weist darauf hin, dass wichtige Parameter fehlen oder ungültig sind.
Verbindung kann nicht hergestellt werden
Problem: Nach Eingabe aller Daten und Klick auf "Mandant laden" erhalten Sie eine Fehlermeldung.
Lösungsansätze:
- URL-Test im Browser: Testen Sie die Webservice-URL in einem Browser.
- Zugangsdaten prüfen: Überprüfen Sie Benutzername und Passwort in BC.
- Netzwerkverbindung: Stellen Sie sicher, dass das Gerät Internetzugang hat.
- Firewall: Prüfen Sie, ob die Verbindung durch eine Firewall blockiert wird.
Zertifikatsprobleme (HTTPS)
Problem: Bei HTTPS-Verbindungen erscheinen Zertifikatsfehler.
Mögliche Ursachen:
- Zertifikat ist abgelaufen
- Zertifikat ist selbstsigniert und nicht vertraut
- Zertifikat stimmt nicht mit dem Hostnamen überein
- Zerttifikate sind besonders bei Android-Systemen problematisch. Das Zertifikat muss auch auf dem Gerät installierbar sein.
Lösungsansätze:
- Stellen Sie sicher, dass das Zertifikat nicht abgelaufen ist. Prüfen Sie das Zertifikat im Browser und entnehmen Sie ggf. auftretende Fehlercodes und Benachrichtigungen.
- Kontaktieren Sie Ihren Administrator oder Infrastruktur-Team.
- Lassen Sie das Zertifikat erneuern oder ein gültiges Zertifikat installieren.
Mandanten können nicht geladen werden
Problem: Der Button "Mandant laden" führt keine Aktion aus oder zeigt keine Mandanten an.
Lösungsansätze:
- Überprüfen Sie die Authentifizierungsdaten.
- Stellen Sie sicher, dass der Benutzer Zugriff auf die Mandanten hat.
- Testen Sie die Verbindung über den Browser.
Fehlermeldung "401 Unauthorized"
Problem: Sie erhalten den HTTP-Status-Code 401.
Bedeutung: Authentifizierung fehlgeschlagen.
Lösungsansätze:
- Benutzername oder Passwort ist falsch → Korrigieren Sie die Zugangsdaten.
- Benutzer ist in BC gesperrt → Kontaktieren Sie den BC-Administrator.
- Passwort ist abgelaufen → Setzen Sie das Passwort in BC zurück.
- URL-Suffix fehlt oder ist fehlerhaft → Prüfen Sie, ob ein URL-Suffix erforderlich ist (siehe unten).
Mandanten werden nicht geladen
Problem: Die Mandanten können nicht geladen werden und Sie erhalten die Fehlermeldung "401 Unauthorized". Beim Test der Webservice-URL im Browser werden Sie trotz Eingabe der korrekten Anmeldedaten in einer Endlosschleife aufgefordert, sich anzumelden.
Mögliche Ursache: Das URL-Suffix ist nicht oder fehlerhaft eingetragen.
Lösungsansätze:
- Rufen Sie die Verbindungseinrichtung auf.
- Ergänzen und prüfen Sie das "URL-Suffix"Kontaktieren Sie Ihren unitop Berater oder BC-Administrator, um das korrekte URL-Suffix zu erhalten.
- Öffnen Sie die Verbindungseinrichtung und tragen Sie das URL-Suffix im entsprechenden Feld ein.
- Speichern Sie die Verbindung und laden Sie die Mandanten erneut.
Hinweis
Das URL-Suffix ist ein Query-Parameter, der für bestimmte Konfigurationen erforderlich ist. Ohne das korrekte Suffix kann die Authentifizierung nicht erfolgreich durchgeführt werden, auch wenn die Zugangsdaten korrekt sind.
Verbindung funktioniert, aber keine Prozesse verfügbar
Problem: Die Verbindung wird hergestellt, aber nach der Anmeldung erscheinen keine Prozesse oder eine leere Maske.
Mögliche Ursachen:
- Business Central-seitige Einrichtung ist unvollständig
- Keine Prozesse für den angemeldeten Benutzer konfiguriert
- Fehlende Berechtigungen in BC
Lösungsansätze:
Prüfen Sie die MDE Einrichtung in Business Central.
Stellen Sie sicher, dass die korrekte Codeunit für den Webservice aktiviert ist.
Der MDE Designer in BC muss aufrufbar und eingerichtet sein.
- Für den Fall, dass Sie einen unerwarteten Designer angezeigt bekommen: In der MDE Einrichtung gibt es ein Feld namens „Erster Designer“. Dieses Feld ermöglicht die Zuordnung eines abweichenden MDE Design Kopfs zur Sortierung 2 . Geben Sie hier den gewünschten Designer Code ein, der als Default Designer verwendet werden soll.
Kontaktieren Sie Ihren unitop Berater oder Administrator.