Formularios de Cognito

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Estándar	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Estándar	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Compatibilidad con formularios de Cognito
URL	https://www.cognitoforms.com/support
Correo Electrónico	support@cognitoforms.com

Metadatos del conector
Publicador	Formularios de Cognito
Sitio web	https://www.cognitoforms.com
Directiva de privacidad	https://www.cognitoforms.com/legal/privacy
Categorías	Productividad; Colaboración

Formularios de Cognito

Cognito Forms le permite crear fácilmente formularios en línea eficaces, como encuestas, formularios de pedido, formularios de registro y mucho más. Gratuitamente. Consulte nuestra documentación de soporte técnico o póngase en contacto con nosotros para obtener ayuda con nuestro conector público de Power Automate.

Publicador: Formularios de Cognito

Prerrequisitos

Se requiere una suscripción de pago.

Operaciones admitidas

Desencadenadores

Los desencadenadores se enviarán poco después de que se produzca el evento suscrito.

NewEntry

Esto se desencadenará cuando se cree una nueva entrada para el formulario especificado. La salida será los datos de entrada, incluidos los datos de archivo y los vínculos temporales a archivos, firmas y documentos de entrada.

Parameters:

• form: nombre del formulario para el que se suscribirán nuevos eventos de entrada.

UpdateEntry

Esto se desencadenará cuando se actualice una entrada para el formulario especificado. La salida será los datos de entrada, incluidos los datos de archivo y los vínculos temporales a archivos, firmas y documentos de entrada.

Parameters:

• form: el nombre del formulario para el que se suscribirán los eventos de entrada actualizados.

EntryDeleted

Esto se desencadenará cuando se elimine una entrada para el formulario especificado. La salida será los datos de entrada, excepto los vínculos.

Parameters:

• form: el nombre del formulario para el que se suscribirán los eventos eliminados de entrada.

Acciones

CreateEntry

Esta acción creará una entrada para el formulario especificado. La acción incluirá propiedades que se pueden establecer para cada campo de entrada, excepto algunos tipos de campo. La salida será los datos de entrada.

Parameters:

• form: el nombre del formulario interno o el identificador

EditEntry

Esta acción actualizará una entrada existente para el formulario especificado. La acción incluirá propiedades que se pueden establecer para cada campo de entrada, excepto algunos tipos de campo. Esta acción producirá un error si la entrada incluye un pedido de pago o el entryId no existe. La salida será los datos de entrada actualizados.

Parameters:

• form: el nombre del formulario interno o el identificador
• entryId: número de entrada o identificador de entrada para la entrada que se va a actualizar.

SetFormAvailability

Esta acción establecerá la configuración de disponibilidad del límite del formulario. Los start parámetros y end deben estar en blanco para que el formulario esté disponible todo el tiempo. La salida será la configuración de disponibilidad actualizada.

Parameters:

• form: el nombre del formulario interno o el identificador
• start: fecha y hora en la que el formulario debe estar disponible.
• end: fecha y hora en la que el formulario ya no debe estar disponible.
• message: mensaje que se debe mostrar a los usuarios que intentan acceder al formulario cuando están fuera del período de disponibilidad.

GetFile

Esta acción recuperará un archivo del almacenamiento. La salida será un objeto que contiene los datos del archivo, los metadatos y un vínculo temporal al archivo.

Parameters:

• id: identificador de archivo para el archivo que se va a recuperar.

GetDocument

Esta acción generará y recuperará un documento de entrada mediante el formulario, la entrada y la plantilla especificados. La salida será un objeto que contiene los datos de archivo del documento, los metadatos y un vínculo temporal al documento.

Parameters:

• form: el nombre del formulario interno o el identificador
• entry: identificador de entrada o número de entrada de la entrada para la que se debe generar el documento.
• templateNumber: número de la plantilla que se debe usar para generar el documento de entrada.

GetEntry

Esta acción obtendrá una entrada existente para el formulario especificado. Esta acción producirá un error si la entrada no existe. La salida será los datos de entrada.

Parameters:

• form: el nombre del formulario interno o el identificador
• entryId: número de entrada o identificador de entrada para la entrada que se va a recuperar.

DeleteEntry

Esta acción eliminará una entrada existente para el formulario especificado. Esta acción producirá un error si la entrada no existe. No habrá ninguna salida.

Parameters:

• form: el nombre del formulario interno o el identificador
• entryId: número de entrada o identificador de entrada para la entrada que se va a eliminar.

Operaciones privadas

Estas operaciones son habilitadores para los desencadenadores y acciones públicos.

GetForms

Esta operación devolverá una lista de formularios como objetos que contienen , IdInternalNamey Name. Cuando se usa para el form parámetro para las acciones y los desencadenadores, el usuario debería ver , Namepero InternalName debe enviarse a la API.

GetFormSchema

Esta operación devolverá el esquema del formulario especificado. El input parámetro debe ser true para que las acciones excluyan las propiedades de solo lectura y false para que los desencadenadores incluyan todas las propiedades. El includeLinks parámetro debe ser true para todas las acciones y desencadenadores, excepto EntryDeleted.

Parameters:

• form: el nombre del formulario interno o el identificador
• input: un valor booleano que indica si el esquema devuelto debe excluir las propiedades que no se pueden establecer. False de forma predeterminada.
• includeLinks: un valor booleano que indica si las propiedades de vínculo para archivos, firmas y documentos deben incluirse en el esquema. True de forma predeterminada.

UnsubscribeWebhook

Esta operación cancelará la suscripción del webhook especificado. El webhook ya no recibirá ningún evento después de que se hayan enviado todos los eventos en cola actualmente.

Parameters:

• id: el identificador del webhook que se debe cancelar la suscripción.
• module: módulo del webhook. Debe establecerse en "forms", ya que este conector solo admite ese módulo.

Obtención de credenciales

Un propietario de la organización debe iniciar sesión en Cognito Forms y autorizar la conexión.

Problemas conocidos

Ninguno

Instrucciones de implementación

Cognito Forms requiere un conector válido Client id y Client secret para crear un conector. Estas propiedades se pueden encontrar en el almacén de claves y solo deben establecerse en la configuración de autenticación del conector personalizado.

1. Ejecutar:

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

2. Inicio de sesión en PowerAutomate

3. Vaya al nuevo conector.

4. En "Seguridad", actualice y Client idClient secret

5. Actualización del conector

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Crear entrada	Crea una nueva entrada.
Eliminar entrada	Elimine una entrada.
Entrada de actualización	Actualiza una entrada.
Establecimiento de la disponibilidad del formulario	Establece la disponibilidad de un formulario.
Obtener archivo	Obtiene un archivo por identificador
Obtener documento	Obtiene un documento.
Obtener entrada	Obtiene una entrada.

Crear entrada

Eliminar entrada

Entrada de actualización

Establecimiento de la disponibilidad del formulario

Obtener archivo

Obtener documento

Obtener entrada

Desencadenadores

Cuando se actualiza una entrada	Se desencadena cuando alguien actualiza una entrada.
Cuando se crea una nueva entrada	Se desencadena cuando alguien crea una nueva entrada.
Cuando se elimina una entrada	Se desencadena cuando alguien elimina una entrada.

Cuando se actualiza una entrada

Cuando se crea una nueva entrada

Cuando se elimina una entrada

Definiciones

FileDataRef

FormAvailability