DQE One – Paketeinrichtung auf PowerApps / Dynamics

Support DQE
Support DQE
  • Aktualisiert

DQE One – Paketeinrichtung auf PowerApps / Dynamics

Überblick

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

Echtzeit-Validierungsablauf:

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

Standalone-Integrationsablauf:

Dynamics 365 (Standalone tab / iframe)  ⟶  DQE Standalone (External server, URL configured in DataQ Settings)
  • Echtzeit-Validierung: Die PCF-Komponenten auf den Formularen Account, Contact und Lead rufen die DQE-Webservices (Adresse, E-Mail, Telefon, Vorname, Unternehmen) über benutzerdefinierte Dynamics-APIs auf. Die Validierung erfolgt inline, während der Benutzer tippt.
  • Standalone-Integration: Ein dedizierter Tab in der DQE-Navigation lädt eine externe DQE-Anwendung in einem iframe. Die Dynamics-Umgebungs-URL wird als Parameter (?dynamics_org=…) übergeben, um einen bidirektionalen Kontext zu ermöglichen.

1. Zugriffseinrichtung

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

Rolle Beschreibung
DQE – Data Administrator Vollständiger Zugriff auf die DQE-Konfiguration und alle DQE-Entitäten. Erforderlich für Administratoren, die die Lösung konfigurieren (DataQ Settings, Feldzuordnungen, Ländertabelle).
DQE – User Endbenutzerzugriff, der erforderlich ist, um die DQE-Validierungsfunktionen auf Dynamics-Formularen zu nutzen. Weisen Sie diese Rolle allen Benutzern zu, die mit Account-, Contact- oder Lead-Formularen arbeiten.
DQE – Unify Application User Nicht-interaktive Anwendungsbenutzerrolle. Gewährt vollständigen Lese-/Schreibzugriff auf Account-, Contact-, Lead- und DQE-Entitäten einschließlich der Merge-Berechtigung. Erforderlich, wenn die DQE Standalone-Anwendung über einen Anwendungsbenutzer auf Dynamics-Daten zugreift.

1.1 Rollenzuweisung

  • DQE-Administrator: weisen Sie die Rolle DQE – Data Administrator zu.
  • Endbenutzer (Formulare): weisen Sie die Rolle DQE – User zu.
  • Standalone-Anwendungsbenutzer: weisen Sie die Rolle DQE – Unify Application User zu.
  1. Rufen Sie das Power Platform admin center auf → 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. Öffnen Sie im Azure portal den Bereich 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. Bewahren Sie diese für die nächsten Schritte auf.
  3. Rufen Sie API permissions → Add a permission → Microsoft APIs → Dynamics CRM auf. Wählen Sie user_impersonation aus und klicken Sie auf Add permissions.
  4. Rufen Sie Manage → Authentication (Preview) auf und klicken Sie auf + Add Redirect URL. Wählen Sie den Typ Web aus und geben Sie anschließend 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, Application (client) ID und Client Secret an einem sicheren Ort auf – sie werden für §1.3 und §2.5 benötigt.

1.3 Anwendungsbenutzer (S2S)

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

  1. Wählen Sie im Power Platform admin center die Zielumgebung aus und rufen Sie Settings → Users → Application users → New app user auf.
  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 eine Business Unit aus (optional) und klicken Sie auf Create.
  4. Öffnen Sie den neu erstellten Anwendungsbenutzer, klicken Sie auf Edit security roles und weisen Sie die folgenden Rollen zu: DQE – Unify Application User, DQE – Data Administrator, DQE – User. Klicken Sie auf Save.

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-Dynamics Sales- oder Power Apps-Umgebung installiert sein, bevor mit einer der folgenden Konfigurationen fortgefahren wird.

2.2 Lizenzaktivierung

Geben Sie den Lizenzschlüssel ein und aktivieren Sie die im Kundenvertrag enthaltenen Webservices.

  1. Geben Sie unter DQE DataQ Settings → General den von Ihrem DQE-Projektmanager bereitgestellten DQE Licence-Schlüssel ein.
  2. Setzen Sie jedes abonnierte Produkt auf Yes. Aktivieren Sie nur das, was im Kundenvertrag enthalten ist:
Schalter Beschreibung
Enable Address Autocomplete Aktiviert das Dropdown für Adressvorschläge
Enable Address Validation (RNVP) Aktiviert den RNVP-Validierungsdialog beim Speichern
Enable Email Validation Aktiviert die E-Mail-Validierung
Enable Phone Validation Aktiviert die Telefonvalidierung
Enable Firstname Validation Aktiviert Vorschläge für Vor-/Nachname
Enable Company Verification Aktiviert B2B-Vorschläge und -Überprüfung
  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 aufzurufen (Adresse, E-Mail, Telefon, Name, Unternehmen).

Einstellung Wert
API URL address Geben Sie die von Ihrem DQE-Projektmanager bereitgestellte DQE-Server-URL ein.
  1. Suchen Sie unter DQE DataQ Settings → General das Feld API URL address.
  2. Geben Sie die von Ihrem DQE-Projektmanager bereitgestellte URL ein.
  3. Klicken Sie auf Save & Close.

Hinweis: Die in früheren Versionen des Pakets 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 Standalone-Tabs der DQE-Navigation angezeigt.

Einstellung Wert
Standalone URL Geben Sie die von Ihrem DQE-Projektmanager bereitgestellte URL der DQE Standalone-Anwendung ein.
  1. Suchen Sie unter DQE DataQ Settings → General das Feld Standalone URL.
  2. Geben Sie die von Ihrem DQE-Projektmanager bereitgestellte URL ein.
  3. Klicken Sie auf Save & Close.
  4. Navigieren Sie zum Standalone-Tab in der DQE-Anwendung, um zu überprüfen, ob der iframe korrekt geladen wird. Ist die URL nicht erreichbar, wird eine Zugänglichkeitswarnung mit der Option angezeigt, die URL 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 innerhalb des iframe. Stellen Sie sicher, dass die 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-Anmeldeinformation hinzufügen. Diese Anmeldedaten werden von Ihrem DQE-Projektmanager bereitgestellt und entsprechen einer Azure AD-Anwendung, die in Ihrem Tenant registriert ist.

  1. Melden Sie sich bei der DQE Standalone-Anwendung an.
  2. Öffnen Sie das User Profile und navigieren Sie zum Bereich Credentials.
  3. Klicken Sie auf New und wählen Sie Microsoft Dynamics als Connector-Typ aus.
  4. Füllen Sie die vier erforderlichen Felder aus:
Feld Wert
Tenant Azure Active Directory-Tenant-ID.
Client Id Application (client) ID der Azure AD-App-Registrierung.
Client Secret Für die App-Registrierung generiertes Client Secret.
Scope Ihre Dynamics-Umgebungs-URL, z. B. https://yourorg.crm.dynamics.com.
  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: Dem mit dieser Anmeldeinformation verknüpften Dynamics-Anwendungsbenutzer muss im Power Platform admin center die Sicherheitsrolle DQE – Unify Application User zugewiesen sein.

Sobald das Paket konfiguriert ist, richten Sie jeden Webservice einzeln im Formular-Editor ein. Siehe Konfiguration von Adresse, E-Mail, Telefon und B2B-Validierung in Dynamics.

Verknüpfung mit

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich