dox42
Il connettore Dox42 fornisce una connessione all'API REST dox42 molto estesa e consente di generare automaticamente documenti in un flusso con dati provenienti da tutte le origini, ad esempio D365, SharePoint o altri.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Supporto per dox42 |
| URL | https://www.dox42.com/Contact |
| support@dox42.com |
| Metadati del connettore | |
|---|---|
| Editore | dox42 |
| Sito web | https://www.dox42.com/ |
| Informativa sulla privacy | https://www.dox42.com/Privacy |
| Categorie | Contenuto e file; Dati |
dox42 offre un'API REST potente e molto estesa. Usando dox42 è possibile generare automaticamente documenti con dati da tutte le origini, ad esempio D365, SharePoint, SAP o altri. dox42 usa l'ID Microsoft Entra per l'autenticazione. Restituire il documento in qualsiasi formato, archiviarlo in SharePoint, inviarlo tramite posta elettronica, firmarlo elettronicamente, allegarlo come nota a un'entità e così via... tutto ciò è possibile automaticamente con dox42.
Prerequisiti
Per procedere, è necessario quanto segue:
- Un piano di Microsoft Power Apps o Power Automate
- Microsoft Entra ID
- Conoscenza HTTP
- una licenza dox42 (dox42 Online o dox42 Server + dox42 Word/Excel/Componenti aggiuntivi PowerPoint)
- Applicazione dox42 Server Designer (versione 1.0.1.4 o successiva)
- SharePoint Online
Come ottenere le credenziali
Registrare un'applicazione Microsoft Entra ID per il connettore Premium
È prima necessario registrare dox42 come applicazione in Microsoft Entra ID. In questo modo il connettore potrà identificarsi con Microsoft Entra ID in modo che possa richiedere le autorizzazioni per accedere ai dati per conto dell'utente finale. Per altre informazioni, vedere qui
Questa applicazione Microsoft Entra ID deve essere registrata nel portale di Azure (https://portal.azure.com), seguendo i passaggi descritti nel capitolo 6 della documentazione dell'ID Microsoft Entra2 dox42: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. Non dimenticare di aggiungere quanto segue come URI di risposta Web all'applicazione: https://global.consent.azure-apim.net/redirect
A questo punto, è disponibile un'applicazione valida di Microsoft Entra ID che può essere usata per ottenere le autorizzazioni dagli utenti finali e accedere alla generazione di documenti Dox42. Il passaggio successivo consiste nel modificare il connettore Premium.
Generare token di accesso e ID esternamente o nei flussi
Metodo 1
- Usando Postman o qualsiasi altro strumento di test dell'API, è possibile generare token di accesso e token ID di Microsoft Entra ID
- È quindi possibile incollare la chiave di accesso nel rispettivo campo "Bearer Access Token" del connettore Dox42
Metodo 2 (scelta consigliata)
- Nei flussi usare il connettore HTTP Premium per generare token di accesso o ID
- Con "Compose" è quindi possibile salvare il token in una variabile che può essere usata nel campo dox42 Connector "Bearer Access Token"
Per entrambi i metodi è possibile fare riferimento a questi articoli:
Recommendations
È consigliabile usare la funzionalità "Secure Inputs/Output" nei flussi in modo che nessuna informazione sensibile sia visibile come testo non crittografato. Inoltre, Azure Key Vault può essere usato per archiviare segreti, password e così via e integrarli facilmente nei flussi.
Introduzione al connettore
Per chiamare la generazione di documenti dox42, inserire una stringa di query generata nell'applicazione Dox42 Server Designer durante la progettazione del flusso. Per altre informazioni, vedere la documentazione del connettore personalizzato dox42: https://www.dox42.com/Download/dox42_dox42Connector.pdf
Un esempio per tale stringa di query è:
Operation=GenerateDocument&DocTemplate=c%3A%5Cdox42Server%5Ctemplates%5CHelloWorldTest%5CHelloWorld.docx&InputParam.name=World&ReturnAction.Format=txt&
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Token di accesso di connessione | securestring | Accesso al bearer o token ID per l'autenticazione con ID Entra di Microsoft |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Dox42 Service Call |
Chiamare il servizio Dox42 |
Dox42 Service Call
Chiamare il servizio Dox42
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome di dominio del server Dox42 configurato
|
domainname | True | string |
Nome di dominio |
|
Parte della query della chiamata al servizio Dox42 desiderata
|
querystring | True | string |
Stringa di query di chiamata al servizio |
|
Token di accesso di connessione
|
token | True | string |
Bearer Access Token for Microsoft Entra ID Authentication |
|
Intestazione di accettazione di base, lasciare così come è!
|
accept | string |
Intestazione accept di base |