DQE One – Paketeinrichtung auf PowerApps / Dynamics

Überblick

Das DQE One Dynamics-Paket arbeitet in zwei sich ergänzenden Modi:

Echtzeit-Validierungsfluss:

Dynamics 365 (PCF controls on forms)  ⟷  DQE Plugin (Custom API backend)  ⟶  DQE API (Webservices)

Standalone-Integrationsfluss:

Dynamics 365 (Standalone tab / iframe)  ⟶  DQE Standalone (External server, URL configured in DataQ Settings)

• Echtzeit-Validierung: PCF-Komponenten auf den Formularen Account, Contact und Lead rufen DQE-Webservices (Address, Email, Phone, First Name, Company) über Dynamics Custom APIs auf. Die Validierung erfolgt bereits während der Eingabe.
• Standalone-Integration: ein eigener Tab in der DQE-Navigation lädt eine externe DQE-Anwendung in einem iframe. Die URL der Dynamics-Umgebung wird als Parameter (?dynamics_org=…) übergeben, um einen bidirektionalen Kontext zu ermöglichen.

1. Zugriffs-Einrichtung

Das DQE-Paket enthält drei Sicherheitsrollen. Weisen Sie diese entsprechend den Aufgaben der jeweiligen Benutzer zu.

1.1 Rollenzuweisung

• DQE-Administrator: weisen Sie DQE - Data administrator zu.
• Endbenutzer (Formulare): weisen Sie DQE - User zu.
• Standalone-Anwendungsbenutzer: weisen Sie DQE - Unify Application User zu.

1. Gehen Sie zum Power Platform admin center → wählen Sie die Zielumgebung aus.
2. Navigieren Sie zu Security roles, suchen Sie die DQE-Rolle und weisen Sie sie den entsprechenden Benutzern zu.
3. Klicken Sie auf Save.

1.2 Azure-App-Registrierung

Das DQE-Standalone-Modul (Unify) authentifiziert sich gegenüber Dynamics über eine Azure Active Directory-Anwendung. Registrieren Sie diese Anwendung in Ihrem Azure-Tenant, bevor Sie den Dynamics-Anwendungsbenutzer erstellen.

1. Gehen Sie im Azure-Portal zu Azure Active Directory → App registrations → New registration. Geben Sie einen Namen ein (z. B. DQE One) und klicken Sie auf Register.
2. Kopieren Sie auf der Overview-Seite die Application (client) ID und die Directory (tenant) ID. Heben Sie diese für die nächsten Schritte auf.
3. Gehen Sie zu Manage → Certificates & secrets, klicken Sie auf + New client secret, fügen Sie eine Beschreibung und ein Ablaufdatum hinzu und klicken Sie dann auf Add. Kopieren Sie den Value des Secrets sofort — Azure zeigt ihn nur einmal an.
4. Optional — gehen Sie zu API permissions → Add a permission → Microsoft APIs → Dynamics CRM. Wählen Sie user_impersonation aus und klicken Sie auf Add permissions. Dieser Schritt ist nicht erforderlich — siehe den Hinweis unten.
5. Gehen Sie zu Manage → Authentication (Preview) und klicken Sie auf + Add Redirect URL. Wählen Sie den Typ Web und geben Sie im Feld Redirect URL Ihre ACI-URL mit dem Suffix /dynamics/code ein:
   https://<your-aci-url>/dynamics/code

Hinweis: bewahren Sie die Directory (tenant) ID, die Application (client) ID und das Client Secret sicher auf — sie werden für §1.3 und §2.5 benötigt.

Hinweis: die oben genannte Berechtigung user_impersonation ist für den in §1.3 beschriebenen Anwendungsbenutzer-Flow (S2S) nicht erforderlich. Der Dataverse-Zugriff des Anwendungsbenutzers wird ausschließlich über seine Sicherheitsrolle (DQE - Unify Application User) gesteuert, nicht über diese Azure-AD-API-Berechtigung. Wenn die Sicherheitsrichtlinie Ihrer Organisation die Vergabe delegierter API-Berechtigungen einschränkt, können Sie diesen Schritt überspringen — eine App-Registrierung mit nur der Standardberechtigung User.Read für Microsoft Graph funktioniert einwandfrei. Weitere Details finden Sie im Artikel Rollen und Berechtigungen von DQE One in Dynamics.

1.3 Anwendungsbenutzer (S2S)

Erstellen Sie einen nicht interaktiven Server-zu-Server-Anwendungsbenutzer (S2S) in der Ziel-Dynamics-Umgebung und weisen Sie ihm die erforderlichen DQE-Rollen zu.

1. Wählen Sie im Power Platform admin center die Zielumgebung aus und gehen Sie zu Settings → Users → Application users → New app user.
2. Klicken Sie auf Add an app und fügen Sie die in §1.2 erhaltene Client ID ein. Wählen Sie die Anwendung aus der Liste aus und klicken Sie auf Add.
3. Wählen Sie optional eine Business Unit aus und klicken Sie auf Create.
4. Öffnen Sie den neu erstellten Anwendungsbenutzer, klicken Sie auf Edit security roles und weisen Sie folgende Rollen zu: DQE - Unify Application User, DQE - Data administrator, DQE - User. Klicken Sie auf Save.

