Bibliothèques de bases de données

Altium Designer permet de placer des composants directement depuis une base de données d'entreprise, en créant et en utilisant un Database Library. Le placement s'effectue depuis le panneau Components qui, une fois la bibliothèque de base de données installée, permet de parcourir votre base de données.

Après le placement, les informations relatives aux paramètres de conception peuvent être synchronisées entre les composants placés et les enregistrements correspondants liés dans la base de données, à l'aide de la commande Tools » Update Parameters From Database. Les mises à jour complètes des composants, y compris le symbole graphique, les références des modèles et les paramètres, peuvent être effectuées à l'aide de la commande Tools » Update From Libraries. Les informations paramétriques de la base de données peuvent également être incluses dans la nomenclature (BOM) finale, prête pour l'approvisionnement en composants.

Placement direct : au-delà d'une simple liaison

Altium Designer propose trois méthodes pour lier un composant à une base de données : à l'aide d'un fichier Database Link (*.DbLink), d'un fichier Database Library (*.DbLib) ou d'un fichier SVN Database Library (*.SVNDbLib), respectivement. L'approche DbLink constitue un moyen efficace de lier les composants utilisés dans votre conception (ou vos bibliothèques) aux données saisies dans la base de données et de les maintenir synchronisés avec celles-ci. L'approche DbLib/SVNDbLib reprend cette efficacité éprouvée et y ajoute la possibilité de placer un composant directement depuis la base de données. Le composant est ainsi créé dynamiquement à partir des informations stockées dans l'enregistrement correspondant de la base de données.

Avant d'explorer plus en détail la fonctionnalité de bibliothèque de base de données, il convient d'examiner les différences entre ces méthodes du point de vue de leur utilisation.

Liaison à l'aide d'un fichier Database Link

Related page: Liaison de composants existants à la base de données de votre entreprise

• Avec cette méthode, le fichier Database Link (*.DbLink) définit la liaison entre le composant du schéma et un enregistrement correspondant dans une base de données. La correspondance avec l'enregistrement est établie par une liaison sur champ clé, qui peut porter sur un seul champ clé (par exemple, une référence de composant) ou sur plusieurs champs clés (en définissant une clause Where).
• Avec cette méthode de liaison, les informations relatives aux modèles et aux paramètres du composant doivent être prédéfinies dans le composant de bibliothèque Altium Designer. La définition du composant de bibliothèque doit également inclure les informations nécessaires sur les champs clés. Une fois ces éléments définis, vous ajoutez un fichier Database Link à votre paquet de bibliothèques ou à votre projet de conception. Vous pouvez ensuite synchroniser les informations du composant (paramètres) avec le contenu des champs de la base de données.
• Bien que chaque composant physique défini par un enregistrement de la base de données ne doive pas nécessairement correspondre à un composant de bibliothèque Altium Designer unique — plusieurs composants de la base de données peuvent partager le même symbole —, cette méthode de liaison est généralement utilisée selon le principe « un enregistrement de base de données pour un composant Altium Designer ». Le composant Altium Designer unique peut être soit une instance placée sur une feuille de schéma, soit un composant unique dans une bibliothèque de composants.
• Avec une liaison à la base de données de type DbLink, vous incluez le fichier Database Link dans le paquet de bibliothèques ou le projet de conception.

Liaison à l'aide d'un fichier Database Library

