Partilhar via


WenDocs Linker (Preview)

Connect to WenDocs Publish API Service. Empowers registered users to call service to assemble WenDocs template(made by our Word add-in: Wendocs Template Designer) and json data, then publish to Word, PDF, HTML formats. By integrating with other connecters, it is easy to produce documents driven by data automatically, like a welcome letter, resume, business report...

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name WenDocs Support
URL https://www.wendocs.com/#/support
Email support@wendocs.com
Connector Metadata
Publisher WenDocs Ltd
Website https://www.wendocs.com
Privacy policy https://www.wendocs.com/public/PrivacyPolicy_en.html
Categories Business Management;Productivity

WenDocs Linker connects to WenDocs Publish REST API Service. Registered users to call service to assemble their WenDocs templates and json data, then publish to Word, PDF, HTML formats.

WenDocs Linker helps enterprise to establish a multi-channel document publish system with consistent appearance and personalized content. By integrating with other connecters on Microsoft 365 platform, it is easy to publish your documents driven by business data automatically, like a welcome letter, resume, order notification... even financial report.

Prerequisites

  1. Please prepared the API_Key and API_Secret obtained from support@wendocs.com for making a basic authenticate connection to REST Service.
  2. Prepare a WenDocs template file and json format data, please search "WenDocs Template Designer" in the Word office add-in store, and create a template file by instructions on Help or start from the Getting Started.

How to get credentials

Input the API_Key and API_Secret when you create a connection for the connector.

Get started with the connector

Take a cloud flow as a example:

  1. Upload the template and json files to your OneDrive or SharePoint site.

  2. Get template and json file content by other connectors.

  3. Create an publish action from "WenDocs Linker", input parameters as the below:

    • "docName", give a string value to name this template file.
    • "documentTemplateData", use base64() expression to encode your template file content.
    • "jsonData", use the json file content.
    • "logLevel", input one of publish log levels: "DEBUG, ERROR, WARNING, INFO".
    • "language", input one of publish log language code: "en, zh".
    • "country", input one of publish country code: "US, CN".
    • "clientType", input "API Service".
  4. Get the published document in the next action, use base64ToBinary() expression to decode the "document" item in the outputs of the publish action. It is the binary data of output files.

Known Limitations

Publish API call is limited by the total numbers and expire date in your subscription.

Common errors and remedies

  • Working with "Get file content" and "Get file content using path" actions of OneDrive

    Please use the "outputs()" expression to get the "content" item from the output body returned by "Get file content" and "Get file content using path" actions. OneDrive will use base64 to encode the file content, so if you read a json file from OneDrive, you need to use "decodeBase64()" expression to further process "content" item, here is a sample:

    decodeBase64(outputs('Action_Name')?['body/$content'])
    

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API_Key securestring provide the API_Key obtained from WenDocs Corporation[www.wendocs.com] True
API_Secret securestring the API_Secret for access publish api service True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Publish a Docx file

Publish a docx file with template and json data

Publish a Html file

Publish a Html file with template and json data

Publish a PDF file

Publish a PDF file with template and json data

Publish a Docx file

Publish a docx file with template and json data

Parameters

Name Key Required Type Description
docName
docName string

name of document

documentTemplateData
documentTemplateData string

a base64 string represents binary data of template file

jsonData
jsonData string

customer data in json format

logLevel
logLevel string

level of publish log: DEBUG, ERROR, WARNING, INFO

language
language string

supported language code of error message: en, zh

country
country string

supported country code of error message: US, CN

clientType
clientType string

For API service users, please use 'API Service'

Returns

Name Path Type Description
documentName
documentName string

name of published document

document
document string

base64 string of published document's binary data

errorMessage
errorMessage string

error message

errorCode
errorCode string

error code

messages
messages array of object

messages of exception stack

level
messages.level string

log level

source
messages.source string

source of log information

message
messages.message string

log message

parameters
messages.parameters array of string

parameters from the source of log

exception
messages.exception string

exception stack information

Publish a Html file

Publish a Html file with template and json data

Parameters

Name Key Required Type Description
docName
docName string

name of document

documentTemplateData
documentTemplateData string

a base64 string represents binary data of template file

jsonData
jsonData string

customer data in json format

logLevel
logLevel string

level of publish log: DEBUG, ERROR, WARNING, INFO

language
language string

supported language code of error message: en, zh

country
country string

supported country code of error message: US, CN

clientType
clientType string

For API service users, please use 'API Service'

Returns

Name Path Type Description
documentName
documentName string

name of published document

document
document string

base64 string of published document's binary data

errorMessage
errorMessage string

error message

errorCode
errorCode string

error code

messages
messages array of object

messages of exception stack

level
messages.level string

log level

source
messages.source string

source of log information

message
messages.message string

log message

parameters
messages.parameters array of string

parameters from the source of log

exception
messages.exception string

exception stack information

Publish a PDF file

Publish a PDF file with template and json data

Parameters

Name Key Required Type Description
docName
docName string

name of document

documentTemplateData
documentTemplateData string

a base64 string represents binary data of template file

jsonData
jsonData string

customer data in json format

logLevel
logLevel string

level of publish log: DEBUG, ERROR, WARNING, INFO

language
language string

supported language code of error message: en, zh

country
country string

supported country code of error message: US, CN

clientType
clientType string

For API service users, please use 'API Service'

Returns

Name Path Type Description
documentName
documentName string

name of published document

document
document string

base64 string of published document's binary data

errorMessage
errorMessage string

error message

errorCode
errorCode string

error code

messages
messages array of object

messages of exception stack

level
messages.level string

log level

source
messages.source string

source of log information

message
messages.message string

log message

parameters
messages.parameters array of string

parameters from the source of log

exception
messages.exception string

exception stack information