Base de données PandaSuite

La base de données PandaSuite n’est pas une base de données traditionnelle. C’est un modèle de données que vous créez dans PandaSuite Studio et qui sera copié sur chaque appareil. Chaque utilisateur possède sa propre version locale qu’il peut modifier sans impacter les autres.

Comment ça marche vraiment ?

Imaginez la Base de données PandaSuite comme un modèle de départ pour vos données :

1. Dans PandaSuite Studio : vous créez un schéma (structure) avec des valeurs par défaut.
2. Au téléchargement : chaque utilisateur reçoit une copie personnelle de ce modèle.
3. En utilisation : les modifications restent locales à chaque appareil.

Points clés à retenir

• Chaque appareil = une copie indépendante : les modifications d’un utilisateur n’affectent pas les autres.
• Données persistantes : elles survivent à la fermeture de l’app (mais pas à sa désinstallation).
• Synchronisation optionnelle : vous pouvez récupérer les mises à jour du modèle depuis PandaSuite Studio.
• Pas de serveur nécessaire : tout fonctionne en local, même hors ligne.

Deux usages principaux

Stockage local de l’utilisateur

Pour sauvegarder des informations propres à chaque utilisateur :

• Scores et progression : le niveau atteint dans un jeu,
• Préférences : langue choisie, mode sombre activé,
• État de l’app : tutoriel déjà vu, formulaires pré-remplis.

Contenu qui pilote votre application

Pour créer du contenu dynamique depuis PandaSuite Studio :

• Catalogue de produits : liste d’articles mise à jour régulièrement,
• Pages dynamiques : contenu éditorial sans recréer l’app,
• Configuration : paramètres de l’app modifiables à distance.

Créer votre base

Ajouter la base

Dans le panneau Base de données, choisissez Base de données PandaSuite. Le composant est ajouté au niveau Projet : ainsi, il est accessible partout.

Cliquez sur la flèche pour ouvrir votre base de données.

Définir la structure

1. Cliquez sur le bouton + Ajouter une propriété
2. Choisissez le type de données (Texte, Nombre, Tableau, Image…).
3. Renommez et renseignez la valeur si nécessaire.

Manipuler les données

Toutes les opérations se déclenchent depuis le panneau Actions : aucun code requis.

Créer / Modifier une donnée (local)

Cette action modifie les données uniquement sur l’appareil de l’utilisateur. C’est l’action la plus courante pour gérer des scores, préférences et un état de l’application.

1. Déclencheur

Choisissez n’importe quel déclencheur. Par exemple : Au Tap sur un bouton « Valider ».

2. Action

3. Cible

Sélectionnez la propriété à modifier dans votre base.

4. Fonction à appliquer

Pour les valeurs simples (texte, nombre…) :

• Définir : remplace complètement la valeur

  Exemple : changer le nom du joueur

• Incrémenter / Décrémenter : Ajoute ou retire un nombre

  Exemple : Augmenter le score de 10 points

  ⚠️ Fonctionne uniquement sur les données de type Nombre

  

Pour les tableaux (listes) :

• Ajouter : ajoute un élément à la fin de la liste

  Exemple : ajouter un produit au panier

• Supprimer par valeur : enlève un élément spécifique

  Exemple : retirer Pomme de la liste de courses

• Supprimer par id : enlève un élément par son identifiant unique

  Exemple : retirer le produit n°42 du panier

Pour tout type de données :

• Supprimer : efface complètement la donnée

  Exemple : réinitialiser les préférences utilisateur

5. Valeur

Définissez ce que vous voulez stocker :

• Texte fixe : Bonjour
• Valeur dynamique : lier à un champ de formulaire
• Fonction : timestamp pour la date actuelle, random pour un nombre aléatoire

Récupérer les données distantes

Cette action permet de récupérer les mises à jour du modèle depuis le Studio. C’est particulièrement utile quand vous utilisez la base pour du contenu dynamique.

Comment fonctionne la synchronisation ?

Vous avez deux options :

1. Écraser tout : remplace complètement les données locales par celles de PandaSuite Studio

   • ✅ Idéal pour : catalogue produit, contenu éditorial
   • ❌ Attention : perd les modifications locales (scores, préférences)

2. Fusionner (Merge) : combine intelligemment les données locales et distantes

   • ✅ Conserve : les modifications de l’utilisateur
   • ✅ Ajoute : les nouveaux éléments du Studio
   • ✅ Met à jour : les valeurs par défaut non modifiées localement

Quand synchroniser ?

Moment	Pourquoi
Au lancement de l’app	Récupérer les dernières mises à jour
Bouton “Actualiser”	Laisser l’utilisateur contrôler
Après connexion internet	Si l’app était utilisée hors ligne

Exporter les données (locale)

Cette action crée un fichier CSV contenant toutes les données locales de l’utilisateur. Utile pour :

• Analyse : comprendre comment vos utilisateurs utilisent l’app
• Support : diagnostiquer des problèmes
• Backup : permettre à l’utilisateur de sauvegarder sa progression

Supprimer votre base

Rendez-vous dans l’onglet Projet et sélectionnez votre base de données.

Cliquez sur l’icône de suppression.

Comprendre les limites (et les contourner)

Ce que la base PandaSuite ne fait PAS

1. Pas de synchronisation automatique entre utilisateurs

   • ✅ Solution : utilisez Firebase ou une API pour partager des données.

2. Pas de requêtes complexes (type SQL)

   • ✅ Solution : organisez vos données simplement, utilisez les filtres des composants.

3. Pas de sauvegarde cloud automatique

   • ✅ Solution : proposez un export CSV ou connectez-vous à un service cloud.

Ses points forts

• Simplicité : pas de serveur à gérer
• Performance : données locales = accès instantané
• Hors ligne : fonctionne sans connexion
• Gratuit : inclus dans PandaSuite

Pour aller plus loin

• Variables
• Collection / Liste
• Data binding
• Mettre en favoris
• API & Données hors ligne