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

Operation ID:

PublishDocx

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

Operation ID:

PublishHtml

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

Operation ID:

PublishPDF

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