Formspace (versão prévia)
O Formspace é um formulário online e uma plataforma de fluxo de trabalho que ajuda as equipes a coletar informações estruturadas, coordenar aprovações e gerenciar o trabalho de acompanhamento. Use essa integração para iniciar processos automatizados a partir de novas respostas de formulário ou etapas específicas de fluxo de trabalho, acessar dados de resposta e arquivos carregados e gerar PDFs de resposta para email, armazenamento e outros sistemas de negócios.
Esse conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões 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: – Azure Governamental regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões 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 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 Formspace |
| URL | https://formspace.com/contact |
| support@formspace.com |
| Metadados do conector | |
|---|---|
| Publicador | VP LABS PTY LTD |
| Site | https://formspace.com |
| Política de privacidade | https://formspace.com/privacy |
| Categories | Produtividade; Gestão de empresas |
Formspace
O Formspace ajuda as equipes a criar formulários, coletar respostas e coordenar o trabalho de acompanhamento. Esse conector inicia fluxos automatizados quando uma resposta de formulário é enviada ou quando um fluxo de trabalho do Formspace publicado atinge um destino conectado. Ele também fornece ações para recuperar arquivos enviados e PDFs de resposta.
Pré-requisitos
- Uma conta do Formspace.
- Associação no Formspace que possui o formulário ou fluxo de trabalho.
- Um formulário publicado antes que um gatilho enviado por resposta possa ser executado.
- Capacidade de execução de fluxo de trabalho disponível na assinatura do Formspace.
Gatilhos
Quando uma resposta de formulário é enviada
Inicia um fluxo sempre que o formulário publicado selecionado recebe uma resposta concluída. O gatilho fornece formulário, resposta, respondente e dados de resposta. As propriedades de resposta são digitadas do esquema publicado do formulário selecionado ou de seu esquema de rascunho atual se o formulário ainda não tiver sido publicado.
Para usar este gatilho:
- Crie um fluxo automatizado e selecione Quando uma resposta de formulário for enviada.
- Entre no Formspace.
- Selecione um formspace e um formulário.
- Salve o fluxo.
O gatilho é executado independentemente da publicação do fluxo de trabalho do Formspace. Depois que a conexão é salva, o fluxo também aparece como uma conexão somente leitura abaixo do Formulário Enviado na tela de fluxo de trabalho do formulário.
Quando invocado por um fluxo de trabalho do Formspace
Registra o fluxo como um destino reutilizável que pode ser selecionado por um fluxo de trabalho do Formspace. Use esse gatilho quando uma ação de aprovação, condição, branch ou fluxo de trabalho anterior deve controlar quando o fluxo é iniciado.
Para usar este gatilho:
- Crie um fluxo automatizado e selecione Quando invocado por um fluxo de trabalho do Formspace.
- Entre no Formspace.
- Selecione um Formspace e insira um nome para o destino.
- Salve o fluxo.
- No Formspace, adicione Executar Power Automate fluxo a um fluxo de trabalho de formulário e selecione o destino.
- Conecte o bloco em que ele deve ser executado e publique o fluxo de trabalho.
O gatilho fornece um envelope de evento estável contendo formulário, resposta, respondente, fluxo de trabalho, resposta e contexto de aprovação. Um destino pertence ao Formspace selecionado e pode ser reutilizado por vários blocos de fluxo de trabalho.
Ações
Obter o conteúdo do arquivo enviado
Retorna o conteúdo binário, o nome do arquivo original e o tipo de conteúdo de um arquivo carregado com uma resposta enviada. Use a ID de resposta e a referência de arquivo durável fornecida por um gatilho do Formspace.
Obter PDF de resposta
Gera um PDF que contém a resposta enviada e seu histórico de fluxo de trabalho do Formspace. Use a ID de resposta fornecida por qualquer gatilho do Formspace.
Limitações e problemas conhecidos
- Se um esquema de formulário for alterado depois que um gatilho enviado por resposta for configurado, atualize ou reelecione o gatilho antes de usar campos de resposta recém-adicionados ou alterados.
- As URLs de resposta de arquivo e assinatura expiram após 24 horas. Os arquivos carregados também incluem uma referência de arquivo durável para obter o conteúdo do arquivo enviado. As imagens de assinatura devem ser copiadas antes que a URL temporária expire.
- A entrega pausa se o proprietário da conexão for removido do Formspace, banido ou excluído. Um membro atual pode recriar o gatilho para assumir a propriedade da conexão.
- Desativar ou excluir um gatilho desconecta sua entrega. Os blocos de fluxo de trabalho do Formspace existentes mantêm o destino selecionado para que o mesmo fluxo possa ser reconectado posteriormente.
- As execuções de automação estão sujeitas ao subsídio de execução de fluxo de trabalho mensal da assinatura do Formspace.
Support
- Documentação do produto: documentação do Formspace
- Suporte: suporte ao Formspace
- Política de privacidade: política de privacidade do Formspace
- Termos: termos e condições do Formspace
Ações
| Obter o conteúdo do arquivo enviado |
Baixa um arquivo de uma resposta enviada usando a referência de arquivo fornecida por um gatilho do Formspace. |
| Obter PDF de resposta |
Gera um PDF que contém a resposta enviada e seu histórico de fluxo de trabalho do Formspace. |
Obter o conteúdo do arquivo enviado
Baixa um arquivo de uma resposta enviada usando a referência de arquivo fornecida por um gatilho do Formspace.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de resposta
|
responseId | True | string |
A ID de resposta enviada de um gatilho do Formspace. |
|
Referência de arquivo
|
fileReference | True | string |
A referência de arquivo opaco de uma resposta de arquivo enviada. |
Retornos
- response
- file
Obter PDF de resposta
Gera um PDF que contém a resposta enviada e seu histórico de fluxo de trabalho do Formspace.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de resposta
|
responseId | True | string |
A ID de resposta enviada de um gatilho do Formspace. |
Retornos
- response
- file
Gatilhos
| Quando invocado por um fluxo de trabalho do Formspace |
Registra esse fluxo como um destino reutilizável para fluxos de trabalho do Formspace. |
| Quando uma resposta de formulário é enviada |
Inicia esse fluxo sempre que o formulário selecionado recebe uma nova resposta. |
Quando invocado por um fluxo de trabalho do Formspace
Registra esse fluxo como um destino reutilizável para fluxos de trabalho do Formspace.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Formspace
|
organizationId | True | string |
O Formspace que pode invocar esse fluxo. |
|
Nome no Formspace
|
name | True | string |
Um nome amigável usado para selecionar esse fluxo no Formspace. |
Retornos
- Corpo
- WorkflowTriggerPayload
Quando uma resposta de formulário é enviada
Inicia esse fluxo sempre que o formulário selecionado recebe uma nova resposta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Formspace
|
organizationId | True | string |
O Formspace que contém o formulário. |
|
Form
|
formId | True | string |
O formulário cujas respostas iniciam esse fluxo. |
Retornos
Definições
TriggerForm
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
A ID do formulário. |
|
title
|
title | string |
O título do formulário. |
TriggerResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
A ID de resposta. |
|
número
|
number | integer |
O número de resposta sequencial do formulário quando disponível. |
|
url
|
url | uri |
Um link do Formspace para a resposta. |
|
submittedAt
|
submittedAt | date-time |
Quando a resposta foi enviada, quando disponível. |
TriggerRespondent
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
email
|
O endereço de email verificado do entrevistado quando disponível. |
WorkflowTriggerPayload
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
evento
|
event | TriggerEvent | |
|
formulário
|
form | TriggerForm | |
|
response
|
response | TriggerResponse | |
|
entrevistado
|
respondent | TriggerRespondent | |
|
fluxo de trabalho
|
workflow | TriggerWorkflow | |
|
respostas
|
answers | object |
As respostas enviadas como um objeto aberto. |
|
aprovação
|
approval | object |
Os dados de aprovação atuais quando esse fluxo segue uma aprovação. |
TriggerEvent
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Um identificador exclusivo para essa invocação. |
|
tipo
|
type | string |
O tipo de evento. |
|
triggeredAt
|
triggeredAt | date-time |
Quando o fluxo de trabalho invocou o fluxo conectado. |
TriggerWorkflow
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
runId
|
runId | string |
A ID de execução do fluxo de trabalho. |
|
versionId
|
versionId | string |
A ID da versão do fluxo de trabalho publicada quando disponível. |
|
blockId
|
blockId | string |
A ID do bloco que invocou esse fluxo. |
|
blockName
|
blockName | string |
O nome do bloco mostrado no Formspace. |
arquivo
Esse é o tipo de dados básico 'file'.