Tables et structures
Les tables sont au cœur de CordBase. Chaque table définit une structure qui génère automatiquement des commandes slash pour les membres de ton serveur.
Types de colonnes
Chaque colonne a un type qui détermine comment les données sont validées, stockées et affichées dans Discord.
Texte
Texte libre. Pour les noms, descriptions, notes ou n'importe quelle donnée texte.
Nombre
Valeurs entières ou décimales. Les colonnes Nombre alimentent la commande leaderboard et peuvent être augmentées avec update. Idéal pour les scores, les prix, les quantités et l'XP.
Date
Une date, saisie au format AAAA-MM-JJ. Pratique pour les échéances et les dates d'événements.
Oui/Non
Un interrupteur vrai/faux (booléen). Parfait pour des statuts comme terminé, actif, vérifié ou payé.
Liste de choix
Une liste d'options prédéfinies que tu choisis en créant la colonne. Parfait pour les catégories, les raretés, les statuts et les rôles.
Membre
Une référence à un utilisateur Discord. Stockée sous forme d'ID utilisateur et affichée avec le nom d'utilisateur. Pour indiquer un propriétaire ou une attribution.
Paramètres de la colonne
- Obligatoire — Si cette option est activée, la commande slash exige ce champ. Sinon, le champ est facultatif et peut rester vide.
Modifier la structure d'une table
Tu peux modifier une table après sa création depuis le tableau de bord. Va sur ta table et clique sur Modifier la table.
- Ajouter des colonnes — Les nouvelles colonnes sont ajoutées à la fin de la structure. Les lignes existantes ont une valeur vide pour la nouvelle colonne jusqu'à ce qu'elles soient modifiées.
- Renommer des colonnes — Change le nom affiché dans le tableau de bord et dans les réponses du bot. Le nom d'option que les membres tapent reste le même.
- Supprimer des colonnes — Retire la colonne de la table et de ses commandes slash.
Les clés et les types des colonnes existantes sont verrouillés une fois la table créée. Pour changer le type d'une colonne, ajoute une nouvelle colonne et supprime l'ancienne.
Après l'enregistrement, CordBase réenregistre les commandes slash auprès de Discord. La propagation prend quelques secondes.
Permissions par rôle
Chaque table a trois niveaux de permission que tu peux attribuer à des rôles Discord :
- Lecture — Peut utiliser
query,view,saved-viewetleaderboardpour consulter les données. - Écriture — Comprend les permissions de Lecture, plus
addetupdatesur n'importe quelle ligne. - Admin — Accès complet, y compris
delete,bulk-updateetbulk-delete. Les commandes groupées nécessitent l'offre Pro ou Max.
Tant que tu n'as pas attribué de rôles à une table, tous les membres peuvent lancer toutes ses commandes, y compris delete. Dès que tu attribues un rôle, les membres qui n'ont aucun des rôles listés ne peuvent plus du tout utiliser la table : donne donc Lecture à un rôle que tous les membres ont si la table doit rester publique. Les administrateurs Discord peuvent toujours tout lancer.