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.

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 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 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.
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

ID d’opération :
CreateEntry

Crée une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
Entrée
 entry True dynamic

Entrée à créer pour le formulaire

Retours

Les sorties de cette opération sont dynamiques.

Définir la disponibilité du formulaire

ID d’opération :
SetFormAvailability

Définit la disponibilité d’un formulaire.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
Début de la disponibilité
 start date-time

Date de début de la disponibilité
Fin de la disponibilité
 end date-time

Date de fin de la disponibilité
Message non disponible
 message string

Message non disponible

Retours

Informations de disponibilité de formulaire telles que la disponibilité de début/fin et le message non disponible.

Corps
FormAvailability

Entrée de mise à jour

ID d’opération :
EditEntry

Met à jour une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
ID d’entrée
 entryId True string

ID d’entrée
Entrée
 entry True dynamic

Données d’entrée mises à jour

Retours

Les sorties de cette opération sont dynamiques.

Obtenir un document

ID d’opération :
GetDocument

Obtient un document

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
ID d’entrée
 entry True string

ID d’entrée
Numéro de modèle
 templateNumber True integer

Numéro de modèle

Retours

Référence de fichier qui inclut les données de fichier et les métadonnées

Corps
FileDataRef

Obtenir un fichier

ID d’opération :
GetFile

Obtient un fichier par ID

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
 id True string

Identificateur unique du fichier

Retours

Référence de fichier qui inclut les données de fichier et les métadonnées

Corps
FileDataRef

Obtenir une entrée

ID d’opération :
GetEntry

Obtient une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
ID d’entrée
 entryId True string

ID d’entrée

Retours

Les sorties de cette opération sont dynamiques.

Supprimer l’entrée

ID d’opération :
DeleteEntry

Supprimez une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 form True string

Nom du formulaire
ID d’entrée
 entryId True string

ID d’entrée

Retours

Les sorties de cette opération sont dynamiques.

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

ID d’opération :
UpdateEntry

Se déclenche lorsqu’une personne met à jour une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 publisher True string

Nom du formulaire

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une entrée est supprimée

ID d’opération :
EntryDeleted

Se déclenche lorsqu’une personne supprime une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 publisher True string

Nom du formulaire

Retours

Les sorties de cette opération sont dynamiques.

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

ID d’opération :
NewEntry

Se déclenche lorsqu’une personne crée une entrée.

Paramètres

Nom Clé Obligatoire Type Description
Formulaire
 publisher True string

Nom du formulaire

Retours

Les sorties de cette opération sont dynamiques.

Définitions

FileDataRef

Référence de fichier qui inclut les données de fichier et les métadonnées

Nom Chemin d’accès Type Description
ID de fichier
 Id string

ID unique du fichier.
Nom du fichier
 Name string

Nom du fichier
Type de contenu de fichier
 ContentType string

Type de contenu du fichier.
Taille du fichier
 Size integer

Taille du fichier.
URL du fichier
 File string

URL du fichier.
Contenu du fichier
 Content byte

Contenu du fichier

FormAvailability

Informations de disponibilité de formulaire telles que la disponibilité de début/fin et le message non disponible.

Nom Chemin d’accès Type Description
Démarrage de la disponibilité du formulaire
 availabilityStart date-time

Démarrage de la disponibilité du formulaire
Fin de la disponibilité du formulaire
 availabilityEnd date-time

Fin de la disponibilité du formulaire
Message non disponible
 notAvailableMessage string

Message non disponible