Formulários cognito

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

Service	Class	Regions
Copilot Studio	Standard	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	Standard	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	Standard	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 do Cognito Forms
URL	https://www.cognitoforms.com/support
Email	support@cognitoforms.com

Metadados do conector
Publicador	Formulários cognito
Site	https://www.cognitoforms.com
Política de Privacidade	https://www.cognitoforms.com/legal/privacy
Categorias	Produtividade; Colaboração

Formulários cognito

O Cognito Forms permite que você crie facilmente formulários online avançados, como pesquisas, formulários de pedidos, formulários de registro e muito mais. De graça. Consulte nossa documentação de suporte ou entre em contato conosco para obter ajuda com nosso conector público do Power Automate.

Publicador: Cognito Forms

Pré-requisitos

Uma assinatura paga é necessária.

Operações com suporte

Triggers

Os gatilhos serão enviados logo após a ocorrência do evento assinado.

NewEntry

Isso será disparado quando uma nova entrada for criada para o formulário especificado. A saída serão os dados de entrada, incluindo dados de arquivo e links temporários para arquivos, assinaturas e documentos de entrada.

Parâmetros:

• form: o nome do formulário para o qual novos eventos de entrada serão assinados.

UpdateEntry

Isso será disparado quando uma entrada for atualizada para o formulário especificado. A saída serão os dados de entrada, incluindo dados de arquivo e links temporários para arquivos, assinaturas e documentos de entrada.

Parâmetros:

• form: o nome do formulário para o qual os eventos de entrada atualizados serão assinados.

EntryDeleted

Isso será disparado quando uma entrada for excluída para o formulário especificado. A saída serão os dados de entrada, excluindo links.

Parâmetros:

• form: o nome do formulário para o qual os eventos excluídos de entrada serão assinados.

Ações

CreateEntry

Essa ação criará uma entrada para o formulário especificado. A ação incluirá propriedades configuráveis para cada campo de entrada, excluindo alguns tipos de campo. A saída serão os dados de entrada.

Parâmetros:

• form: o nome do formulário interno ou a ID

EditEntry

Essa ação atualizará uma entrada existente para o formulário especificado. A ação incluirá propriedades configuráveis para cada campo de entrada, excluindo alguns tipos de campo. Essa ação falhará se a entrada incluir um pedido pago ou se a entryId não existir. A saída será os dados de entrada atualizados.

Parâmetros:

• form: o nome do formulário interno ou a ID
• entryId: o número de entrada ou a ID de entrada para a entrada a ser atualizada

SetFormAvailability

Essa ação definirá as configurações de disponibilidade de limite do formulário. O start e end os parâmetros devem estar em branco para disponibilizar o formulário o tempo todo. A saída será as configurações de disponibilidade atualizadas.

Parâmetros:

• form: o nome do formulário interno ou a ID
• start: o datetime no qual o formulário deve ficar disponível.
• end: o datetime no qual o formulário não deve mais estar disponível.
• message: a mensagem que deve ser mostrada aos usuários que tentam acessar o formulário quando estiver fora do período de disponibilidade.

GetFile

Essa ação recuperará um arquivo do armazenamento. A saída será um objeto que contém os dados do arquivo, os metadados e um link temporário para o arquivo.

Parâmetros:

• id: a ID do arquivo a ser recuperado.

GetDocument

Essa ação gerará e recuperará um documento de entrada usando o formulário, a entrada e o modelo especificados. A saída será um objeto que contém os dados do arquivo do documento, os metadados e um link temporário para o documento.

Parâmetros:

• form: o nome do formulário interno ou a ID
• entry: A ID de entrada ou o número de entrada da entrada para a qual o documento deve ser gerado
• templateNumber: o número do modelo que deve ser usado para gerar o documento de entrada

GetEntry

Essa ação obterá uma entrada existente para o formulário especificado. Essa ação falhará se a entrada não existir. A saída serão os dados de entrada.

Parâmetros:

• form: o nome do formulário interno ou a ID
• entryId: o número de entrada ou a ID de entrada para a entrada a ser recuperada

DeleteEntry

Essa ação excluirá uma entrada existente para o formulário especificado. Essa ação falhará se a entrada não existir. Não haverá saída.

Parâmetros:

• form: o nome do formulário interno ou a ID
• entryId: o número de entrada ou a ID de entrada para a entrada a ser excluída

Operações Privadas

Essas operações são habilitadores para os gatilhos e ações públicos.

GetForms

Esta operação retornará uma lista de formulários como objetos que contêm o Id, InternalNamee Name. Quando usado para o form parâmetro para ações e gatilhos, o usuário deve ver o Name, mas o InternalName deve ser enviado para a API.

GetFormSchema

Essa operação retornará o esquema do formulário especificado. O input parâmetro deve ser verdadeiro para que as ações excluam as propriedades somente leitura e false para que os gatilhos incluam todas as propriedades. O includeLinks parâmetro deve ser verdadeiro para todas as ações e gatilhos, exceto para EntryDeleted.

Parâmetros:

• form: o nome do formulário interno ou a ID
• input: um booliano que indica se o esquema retornado deve excluir propriedades que não podem ser definidas. False por padrão.
• includeLinks: um booliano que indica se as propriedades de link para arquivos, assinaturas e documentos devem ser incluídas no esquema. True por padrão.

CancelarsubscribeWebhook

Essa operação cancelará a assinatura do webhook especificado. O webhook não receberá mais eventos depois que todos os eventos na fila tiverem sido enviados.

Parâmetros:

• id: a ID do webhook que deve ser desinscrita.
• module: o módulo do webhook. Isso deve ser definido como "formulários", pois esse conector só dá suporte a esse módulo.

Obtendo credenciais

Um proprietário da organização deve fazer logon no Cognito Forms e autorizar a conexão.

Problemas conhecidos

None

Instruções de implantação

O Cognito Forms requer um conector válido Client id e Client secret um conector. Essas propriedades podem ser encontradas no cofre de chaves e devem ser definidas apenas nas configurações de autenticação do conector personalizado.

1. Run:

    paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
   

2. Fazer logon no PowerAutomate

3. Navegue até o novo conector

4. Em "Segurança" atualize o Client id e Client secret

5. Atualizar o conector

Limitações

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

Ações

Criar entrada	Cria uma nova entrada.
Definir a disponibilidade do formulário	Define a disponibilidade de um formulário.
Entrada de atualização	Atualiza uma entrada.
Excluir entrada	Excluir uma entrada.
Obter arquivo	Obtém um arquivo por id
Obter Documento	Obtém um documento
Obter entrada	Obtém uma entrada.

Criar entrada

Definir a disponibilidade do formulário

Entrada de atualização

Excluir entrada

Obter arquivo

Obter Documento

Obter entrada

Gatilhos

Quando uma entrada é atualizada	Dispara quando alguém atualiza uma entrada.
Quando uma entrada é excluída	Dispara quando alguém exclui uma entrada.
Quando uma nova entrada é criada	Dispara quando alguém cria uma nova entrada.

Quando uma entrada é atualizada

Quando uma entrada é excluída

Quando uma nova entrada é criada

Definições

FileDataRef

FormAvailability