L'installation de l'extension est très simple. Il suffit de se connecter au «repository» des extensions Typo3 et de télécharger «DB Sync» (dbsync), qui se trouve dans la section «backend module». Vous aurez également besoin de télécharger l'extension «Developer API» (api_macmade), qui est nécessaire au bon fonctionnement du module.

Une fois l'extension installée, vous remarquerez un nouvel élément dans le menu de gauche, sous la section outils.

La première fonction du module backend vous permet de synchroniser deux tables différentes au sein de la même base de données. Cela peut être utile dans de nombreux contextes, comme passer d'une extension à une autre sans perdre le contenu existant. Dans le exemples suivants, nous allons synchroniser les utilisateurs frontend avec les utilisateurs backend.

La première chose à faire est de sélectionner les tables à utiliser. En premier, il faut choisir une table source (à gauche). Il s'agit de la table de laquelle vont provenir les enregistrements. Ensuite, sélectionnez simplement une table de destination (à droite). C'est dans cette table que les enregistrements seront importés.

Vous allez ensuite devoir faire correspondre les champs de ces deux tables. Le programme va essayer de le faire pour vous, en regardant les noms des champs, mais vous pouvez aussi le faire à la main à l'aide des menus déroulant. Dans la colonne de droite, vous trouverez tous les champs disponibles de la table de destination. Vous pouvez faire correspondre chacun avec un champ de la table source.

Une fois que la correspondance est faite, vous avez le choix entre plusieurs options, qui affecteront la façon dont les enregistrements seront importés dans la table de destination.

En premier, vous pouvez choisir d'ajouter les enregistrements source à la table de destination, ou de vider la table de destination avant l'importation. Avec la première méthode, les données existantes seront préservées.

Vous devez également choisir une page de destination pour les enregistrements importés, à l'aide du menu déroulant représentant l'arborescence du site.

Vous pouvez ensuite choisir d'importer seulement certains enregistrements. Si vous n'en spécifiez aucun dans le sélecteur, la table complète sera importée. Par défaut, les enregistrements marqués comme effacés dans la base de données ne seront pas importés, mais vous pouvez toujours changer cela à l'aide de la case à cocher juste en dessous.

La seconde fonction du module vous permet de synchroniser deux bases de données différentes. Cela peut être très utile si vous avez, par exemple, un site de production (publique), et un site de développement. Vous pouvez tout faire sur le site de développement, sans risquer de causer des problèmes au site de production, et ensuite simplement synchroniser les deux bases de données pour publier vos changements sur le site publique.

La première étape est de se connecter à un serveur de base de données, en donnant un nom d'utilisateur, un mot de passe et un hôte.

Une fois que vous êtes connectés au serveur de bases de données externe, vous verrez une liste des bases de données auquel l'utilisateur à accès. Sélectionnez simplement une de ces base de données pour pouvoir synchroniser.

Vous verrez ensuite toutes les tables présentes dans les deux bases de données. Vous pouvez alors soit ajouter les enregistrements de la table externe dans la table locale, ou effacer la table locale avant d'importer les enregistrements. Avec cette dernière option, vous obtiendrez une copie conforme de la base de donnée externe.

Soyez prudents lorsque vous synchronisez vos bases de données, et faites des copies de sauvegarde avant d'effectuer l'opération.