Ajouter des fichiers joints aux soumissions de formulaire

Fonctionnalité limitée (disponible avec l’API seulement)

L’utilisation de téléverseurs de fichiers et la récupération de fichiers joints n’est que disponible les utilisateur·rice·s de Formulaires GC qui utilisent l’API pour récupérer les données soumises.

Accéder à la fonctionnalité de téléversement de fichiers

Formulaires GC dispose d’une interface de programmation d’application (API) qui peut être utilisée pour récupérer les réponses aux formulaires, à l’aide de connexion de machine à machine. La méthode de récupération des données via l’API est le seul moyen d’inclure des composants de téléverseurs de fichiers dans vos formulaires et de récupérer les fichiers joints aux réponses aux formulaires.

Consultez notre documentation technique sur l’API pour savoir comment configurer l’intégration de l’API pour un formulaire.

Créer un formulaire avec l’option de téléverser des fichiers

Cette version initiale du téléchargement de fichiers, en tant que fonctionnalité comporte certaines limitations. Cela inclut notamment des contraintes liées aux formats de fichiers, à la taille des fichiers et à la possibilité pour les utilisateur·rice·s de sauvegarder leurs progrès.

Récupération des données par API seulement :
- Devoir s’intégrer à l’API de récupération des données.
- Devoir garder cette méthode de livraison des réponses, sans modifier celle-ci ou supprimer la clé API une fois le formulaire publié.
Types de fichiers autorisés :
- Documents (pdf, txt, doc, docx)
- Images (jpg, jpeg, png)
- Feuilles de calcul (xls, xlsx, csv)
Limites de taille des fichiers :
- 10 Mo maximum par fichiers
- 50 fichiers dans un ensemble récurrent
Utilisateur·rice·s qui sauvegardent une copie de leurs réponses :
- La sauvegarde des réponses, qu’elles soient en cours ou déjà soumises, n’inclura pas les fichiers téléchargés eux-mêmes. Si un·e utilisateur·rice reprend le remplissage du formulaire plus tard, il devra télécharger à nouveau les fichiers déjà téléchargés.

Pour ajouter le téléverseur de fichiers à un formulaire que vous créez :

Créez un formulaire.
Dans les Paramètres > Intégration API, générez une clé API.
Collaborez avec un·e développeur·e pour intégrer l’API. Consultez la documentation API pour savoir comment procéder à l’authentification, vous connecter à votre système cible et effectuer diverses requêtes.
Ajoutez un élément à votre formulaire et sélectionnez le composant de téléverseur de fichiers.
Assurez-vous que votre formulaire contient également une question demandant les coordonnées des utilisateur·rice·s. (Ceci est important dans les cas où vous pourriez avoir besoin de faire un suivi, s’il y a un problème avec un fichier joint).
Testez et publiez votre formulaire.
Partagez votre formulaire et commencez à recevoir des réponses.

Récupérer des fichiers soumis dans un formulaire

La récupération des fichiers joints aux soumissions n’est possible que via la méthode de transmission des données API. Les mêmes conditions de stockage s’appliquent que pour les données de soumission, GC Forms ne conservant les données et les fichiers que temporairement jusqu’à leur téléchargement et leur confirmation.

Les fichiers sont directement liés aux réponses et accompagnés d’un attribut indiquant si l’analyse des fichiers malveillants a détecté un danger potentiel. Il est de votre responsabilité de vérifier l’attribut de malveillance isPotentiallyMalicious avant d’ouvrir les fichiers liés.

Pour récupérer les fichiers téléversés dans une soumission de formulaire :

Une fois configuré, votre système cible intégré effectuera un appel API pour récupérer les réponses. Vous recevrez chaque soumission sous forme de fichier JSON brut comprenant des liens directs vers les fichiers, s’ils sont joints.
- À noter : Pour des raisons de sécurité, ces liens de téléchargement direct ne sont valables que pendant 10 secondes.
Les fichiers étant analysés lors de leur soumission, ils peuvent également être signalés comme potentiellement malveillants, en fonction du logiciel d’analyse des fichiers. Vous devez décider quoi faire avec les fichiers signalés — soit que vous les téléchargez ou non, s’ils comportent un attribut de métadonnées « malveillant » ou « mauvais ».
- À noter : Aucun logiciel d’analyse de fichiers n’est parfait, prenez des précautions lorsque vous ouvrez des fichiers.
Ajoutez du code pour gérer les cas où les fichiers sont signalés et isPotentiallyMalicious:true est rencontré.
Accédez aux données soumises et aux fichiers joints dans votre système.
- Avant de confirmer une réponse, assurez-vous d’avoir accès à tous les fichiers joints. Ces liens de téléchargement de fichiers ne sont disponibles que temporairement, car ils ne sont valables que pendant 10 secondes. Si vous n’avez pas reçu tous les fichiers, téléchargez à nouveau le même formulaire soumis pour obtenir de nouveaux liens de téléchargement.
Signalez tout problème lié aux fichiers ou aux données.
Une fois que vous êtes certain d’avoir bien reçu toutes les données et tous les fichiers soumis, vérifiez que toutes les données ont été transférées avec succès.
Les réponses et les fichiers seront alors supprimés de Formulaires GC, après 30 jours.

Exemple : Les données de réponses ressembleront à ceci :

{

   "createdAt":1749476854628,

   "status":"New",

   "confirmationCode":"714dfe46-6fa1-4281-8d15-a39bcebc3c4f",

   "answers":"{\"1\":\"Test1\",\"2\":\"form_attachments/2025-06-09/8b42aafd-09e9-44ad-9208-d3891a7858df/output.txt\",\"3\":\"form_attachments/2025-06-09/9064b3c7-eee5-4599-99c8-a257b2b5f37d/a0393b10-396c-4b8d-a97c-15394fddda86.jpg\",\"4\":\"form_attachments/2025-06-09/0c7c3414-05e2-4ae6-a825-683857e4c0c4/IMG_0441.jpeg\"}",

   "checksum":"cc33cb49f6c088bf98b7315794db216e",

   "attachments":[

      {

         "name":"output.txt",

         "directLinkToFile":"https://s3-link...",

         "isPotentiallyMalicious":true
       
         "md5":"54b0c58c7ce9f2a8b551351102ee0938"


      }

   ]

}