Eine allgemeinverständliche Erklärung, warum sowohl die Azure App Registration (§1.2) als auch dieser Anwendungsbenutzer (§1.3) erforderlich sind, finden Sie unter Azure App Registration vs Dynamics Application User (S2S).

2. Konfiguration

Die gesamte Konfiguration erfolgt in DQE DataQ Settings, erreichbar über die Navigation der DQE-Anwendung (Parameters → DQE DataQ Settings). Die Navigation leitet automatisch zum einzigen Konfigurationsdatensatz weiter.

2.1 Paketinstallation

Die verwaltete Lösung DQE One muss in der Ziel-Umgebung (Dynamics Sales oder Power Apps) installiert sein, bevor Sie mit einer der folgenden Konfigurationen fortfahren.

2.2 Lizenzaktivierung

Geben Sie den Lizenzschlüssel ein und aktivieren Sie die im Vertrag des Kunden enthaltenen Webservices.

1. Geben Sie unter DQE DataQ Settings → General den von Ihrem DQE-Projektleiter bereitgestellten DQE Licence-Schlüssel ein.
2. Setzen Sie jedes abonnierte Produkt auf Yes. Aktivieren Sie nur, was im Vertrag des Kunden enthalten ist:

1. Klicken Sie auf Save & Close.

2.3 API-URL

Die DQE-API-URL ist die Adresse des DQE-Webservice-Servers. Sie wird von den Dynamics-Backend-Plugins verwendet, um die Validierungs-APIs (Adresse, E-Mail, Telefon, Name, Unternehmen) aufzurufen.

1. Suchen Sie unter DQE DataQ Settings → General das Feld Adresse de l'API DQE (dieses Feld ist unerwarteterweise auch in englisch-/deutschsprachigen Organisationen auf Französisch beschriftet — ein bekanntes Problem der Produktbeschriftung, kein Fehler Ihrerseits).
2. Geben Sie die von Ihrem DQE-Projektleiter bereitgestellte URL ein.
3. Klicken Sie auf Save & Close.

Hinweis: die in früheren Paketversionen vorhandene Entität DQE Metadata wurde entfernt. Die API-URL wird jetzt direkt in DataQ Settings verwaltet.

2.4 Standalone-URL

Die Standalone-URL verweist auf die externe DQE-Standalone-Anwendung. Sie wird in einem iframe innerhalb des Tabs Standalone der DQE-Navigation angezeigt.

1. Suchen Sie unter DQE DataQ Settings → General das Feld Standalone URL.
2. Geben Sie die von Ihrem DQE-Projektleiter bereitgestellte URL ein.
3. Klicken Sie auf Save & Close.
4. Gehen Sie zum Tab Standalone der DQE-Anwendung, um zu prüfen, ob das iframe korrekt lädt. Ist die URL nicht erreichbar, wird ein Erreichbarkeits-Hinweis mit der Möglichkeit angezeigt, die URL direkt inline zu bearbeiten.

Wichtig: die Standalone-URL muss vom Browser des Benutzers aus öffentlich erreichbar sein. Sie wird nicht serverseitig aufgerufen — der Browser lädt sie direkt im iframe. Stellen Sie sicher, dass CORS- und Firewall-Regeln den Zugriff aus den Netzwerken der Dynamics-Benutzer zulassen.

2.5 Standalone-Anmeldedaten

Um die Standalone-Anwendung mit Ihrer Dynamics 365-Umgebung zu verbinden, müssen Sie direkt in der Standalone-Oberfläche eine Dynamics-Anmeldedaten hinzufügen. Diese Anmeldedaten werden von Ihrem DQE-Projektleiter bereitgestellt und entsprechen einer in Ihrem Tenant registrierten Azure-AD-Anwendung.

1. Melden Sie sich bei der DQE-Standalone-Anwendung an.
2. Öffnen Sie User Profile und navigieren Sie zum Bereich Credentials.
3. Klicken Sie auf New und wählen Sie Microsoft Dynamics als Verbindungstyp aus.
4. Füllen Sie die vier erforderlichen Felder aus:

1. Klicken Sie auf Log In. Der Standalone-Server authentifiziert sich gegenüber Dynamics und speichert die Anmeldedaten für die zukünftige Verwendung.

Hinweis: der mit dieser Anmeldedaten verknüpfte Dynamics-Anwendungsbenutzer muss im Power Platform admin center die Sicherheitsrolle DQE - Unify Application User zugewiesen haben.

Sobald das Paket konfiguriert ist, fahren Sie mit der individuellen Einrichtung jedes Webservice im Formular-Editor fort. Siehe Configure address, email, phone, name and B2B validation in Dynamics.