Le SDK Formaloo est un SDK en Python destiné au développement d’applications et de scripts tirant parti de la puissance des fonctionnalités de Formaloo.
L’objectif principal du SDK est de fournir un environnement Python simple à utiliser, permettant aux développeurs d’authentifier un utilisateur et d’utiliser les API de la Customer Data Platform (CDP) de Formaloo et du créateur de bases de données Formaloo.
Que peut faire la plateforme Formaloo pour moi et mon entreprise ?
Formaloo représente la nouvelle génération de l’analyse de données. Avec Formaloo, vous pouvez utiliser vos propres données pour analyser vos clients et votre activité, et même anticiper l’avenir.
Formaloo offre aux TPE et PME un expert des données propulsé par l’IA, afin qu’elles comprennent réellement leur activité et leurs clients, et agissent pour renforcer leur fidélité, leur valeur vie client (LTV) et l’expérience client (CX).
Formaloo est conçu pour les entreprises, pas pour les data scientists. Il est très simple à utiliser et à comprendre : vous n’avez pas besoin de connaissances en analyse de données ou en programmation et, surtout, aucun expert des données n’est nécessaire pour le faire fonctionner.
Formaloo CDP est une Customer Data Platform qui collecte, analyse et unifie les données de toutes vos sources afin de renforcer la fidélité de vos clients.
Formaloo est une solution de productivité conçue pour transformer la manière dont les gens collectent des informations et les exploitent.
Les solutions Formaloo, comme Formaloo CDP, la collecte de données (créateur de bases de données et de formulaires), Formaloo DataFlow, l’outil d’analyse de données et l’automatisation des flux de travail, aident chaque jour des milliers d’entreprises à collecter et à gérer leurs données de manière efficace.
Remarque : même si vous n’avez besoin d’écrire aucun code pour utiliser Formaloo, nous vous permettons de créer vos propres applications et d’utiliser les API Formaloo comme vous le souhaitez grâce au SDK Formaloo.
Comment utiliser le SDK Formaloo
● Première étape : installation
Installez le SDK Formaloo avec pip :
pip install formaloo-cdp
● Deuxième étape : authentification
Pour utiliser le SDK, vous devez créer un compte Formaloo avec une connexion (Connection) et disposer des codes client_key et client_secret de cette connexion.
Obtenir la clé client et la clé secrète dans le tableau de bord Formaloo :
Rendez-vous sur le lien ci-dessous et cliquez sur le bouton Add Source pour créer une nouvelle connexion.
[Formaloo CDP (Beta)](https://cdp.formaloo.net/redirect/current-organization/integrations)
[Web site created using create-react-app](https://cdp.formaloo.net/redirect/current-organization/integrations)[cdp.formaloo.net](https://cdp.formaloo.net/redirect/current-organization/integrations)
Cliquez ensuite sur votre connexion pour afficher cette page :
Formaloo CDP
Exportez-les ensuite en tant que variables d’environnement :
export FORMALOO_CLIENT_KEY = 'YOUR_FORMALOO_CLIENT_KEY'
export FORMALOO_CLIENT_SECRET = 'YOUR_FORMALOO_CLIENT_SECRET'
Vous pouvez également créer un fichier .env et y ajouter ces variables.
Exemple d’utilisation simple
Par exemple, si vous souhaitez obtenir la liste de vos formulaires, importez d’abord la classe Form et créez une instance, puis appelez la méthode get_list comme ci-dessous :
from formaloo.forms import Form form = Form() form.get_list()
action : chaque classe dispose d’une liste d’actions. Dans cet exemple, get_list est une action de la classe Form. Vous pouvez accéder à la liste des actions d’une classe grâce à la propriété actions_list. print(form.actions_list)
Un scénario simple
Nous souhaitons utiliser le SDK Formaloo pour créer dans notre application un formulaire comportant un champ, puis envoyer ce formulaire avec nos données. Nous récupérerons ensuite la liste des lignes (envois) de notre formulaire.
● Tout d’abord, nous créons un formulaire
Nous créons un formulaire et conservons son slug et son adresse.
from formaloo.forms import Form form = Form( title="my simple form" ) form.create() form_slug = form.slug form_address = form.address
● Ajout de champs au formulaire
Ajoutez des champs prénom et nom au formulaire à l’aide du slug du formulaire et du type de champ short_text.
from formaloo.forms import first_name_field = Field( type='short_text', form=form_slug, title="Your first name" ) first_name_field.create() first_name_field_slug = first_name_field.slug last_name_field = Field( type='short_text', form=form_slug, title="Your last name" ) last_name_field.create() last_name_field_slug = last_name_field.slug
Notre formulaire comporte désormais deux champs :
Consultez votre formulaire à l’aide de la variable form_address que vous avez définie :
Ouvrez cette URL : https://formaloo.net/form_address
● Envoi du formulaire
Envoyez le formulaire : vous pourrez ensuite consulter ses réponses dans le tableau de bord Formaloo.
from formaloo.forms import FormDisplay submit_data = { first_name_field_slug: "John", last_name_field_slug: "Doe" } form_display = FormDisplay( **submit_data ) form_display.submit(url_params=[form_slug])
url_params : dans cet argument, nous définissons les paramètres de l’URL dans une liste, dans l’ordre.
Ouvrez https://dash.formaloo.net/u?page=1 et sélectionnez votre formulaire : vous verrez que la réponse (ligne) a été ajoutée à votre formulaire :
● Obtenir la liste des lignes du formulaire
Nous pouvons ensuite obtenir la liste des envois (lignes) du formulaire à l’aide du SDK :
rows_list = form.rows_list(url_params=[form_slug])print(rows_list)