dox42

  • Reference

The dox42 connector provides a connection to the very extensive dox42 REST API and allows you to automatically generate documents in a flow with data from all sources, like D365, SharePoint or others.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name dox42 Support
URL https://www.dox42.com/Contact
Email support@dox42.com
Connector Metadata
Publisher dox42
Website https://www.dox42.com/
Privacy Policy https://www.dox42.com/Privacy
Categories Content and Files;Data

dox42 provides a powerful and very extensive REST API. Using dox42 you can automatically generate documents with data from all sources, like D365, SharePoint, SAP or others. dox42 uses Azure Active Directory for authentication. Return your document in any format, store it on SharePoint, send it by email, sign electronically, attach it as a note to an entity, etc... all of that is possible automatically with dox42.

Prerequisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan
  • Azure Active Directory
  • HTTP knowledge
  • a dox42 license (dox42 Online or dox42 Server + dox42 Word/Excel/PowerPoint Add-ins)
  • dox42 Server Designer application (Version 1.0.1.4 or later)
  • SharePoint Online

How to get credentials

Register an Azure AD application for your premium connector

We first need to register dox42 as an application in Azure AD. This will allow the connector to identify itself to Azure AD so that it can ask for permissions to access your data on behalf of the end user. You can read more about this here

This Azure AD application has to be registered in Azure Portal (https://portal.azure.com), by following the steps outlined in chapter 6 of the dox42 AAD Documentation: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. Don't forget to add the following as Web Reply URI to your application: https://global.consent.azure-apim.net/redirect

At this point, we have a valid Azure AD application that can be used to get permissions from end users and access dox42 document generation. The next step for us is to modify the premium connector.

Generate Access and ID Tokens externally or in your flows

Recommendations

We highly recommend using the "Secure Inputs/Output" functionality in your flows so no sensitive information is visible as clear text. Additionally, Azure Key Vault can be used to store secrets, passwords and so on and easily integrates in your flows.

Getting started with your connector

  • For calling the dox42 document generation, insert a query string generated in the dox42 Server Designer application, when designing your Flow. For further information follow our dox42 custom connector documentation: https://www.dox42.com/Download/dox42_dox42Connector.pdf

  • An example for such query string is:

    Operation=GenerateDocument&DocTemplate=c%3A%5Cdox42Server%5Ctemplates%5CHelloWorldTest%5CHelloWorld.docx&InputParam.name=World&ReturnAction.Format=txt&

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Bearer Access Token securestring Bearer access or ID token for Azure AD authentication

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

dox42 Service Call

Call to the dox42 service

dox42 Service Call

Operation ID:
dox42_Call

Call to the dox42 service

Parameters

Name Key Required Type Description
The domain name of your configured dox42 Server
 domainname True string

Domain name
Query portion of the desired dox42 service call
 querystring True string

Service call query string
Bearer Access Token
 token True string

Bearer Access Token for Azure AD Authentication
Basic accept header, leave as is!
 accept string

Basic accept header

Returns