• Avec cette méthode, le fichier Database Library (*.DbLib) définit également la liaison entre le composant du schéma et un enregistrement correspondant dans une base de données. Là encore, la correspondance avec l'enregistrement est établie par une liaison sur champ clé, qui peut porter sur un seul champ clé (par exemple, une référence de composant) ou sur plusieurs champs clés (en définissant une clause Where).
• La principale différence de cette méthode de liaison réside dans le fait que les informations relatives au symbole, aux modèles et aux paramètres du composant sont stockées dans la définition de l'enregistrement de ce composant dans la base de données externe. Le composant de schéma référencé (stocké dans une bibliothèque de composants sous-jacente (*.SchLib)) ne contient que le symbole ; il ne comporte aucun modèle lié ni aucun paramètre de conception défini.
• Lors du placement du composant, ses informations de paramètres et de modèles sont créées à la volée, à partir des champs correspondants de l'enregistrement associé dans la base de données et conformément au mappage défini. Un ou plusieurs de ces paramètres servent ensuite à maintenir une liaison permanente avec la base de données, selon les critères de correspondance définis, afin de permettre une synchronisation ultérieure après le placement.
• Grâce à la création dynamique des composants au moment du placement, cette méthode de liaison se prête très bien à une utilisation selon le principe « plusieurs enregistrements de base de données pour un composant Altium Designer ».
• Contrairement à la liaison à la base de données de type DbLink, qui exige que le fichier DbLink soit inclus dans le paquet de bibliothèques (ou le projet de conception), le fichier DbLib/SVNDbLib n'a pas besoin d'être ajouté au projet. La bibliothèque de base de données (DbLib) est incluse dans les bibliothèques basées sur des fichiers disponibles, accessibles depuis le panneau Components. Pour rappel, les bibliothèques basées sur des fichiers disponibles peuvent comprendre les bibliothèques du projet, les bibliothèques installées ou celles trouvées dans les chemins de recherche spécifiés.
• En général, les fichiers DbLib/SVNDbLib sont organisés comme des bibliothèques. Vous pouvez, par exemple, en avoir un pour toutes les résistances répertoriées dans la base de données de votre entreprise, un autre pour les condensateurs, et ainsi de suite.

DbLib et SVNDbLib

Une bibliothèque de base de données SVN est une extension du modèle de bibliothèque de base de données, à la différence que le symbole et les modèles sources sont placés sous contrôle de version.

Les bibliothèques sources sont créées, enrichies et maintenues dans un dépôt Subversion. La liaison au dépôt et à la base de données externe est définie dans un fichier SVN Database Library (*.SVNDbLib). Comme cette approche est une extension de la bibliothèque de base de données, elle est souvent appelée Version-Controlled Database Library.

Gestionnaire de bibliothèques ou concepteur ?

Il existe essentiellement deux modes d’utilisation d’une bibliothèque de base de données sous gestion de versions : en tant que Librarian ou en tant que Designer.

En tant que bibliothécaire, vous devez non seulement configurer et maintenir le dépôt externe de gestion de versions contenant les bibliothèques de symboles et de modèles, mais également configurer le fichier de bibliothèque de base de données SVN. Cela implique de :

• Se connecter à la base de données externe de composants.
• Définir la correspondance entre les enregistrements de la base de données et les paramètres/modèles des composants.
• Spécifier le lien vers le dépôt SVN dans lequel les bibliothèques de symboles et de modèles sont stockées.

En tant que concepteur, vous utilisez le fichier SVNDbLib généré par le bibliothécaire et le rendez accessible dans le panneau Components, en l’ajoutant à la liste des bibliothèques disponibles basées sur des fichiers, afin de pouvoir parcourir et placer les composants de la base de données.

Ces rôles sont utilisés différemment selon les entreprises. Une grande entreprise peut disposer d’un service dédié aux bibliothèques qui, dans le rôle de bibliothécaire, se consacre exclusivement à la configuration et à la maintenance des bibliothèques de symboles et de modèles dans le dépôt de gestion de versions, ainsi qu’à la génération des fichiers de bibliothèque de base de données SVN. Les fichiers SVNDbLib sont ensuite mis à la disposition des concepteurs de l’entreprise, qui installent et utilisent les fichiers de bibliothèque pour placer les composants dans leurs conceptions.

Dans une entreprise plus petite, une même personne peut remplir les deux rôles. Cette personne configure et maintient le dépôt de bibliothèques, tout en utilisant les fichiers SVNDbLib définis dans ses travaux de conception.

Le dépôt de gestion de versions

Related article: Utilisation d’un système externe de gestion de versions

Les fichiers de bibliothèque de symboles et de modèles doivent être ajoutés à un dépôt Subversion (SVN). Altium Designer comprend un fournisseur de gestion de versions SVN, qui s’active et se configure sur la page Gestion des données - Gestion de versions de la boîte de dialogue Preferences. Une fois le fournisseur de gestion de versions SVN activé, un dépôt peut être créé sur la page Gestion des données - Dépôts de conception de la boîte de dialogue Preferences.

