TemplioniX (préversion)
TemplioniX est une API de génération de documents permettant de créer des fichiers DOCX et PDF à partir de modèles de Word réutilisables. Utilisez ce connecteur pour extraire des métadonnées de modèle, générer un document unique, exécuter la génération de documents en bloc, vérifier l’état du travail en bloc, télécharger les résultats générés et afficher les informations d’abonnement ou d’utilisation.
L’authentification est effectuée avec une clé API passée.
Les liens de téléchargement ZIP en bloc générés sont valides pendant 24 heures.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - régions Azure Government - régions de chine Azure - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de TemplioniX |
| URL | https://templionix.com |
| Courrier électronique | support@templionix.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | TemplioniX |
| Site web | https://templionix.com |
| Politique de confidentialité | https://templionix.com/privacy-policy |
| Conditions d’utilisation | https://templionix.com/terms-of-use |
| Categories | Productivité; Contenu et fichiers |
| IconBrandColor | #333A41 |
Connecteur TemplioniX
Overview
TemplioniX est un service de génération de documents qui permet de créer des fichiers DOCX et PDF à partir de modèles de Microsoft Word réutilisables et de données JSON structurées.
Ce connecteur permet aux utilisateurs de se connecter Microsoft Power Automate, Power Apps, Azure Logic Apps et Copilot Studio flux de travail à l’API TemplioniX. Les utilisateurs peuvent extraire des métadonnées de modèle, générer des charges utiles JSON de démarrage, générer des documents, exécuter des travaux de génération de documents en bloc, vérifier l’état du travail, télécharger les résultats générés et récupérer des modèles disponibles.
Éditeur
TemplioniX
Produits Microsoft prévus
- Le Microsoft Power Automate
Le connecteur est implémenté en tant que connecteur personnalisé Microsoft Power Platform et peut être utilisable dans d’autres expériences de connecteur Microsoft où les connecteurs certifiés sont pris en charge.
Authentification
Le connecteur utilise l’authentification par clé API. La clé API est transmise dans l’en-tête de x-functions-key requête.
Les utilisateurs doivent disposer d’un compte TemplioniX actif et d’une clé API valide pour utiliser ce connecteur.
Fonctionnalités principales
Obtenir des modèles
Récupère une liste paginé de modèles de documents disponibles à partir de TemplioniX. Cette opération peut être utilisée pour sélectionner un modèle avant de générer des métadonnées, un modèle de démarrage, un document unique ou un travail de génération de document en bloc.
Extraire des champs de modèle et des espaces réservés
Extrait les métadonnées d’un modèle sélectionné, y compris les champs de modèle et les espaces réservés. Cela permet aux utilisateurs de comprendre les données attendues par le modèle.
Générer une charge utile JSON de démarrage pour un modèle
Génère un exemple de charge utile JSON en fonction du modèle sélectionné. Les utilisateurs peuvent utiliser cette charge utile comme point de départ pour mapper les données d’autres systèmes dans une demande de génération de document.
Générer un document
Génère un document DOCX ou PDF à partir d’un modèle sélectionné et de données JSON d’entrée.
Générer des documents en bloc
Démarre un travail de génération de documents en bloc à l’aide d’un modèle sélectionné et de plusieurs enregistrements d’entrée. Les liens de téléchargement ZIP en bloc générés sont valides pendant 24 heures.
Obtenir l’état du travail de génération en bloc
Récupère l’état et les informations de résultat d’un travail de génération de document en bloc spécifique.
Obtenir des travaux de génération en bloc par modèle
Récupère les travaux de génération en bloc associés à un modèle sélectionné.
Scénarios d’utilisation courants
- Générez des contrats, des factures, des propositions, des rapports, des lettres et d’autres documents métier à partir de données structurées.
- Automatisez la création de documents à partir de systèmes CRM, ERP, Excel, SharePoint, Dataverse, SQL ou API.
- Créez des documents uniques à la demande à partir d’un flux de travail.
- Générez plusieurs documents en bloc et récupérez le résultat ZIP généré.
- Utilisez les métadonnées de modèle extraites pour comprendre quels champs sont requis pour la génération de documents.
Exemple de flux de travail
- Déclenchez un flux manuellement ou à partir d’un événement métier.
- Utilisez l’opération Obtenir des modèles pour sélectionner un modèle.
- Utilisez l’opération Générer une charge utile JSON de démarrage pour comprendre la structure de données attendue.
- Mapper les données système sources dans la structure JSON générée.
- Utilisez l’opération Générer un document pour créer un fichier DOCX ou PDF.
- Enregistrez le fichier généré dans OneDrive, SharePoint, Dataverse, e-mail ou une autre destination.
Support
Pour obtenir des informations sur le produit, la documentation et le support, visitez :
- Site internet: https://templionix.com
- Documentation: https://docs.templionix.com
- Soutien: https://templionix.com/contact
- Politique de confidentialité : https://templionix.com/privacy-policy
- Conditions d’utilisation : https://templionix.com/terms-of-use
Remarques relatives à la révision de certification
Ce package contient la solution de connecteur TemplioniX et un exemple de solution de flux qui illustre les opérations du connecteur. Le connecteur communique avec l’API TemplioniX de production et utilise l’authentification par clé API via l’en-tête x-functions-key .
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Description | Required |
|---|---|---|---|
| Clé api TemplioniX | securestring | Clé d’API TemplioniX pour cette API | True |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Démarrer la génération de documents en bloc |
Démarrez un travail en bloc pour générer des documents à partir d’un modèle partagé, crée un fichier ZIP avec une URL SAP de lecture et effectue le suivi de la progression. Retourne immédiatement l’ID de travail. L’URL de téléchargement ZIP retournée est disponible une fois le travail terminé et valide pendant 24 heures à partir de l’heure de génération. |
| Extraire des champs de modèle et des espaces réservés |
Lit le modèle sélectionné et retourne les contrôles de contenu découverts dans le document, y compris leur titre, leur balise, leur type et leurs valeurs prédéfinies lorsqu’ils sont disponibles. |
| Générer un document à partir de données de modèle |
Fusionne la charge utile JSON fournie avec le modèle sélectionné et retourne le document généré. Utiliser |
| Générer une charge utile JSON de démarrage pour un modèle |
Génère un exemple de structure JSON qui correspond aux espaces réservés découverts dans le modèle sélectionné afin qu’il puisse être réutilisé comme entrée pour la génération de document |
| Obtenir l’état du travail de génération en bloc |
Charge l’état du travail par ID : état, heures de début/fin, URL SAS ZIP en cas d’achèvement, erreur d’orchestration en cas d’échec et échecs de génération par élément analysés. |
| Répertorier les modèles disponibles |
Retourne une liste paginé de modèles qui peuvent être utilisés avec l’extraction de métadonnées, la génération de modèle et les points de terminaison de génération de documents |
| Répertorier les travaux de génération en bloc pour un modèle |
Retourne tous les travaux de la partition de génération en bloc où TemplateId correspond ; même forme de charge utile que l’état d’un travail unique, trié par heure de début décroissant |
Démarrer la génération de documents en bloc
Démarrez un travail en bloc pour générer des documents à partir d’un modèle partagé, crée un fichier ZIP avec une URL SAP de lecture et effectue le suivi de la progression. Retourne immédiatement l’ID de travail. L’URL de téléchargement ZIP retournée est disponible une fois le travail terminé et valide pendant 24 heures à partir de l’heure de génération.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Modèle
|
templateId | uuid |
Identificateur de modèle unique |
|
|
Format
|
format | string |
Format de sortie. Utiliser .docx pour Word documents ou .pdf pour les documents PDF |
|
|
Nom du fichier
|
fileName | string |
Nom de fichier généré ou demandé |
|
|
items
|
items | object |
Retours
Réponse retournée lorsqu’un travail de génération de documents en bloc a été accepté pour traitement.
Extraire des champs de modèle et des espaces réservés
Lit le modèle sélectionné et retourne les contrôles de contenu découverts dans le document, y compris leur titre, leur balise, leur type et leurs valeurs prédéfinies lorsqu’ils sont disponibles.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de modèle
|
templateId | True | uuid |
Identificateur de modèle unique retourné par le catalogue de modèles |
Retours
- response
- array of contentControlInfoDto
Générer un document à partir de données de modèle
Fusionne la charge utile JSON fournie avec le modèle sélectionné et retourne le document généré. Utiliser .docx pour Word sortie ou .pdf pour la sortie PDF
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Modèle
|
templateId | uuid |
Identificateur de modèle unique |
|
|
data
|
data | object |
Objet JSON contenant des valeurs pour les espaces réservés de modèle. |
|
|
Nom du document
|
documentName | string |
Nom du document généré sans extension, sauf si votre API accepte une extension |
|
|
Format
|
format | string |
Format de sortie. Utilisez .docx pour Word documents ou .pdf pour les documents PDF. |
Retours
- response
- file
Générer une charge utile JSON de démarrage pour un modèle
Génère un exemple de structure JSON qui correspond aux espaces réservés découverts dans le modèle sélectionné afin qu’il puisse être réutilisé comme entrée pour la génération de document
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de modèle
|
templateId | True | uuid |
Identificateur de modèle unique retourné par le catalogue de modèles |
Retours
- response
- object
Obtenir l’état du travail de génération en bloc
Charge l’état du travail par ID : état, heures de début/fin, URL SAS ZIP en cas d’achèvement, erreur d’orchestration en cas d’échec et échecs de génération par élément analysés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de travail en bloc
|
jobId | True | string |
ID de travail retourné dans la réponse generateDocumentsBulk 202 ( |
Retours
Détails de l’état et des résultats d’un travail de génération de documents en bloc.
Répertorier les modèles disponibles
Retourne une liste paginé de modèles qui peuvent être utilisés avec l’extraction de métadonnées, la génération de modèle et les points de terminaison de génération de documents
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nombre de pages
|
pageNumber | True | integer |
Index de page basé sur 1 à retourner |
|
Taille de la page
|
pageSize | True | integer |
Nombre maximal de modèles à retourner dans une seule réponse |
Retours
Réponse paginée basée sur offset contenant des enregistrements de modèle.
Répertorier les travaux de génération en bloc pour un modèle
Retourne tous les travaux de la partition de génération en bloc où TemplateId correspond ; même forme de charge utile que l’état d’un travail unique, trié par heure de début décroissant
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Identificateur de modèle
|
templateId | True | uuid |
Seuls les travaux démarrés avec cet ID de modèle sont retournés |
Retours
- response
- array of bulkGenerationJobStatusDto
Définitions
bulkGenerationAcceptedDto
Réponse retournée lorsqu’un travail de génération de documents en bloc a été accepté pour traitement.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de travail
|
jobId | string |
Identificateur de travail de génération en bloc unique. |
|
Démarré à
|
startedAt | date-time |
Date et heure UTC de démarrage de l’opération. |
bulkGenerationFailureItemDto
Informations sur un élément de document ayant échoué dans un travail de génération en bloc.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Global Index
|
globalIndex | string |
Index ou identificateur interne de l’élément généré ayant échoué. |
|
Nom du fichier
|
fileName | string |
Nom de fichier généré ou demandé. |
|
Error
|
error | string |
Message d’erreur pour l’élément ayant échoué. |
bulkGenerationJobStatusDto
Détails de l’état et des résultats d’un travail de génération de documents en bloc.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de travail
|
jobId | string |
Identificateur de travail de génération en bloc unique. |
|
ID de modèle
|
templateId | uuid |
Identificateur de modèle unique. |
|
État
|
status | string |
État actuel du travail, par exemple : En attente, En cours d’exécution, Terminé, Échec ou PartiellementCompleted. |
|
Démarré à
|
startedAt | date-time |
Date et heure UTC de démarrage de l’opération. |
|
Heure de fin
|
endTime | date-time |
Date et heure UTC de fin du travail. |
|
Zip Url
|
zipUrl | string |
URL de téléchargement temporaire pour le fichier ZIP généré. Pour la génération en bloc, ce lien est valide pendant 24 heures à partir de l’heure de génération. |
|
Message d’erreur
|
errorMessage | string |
Message d’erreur au niveau du travail, si l’orchestration a échoué. |
|
failedGenerations
|
failedGenerations | array of bulkGenerationFailureItemDto |
Collection d’éléments ayant échoué à l’intérieur d’un travail de génération en bloc. |
|
Nombre de générations ayant échoué
|
failedGenerationCount | integer |
Nombre d’éléments ayant échoué à l’intérieur d’un travail de génération en bloc. |
categoryDto
Informations sur les catégories de modèle.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
id
|
id | uuid |
Identificateur unique. |
|
name
|
name | string |
Nom d'affichage. |
contentControlInfoDto
Métadonnées d’un contrôle de contenu ou d’un espace réservé Word découverts dans un modèle.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
title
|
title | string |
Titre du contrôle de contenu. |
|
tag
|
tag | string |
Balise de contrôle de contenu utilisée comme clé de champ JSON. |
|
type
|
type | string |
Type de contrôle de contenu. |
pagedResponseOffsetDto_templateInfoDto
Réponse paginée basée sur offset contenant des enregistrements de modèle.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
data
|
data | array of templateInfoDto |
Objet JSON contenant des valeurs pour les espaces réservés de modèle. |
|
Numéro de page
|
pageNumber | integer |
Numéro de page actuel. |
|
Taille de la page
|
pageSize | integer |
Nombre d’enregistrements par page. |
|
Nombre total d’enregistrements
|
totalRecords | integer |
Nombre total d’enregistrements disponibles. |
|
Total Pages
|
totalPages | integer |
Nombre total de pages. |
templateInfoDto
Élément de catalogue de modèles retourné par le point de terminaison de liste de modèles.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | uuid |
Identificateur unique. |
|
Nom
|
name | string |
Nom d'affichage. |
|
Description
|
description | string |
Description lisible par l’homme. |
|
Date de création
|
createdOn | date-time |
Date et heure UTC de création du modèle. |
|
Dernière modification
|
lastModified | date-time |
Date et heure UTC de la dernière modification du modèle. |
|
categories
|
categories | array of categoryDto |
Catégories de modèles. |
fichier
Il s’agit du type de données de base « fichier ».
object
Il s’agit du type 'object'.