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 |
| 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
- Please prepared the API_Key and API_Secret obtained from support@wendocs.com for making a basic authenticate connection to REST Service.
- 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:
Upload the template and json files to your OneDrive or SharePoint site.
Get template and json file content by other connectors.
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".
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 |