Les dépôts SVN peuvent également être créés et gérés en dehors d’Altium Designer à l’aide d’un client et d’un serveur SVN externes, tels que TortoiseSVN. Vous pouvez vous connecter à un dépôt existant sur la page Data Management - Design Repositories de la boîte de dialogue Preferences.

Un point important à noter lors de l’ajout de fichiers au dépôt est que chaque symbole et chaque modèle must be stored in its own library file. Dans une bibliothèque classique, qui peut contenir un nombre quelconque de symboles ou de modèles, la modification d’une seule entrée entraîne le marquage de l’ensemble comme ayant été modifié par le système de gestion de versions. Le fait de conserver un seul symbole ou modèle par fichier de bibliothèque est adapté au fonctionnement de la gestion de versions et vous permet de suivre précisément ce qui a été modifié et ce qui ne l’a pas été.

Dans le cadre de ce document, nous supposons que le dépôt a déjà été créé.

Utilisation de l’assistant de fractionnement des bibliothèques

Si les bibliothèques de symboles et de modèles sont créées à partir de zéro, il est facile de veiller à ne conserver qu’un seul symbole ou modèle par fichier. En général, toutefois, les bibliothèques sources existent déjà. Pour simplifier leur séparation en fichiers ne contenant qu’une seule entité en vue de leur ajout au dépôt SVN, Altium Designer fournit un outil de fractionnement : Library Splitter Wizard. Cet assistant vous permet de fractionner rapidement les bibliothèques de schémas (*.SchLib) et de PCB (*.PcbLib) contenant plusieurs composants en bibliothèques de composants individuels. L’assistant est accessible depuis le menu Tools de l’éditeur de bibliothèques de schémas, de l’éditeur de bibliothèques PCB et de l’éditeur de bibliothèques de base de données SVN.

Fractionnez les bibliothèques sources pour ne conserver qu’un seul symbole ou modèle par fichier à l’aide de Library Splitter Wizard.

La préparation du processus de fractionnement comprend les étapes suivantes :

1. Ajout des fichiers de bibliothèque source à fractionner (ils ne doivent pas nécessairement se trouver dans le même dossier). Utilisez la page Libraries to Split pour choisir les bibliothèques de schémas ou de PCB à fractionner. Cliquez sur le bouton Add pour ouvrir une boîte de dialogue permettant de rechercher et d’ajouter les bibliothèques souhaitées à la liste. Les bibliothèques ajoutées seront fractionnées en bibliothèques de composants individuels à une étape ultérieure de l’assistant. Les bibliothèques sources ne doivent pas nécessairement se trouver dans le même dossier. Utilisez le bouton Remove pour supprimer de la liste une bibliothèque sélectionnée.

   

2. Spécification du répertoire de sortie. La page Output Directories permet de définir les répertoires de sortie des bibliothèques de composants individuels. Le Output Directory affiché correspond au chemin dans lequel les bibliothèques fractionnées seront placées. Cliquez sur Change Output Directory pour modifier le répertoire affiché et sélectionné, si nécessaire. Une boîte de dialogue s’ouvre pour vous permettre de rechercher et de sélectionner le nouveau dossier du répertoire de sortie.

   Par défaut, le répertoire de sortie est le même que celui dans lequel la bibliothèque source est stockée. Soyez prudent si toutes les bibliothèques sources d’origine sont stockées dans le même dossier source. Si les répertoires de sortie ne sont pas spécifiés et conservent leurs valeurs par défaut, pointant vers le même dossier source, vous risquez de vous retrouver avec un très grand nombre de bibliothèques de symboles et de modèles individuels mélangées. Leur tri lors de la création de la structure du dépôt peut alors prendre beaucoup de temps.

   

   Puisque les fichiers de bibliothèque fractionnés seront ajoutés au dépôt SVN, il peut être judicieux de créer localement sur votre disque dur la structure de dossiers souhaitée dans le dépôt pour les fichiers de symboles et de modèles. Une fois la structure définie, copiez les bibliothèques sources dans leurs dossiers respectifs au sein de cette structure. Vous pouvez alors conserver les paramètres par défaut du répertoire de sortie pour chaque bibliothèque source. Après le fractionnement, les fichiers de bibliothèque individuels générés se trouveront déjà aux bons emplacements. Vous pourrez ensuite supprimer la bibliothèque source d’origine de chaque dossier et ajouter les dossiers au dépôt à l’aide du client SVN que vous avez choisi.

