Activation de la synchronisation de la base de données
La fonctionnalité de synchronisation de la base de données vous permet de voir les données de vos citoyens et véhicules en temps réel dans le TDM. Une fois configurée, cette fonctionnalité sera disponible pour tous les services de votre communauté.
En tant que propriétaire de communauté, vous pouvez activer la synchronisation de la base de données en suivant ces étapes.
TIP
Veuillez noter que le TDM est une fonctionnalité disponible avec les plans OnClock Premium. Vous pouvez configurer la synchronisation de la base de données pour votre communauté, mais seuls les services premium y auront accès depuis le TDM.
Frameworks officiellement pris en charge
La fonctionnalité de synchronisation de la base de données est compatible avec tous les jeux ou frameworks utilisant une base de données MySQL ou MariaDB.
Nous fournissons également une prise en charge intégrée pour les frameworks FiveM suivants avec des options personnalisables :
Ouvrir les paramètres de la communauté
Sur la page de sélection de communauté, cliquez sur l’icône en forme de roue dentée à côté du nom de votre communauté.
Cliquez sur l’onglet « Synchronisation de la base de données ».
Configurer la connexion à la base de données
Cliquez sur « Commencer » pour démarrer le processus de configuration.
Dans le champ Hôte, saisissez le nom de domaine ou l'adresse IP de votre serveur de base de données.
Sur votre serveur de base de données, créez un nouveau nom d'utilisateur et un mot de passe sécurisé.
WARNING
Votre mot de passe est stocké de manière sécurisée et chiffré, mais nous recommandons d’utiliser un utilisateur en lecture seule avec les permissions minimales requises. Nous recommandons également de restreindre les connexions à nos serveurs uniquement.
Vous trouverez une liste à jour de nos serveurs sur le côté droit de la fenêtre de configuration.
Saisissez le nom d’utilisateur et le mot de passe dans les champs correspondants.
Dans le champ Nom de la base de données, saisissez le nom de votre base de données.
Vérifiez que toutes les informations requises sont correctement saisies.
Exemple :
Si correctement rempli, votre formulaire devrait ressembler à ceci. Cliquez sur « Tester la connexion » pour vérifier la connexion.
Si le test est réussi, continuez. Sinon, vérifiez le message d’erreur et réessayez.
Exemple :
Dans cet exemple, seule la permission SELECT est activée pour l'utilisateur. WARNING
Assurez-vous que l’utilisateur dispose uniquement des permissions minimales requises pour l’accès à la base de données. Les permissions marquées d’un crochet vert sont nécessaires ; toutes les permissions inutiles doivent être supprimées.
Si vous utilisez un framework pris en charge, sélectionnez-le dans le champ de mappage automatique. Cela permettra de mapper automatiquement les tables et colonnes.
Exemple :
Cliquez sur « Suivant ».
Mapper la table des citoyens
Si vous utilisez un framework pris en charge, la table des citoyens sera mappée automatiquement. Vous pouvez passer à l’étape 4 ; sinon, vous devrez mapper les colonnes manuellement.
Exemple :
Dans cet exemple, la table des citoyens est mappée automatiquement avec le framework QBCore. Sélectionnez la table contenant les données des citoyens.
Mappez les colonnes aux champs correspondants.
TIP
- Passez la souris sur l’icône du point d’interrogation pour des explications.
- Si un deuxième menu déroulant apparaît, cela signifie que la colonne est formatée en JSON. Vous devez sélectionner la propriété imbriquée.
Cliquez sur « Tester la connexion » pour vérifier.
Si le test est réussi, jusqu’à trois citoyens de votre base de données seront affichés. Sinon, vérifiez le message d’erreur et réessayez.
Exemple :
Cliquez sur « Suivant ».
Mapper la table des véhicules
Si vous utilisez un framework pris en charge, la table des vehicles sera mappée automatiquement. Vous pouvez passer à l’étape 4 ; sinon, vous devrez mapper les colonnes manuellement.
Exemple :
Dans cet exemple, la table des vehicles est mappée automatiquement avec le framework QBCore. Sélectionnez la table contenant les données des vehicles.
Mappez les colonnes aux champs correspondants.
TIP
- Passez la souris sur l’icône du point d’interrogation pour des explications.
- Si un deuxième menu déroulant apparaît, cela signifie que la colonne est formatée en JSON. Vous devez sélectionner la propriété imbriquée.
Cliquez sur « Tester la connexion » pour vérifier.
Si le test est réussi, jusqu’à trois vehicles et leur propriétaire de votre base de données seront affichés. Sinon, vérifiez le message d’erreur et réessayez.
Exemple :
Cliquez sur « Suivant ».
Mapper la table des licences et permis
Si vous utilisez un framework pris en charge, la table des licenses et des permis sera mappée automatiquement. Vous pouvez passer à l’étape 5 ; sinon, vous devrez mapper les colonnes manuellement.
Exemple :
Dans cet exemple, la table des licenses est mappée automatiquement avec le framework QBCore. Sélectionnez le type de lien entre les citoyens et les licences. Si vous n'êtes pas sûr, n'hésitez pas à contacter le support.
Sélectionnez la table contenant les données des licences. Il peut s’agir d’une table distincte ou dans certains cas, de la mâme table que la celle des citoyens.
Mappez les colonnes aux champs correspondants.
TIP
- Passez la souris sur l’icône du point d’interrogation pour des explications.
- Si un deuxième menu déroulant apparaît, cela signifie que la colonne est formatée en JSON. Vous devez sélectionner la propriété imbriquée.
Cliquez sur « Tester la connexion » pour vérifier.
Si le test est réussi, jusqu’à trois citoyens et leurs licences de votre base de données seront affichés. Sinon, vérifiez le message d’erreur et réessayez.
Exemple :
Cliquez sur « Suivant ».
Configurer le mappage des noms de licences
Cette étape permet d’associer les noms des licences de votre base de données à ceux utilisés dans le TDM (ex. : driver → Permis de conduire).
Si vous utilisez un framework pris en charge, le mappage est créé automatiquement. Vous devrez peut-être ajouter des mappages supplémentaires si vous avez des licences supplémentaires.
Exemple :
Dans cet exemple, les noms des licences sont ajoutés automatiquement en fonction du framework QBCore. Pour ajouter un nouveau nom de licence, entrez la valeur de la base de données et le nom d'affichage pour le TDM, puis cliquez sur « Ajouter ».
Répétez l’étape précédente pour chaque licence supplémentaire.
Cliquez sur « Suivant ».
Vérifier et enregistrer la configuration
Vérifiez votre configuration. Pour apporter des modifications, cliquez sur le numéro d’étape en haut de la fenêtre.
Cliquez sur « Enregistrer ». Vous devriez voir un message de succès.
Exemple :
La synchronisation de la base de données est prête
Félicitations ! Vous avez activé avec succès la synchronisation de la base de données pour votre communauté. Vous pouvez maintenant voir les données de vos citoyens et véhicules en temps réel dans le TDM.
Pour toute assistance, contactez notre équipe de support. Nous sommes là pour vous aider !