Mise à jour d’une base Access par fichier CSV ou Excel – Episode 6

On poursuit la série sur l’importation de données CSV ou Excel dans une base de données Access.

Dans cet article, je fais simplement un point sur la classe centrale TableUpdater, qui s’occupe de l’ajout ou de la mise à jour des lignes de tables.

La plupart des méthodes ont déjà été traitées, l’article permettra de les synthétiser.

Si vous avez manqué le début

Voici la liste des épisodes précédents, importants pour que tout marche bien… 😉

La classe TableUpdater

TableUpdater est une classe VBA. Vous savez sans doute que l’icône Explorateur d’objets (ou la touche F2 du clavier) permet de consulter le détail d’un objet. Voici ce que ça donne pour TableUpdater :

Dans la suite, j’ai réorganisé ces méthodes ou propriétés en plusieurs familles logiques, et pas par ordre alphabétique.

Propriétés décrivant le fichier source

• Source : chemin complet du fichier CSV ou Excel à importer.
• SourceType : type de fichier. Peut prendre les valeurs SourceTypes.Csv ou SourceTypes.Excel.
• ExcelVersion : version du fichier Excel. Utilisée seulement lorsque SourceType = SourceTypes.Excel.

Propriétés décrivant les données importées

• Headers : True si le fichier source contient une ligne d’en-têtes. False sinon. A priori, vos données sources doivent avoir une ligne d’en-tête pour une importation correcte.
• ImportSpecs : spécifications d’importation (à utiliser lorsque le fichier CSV source n’est pas standard). Voir l’épisode 5 pour un exemple.

Propriétés décrivant la table cible Access

• Target : table Access à mettre à jour.
• TempTable : nom de la table temporaire à utiliser pour l’importation des données.

Propriétés diverses

• AutoClean : le processus d’importation crée des objets temporaires dans la base Access (notamment la table temporaire TempTable ci-dessus). Si AutoClean = True, ces objets sont supprimés en fin d’importation (c’est le cas par défaut).

Importation

• Import : méthode d’importation. Cette méthode doit être appelée après que les paramètres ci-dessus ont été réglés. C’est elle déclenche l’importation proprement dite. En fin de processus, les propriétés qui suivent sont renseignées, et peuvent servir de diagnostic.
• LastError : objet ImportError qui indique si une erreur s’est produite. LastError.Number donne une valeur définie par l’énumération ImportInfo. Si l’importation s’est bien passée, LastError.Number = NoError.
• InsertedRows : nombre de lignes insérées dans la table.
• UpdatedRows : nombre de lignes mises à jour dans la table.

La classe ImportError

Cette classe secondaire sert à décrire les erreurs d’importation. Chaque erreur est décrite par un numéro (Number), et par son intitulé en clair (Label).