Formulaires Cognito

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Norme	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Régions Azure Government      - Régions Azure Chine      - Us Department of Defense (DoD)
Power Apps	Norme	Toutes les régions Power Apps , à l’exception des suivantes :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Norme	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

Contact
Nom	Prise en charge des formulaires Cognito
URL	https://www.cognitoforms.com/support
Messagerie électronique	support@cognitoforms.com

Métadonnées du connecteur
Éditeur	Formulaires Cognito
Site internet	https://www.cognitoforms.com
Politique de confidentialité	https://www.cognitoforms.com/legal/privacy
Catégories	Productivité; Collaboration

Formulaires Cognito

Cognito Forms vous permet de créer facilement des formulaires en ligne puissants, tels que des enquêtes, des formulaires de commande, des formulaires d’inscription et bien plus encore. Gratuitement. Consultez notre documentation de support ou contactez-nous pour obtenir de l’aide sur notre connecteur Power Automate public.

Éditeur : Cognito Forms

Prerequisites

Un abonnement payant est requis.

Opérations prises en charge

Triggers

Les déclencheurs seront envoyés peu après l’événement abonné.

NewEntry

Cette opération est déclenchée lorsqu’une nouvelle entrée est créée pour le formulaire spécifié. La sortie sera les données d’entrée, y compris les données de fichier et les liens temporaires vers les fichiers, les signatures et les documents d’entrée.

Paramètres :

• form: nom du formulaire pour lequel les nouveaux événements d’entrée seront abonnés.

UpdateEntry

Cette opération est déclenchée lorsqu’une entrée est mise à jour pour le formulaire spécifié. La sortie sera les données d’entrée, y compris les données de fichier et les liens temporaires vers les fichiers, les signatures et les documents d’entrée.

Paramètres :

• form: nom du formulaire pour lequel les événements d’entrée mis à jour seront abonnés.

EntryDeleted

Cette opération est déclenchée lorsqu’une entrée est supprimée pour le formulaire spécifié. La sortie sera les données d’entrée, à l’exclusion des liens.

Paramètres :

• form: nom du formulaire pour lequel les événements supprimés d’entrée seront abonnés.

Actions

CreateEntry

Cette action crée une entrée pour le formulaire spécifié. L’action inclut des propriétés settables pour chaque champ d’entrée, à l’exclusion de certains types de champs. La sortie sera les données d’entrée.

Paramètres :

• form: Nom ou ID du formulaire interne

EditEntry

Cette action met à jour une entrée existante pour le formulaire spécifié. L’action inclut des propriétés settables pour chaque champ d’entrée, à l’exclusion de certains types de champs. Cette action échoue si l’entrée inclut une commande payante ou si l’id d’entrée n’existe pas. La sortie sera les données d’entrée mises à jour.

Paramètres :

• form: Nom ou ID du formulaire interne
• entryId: numéro d’entrée ou ID d’entrée à mettre à jour pour l’entrée

SetFormAvailability

Cette action définit les paramètres de disponibilité limite du formulaire. Les start paramètres et end les paramètres doivent être vides pour rendre le formulaire disponible tout le temps. La sortie sera les paramètres de disponibilité mis à jour.

Paramètres :

• form: Nom ou ID du formulaire interne
• start: date à laquelle le formulaire doit être disponible.
• end: date à laquelle le formulaire ne doit plus être disponible.
• message: message qui doit être affiché aux utilisateurs qui tentent d’accéder au formulaire en dehors de la période de disponibilité.

GetFile

Cette action récupère un fichier à partir du stockage. La sortie est un objet contenant les données du fichier, les métadonnées et un lien temporaire vers le fichier.

Paramètres :

• id: ID de fichier à récupérer.

GetDocument

Cette action génère et récupère un document d’entrée à l’aide du formulaire, de l’entrée et du modèle spécifiés. La sortie est un objet contenant les données de fichier du document, les métadonnées et un lien temporaire vers le document.

Paramètres :

