dox42

El conector dox42 proporciona una conexión a la API REST dox42 muy extensa y le permite generar documentos automáticamente en un flujo con datos de todos los orígenes, como D365, SharePoint u otros.

Este conector está disponible en los siguientes productos y regiones:

dox42 proporciona una API REST eficaz y muy extensa. Con dox42, puede generar automáticamente documentos con datos de todos los orígenes, como D365, SharePoint, SAP u otros. dox42 usa microsoft Entra ID para la autenticación. Devolver el documento en cualquier formato, almacenarlo en SharePoint, enviarlo por correo electrónico, firmar electrónicamente, adjuntarlo como una nota a una entidad, etc... todo eso es posible automáticamente con dox42.

Prerrequisitos

Necesitará lo siguiente para continuar:

• Un plan de Microsoft Power Apps o Power Automate
• Microsoft Entra ID
• Conocimientos http
• una licencia dox42 (dox42 Online o dox42 Server + dox42 Word/Excel/PowerPoint Add-ins)
• Aplicación del Diseñador de servidores dox42 (versión 1.0.1.4 o posterior)
• SharePoint Online

Obtención de credenciales

Registro de una aplicación de Microsoft Entra ID para el conector Premium

En primer lugar, es necesario registrar dox42 como una aplicación en el identificador de Entra de Microsoft. Esto permitirá que el conector se identifique a sí mismo con el identificador de Entra de Microsoft para que pueda solicitar permisos para acceder a los datos en nombre del usuario final. Puede leer más sobre esto aquí.

Esta aplicación de id. de Microsoft Entra debe registrarse en Azure Portal (https://portal.azure.com), siguiendo los pasos descritos en el capítulo 6 de la documentación de id. de Microsoft Entra de dox42: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. No olvide agregar lo siguiente como URI de respuesta web a la aplicación: https://global.consent.azure-apim.net/redirect

En este momento, tenemos una aplicación de id. de Microsoft Entra válida que se puede usar para obtener permisos de los usuarios finales y acceder a la generación de documentos dox42. El siguiente paso para nosotros es modificar el conector Premium.

Generar tokens de acceso e identificador externamente o en los flujos

• Método 1

  • Con Postman o cualquier otra herramienta de prueba de API, puede generar tokens de acceso de Id. de Microsoft Entra y tokens de identificador.
  • A continuación, puede pegar dicha clave de acceso en el campo correspondiente "Token de acceso de portador" del conector dox42.

• Método 2 (recomendado)

  • En los flujos, use el conector HTTP Premium para generar tokens de acceso o identificador.
  • Con "Compose", puede guardar el token en una variable que se puede usar en el campo "Token de acceso de portador" del conector dox42.

• Para ambos métodos, puede consultar estos artículos:

  • https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
  • https://docs.microsoft.com/en-us/azure/databricks/dev-tools/api/latest/aad/app-aad-token

Recommendations

Se recomienda encarecidamente usar la funcionalidad "Entradas seguras/salida" en los flujos, por lo que no hay información confidencial visible como texto no cifrado. Además, Azure Key Vault se puede usar para almacenar secretos, contraseñas, etc. y así sucesivamente se integra fácilmente en los flujos.

Introducción al conector

• Para llamar a la generación de documentos dox42, inserte una cadena de consulta generada en la aplicación diseñador de servidores dox42 al diseñar el flujo. Para más información, siga nuestra documentación del conector personalizado dox42: https://www.dox42.com/Download/dox42_dox42Connector.pdf

• Un ejemplo de esta cadena de consulta es:

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

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Acciones

Llamada de servicio dox42