Rascunho de Documento
O conector do Document Drafter capacita os usuários a automatizar a criação e o gerenciamento de documentos. Com esse conector, você pode gerar documentos dinâmicos a partir de modelos, preenchê-los com dados de seus sistemas, roteá-los para revisão ou aprovação e fornecer com segurança a saída final. Ele foi projetado para ajudar as organizações a reduzir o esforço manual, garantir a consistência e acelerar os fluxos de trabalho controlados por documentos.
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 | Rascunho de Documento |
| URL | https://documentdrafter.com |
| support@documentdrafter.com |
| Metadados do conector | |
|---|---|
| Publicador | Rascunho de Documento |
| Site | https://documentdrafter.com |
| Política de privacidade | https://documentdrafter.com/privacy/ |
| Categorias | Colaboração; Operações de TI |
Conector do Rascunho de Documento
O Conector do Rascunho de Documento permite a criação e o gerenciamento de fluxos de trabalho para seus processos de documentos automatizados.
Pré-requisitos
Obrigatório: uma assinatura do Document Drafter e acesso ao seu portal.
Como obter acesso?
Para uma demonstração, entre em contato conosco documentdrafter.com
Criando uma conexão
Conecte-se usando um token obtido no portal do Document Drafter.
Operações com suporte
O conector dá suporte a várias operações:
Triggers
-
Button press: inicia um fluxo de trabalho quando um botão em um questionário é pressionado. -
Link submission: inicia um fluxo de trabalho após o envio de um questionário por meio de uma URL.
Ações
-
Create and Fill Questionnaire: preencher um questionário usando dados JSON. -
Create Questionnaire: configure um novo questionário. -
Get Link to a Questionnaire: recupere um link para acessar um questionário. -
Get Documents: obtenha documentos gerados a partir de um questionário. -
Get Questionnaire Information: informações de acesso inseridas em um questionário. -
Get Tags for a Questionnaire: exiba todas as marcas atribuídas a um questionário. -
Get information on flow states and triggers: o fluxo pode ter vários estados com vários gatilhos. Essa ação recupera essas informações com base na chave de fluxo. -
Get link to a questionnaire: cria um novo link profundo para um questionário. -
Set current state for a questionnaire: o fluxo pode ter vários estados. Essa ação permite que você altere o estado de um questionário. -
Grant users or groups access to a questionnaire: conceda aos usuários ou grupos acesso a um questionário. -
Revoke access to a questionnaire for all users and groups:Revogar o acesso a um questionário para todos os usuários e grupos. -
Get or Create a Workspace: verifica um workspace existente por nome. Se o workspace não for encontrado e o parâmetro "Criar se não for encontrado" for definido como true, um novo workspace será criado. Ele retorna o status do Workspace Exists e, se aplicável, o nome, a ID e o caminho do workspace. Um parâmetro opcional permite que você copie o estilo e as pastas de outro workspace mestre. -
Get or Create a Folder: verifica uma pasta por nome em um workspace especificado. Se a pasta não for encontrada e o parâmetro "Criar se não for encontrado" for definido como true, uma nova pasta será criada. Ele retorna o status "Pasta Existe" e, se aplicável, o nome, a ID e o caminho da pasta. -
Save Static Files to a Workspace: salva arquivos estáticos em um workspace e pasta especificados no formato base64. Ele retorna o nome, a ID e o caminho do arquivo salvo. -
Get or Create a User: verifica se há um usuário por endereço de email. Se o usuário não for encontrado e o parâmetro Criar se não for encontrado for definido como true, um novo usuário será criado. Ele retorna o status de Usuário Existe e, se aplicável, a ID e o nome do usuário. Os parâmetros opcionais permitem suprimir o email de convite gerado pelo sistema e recuperar a senha temporária para um fluxo de email personalizado. Você também pode especificar um grupo ao qual adicionar o novo usuário. -
Get or Create a Group: verifica se há um grupo existente por nome. Se o grupo não for encontrado e o parâmetro "Criar se não for encontrado" for definido como true, um novo grupo será criado. Ele retorna o status "Grupo Existe" e, se aplicável, a ID e o nome do grupo. -
Add Access for a Group: adiciona acesso a um grupo a um workspace ou pasta especificado. Ele retorna o status do Access Exists e, se aplicável, confirma que o acesso foi concedido. Ele pode ser usado para verificar o acesso existente sem adicioná-lo.
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 |
|---|---|---|---|
| Chave de API | secureString | A chave de API para este conector | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Conceder aos usuários ou grupos acesso a um questionário |
Conceder aos usuários ou grupos acesso a um questionário |
| Criar e preencher questionário usando dados JSON |
Crie e preencha um questionário carregando um arquivo JSON. Após essa ação, você pode usar as ações Obter documentos ou Obter informações de questionário. |
| Criar um questionário |
Criar um novo questionnare no modelo selecionado |
| Definir o estado atual para um questionário |
O fluxo pode ter vários estados. Essa ação permite que você altere o estado de um questionário. |
| Obter documentos |
Obter arquivos de documento com base na ID do documento |
| Obter informações de fluxo |
Obter informações de fluxo com base na chave de fluxo |
| Obter informações de questionário |
Buscar variáveis para um único modelo |
| Obter link de questionário anônimo |
Obter um deeplink para o questionário de compartilhamento externo |
| Obter link para um questionário |
Cria um novo link profundo para um questionário |
| Obter ou criar acesso à pasta |
Obter informações sobre o acesso a uma pasta e criá-la se ela não existir |
| Obter ou criar grupo |
Obter informações sobre um grupo e criá-lo se ele não existir |
| Obter ou criar pasta |
Obter informações sobre uma pasta e criá-la se ela não existir |
| Obter ou criar usuário |
Obter informações sobre um usuário e criá-lo se ele não existir |
| Obter ou criar workspace |
Obter informações sobre um workspace e criá-lo se ele não existir |
| Preencher todas as marcas para questionário |
Obter marcas de questionário |
| Revogar o acesso a um questionário para todos os usuários e grupos |
Revogar o acesso a um questionário para todos os usuários e grupos |
| Salvar arquivo estático em uma pasta |
Salva um arquivo estático em uma pasta especificada |
Conceder aos usuários ou grupos acesso a um questionário
Conceder aos usuários ou grupos acesso a um questionário
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
|
Grupo ou Email
|
GroupOrMail | True | string |
Grupo ou Email |
|
Acesso a perguntas selecionadas
|
SelectedQuestions | boolean |
Habilitar o acesso a perguntas selecionadas, o padrão é o acesso completo |
Retornos
descrição de saída
- response
- object
Criar e preencher questionário usando dados JSON
Crie e preencha um questionário carregando um arquivo JSON. Após essa ação, você pode usar as ações Obter documentos ou Obter informações de questionário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Workspace
|
WorkSpace | True | string |
Selecionar workspace no menu suspenso |
|
Questionário
|
TemplateId | True | string |
Selecionar modelo na lista suspensa |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
|
Dados JSON
|
JsonData | True | string |
Dados JSON para preencher o questionário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do documento
|
documentId | string |
ID do documento |
Criar um questionário
Criar um novo questionnare no modelo selecionado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Workspace
|
WorkSpace | True | string |
Selecionar workspace no menu suspenso |
|
Questionário
|
TemplateId | True | string |
Selecionar modelo na lista suspensa |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
Definir o estado atual para um questionário
O fluxo pode ter vários estados. Essa ação permite que você altere o estado de um questionário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Chave de fluxo
|
FlowKey | True | string |
A chave de fluxo do Rascunho do Documento |
|
Estado
|
State | True | string |
Estado de fluxo |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
descrição de saída
- response
- object
Obter documentos
Obter arquivos de documento com base na ID do documento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
|
Docx ou PDF
|
OutputFormat | True | string |
Formatar para os documentos gerados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
QuestionnaireName
|
QuestionnaireName | string |
Nome do questionário |
|
Nome do documento (documento único)
|
FirstFileName | string |
Nome do documento (uso somente para um único documento) |
|
Conteúdo do documento (documento único)
|
FirstFileContentBytes | string |
Objeto codificado em Base64 para conteúdo do documento |
|
Arquivos
|
Files | array of object |
Coleção de arquivos criados para documento |
|
Nomes para todos os documentos (vários documentos)
|
Files.Name | string |
Lista de nomes para todos os documentos |
|
Conteúdo para todos os documentos (vários documentos)
|
Files.ContentBytes | string |
Lista de objetos codificados em Base64 para conteúdo de todos os documentos |
Obter informações de fluxo
Obter informações de fluxo com base na chave de fluxo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de fluxo
|
FlowKey | True | string |
A chave de fluxo do Rascunho do Documento |
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
Retornos
Obter informações de questionário
Buscar variáveis para um único modelo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Workspace
|
WorkSpace | True | string |
Selecionar workspace no menu suspenso |
|
Questionário
|
TemplateId | True | string |
Selecionar modelo na lista suspensa |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
Obter link de questionário anônimo
Obter um deeplink para o questionário de compartilhamento externo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Digite uma referência para identificar o link
|
Scope | True | string |
Especificar referência para link na ação de gatilho |
|
Link válido em dias
|
ExpireDays | True | integer |
O número de dias em que o link é válido |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
Retorna o link de compartilhamento
- Link
- string
Obter link para um questionário
Cria um novo link profundo para um questionário
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Email do usuário para link
|
True | string |
O email dos usuários para o link |
|
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
Retorna o link de compartilhamento
- Link
- string
Obter ou criar acesso à pasta
Obter informações sobre o acesso a uma pasta e criá-la se ela não existir
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Criar se não for encontrado
|
CreateIfNotFound | True | boolean |
Crie o objeto se ele não existir |
|
Nome do grupo do rascunho do documento
|
GroupNamePath | True | string |
Nome do grupo |
|
ID da pasta do rascunho do documento
|
FolderId | True | string |
ID da pasta |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Situação
|
Status | string |
O status atual do acesso |
Obter ou criar grupo
Obter informações sobre um grupo e criá-lo se ele não existir
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Criar se não for encontrado
|
CreateIfNotFound | True | boolean |
Crie o objeto se ele não existir |
|
Nome do grupo do rascunho do documento
|
GroupNamePath | True | string |
Nome do grupo |
|
Função De rascunho de documento
|
Role | string |
Função do usuário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
O identificador exclusivo do grupo |
|
Nome
|
Name | string |
O nome do grupo |
|
Situação
|
Status | string |
O status atual do grupo |
Obter ou criar pasta
Obter informações sobre uma pasta e criá-la se ela não existir
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Criar se não for encontrado
|
CreateIfNotFound | True | boolean |
Crie o objeto se ele não existir |
|
Nome da pasta do rascunho do documento
|
FolderName | True | string |
Nome da pasta |
|
Pasta pai do rascunho do documento/ID do workspace
|
ParentId | True | string |
ID da pasta/workspace pai |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
O identificador exclusivo da pasta |
|
Nome
|
Name | string |
O nome da pasta |
|
Caminho
|
Path | string |
O caminho da pasta |
|
Situação
|
Status | string |
O status atual da pasta |
Obter ou criar usuário
Obter informações sobre um usuário e criá-lo se ele não existir
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Criar se não for encontrado
|
CreateIfNotFound | True | boolean |
Crie o objeto se ele não existir |
|
Nome do grupo do rascunho do documento
|
GroupName | True | string |
Nome do grupo |
|
Email do Usuário do Rascunho do Documento
|
True | string |
E-mail do usuário |
|
|
Convite de envio de rascunho de documento para o usuário
|
sendInvite | True | boolean |
Enviar convite para o usuário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Situação
|
Status | string |
O status atual do usuário |
|
ID
|
Id | string |
O identificador exclusivo do usuário |
|
Nome
|
Name | string |
O nome do utilizador |
|
Senha
|
Password | string |
A senha do usuário (retornada somente quando criado e nenhum convite enviado) |
Obter ou criar workspace
Obter informações sobre um workspace e criá-lo se ele não existir
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Nome do espaço de trabalho
|
WorkspaceNameRoute | True | string |
Nome do workspace |
|
Criar se não for encontrado
|
CreateIfNotFound | True | boolean |
Crie o objeto se ele não existir |
|
Workspace mestre
|
MasterWorkSpace | string |
Selecione o workspace mestre no menu suspenso |
|
|
Copiar o estilo do workspace mestre
|
CopyStyling | boolean |
Copiar o estilo do workspace mestre |
|
|
Copiar pastas do workspace mestre
|
CopyFolders | boolean |
Copiar estrutura de pastas do workspace mestre |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
O identificador exclusivo do workspace |
|
Nome
|
Name | string |
O nome do espaço de trabalho |
|
Caminho
|
Path | string |
O caminho do workspace |
|
Situação
|
Status | string |
O status atual do workspace |
Preencher todas as marcas para questionário
Obter marcas de questionário
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento para questionário
|
DocumentId | string |
ID do documento para questionário |
|
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of object |
Lista de marcas para questionário |
|
marca
|
items.tag | string |
Marca para o elemento de dados |
|
responder
|
items.answer | string |
Resposta para o elemento marcado |
Revogar o acesso a um questionário para todos os usuários e grupos
Revogar o acesso a um questionário para todos os usuários e grupos
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID do documento
|
DocumentId | True | string |
ID exclusiva única para todos os documentos gerados |
|
Email do usuário
|
CreateUser | True | string |
Email do usuário disparando o fluxo |
Retornos
descrição de saída
- response
- object
Salvar arquivo estático em uma pasta
Salva um arquivo estático em uma pasta especificada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
ID da pasta do rascunho do documento
|
FolderId | True | string |
ID da pasta |
|
Nome do Arquivo do Rascunho do Documento com extensão
|
FileName | True | string |
Nome do arquivo a ser carregado, incluindo a extensão |
|
Arquivo do Rascunho de Documento na base64
|
FileBase64 | True | string |
Arquivo a ser carregado no formato base64 |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
O identificador exclusivo da pasta |
|
Nome
|
Name | string |
O nome da pasta |
|
Caminho
|
Path | string |
O caminho da pasta |
|
Situação
|
Status | string |
O status atual da pasta |
Gatilhos
| Aguardar envio do link de compartilhamento externo |
Esse gatilho aguarda o questionário ter sido enviado do link de compartilhamento externo |
| Gatilho de fluxo no botão de questionário pressionado |
Esse gatilho verifica a plataforma do Document Drafter em busca de um novo gatilho de fluxo personalizado com base em uma chave de fluxo |
Aguardar envio do link de compartilhamento externo
Esse gatilho aguarda o questionário ter sido enviado do link de compartilhamento externo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
|
Digite uma referência para identificar o link
|
Scope | True | string |
Especificar referência para link na ação de gatilho |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of object | |
|
status
|
items.status | string |
O status do trabalho (Concluído, Tempo Limite) |
|
documentId
|
items.documentId | string |
ID de documento exclusiva |
Gatilho de fluxo no botão de questionário pressionado
Esse gatilho verifica a plataforma do Document Drafter em busca de um novo gatilho de fluxo personalizado com base em uma chave de fluxo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de fluxo
|
FlowKey | True | string |
A chave de fluxo do Rascunho do Documento |
|
URL do Portal do Rascunho de Documentos
|
SiteUrl | True | string |
Por exemplo, contenso.documentdrafter.com |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
items
|
items | array of object |
items |
|
Email do usuário
|
items.createUser | string |
Email do usuário disparando o fluxo |
|
ID do documento
|
items.documentId | string |
ID exclusiva única para todos os documentos gerados |
|
Carimbo de data/hora de fluxo
|
items.triggerTime | string |
Carimbo de data/hora quando o fluxo foi disparado. |
|
Nome do questionário
|
items.documentName | string |
Nome do questionário que dispara o fluxo |
|
Chave de estado atual
|
items.stateKey | string |
Chave de estado atual do documento |
|
Chave de gatilho
|
items.triggerKey | string |
Chave disparada para evento |
|
Dados para evento
|
items.additionalData | string |
Disparar dados para evento |
|
Email de origem
|
items.OriginCreateUser | string |
Email de origem do usuário que está criando o questionário |
Definições
cadeia
Esse é o tipo de dados básico 'string'.
objeto
Esse é o tipo 'object'.