3. Configuration d’options supplémentaires pour contrôler le fractionnement des bibliothèques sources. Pour une bibliothèque de composants de schéma, ces options permettent notamment de supprimer les informations de paramètres et/ou de modèles de chaque composant, afin de ne conserver que le symbole.

    
   Deux variantes de la page Fractionner les bibliothèques : à gauche, lors de la conversion d’un fichier .PCBLib ; à droite, lors de la conversion d’un fichier .SCHLib .

   Vous pouvez contrôler la manière dont les bibliothèques sont fractionnées à l'aide de la page Options . Utilisez la liste déroulante (illustrée dans l'image ci-dessus) pour sélectionner le traitement à appliquer aux nouveaux fichiers. Le choix de Overwrite Existing Files (par défaut) entraîne le remplacement des fichiers existants par les nouveaux fichiers créés. Si Append Incrementing Number To File Names est sélectionné, l'outil de fractionnement des bibliothèques parcourt tous les répertoires de sortie sélectionnés à la page précédente (Output Directories) et crée une liste des fichiers à protéger afin qu'ils ne soient pas écrasés. Le suffixe « _#Increment Number » est ajouté au nom des nouvelles bibliothèques de composants portant le même nom.

4. Une fois les bibliothèques sources et les options définies, l'assistant effectue une analyse et affiche, pour vérification, la liste des bibliothèques contenant chacune un seul symbole ou modèle qui seront créées. Le nom de chaque bibliothèque issue du fractionnement est indiqué, ainsi que le nom réel du composant schématique ou du modèle d'empreinte qu'elle contient. La bibliothèque source d'origine est également indiquée. Le nom attribué à une bibliothèque est identique à celui du composant ou du modèle qu'elle contient.

   Si l'un des caractères suivants est utilisé dans le nom du composant ou du modèle, il sera remplacé par un trait de soulignement lors de la création du nom de la bibliothèque : '\', '/', '!', ''', '[', ']'.

   

   Les bibliothèques de composants qui seront créées peuvent être examinées sur la page Review. Les éléments Splitted Library Name, Component Name et Source Library sont répertoriés pour présenter les nouveaux fichiers qui seront créés lors du fractionnement. Une liste déroulante des données de chaque colonne est facilement accessible en cliquant sur la flèche vers le bas située à droite de chaque colonne. Cette fonctionnalité est particulièrement utile pour examiner les fichiers de bibliothèques très volumineuses.

5. Vérifiez la liste des bibliothèques à créer, puis cliquez sur Next pour lancer le fractionnement et obtenir les bibliothèques à ajouter au dépôt de gestion de versions. Une fois l'assistant terminé avec succès, cliquez sur Finish pour le fermer.

   

Utilisation de l'assistant de conversion en bibliothèque de base de données SVN

Une autre méthode pour convertir des bibliothèques existantes en bibliothèque de base de données de type SVN consiste à utiliser l'assistant de conversion en bibliothèque de base de données SVN. Cet assistant convertit les bibliothèques de schémas, de PCB, de bases de données et les bibliothèques intégrées en bibliothèques de bases de données SVN. Il propose plusieurs options de conversion, notamment la manière de fractionner les bibliothèques sources, les répertoires et le dépôt dans lesquels les stocker, ainsi que le répertoire de sortie du fichier SVNDbLib et du fichier de base de données MDB créés. 

L'assistant est accessible depuis le menu Tools lors de la modification d'un document de bibliothèque de PCB ou de schémas.

L'assistant fractionne les bibliothèques de symboles et d'empreintes, les enregistre dans un dépôt et crée les fichiers SVNDbLib et de base de données Access.

Pour aller plus loin

Consultez les pages suivantes pour en savoir plus sur les différents aspects de l'utilisation des bibliothèques de bases de données :

• Création et définition de la bibliothèque de base de données
• Modification d'une table de base de données
• Modification des symboles et des empreintes