TemplioniX (anteprima)
TemplioniX è un'API di generazione di documenti per la creazione di file DOCX e PDF da modelli di Word riutilizzabili. Usare questo connettore per estrarre i metadati del modello, generare un singolo documento, eseguire la generazione di documenti in blocco, controllare lo stato del processo bulk, scaricare i risultati generati e visualizzare le informazioni sull'utilizzo o sulla sottoscrizione.
L'autenticazione viene eseguita con una chiave API passata.
I collegamenti di download ZIP in blocco generati sono validi per 24 ore.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree 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 | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Azure cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps 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) |
| Power Automate | Premium | Tutte le aree 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) |
| Contact | |
|---|---|
| Name | Supporto di TemplioniX |
| URL | https://templionix.com |
| support@templionix.com |
| Metadati del connettore | |
|---|---|
| Editore | TemplioniX |
| Sito web | https://templionix.com |
| Informativa sulla privacy | https://templionix.com/privacy-policy |
| Condizioni per l'utilizzo | https://templionix.com/terms-of-use |
| Categorie | Produttività; Contenuto e file |
| IconBrandColor | #333A41 |
Connettore TemplioniX
Overview
TemplioniX è un servizio di generazione di documenti che consente di creare file DOCX e PDF da modelli riutilizzabili Microsoft Word e dati JSON strutturati.
Questo connettore consente agli utenti di connettere flussi di lavoro Microsoft Power Automate, Power Apps, App per la logica di Azure e Copilot Studio all'API TemplioniX. Gli utenti possono estrarre i metadati del modello, generare payload JSON iniziali, generare documenti, eseguire processi di generazione di documenti in blocco, controllare lo stato del processo, scaricare i risultati generati e recuperare i modelli disponibili.
Editore
TemplioniX
Prodotti Microsoft previsti
- Microsoft Power Automate
Il connettore viene implementato come connettore personalizzato Microsoft Power Platform e può essere utilizzabile in altre esperienze del connettore Microsoft in cui sono supportati i connettori certificati.
Autenticazione
Il connettore usa l'autenticazione della chiave API. La chiave API viene passata nell'intestazione della x-functions-key richiesta.
Per usare questo connettore, gli utenti devono avere un account TemplioniX attivo e una chiave API valida.
Funzionalità principali
Ottenere modelli
Recupera un elenco impaginato di modelli di documento disponibili da TemplioniX. Questa operazione può essere usata per selezionare un modello prima di generare metadati, un modello iniziale, un singolo documento o un processo di generazione di documenti in blocco.
Estrarre campi modello e segnaposto
Estrae i metadati da un modello selezionato, inclusi i campi del modello e i segnaposto. Ciò consente agli utenti di comprendere quali dati sono previsti dal modello.
Generare un payload JSON iniziale per un modello
Genera un payload JSON di esempio basato sul modello selezionato. Gli utenti possono usare questo payload come punto di partenza per il mapping dei dati di altri sistemi in una richiesta di generazione di documenti.
Generare un documento
Genera un documento DOCX o PDF da un modello selezionato e da dati JSON di input.
Generare documenti in blocco
Avvia un processo di generazione di documenti in blocco usando un modello selezionato e più record di input. I collegamenti di download ZIP in blocco generati sono validi per 24 ore.
Ottenere lo stato del processo di generazione bulk
Recupera lo stato e le informazioni sui risultati per un processo di generazione di documenti bulk specifico.
Ottenere processi di generazione bulk in base al modello
Recupera i processi di generazione bulk associati a un modello selezionato.
Scenari di utilizzo comuni
- Generare contratti, fatture, proposte, report, lettere e altri documenti aziendali da dati strutturati.
- Automatizzare la creazione di documenti da sistemi CRM, ERP, moduli, Excel, SharePoint, Dataverse, SQL o BASATI su API.
- Creare singoli documenti su richiesta da un flusso di lavoro.
- Generare più documenti in blocco e recuperare il risultato ZIP generato.
- Usare i metadati del modello estratti per comprendere quali campi sono necessari per la generazione di documenti.
Esempio di flusso di lavoro
- Attivare un flusso manualmente o da un evento aziendale.
- Usare l'operazione Recupera modelli per selezionare un modello.
- Usare l'operazione Genera un payload JSON iniziale per comprendere la struttura dei dati prevista.
- Eseguire il mapping dei dati del sistema di origine nella struttura JSON generata.
- Utilizzare l'operazione Genera un documento per creare un file DOCX o PDF.
- Salvare il file generato in OneDrive, SharePoint, Dataverse, posta elettronica o un'altra destinazione.
Support
Per informazioni sul prodotto, documentazione e supporto tecnico, visitare:
- Sito web: https://templionix.com
- Documentazione: https://docs.templionix.com
- Supporto: https://templionix.com/contact
- Informativa sulla privacy: https://templionix.com/privacy-policy
- Condizioni per l'utilizzo: https://templionix.com/terms-of-use
Note per la revisione della certificazione
Questo pacchetto contiene la soluzione connettore TemplioniX e una soluzione di flusso di esempio che illustra le operazioni del connettore. Il connettore comunica con l'API TemplioniX di produzione e usa l'autenticazione della chiave API tramite l'intestazione x-functions-key .
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.
| Name | Tipo | Description | Obbligatorio |
|---|---|---|---|
| Chiave API TemplioniX | securestring | Chiave API TemplioniX per questa API | True |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Avviare la generazione di documenti in blocco |
Avviare il processo in blocco per generare documenti da un modello condiviso, creare un file ZIP con un URL di firma di accesso condiviso in lettura e tenere traccia dello stato di avanzamento. Restituisce immediatamente l'ID processo. L'URL di download ZIP restituito è disponibile al termine del processo ed è valido per 24 ore dall'ora di generazione. |
| Elencare i modelli disponibili |
Restituisce un elenco impaginato di modelli che possono essere usati con l'estrazione dei metadati, la generazione di modelli e gli endpoint di generazione di documenti |
| Elencare i processi di generazione bulk per un modello |
Restituisce tutti i processi per la partizione di generazione bulk in cui TemplateId corrisponde; stessa forma di payload dello stato di un singolo processo, ordinato in base all'ora di inizio decrescente |
| Estrarre campi modello e segnaposto |
Legge il modello selezionato e restituisce i controlli contenuto individuati nel documento, inclusi il titolo, il tag, il tipo e i valori predefiniti, se disponibili. |
| Generare un documento dai dati del modello |
Unisce il payload JSON fornito con il modello selezionato e restituisce il documento generato. Usare |
| Generare un payload JSON iniziale per un modello |
Compila una struttura JSON di esempio che corrisponde ai segnaposto individuati nel modello selezionato in modo che possa essere riutilizzata come input per la generazione di documenti |
| Ottenere lo stato del processo di generazione bulk |
Carica lo stato del processo in base all'ID: stato, ora di inizio/fine, URL della firma di accesso condiviso ZIP al termine, errore di orchestrazione in caso di errore di generazione e analisi per ogni elemento. |
Avviare la generazione di documenti in blocco
Avviare il processo in blocco per generare documenti da un modello condiviso, creare un file ZIP con un URL di firma di accesso condiviso in lettura e tenere traccia dello stato di avanzamento. Restituisce immediatamente l'ID processo. L'URL di download ZIP restituito è disponibile al termine del processo ed è valido per 24 ore dall'ora di generazione.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
Identificatore univoco del modello |
|
|
Format
|
format | string |
Formato di output. Utilizzare .docx per documenti Word o .pdf per i documenti PDF |
|
|
Nome del file
|
fileName | string |
Nome file generato o richiesto |
|
|
items
|
items | object |
Valori restituiti
Risposta restituita quando è stato accettato un processo di generazione di documenti in blocco per l'elaborazione.
Elencare i modelli disponibili
Restituisce un elenco impaginato di modelli che possono essere usati con l'estrazione dei metadati, la generazione di modelli e gli endpoint di generazione di documenti
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Numero di pagina
|
pageNumber | True | integer |
Indice di pagina basato su 1 da restituire |
|
Dimensioni della pagina
|
pageSize | True | integer |
Numero massimo di modelli da restituire in una singola risposta |
Valori restituiti
Risposta di paging basata su offset contenente record modello.
Elencare i processi di generazione bulk per un modello
Restituisce tutti i processi per la partizione di generazione bulk in cui TemplateId corrisponde; stessa forma di payload dello stato di un singolo processo, ordinato in base all'ora di inizio decrescente
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Identificatore del modello
|
templateId | True | uuid |
Vengono restituiti solo i processi avviati con questo ID modello |
Valori restituiti
- response
- array of bulkGenerationJobStatusDto
Estrarre campi modello e segnaposto
Legge il modello selezionato e restituisce i controlli contenuto individuati nel documento, inclusi il titolo, il tag, il tipo e i valori predefiniti, se disponibili.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Identificatore del modello
|
templateId | True | uuid |
Identificatore univoco del modello restituito dal catalogo dei modelli |
Valori restituiti
- response
- array of contentControlInfoDto
Generare un documento dai dati del modello
Unisce il payload JSON fornito con il modello selezionato e restituisce il documento generato. Usare .docx per Word output o .pdf per l'output PDF
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Template
|
templateId | uuid |
Identificatore univoco del modello |
|
|
data
|
data | object |
Oggetto JSON contenente valori per i segnaposto del modello. |
|
|
Nome documento
|
documentName | string |
Nome del documento generato senza estensione, a meno che l'API non accetti un'estensione |
|
|
Format
|
format | string |
Formato di output. Utilizzare .docx per Word documenti o .pdf per i documenti PDF. |
Valori restituiti
- response
- file
Generare un payload JSON iniziale per un modello
Compila una struttura JSON di esempio che corrisponde ai segnaposto individuati nel modello selezionato in modo che possa essere riutilizzata come input per la generazione di documenti
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Identificatore del modello
|
templateId | True | uuid |
Identificatore univoco del modello restituito dal catalogo dei modelli |
Valori restituiti
- response
- object
Ottenere lo stato del processo di generazione bulk
Carica lo stato del processo in base all'ID: stato, ora di inizio/fine, URL della firma di accesso condiviso ZIP al termine, errore di orchestrazione in caso di errore di generazione e analisi per ogni elemento.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Identificatore del processo in blocco
|
jobId | True | string |
ID processo restituito nella risposta generateDocumentsBulk 202 ( |
Valori restituiti
Stato e dettagli dei risultati per un processo di generazione di documenti in blocco.
Definizioni
bulkGenerationAcceptedDto
Risposta restituita quando è stato accettato un processo di generazione di documenti in blocco per l'elaborazione.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID lavoro
|
jobId | string |
Identificatore univoco del processo di generazione bulk. |
|
Attività iniziali
|
startedAt | date-time |
Data e ora UTC all'avvio dell'operazione. |
bulkGenerationFailureItemDto
Informazioni su un elemento documento non riuscito in un processo di generazione bulk.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Indice globale
|
globalIndex | string |
Indice o identificatore interno dell'elemento generato non riuscito. |
|
Nome del file
|
fileName | string |
Nome file generato o richiesto. |
|
Error
|
error | string |
Messaggio di errore per l'elemento non riuscito. |
bulkGenerationJobStatusDto
Stato e dettagli dei risultati per un processo di generazione di documenti in blocco.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID lavoro
|
jobId | string |
Identificatore univoco del processo di generazione bulk. |
|
ID modello
|
templateId | uuid |
Identificatore univoco del modello. |
|
Condizione
|
status | string |
Stato del processo corrente, ad esempio In sospeso, In esecuzione, Completato, Non riuscito o ParzialmenteCompleted. |
|
Attività iniziali
|
startedAt | date-time |
Data e ora UTC all'avvio dell'operazione. |
|
Ora di fine
|
endTime | date-time |
Data e ora UTC al termine del processo. |
|
Zip Url
|
zipUrl | string |
URL di download temporaneo per il file ZIP generato. Per la generazione bulk, questo collegamento è valido per 24 ore dall'ora di generazione. |
|
Messaggio di errore
|
errorMessage | string |
Messaggio di errore a livello di processo, se l'orchestrazione non è riuscita. |
|
generation non riuscite
|
failedGenerations | array of bulkGenerationFailureItemDto |
Raccolta di elementi non riusciti all'interno di un processo di generazione bulk. |
|
Conteggio generazione non riuscita
|
failedGenerationCount | integer |
Numero di elementi non riusciti all'interno di un processo di generazione bulk. |
categoryDto
Informazioni sulla categoria del modello.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | uuid |
Identificatore univoco. |
|
name
|
name | string |
Nome visualizzato. |
contentControlInfoDto
Metadati per un Word controllo contenuto o segnaposto individuati in un modello.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Titolo
|
title | string |
Titolo del controllo contenuto. |
|
tag
|
tag | string |
Tag di controllo contenuto usato come chiave di campo JSON. |
|
type
|
type | string |
Tipo di controllo contenuto. |
pagedResponseOffsetDto_templateInfoDto
Risposta di paging basata su offset contenente record modello.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
data
|
data | array of templateInfoDto |
Oggetto JSON contenente valori per i segnaposto del modello. |
|
Numero pagina
|
pageNumber | integer |
Numero di pagina corrente. |
|
Dimensioni pagina
|
pageSize | integer |
Numero di record per pagina. |
|
Totale record
|
totalRecords | integer |
Numero totale di record disponibili. |
|
Totale pagine
|
totalPages | integer |
Numero totale di pagine. |
templateInfoDto
Elemento del catalogo modello restituito dall'endpoint dell'elenco di modelli.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID
|
id | uuid |
Identificatore univoco. |
|
Name
|
name | string |
Nome visualizzato. |
|
Description
|
description | string |
Descrizione leggibile dagli umani |
|
Data di creazione
|
createdOn | date-time |
Data e ora UTC in cui è stato creato il modello. |
|
Ultima modifica
|
lastModified | date-time |
Data e ora UTC dell'ultima modifica del modello. |
|
categories
|
categories | array of categoryDto |
Categorie di modelli. |
file
Si tratta del tipo di dati di base 'file'.
oggetto
Si tratta del tipo 'object'.