dox42
Der dox42-Connector stellt eine Verbindung mit der sehr umfangreichen Dox42-REST-API bereit und ermöglicht es Ihnen, Automatisch Dokumente in einem Fluss mit Daten aus allen Quellen zu generieren, z. B. D365, SharePoint oder andere.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | dox42-Unterstützung |
| URL | https://www.dox42.com/Contact |
| support@dox42.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | dox42 |
| Webseite | https://www.dox42.com/ |
| Datenschutzrichtlinie | https://www.dox42.com/Privacy |
| Kategorien | Inhalt und Dateien; Daten |
dox42 bietet eine leistungsstarke und sehr umfangreiche REST-API. Mithilfe von Dox42 können Sie Dokumente automatisch mit Daten aus allen Quellen generieren, z. B. D365, SharePoint, SAP oder andere. dox42 verwendet Microsoft Entra-ID für die Authentifizierung. Geben Sie Ihr Dokument in einem beliebigen Format zurück, speichern Sie es in SharePoint, senden Sie es per E-Mail, signieren Sie es elektronisch, fügen Sie es als Notiz an eine Entität an, usw. all dies ist automatisch mit dox42 möglich.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Microsoft Power Apps- oder Power Automate-Plan
- Microsoft Entra ID
- HTTP-Kenntnisse
- eine Dox42-Lizenz (dox42 Online oder dox42 Server + dox42 Word/Excel/PowerPoint-Add-Ins)
- dox42 Server Designer-Anwendung (Version 1.0.1.4 oder höher)
- SharePoint Online
So erhalten Sie Anmeldeinformationen
Registrieren einer Microsoft Entra ID-Anwendung für Ihren Premium-Connector
Zunächst müssen wir dox42 als Anwendung in der Microsoft Entra-ID registrieren. Dadurch kann der Connector sich selbst mit der Microsoft Entra-ID identifizieren, sodass er berechtigungen für den Zugriff auf Ihre Daten im Auftrag des Endbenutzers anfordern kann. Weitere Informationen hierzu finden Sie hier
Diese Microsoft Entra-ID-Anwendung muss im Azure-Portal () registriert werden,https://portal.azure.com indem Sie die in Kapitel 6 der Dokumentation zu dox42 Microsoft Entra ID beschriebenen Schritte ausführen: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf Vergessen Sie nicht, Folgendes als Webantwort-URI zu Ihrer Anwendung hinzuzufügen: https://global.consent.azure-apim.net/redirect
An diesem Punkt verfügen wir über eine gültige Microsoft Entra-ID-Anwendung, die verwendet werden kann, um Berechtigungen von Endbenutzern zu erhalten und auf dox42-Dokumentgenerierung zuzugreifen. Der nächste Schritt für uns besteht darin, den Premium-Connector zu ändern.
Generieren von Zugriffs- und ID-Token extern oder in Ihren Flüssen
Methode 1
- Mithilfe von Postman oder einem anderen API-Testtool können Sie Microsoft Entra ID-Zugriffstoken und ID-Token generieren.
- Sie können dann die besagte Zugriffstaste in das entsprechende Feld "Bearer-Zugriffstoken" des dox42 Connectors einfügen.
Methode 2 (empfohlen)
- Verwenden Sie in Ihren Flüssen den HTTP Premium-Connector, um Zugriffs- oder ID-Token zu generieren.
- Mit "Verfassen" können Sie das Token dann in einer Variablen speichern, die im Feld "dox42 Connector "Bearer Access Token" verwendet werden kann.
Für beide Methoden können Sie sich auf die folgenden Artikel beziehen:
Recommendations
Es wird dringend empfohlen, die Funktion "Sichere Eingaben/Ausgabe" in Ihren Flüssen zu verwenden, sodass keine vertraulichen Informationen als Klartext sichtbar sind. Darüber hinaus kann Azure Key Vault verwendet werden, um Geheime, Kennwörter usw. in Ihren Flüssen zu speichern und so weiter zu integrieren.
Erste Schritte mit Ihrem Connector
Zum Aufrufen der Dox42-Dokumentgenerierung fügen Sie beim Entwerfen des Flusses eine abfragezeichenfolge ein, die in der Dox42 Server Designer-Anwendung generiert wird. Weitere Informationen hierzu folgen der dokumentation zu benutzerdefinierten dox42-Connectors: https://www.dox42.com/Download/dox42_dox42Connector.pdf
Ein Beispiel für eine solche Abfragezeichenfolge ist:
Operation=GenerateDocument&DocTemplate=c%3A%5Cdox42Server%5Ctemplates%5CHelloWorldTest%5CHelloWorld.docx&InputParam.name=World&ReturnAction.Format=txt&
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Bearer-Zugriffstoken | securestring | Bearer-Zugriffs- oder ID-Token für die Microsoft Entra ID-Authentifizierung |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| dox42-Dienstaufruf |
Aufrufen des Dox42-Diensts |
dox42-Dienstaufruf
Aufrufen des Dox42-Diensts
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Der Domänenname Des konfigurierten dox42-Servers
|
domainname | True | string |
Domänenname |
|
Abfrageteil des gewünschten Dox42-Dienstaufrufs
|
querystring | True | string |
Abfragezeichenfolge für Dienstaufrufe |
|
Bearer-Zugriffstoken
|
token | True | string |
Bearer-Zugriffstoken für die Microsoft Entra ID-Authentifizierung |
|
Einfaches Akzeptieren von Kopfzeilen, Belassen wie es ist!
|
accept | string |
Standardakzepterheader |