Compartilhar via


Vinculador wenDocs (versão prévia)

Conecte-se ao Serviço de API de Publicação do WenDocs. Capacita os usuários registrados a chamar o serviço para montar modelos wenDocs(feitos pelo nosso suplemento do Word: Designer de Modelo de Wendocs) e dados json e, em seguida, publicar em formatos Word, PDF, HTML. Ao integrar com outros conectores, é fácil produzir documentos controlados por dados automaticamente, como uma carta de boas-vindas, um currículo, um relatório de negócios...

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte ao WenDocs
URL https://www.wendocs.com/#/support
Email support@wendocs.com
Metadados do conector
Publicador WenDocs Ltd
Site https://www.wendocs.com
Política de privacidade https://www.wendocs.com/public/PrivacyPolicy_en.html
Categorias Gestão de empresas; Produtividade

O WenDocs Linker conecta-se ao Serviço de API REST de Publicação do WenDocs. Usuários registrados para chamar o serviço para montar seus modelos wenDocs e dados json e, em seguida, publicar em formatos HTML, PDF, Word.

O WenDocs Linker ajuda a empresa a estabelecer um sistema de publicação de documentos de vários canais com aparência consistente e conteúdo personalizado. Ao integrar com outros conectores na plataforma Microsoft 365, é fácil publicar seus documentos controlados por dados corporativos automaticamente, como uma carta de boas-vindas, um currículo, uma notificação de pedido... mesmo relatório financeiro.

Pré-requisitos

  1. Prepare o API_Key e API_Secret obtidos support@wendocs.com para fazer uma conexão de autenticação básica com o Serviço REST.
  2. Prepare um arquivo de modelo do WenDocs e dados de formato json, pesquise "Designer de Modelo wenDocs" no repositório de suplementos do Office do Word e crie um arquivo de modelo por instruções sobre a Ajuda ou comece a partir da Introdução.

Como obter credenciais

Insira o API_Key e API_Secret ao criar uma conexão para o conector.

Introdução ao conector

Veja um fluxo de nuvem como exemplo:

  1. Carregue o modelo e os arquivos json no seu site do OneDrive ou do SharePoint.

  2. Obtenha o conteúdo do arquivo json e do modelo por outros conectores.

  3. Crie uma ação de publicação a partir de "WenDocs Linker", parâmetros de entrada conforme mostrado abaixo:

    • "docName", dê um valor de cadeia de caracteres para nomear este arquivo de modelo.
    • "documentTemplateData", use a expressão base64() para codificar o conteúdo do arquivo de modelo.
    • "jsonData", use o conteúdo do arquivo json.
    • "logLevel", insira um dos níveis de log de publicação: "DEBUG, ERROR, WARNING, INFO".
    • "language", insira um dos códigos de idioma do log de publicação: "en, zh".
    • "país", insira um dos códigos do país de publicação: "EUA, CN".
    • "clientType", entrada "Serviço de API".
  4. Obtenha o documento publicado na próxima ação, use a expressão base64ToBinary() para decodificar o item "document" nas saídas da ação de publicação. São os dados binários dos arquivos de saída.

Limitações conhecidas

A chamada à API de publicação é limitada pelo total de números e data de expiração em sua assinatura.

Erros e soluções comuns

  • Trabalhando com as ações "Obter conteúdo do arquivo" e "Obter conteúdo do arquivo usando o caminho" do OneDrive

    Use a expressão "outputs()" para obter o item "content" do corpo de saída retornado pelas ações "Obter conteúdo do arquivo" e "Obter conteúdo do arquivo usando o caminho". O OneDrive usará base64 para codificar o conteúdo do arquivo, portanto, se você ler um arquivo json do OneDrive, precisará usar a expressão "decodeBase64()" para processar ainda mais o item de "conteúdo", aqui está um exemplo:

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

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
API_Key secureString fornecer o API_Key obtido da WenDocs Corporation[www.wendocs.com] Verdade
API_Secret secureString o API_Secret para o serviço de API de publicação de acesso Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Publicar um arquivo Docx

