TemplioniX (versión preliminar)
TemplioniX es una API de generación de documentos para crear archivos DOCX y PDF a partir de plantillas de Word reutilizables. Use este conector para extraer metadatos de plantilla, generar un único documento, ejecutar generación masiva de documentos, comprobar el estado del trabajo masivo, descargar los resultados generados y ver la información de suscripción o uso.
La autenticación se realiza con una clave de API pasada.
Los vínculos de descarga masiva de ZIP generados son válidos durante 24 horas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Azure regiones de China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contact | |
|---|---|
| Nombre | Compatibilidad con TemplioniX |
| URL | https://templionix.com |
| Correo Electrónico | [email protected] |
| Metadatos del conector | |
|---|---|
| Publicador | TemplioniX |
| Sitio web | https://templionix.com |
| Directiva de privacidad | https://templionix.com/privacy-policy |
| Términos de uso | https://templionix.com/terms-of-use |
| Categories | Productividad; Contenido y archivos |
| IconBrandColor | #333A41 |
Conector templioniX
Visión general
TemplioniX es un servicio de generación de documentos que ayuda a crear archivos DOCX y PDF a partir de plantillas de Microsoft Word reutilizables y datos JSON estructurados.
Este conector permite a los usuarios conectarse Microsoft Power Automate, Power Apps, Azure Logic Apps y flujos de trabajo de Copilot Studio a la API templioniX. Los usuarios pueden extraer metadatos de plantilla, generar cargas JSON de inicio, generar documentos, ejecutar trabajos de generación masiva de documentos, comprobar el estado del trabajo, descargar los resultados generados y recuperar plantillas disponibles.
Publicador
TemplioniX
Productos Microsoft previstos
- Microsoft Power Automate
El conector se implementa como un conector personalizado Microsoft Power Platform y puede usarse en otras experiencias del conector de Microsoft en las que se admiten conectores certificados.
Autenticación
El conector usa la autenticación de clave de API. La clave de API se pasa en el encabezado de x-functions-key solicitud.
Los usuarios deben tener una cuenta activa de TemplioniX y una clave de API válida para usar este conector.
Funcionalidades principales
Obtener plantillas
Recupera una lista paginada de plantillas de documento disponibles de TemplioniX. Esta operación se puede usar para seleccionar una plantilla antes de generar metadatos, un modelo de inicio, un único documento o un trabajo de generación masiva de documentos.
Extracción de campos de plantilla y marcadores de posición
Extrae los metadatos de una plantilla seleccionada, incluidos los campos de plantilla y los marcadores de posición. Esto ayuda a los usuarios a comprender qué datos espera la plantilla.
Generación de una carga JSON de inicio para una plantilla
Genera una carga JSON de ejemplo basada en la plantilla seleccionada. Los usuarios pueden usar esta carga como punto de partida para asignar datos de otros sistemas a una solicitud de generación de documentos.
Generación de un documento
Genera un documento DOCX o PDF a partir de una plantilla seleccionada y datos JSON de entrada.
Generación de documentos en masa
Inicia un trabajo de generación masiva de documentos mediante una plantilla seleccionada y varios registros de entrada. Los vínculos de descarga masiva de ZIP generados son válidos durante 24 horas.
Obtención del estado del trabajo de generación masiva
Recupera el estado y la información de resultados de un trabajo específico de generación de documentos masivos.
Obtención de trabajos de generación masiva por plantilla
Recupera trabajos de generación masiva asociados a una plantilla seleccionada.
Escenarios de uso comunes
- Genere contratos, facturas, propuestas, informes, cartas y otros documentos empresariales a partir de datos estructurados.
- Automatice la creación de documentos a partir de sistemas basados en CRM, ERP, forms, Excel, SharePoint, Dataverse, SQL o API.
- Cree documentos únicos a petición a partir de un flujo de trabajo.
- Genere varios documentos de forma masiva y recupere el resultado zip generado.
- Use metadatos de plantilla extraídos para comprender qué campos son necesarios para la generación de documentos.
Flujo de trabajo de ejemplo
- Desencadene un flujo manualmente o desde un evento empresarial.
- Use la operación Obtener plantillas para seleccionar una plantilla.
- Use la operación Generar una carga JSON de inicio para comprender la estructura de datos esperada.
- Asigne datos del sistema de origen a la estructura JSON generada.
- Use la operación Generar un documento para crear un archivo DOCX o PDF.
- Guarde el archivo generado en OneDrive, SharePoint, Dataverse, correo electrónico u otro destino.
Apoyo
Para obtener información sobre el producto, documentación y soporte técnico, visite:
- Sitio web: https://templionix.com
- Documentación: https://docs.templionix.com
- Soporte técnico: https://templionix.com/contact
- Directiva de privacidad: https://templionix.com/privacy-policy
- Términos de uso: https://templionix.com/terms-of-use
Notas para la revisión de certificación
Este paquete contiene la solución del conector TemplioniX y una solución de flujo de ejemplo que muestra las operaciones del conector. El conector se comunica con la API templioniX de producción y usa la autenticación de clave de API mediante el x-functions-key encabezado .
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
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.
| Nombre | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| Clave de api de TemplioniX | securestring | Clave de api de TemplioniX para esta API | True |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enumeración de trabajos de generación masiva para una plantilla |
Devuelve todos los trabajos de la partición de generación masiva donde TemplateId coincide; misma forma de carga que el estado de un solo trabajo, ordenado por hora de inicio descendente |
| Enumerar plantillas disponibles |
Devuelve una lista paginada de plantillas que se pueden usar con la extracción de metadatos, la generación de modelos y los puntos de conexión de generación de documentos. |
| Extracción de campos de plantilla y marcadores de posición |
Lee la plantilla seleccionada y devuelve los controles de contenido detectados en el documento, incluidos su título, etiqueta, tipo y valores predefinidos cuando están disponibles. |
| Generación de un documento a partir de datos de plantilla |
Combina la carga JSON proporcionada con la plantilla seleccionada y devuelve el documento generado. Se usa |
| Generación de una carga JSON de inicio para una plantilla |
Compila una estructura JSON de ejemplo que coincide con los marcadores de posición detectados en la plantilla seleccionada para que se pueda reutilizar como entrada para la generación de documentos. |
| Inicio de la generación masiva de documentos |
Inicie un trabajo masivo para generar documentos a partir de una plantilla compartida, compila un archivo ZIP con una dirección URL de SAS de lectura y realiza un seguimiento del progreso. Devuelve inmediatamente el identificador de trabajo. La dirección URL de descarga ZIP devuelta está disponible una vez completado el trabajo y es válido durante 24 horas desde el tiempo de generación. |
| Obtención del estado del trabajo de generación masiva |
Carga el estado del trabajo por identificador: status, start/end times, ZIP SAS URL when completed, orchestration error when failed, and parsed per-item generation failures. |
Enumeración de trabajos de generación masiva para una plantilla
Devuelve todos los trabajos de la partición de generación masiva donde TemplateId coincide; misma forma de carga que el estado de un solo trabajo, ordenado por hora de inicio descendente
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de plantilla
|
templateId | True | uuid |
Solo se devuelven los trabajos iniciados con este identificador de plantilla. |
Devoluciones
- response
- array of bulkGenerationJobStatusDto
Enumerar plantillas disponibles
Devuelve una lista paginada de plantillas que se pueden usar con la extracción de metadatos, la generación de modelos y los puntos de conexión de generación de documentos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Número de página
|
pageNumber | True | integer |
Índice de página basado en 1 para devolver |
|
Tamaño de página
|
pageSize | True | integer |
Número máximo de plantillas que se van a devolver en una única respuesta |
Devoluciones
Respuesta paginada basada en desplazamiento que contiene registros de plantilla.
Extracción de campos de plantilla y marcadores de posición
Lee la plantilla seleccionada y devuelve los controles de contenido detectados en el documento, incluidos su título, etiqueta, tipo y valores predefinidos cuando están disponibles.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de plantilla
|
templateId | True | uuid |
Identificador de plantilla único devuelto por el catálogo de plantillas |
Devoluciones
- response
- array of contentControlInfoDto
Generación de un documento a partir de datos de plantilla
Combina la carga JSON proporcionada con la plantilla seleccionada y devuelve el documento generado. Se usa .docx para Word salida o .pdf para la salida de PDF
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
Identificador de plantilla único |
|
|
data
|
data | object |
Objeto JSON que contiene valores para marcadores de posición de plantilla. |
|
|
Nombre del documento
|
documentName | string |
Nombre del documento generado sin extensión, a menos que la API acepte una extensión. |
|
|
Format
|
format | string |
Formato de salida. Use .docx para Word documentos o .pdf para documentos PDF. |
Devoluciones
- response
- file
Generación de una carga JSON de inicio para una plantilla
Compila una estructura JSON de ejemplo que coincide con los marcadores de posición detectados en la plantilla seleccionada para que se pueda reutilizar como entrada para la generación de documentos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de plantilla
|
templateId | True | uuid |
Identificador de plantilla único devuelto por el catálogo de plantillas |
Devoluciones
- response
- object
Inicio de la generación masiva de documentos
Inicie un trabajo masivo para generar documentos a partir de una plantilla compartida, compila un archivo ZIP con una dirección URL de SAS de lectura y realiza un seguimiento del progreso. Devuelve inmediatamente el identificador de trabajo. La dirección URL de descarga ZIP devuelta está disponible una vez completado el trabajo y es válido durante 24 horas desde el tiempo de generación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
Identificador de plantilla único |
|
|
Format
|
format | string |
Formato de salida. Usar .docx para Word documentos o .pdf para documentos PDF |
|
|
Nombre del archivo
|
fileName | string |
Nombre de archivo generado o solicitado |
|
|
items
|
items | object |
Devoluciones
Respuesta devuelta cuando se ha aceptado un trabajo de generación masiva de documentos para su procesamiento.
Obtención del estado del trabajo de generación masiva
Carga el estado del trabajo por identificador: status, start/end times, ZIP SAS URL when completed, orchestration error when failed, and parsed per-item generation failures.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de trabajo masivo
|
jobId | True | string |
Identificador de trabajo devuelto en la respuesta generateDocumentsBulk 202 ( |
Devoluciones
Detalles de estado y resultado de un trabajo de generación masiva de documentos.
Definiciones
bulkGenerationAcceptedDto
Respuesta devuelta cuando se ha aceptado un trabajo de generación masiva de documentos para su procesamiento.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. del trabajo
|
jobId | string |
Identificador único de trabajo de generación masiva. |
|
Fecha de inicio
|
startedAt | date-time |
Fecha y hora UTC en que se inició la operación. |
bulkGenerationFailureItemDto
Información sobre un elemento de documento con errores en un trabajo de generación masiva.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Índice global
|
globalIndex | string |
Índice o identificador interno del elemento generado con errores. |
|
Nombre del archivo
|
fileName | string |
Nombre de archivo generado o solicitado. |
|
Error
|
error | string |
Mensaje de error para el elemento con errores. |
bulkGenerationJobStatusDto
Detalles de estado y resultado de un trabajo de generación masiva de documentos.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. del trabajo
|
jobId | string |
Identificador único de trabajo de generación masiva. |
|
Identificador de plantilla
|
templateId | uuid |
Identificador de plantilla único. |
|
Situación
|
status | string |
Estado actual del trabajo, por ejemplo: Pendiente, En ejecución, Completado, Erróneo o ParcialmenteCompleted. |
|
Fecha de inicio
|
startedAt | date-time |
Fecha y hora UTC en que se inició la operación. |
|
Hora de finalización
|
endTime | date-time |
Fecha y hora UTC en que el trabajo finalizó. |
|
Zip Url
|
zipUrl | string |
Dirección URL de descarga temporal del archivo ZIP generado. Para la generación masiva, este vínculo es válido durante 24 horas a partir del tiempo de generación. |
|
Mensaje de error
|
errorMessage | string |
Mensaje de error de nivel de trabajo, si se produjo un error en la orquestación. |
|
failedGenerations
|
failedGenerations | array of bulkGenerationFailureItemDto |
Colección de elementos con errores dentro de un trabajo de generación masiva. |
|
Recuento de generación con errores
|
failedGenerationCount | integer |
Número de elementos con errores dentro de un trabajo de generación masiva. |
categoryDto
Información de categoría de plantilla.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | uuid |
Identificador único. |
|
name
|
name | string |
Nombre para mostrar. |
contentControlInfoDto
Metadatos de un Word control de contenido o marcador de posición detectados en una plantilla.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
title
|
title | string |
Título del control de contenido. |
|
tag
|
tag | string |
Etiqueta de control de contenido usada como clave de campo JSON. |
|
type
|
type | string |
Tipo de control de contenido. |
pagedResponseOffsetDto_templateInfoDto
Respuesta paginada basada en desplazamiento que contiene registros de plantilla.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
data
|
data | array of templateInfoDto |
Objeto JSON que contiene valores para marcadores de posición de plantilla. |
|
Número de página
|
pageNumber | integer |
Número de página actual. |
|
Tamaño de página
|
pageSize | integer |
Número de registros por página. |
|
Total de registros
|
totalRecords | integer |
Número total de registros disponibles. |
|
Total de páginas
|
totalPages | integer |
Número total de páginas. |
templateInfoDto
Elemento de catálogo de plantillas devuelto por el punto de conexión de lista de plantillas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID
|
id | uuid |
Identificador único. |
|
Nombre
|
name | string |
Nombre para mostrar. |
|
Descripción
|
description | string |
Descripción legible para humanos. |
|
Creado el
|
createdOn | date-time |
Fecha y hora UTC en que se creó la plantilla. |
|
Modificado por última vez
|
lastModified | date-time |
Fecha y hora UTC en que se modificó por última vez la plantilla. |
|
categories
|
categories | array of categoryDto |
Categorías de plantilla. |
archivo
Este es el tipo de datos básico "file".
object
Este es el tipo 'objeto'.