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 de chine Azure      - Us Department of Defense (DoD)
Power Apps	Norme	Toutes les régions Power Apps à l’exception des éléments suivants :      - 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
Publisher	Cognito Forms, LLC
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 support ou contactez-nous pour obtenir de l’aide sur notre connecteur Power Automate public.

Publisher : Formulaires Cognito

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

ImportEntries

Cette action crée, met à jour ou supprime des entrées à l’aide du contenu de fichier fourni (.xlsx ou .csv). La sortie est un objet contenant l’ID d’importation et l’état.

Paramètres :

• form: Nom ou ID du formulaire interne
• File: fichier (.xlsx ou .csv) contenant les entrées à importer
• ImportMode: mode de l’importation (CreateNew, UpdateExisting ou SyncEntries)
• Email: adresse e-mail à recevoir des notifications d’importation (facultatif)
• MatchEntriesUsing: remplacement d’ID d’entrée (facultatif)

GetImportStatus

Cette action obtient l’état actuel d’une importation et retourne le nombre d’entrées réussies et infructueuses. La sortie est un objet contenant l’état d’importation, le nombre et les informations d’erreur le cas échéant.

Paramètres :

• form: Nom ou ID du formulaire interne
• importId: ID de l’importation pour vérifier l’état

UploadFile

Cette action charge un fichier dans Cognito Forms.

Paramètres :

• fileContent: données binaires du fichier
• fileName : nom du fichier

GetEntryViewEntries

Cette action obtient toutes les entrées d’une vue spécifiée. La sortie sera les données d’entrée en fonction de la configuration de la vue.

Paramètres :

• form: Nom ou ID du formulaire interne
• viewId: ID de la vue
• $count: Inclure le nombre total d’entrées (facultatif)
• $select: retourne la liste des ID d’entrée dans une vue lorsque $select=Id est spécifié (facultatif)

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 en tant qu’objets qui contiennent le Id et 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 Id doit être envoyé à l’API. Les formulaires archivés ne sont pas inclus dans la réponse.

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.
Importer des entrées	Crée, met à jour ou supprime des entrées à l’aide du contenu de fichier fourni.
Obtenir des entrées de formulaire	Obtenir toutes les entrées d’une vue spécifiée
Obtenir l’état de l’importation	Obtient l’état actuel d’une importation et retourne le nombre d’entrées réussies et infructueuses.
Obtenir un document	Obtient un document
Obtenir une entrée	Obtient une entrée.
Récupérer fichier	Obtient un fichier par ID.
Supprimer l’entrée	Supprimez une entrée.
Télécharger le fichier	Charge un fichier à utiliser dans les entrées de formulaire.

Créer une entrée

Définir la disponibilité du formulaire

Entrée de mise à jour

Importer des entrées

Obtenir des entrées de formulaire

Obtenir l’état de l’importation

Obtenir un document

Obtenir une entrée

Récupérer fichier

Supprimer l’entrée

Télécharger le fichier

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

object