• form: Nom ou ID du formulaire interne
• entry: ID d’entrée ou numéro d’entrée de l’entrée pour laquelle le document doit être généré
• templateNumber: nombre du modèle à utiliser pour générer le document d’entrée

GetEntry

Cette action obtient une entrée existante pour le formulaire spécifié. Cette action échoue si l’entrée n’existe pas. La sortie sera les données d’entrée.

Paramètres :

• form: Nom ou ID du formulaire interne
• entryId: numéro d’entrée ou ID d’entrée à récupérer pour l’entrée

DeleteEntry

Cette action supprime une entrée existante pour le formulaire spécifié. Cette action échoue si l’entrée n’existe pas. Il n’y aura pas de sortie.

Paramètres :

• form: Nom ou ID du formulaire interne
• entryId: numéro d’entrée ou ID d’entrée pour la suppression de l’entrée

Opérations privées

Ces opérations sont des enablers pour les déclencheurs et actions publics.

GetForms

Cette opération retourne une liste de formulaires sous forme d’objets qui contiennent le Id, InternalNameet Name. Lorsqu’il est utilisé pour le form paramètre pour les actions et les déclencheurs, l’utilisateur doit voir le Name, mais il InternalName doit être envoyé à l’API.

GetFormSchema

Cette opération retourne le schéma du formulaire spécifié. Le input paramètre doit être vrai pour que les actions excluent les propriétés en lecture seule et false pour que les déclencheurs incluent toutes les propriétés. Le includeLinks paramètre doit être true pour toutes les actions et déclencheurs, à l’exception d’EntryDeleted.

Paramètres :

• form: Nom ou ID du formulaire interne
• input: valeur booléenne indiquant si le schéma retourné doit exclure les propriétés qui ne peuvent pas être définies. False par défaut.
• includeLinks: valeur booléenne indiquant si les propriétés de lien des fichiers, signatures et documents doivent être incluses dans le schéma. True par défaut.

UnsubscribeWebhook

Cette opération désinscrit le webhook spécifié. Le webhook ne recevra plus d’événements après l’envoi de tous les événements actuellement mis en file d’attente.

Paramètres :

• id: ID du webhook qui doit être désinscrit.
• module: module du webhook. Cette valeur doit être définie sur « forms », car ce connecteur prend uniquement en charge ce module.

Obtention des informations d’identification

Un propriétaire de l’organisation doit se connecter à Cognito Forms et autoriser la connexion.

Problèmes connus

Aucun

Instructions de déploiement

Cognito Forms nécessite un connecteur valide Client id et Client secret pour créer un connecteur. Ces propriétés sont disponibles dans le coffre de clés et doivent être définies uniquement dans les paramètres d’authentification du connecteur personnalisé.

1. Run:

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

2. Connexion à PowerAutomate

3. Accédez au nouveau connecteur

4. Sous « Sécurité », mettez à jour et Client idClient secret

5. Mettre à jour le connecteur

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	100	60 secondes

Actions

Créer une entrée	Crée une entrée.
Définir la disponibilité du formulaire	Définit la disponibilité d’un formulaire.
Entrée de mise à jour	Met à jour une entrée.
Obtenir un document	Obtient un document
Obtenir un fichier	Obtient un fichier par ID
Obtenir une entrée	Obtient une entrée.
Supprimer l’entrée	Supprimez une entrée.

Créer une entrée

Définir la disponibilité du formulaire

Entrée de mise à jour

Obtenir un document

Obtenir un fichier

Obtenir une entrée

Supprimer l’entrée

Déclencheurs

Lorsqu’une entrée est mise à jour	Se déclenche lorsqu’une personne met à jour une entrée.
Lorsqu’une entrée est supprimée	Se déclenche lorsqu’une personne supprime une entrée.
Lorsqu’une nouvelle entrée est créée	Se déclenche lorsqu’une personne crée une entrée.

Lorsqu’une entrée est mise à jour

Lorsqu’une entrée est supprimée

Lorsqu’une nouvelle entrée est créée

Définitions

FileDataRef

FormAvailability