Linker WenDocs (anteprima)
Connettersi al servizio API Publish di WenDocs. Consente agli utenti registrati di chiamare il servizio per assemblare i modelli WenDocs (creati dal componente aggiuntivo di Word: Progettazione modelli Wendocs) e i dati JSON, quindi pubblicarli in word, PDF, formati HTML. Grazie all'integrazione con altri connecter, è facile produrre documenti basati automaticamente sui dati, ad esempio una lettera di benvenuto, un curriculum, un report aziendale...
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di 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 | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di 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) |
| Contatto | |
|---|---|
| Nome | Supporto di WenDocs |
| URL | https://www.wendocs.com/#/support |
| support@wendocs.com |
| Metadati del connettore | |
|---|---|
| Editore | WenDocs Ltd |
| Sito web | https://www.wendocs.com |
| Informativa sulla privacy | https://www.wendocs.com/public/PrivacyPolicy_en.html |
| Categorie | Gestione aziendale; Produttività |
WenDocs Linker si connette al servizio API REST di pubblicazione di WenDocs. Utenti registrati per chiamare il servizio per assemblare i modelli e i dati JSON di WenDocs, quindi pubblicarli in word, PDF, formati HTML.
WenDocs Linker aiuta l'azienda a stabilire un sistema di pubblicazione di documenti multicanale con aspetto coerente e contenuto personalizzato. Grazie all'integrazione con altri connecter sulla piattaforma Microsoft 365, è facile pubblicare automaticamente i documenti basati sui dati aziendali, ad esempio una lettera di benvenuto, un curriculum, una notifica di ordine... anche la relazione finanziaria.
Prerequisiti
- Si prega di preparare il API_Key e API_Secret ottenuto da support@wendocs.com per effettuare una connessione di autenticazione di base al servizio REST.
- Preparare un file di modello WenDocs e i dati in formato JSON, cercare "WenDocs Template Designer" nell'archivio dei componenti aggiuntivi di Word office e creare un file modello seguendo le istruzioni della Guida o iniziare dalla Guida introduttiva.
Come ottenere le credenziali
Immettere il API_Key e API_Secret quando si crea una connessione per il connettore.
Introduzione al connettore
Si prenda un flusso cloud come esempio:
Caricare il modello e i file JSON nel sito di OneDrive o SharePoint.
Ottenere il contenuto del modello e del file JSON da altri connettori.
Creare un'azione di pubblicazione da "WenDocs Linker", i parametri di input come indicato di seguito:
- "docName", assegnare un valore stringa per denominare questo file modello.
- "documentTemplateData", usare l'espressione base64() per codificare il contenuto del file modello.
- "jsonData", usare il contenuto del file JSON.
- "logLevel", immettere uno dei livelli di log di pubblicazione: "DEBUG, ERRORE, AVVISO, INFO".
- "language", input di uno dei codici della lingua del log di pubblicazione: "en, zh".
- "country", immettere uno dei codici paese di pubblicazione: "US, CN".
- "clientType", input "Servizio API".
Ottenere il documento pubblicato nell'azione successiva, usare l'espressione base64ToBinary() per decodificare l'elemento "documento" negli output dell'azione di pubblicazione. Si tratta dei dati binari dei file di output.
Limitazioni note
La chiamata API di pubblicazione è limitata dai numeri totali e dalla data di scadenza nella sottoscrizione.
Errori e rimedi comuni
Uso delle azioni "Recupera contenuto file" e "Recupera contenuto file usando il percorso" di OneDrive
Usare l'espressione "outputs()" per ottenere l'elemento "content" dal corpo di output restituito dalle azioni "Recupera contenuto file" e "Recupera contenuto file usando il percorso". OneDrive userà Base64 per codificare il contenuto del file, quindi se si legge un file JSON da OneDrive, è necessario usare l'espressione "decodeBase64()" per elaborare ulteriormente l'elemento "contenuto", di seguito è riportato un esempio:
decodeBase64(outputs('Action_Name')?['body/$content'])
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.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| API_Key | securestring | fornire il API_Key ottenuto da WenDocs Corporation[www.wendocs.com] | Vero |
| API_Secret | securestring | il API_Secret per l'accesso al servizio API di pubblicazione | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Pubblicare un file Docx |
Pubblicare un file docx con modelli e dati JSON |
| Pubblicare un file HTML |
Pubblicare un file HTML con modelli e dati JSON |
| Pubblicare un file PDF |
Pubblicare un file PDF con modelli e dati JSON |
Pubblicare un file Docx
Pubblicare un file docx con modelli e dati JSON
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
docName
|
docName | string |
nome del documento |
|
|
documentTemplateData
|
documentTemplateData | string |
una stringa base64 rappresenta i dati binari del file modello |
|
|
jsonData
|
jsonData | string |
dati dei clienti in formato JSON |
|
|
Livello di registro
|
logLevel | string |
livello di log di pubblicazione: DEBUG, ERRORE, AVVISO, INFO |
|
|
language
|
language | string |
codice linguistico supportato del messaggio di errore: en, zh |
|
|
country
|
country | string |
codice paese supportato del messaggio di errore: US, CN |
|
|
clientType
|
clientType | string |
Per gli utenti del servizio API, usare "Servizio API" |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome documento
|
documentName | string |
nome del documento pubblicato |
|
documento
|
document | string |
Stringa base64 dei dati binari del documento pubblicato |
|
messaggio di errore
|
errorMessage | string |
messaggio di errore |
|
codice di errore
|
errorCode | string |
codice errore |
|
messages
|
messages | array of object |
messaggi dello stack di eccezioni |
|
livello
|
messages.level | string |
livello di log |
|
source
|
messages.source | string |
origine delle informazioni di log |
|
message
|
messages.message | string |
messaggio di log |
|
parameters
|
messages.parameters | array of string |
parametri dall'origine del log |
|
exception
|
messages.exception | string |
informazioni sullo stack di eccezioni |
Pubblicare un file HTML
Pubblicare un file HTML con modelli e dati JSON
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
docName
|
docName | string |
nome del documento |
|
|
documentTemplateData
|
documentTemplateData | string |
una stringa base64 rappresenta i dati binari del file modello |
|
|
jsonData
|
jsonData | string |
dati dei clienti in formato JSON |
|
|
Livello di registro
|
logLevel | string |
livello di log di pubblicazione: DEBUG, ERRORE, AVVISO, INFO |
|
|
language
|
language | string |
codice linguistico supportato del messaggio di errore: en, zh |
|
|
country
|
country | string |
codice paese supportato del messaggio di errore: US, CN |
|
|
clientType
|
clientType | string |
Per gli utenti del servizio API, usare "Servizio API" |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome documento
|
documentName | string |
nome del documento pubblicato |
|
documento
|
document | string |
Stringa base64 dei dati binari del documento pubblicato |
|
messaggio di errore
|
errorMessage | string |
messaggio di errore |
|
codice di errore
|
errorCode | string |
codice errore |
|
messages
|
messages | array of object |
messaggi dello stack di eccezioni |
|
livello
|
messages.level | string |
livello di log |
|
source
|
messages.source | string |
origine delle informazioni di log |
|
message
|
messages.message | string |
messaggio di log |
|
parameters
|
messages.parameters | array of string |
parametri dall'origine del log |
|
exception
|
messages.exception | string |
informazioni sullo stack di eccezioni |
Pubblicare un file PDF
Pubblicare un file PDF con modelli e dati JSON
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
docName
|
docName | string |
nome del documento |
|
|
documentTemplateData
|
documentTemplateData | string |
una stringa base64 rappresenta i dati binari del file modello |
|
|
jsonData
|
jsonData | string |
dati dei clienti in formato JSON |
|
|
Livello di registro
|
logLevel | string |
livello di log di pubblicazione: DEBUG, ERRORE, AVVISO, INFO |
|
|
language
|
language | string |
codice linguistico supportato del messaggio di errore: en, zh |
|
|
country
|
country | string |
codice paese supportato del messaggio di errore: US, CN |
|
|
clientType
|
clientType | string |
Per gli utenti del servizio API, usare "Servizio API" |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome documento
|
documentName | string |
nome del documento pubblicato |
|
documento
|
document | string |
Stringa base64 dei dati binari del documento pubblicato |
|
messaggio di errore
|
errorMessage | string |
messaggio di errore |
|
codice di errore
|
errorCode | string |
codice errore |
|
messages
|
messages | array of object |
messaggi dello stack di eccezioni |
|
livello
|
messages.level | string |
livello di log |
|
source
|
messages.source | string |
origine delle informazioni di log |
|
message
|
messages.message | string |
messaggio di log |
|
parameters
|
messages.parameters | array of string |
parametri dall'origine del log |
|
exception
|
messages.exception | string |
informazioni sullo stack di eccezioni |