Publicar um arquivo docx com dados de modelo e json

Publicar um arquivo Html

Publicar um arquivo Html com dados de modelo e json

Publicar um arquivo PDF

Publicar um arquivo PDF com dados de modelo e json

Publicar um arquivo Docx

Publicar um arquivo docx com dados de modelo e json

Parâmetros

Nome Chave Obrigatório Tipo Description
docName
docName string

nome do documento

documentTemplateData
documentTemplateData string

uma cadeia de caracteres base64 representa dados binários do arquivo de modelo

jsonData
jsonData string

dados do cliente no formato json

Nível de log
logLevel string

nível de log de publicação: DEBUG, ERROR, WARNING, INFO

linguagem
language string

código de idioma com suporte da mensagem de erro: en, zh

country
country string

código de erro de país com suporte: EUA, CN

clientType
clientType string

Para usuários do serviço de API, use 'Serviço de API'

Retornos

Nome Caminho Tipo Description
nome_do_documento
documentName string

nome do documento publicado

documento
document string

cadeia de caracteres base64 dos dados binários do documento publicado

errorMessage
errorMessage string

mensagem de erro

código de erro
errorCode string

código de erro

messages
messages array of object

mensagens de pilha de exceção

nível
messages.level string

nível de log

fonte
messages.source string

fonte de informações de log

mensagem
messages.message string

mensagem de log

parameters
messages.parameters array of string

parâmetros da origem do log

exceção
messages.exception string

informações de pilha de exceção

Publicar um arquivo Html

Publicar um arquivo Html com dados de modelo e json

Parâmetros

Nome Chave Obrigatório Tipo Description
docName
docName string

nome do documento

documentTemplateData
documentTemplateData string

uma cadeia de caracteres base64 representa dados binários do arquivo de modelo

jsonData
jsonData string

dados do cliente no formato json

Nível de log
logLevel string

nível de log de publicação: DEBUG, ERROR, WARNING, INFO

linguagem
language string

código de idioma com suporte da mensagem de erro: en, zh

country
country string

código de erro de país com suporte: EUA, CN

clientType
clientType string

Para usuários do serviço de API, use 'Serviço de API'

Retornos

Nome Caminho Tipo Description
nome_do_documento
documentName string

nome do documento publicado

documento
document string

cadeia de caracteres base64 dos dados binários do documento publicado

errorMessage
errorMessage string

mensagem de erro

código de erro
errorCode string

código de erro

messages
messages array of object

mensagens de pilha de exceção

nível
messages.level string

nível de log

fonte
messages.source string

fonte de informações de log

mensagem
messages.message string

mensagem de log

parameters
messages.parameters array of string

parâmetros da origem do log

exceção
messages.exception string

informações de pilha de exceção

Publicar um arquivo PDF

Publicar um arquivo PDF com dados de modelo e json

Parâmetros

Nome Chave Obrigatório Tipo Description
docName
docName string

nome do documento

documentTemplateData
documentTemplateData string

uma cadeia de caracteres base64 representa dados binários do arquivo de modelo

jsonData
jsonData string

dados do cliente no formato json

Nível de log
logLevel string

nível de log de publicação: DEBUG, ERROR, WARNING, INFO

linguagem
language string

código de idioma com suporte da mensagem de erro: en, zh

country
country string

código de erro de país com suporte: EUA, CN

clientType
clientType string

Para usuários do serviço de API, use 'Serviço de API'

Retornos

Nome Caminho Tipo Description
nome_do_documento
documentName string

nome do documento publicado

documento
document string

cadeia de caracteres base64 dos dados binários do documento publicado

errorMessage
errorMessage string

mensagem de erro

código de erro
errorCode string

código de erro

messages
messages array of object

mensagens de pilha de exceção

nível
messages.level string

nível de log

fonte
messages.source string

fonte de informações de log

mensagem
messages.message string

mensagem de log

parameters
messages.parameters array of string

parâmetros da origem do log

exceção
messages.exception string

informações de pilha de exceção