Formulários cognito

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

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

Metadados do conector
Publisher	Cognito Forms, LLC
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 support ou contact us para obter ajuda com nosso conector de Power Automate público.

Publisher: 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

ImportEntries

Essa ação criará, atualizará ou excluirá entradas usando o conteúdo do arquivo fornecido (.xlsx ou .csv). A saída será um objeto que contém a ID de importação e o status.

Parâmetros:

• form: o nome do formulário interno ou a ID
• File: o arquivo (.xlsx ou .csv) que contém as entradas a serem importadas
• ImportMode: o modo de importação (CreateNew, UpdateExisting ou SyncEntries)
• Email: o endereço de email para receber notificações de importação (opcional)
• MatchEntriesUsing: um substituto de ID de entrada (opcional)

GetImportStatus

Essa ação obterá o status atual de uma importação e retornará o número de entradas bem-sucedidas e malsucedidas. A saída será um objeto que contém o status de importação, contagens e informações de erro, se aplicável.

Parâmetros:

• form: o nome do formulário interno ou a ID
• importId: a ID da importação para verificar o status

UploadFile

Essa ação carregará um arquivo no Cognito Forms.

Parâmetros:

• fileContent: os dados binários do arquivo
• fileName: o nome do arquivo

GetEntryViewEntries

Essa ação obterá todas as entradas para um modo de exibição especificado. A saída será os dados de entrada com base na configuração de exibição.

Parâmetros:

• form: o nome do formulário interno ou a ID
• viewId: a ID do modo de exibição
• $count: inclua a contagem total de entradas (opcional)
• $select: retorna a lista de IDs de entrada em um modo de exibição quando $select=Id é especificado (opcional)

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 e Name. Quando usado para o form parâmetro para ações e gatilhos, o usuário deve ver o Name, mas o Id deve ser enviado para a API. Os formulários arquivados não estão incluídos na resposta.

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

Carregar Arquivo	Carrega um arquivo a ser usado em entradas de formulário.
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.
Importar Entradas	Cria, atualiza ou exclui entradas usando o conteúdo do arquivo fornecido.
Obter arquivo	Obtém um arquivo por id.
Obter Documento	Obtém um documento
Obter entrada	Obtém uma entrada.
Obter entradas de formulário	Obter todas as entradas para um modo de exibição especificado
Obter status de importação	Obtém o status atual de uma importação e retorna o número de entradas bem-sucedidas e malsucedidas.

Carregar Arquivo

Criar entrada

Definir a disponibilidade do formulário

Entrada de atualização

Excluir entrada

Importar Entradas

Obter arquivo

Obter Documento

Obter entrada

Obter entradas de formulário

Obter status de importação

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

objeto