Database Libraries

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, après l’installation de la bibliothèque de base de données, agit comme un navigateur dans votre base de données.

Après le placement, les informations de paramètres de conception peuvent être synchronisées entre les composants placés et leurs enregistrements liés correspondants 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 de modèle et les paramètres — peuvent être effectuées à l’aide de la commande Tools » Update From Libraries. Les informations paramétriques provenant de la base de données peuvent également être incluses dans la nomenclature finale (BOM), prêtes pour l’approvisionnement des composants.

Placement direct - Au-delà du simple lien

Altium Designer propose trois méthodes pour établir un lien entre un composant et une base de données : en utilisant respectivement un fichier Database Link (*.DbLink), un fichier Database Library (*.DbLib) ou un fichier SVN Database Library (*.SVNDbLib). L’approche DbLink fournit un moyen efficace de lier et de maintenir synchronisés les composants utilisés dans votre conception (ou vos bibliothèques) avec les données saisies dans la base de données. L’approche DbLib/SVNDbLib reprend cette efficacité éprouvée de liaison et y ajoute la liberté de pouvoir placer un composant directement depuis la base de données — en créant essentiellement le composant de manière dynamique à partir des informations stockées pour celui-ci dans l’enregistrement correspondant de la base de données.

Avant d’explorer plus en profondeur la fonctionnalité de bibliothèque de base de données, il convient d’examiner les différences entre ces méthodes quant à la manière de les utiliser.

Liaison à l’aide d’un fichier Database Link

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

• En utilisant cette méthode, le fichier Database Link (*.DbLink) définit la liaison entre le composant schématique et un enregistrement correspondant dans une base de données. La correspondance de l’enregistrement est établie par liaison sur champ clé, qui peut être un seul champ clé (par exemple un numéro de pièce) ou plusieurs champs clés (en définissant une clause Where).
• Avec cette méthode de liaison, les informations de modèle et de paramètres du composant doivent être prédéfinies dans le composant de bibliothèque Altium Designer. Le composant de bibliothèque doit également inclure les informations de champ clé nécessaires dans sa définition. Une fois cela défini, vous ajoutez un fichier Database Link à votre package de bibliothèque ou à votre projet de conception, puis vous pouvez 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 chaque enregistrement de base de données n’ait pas besoin de correspondre à un composant de bibliothèque Altium Designer unique — plusieurs composants de base de données peuvent partager le même symbole de composant — cette méthode de liaison serait généralement utilisée selon une logique « 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 de base de données de type DbLink, vous incluez le fichier Database Link avec le package de bibliothèque ou le projet de conception.

Liaison à l’aide d’un fichier Database Library

• En utilisant cette méthode, le fichier Database Library (*.DbLib) définit également la liaison entre le composant schématique et un enregistrement correspondant dans une base de données. Là encore, la correspondance de l’enregistrement est établie par liaison sur champ clé, qui peut être un seul champ clé (par exemple un numéro de pièce) ou plusieurs champs clés (en définissant une clause Where).
• La différence essentielle avec cette méthode de liaison est que les informations de symbole de composant, de modèle et de paramètres d’un composant sont stockées dans la définition de l’enregistrement de ce composant dans la base de données externe. Le composant schématique référencé (stocké dans une bibliothèque de composants sous-jacente (*.SchLib)) n’est que le symbole ; il ne possède ni modèles liés ni paramètres de conception définis.
• Lorsque le composant est placé, ses informations de paramètres et de modèle sont créées à la volée, à l’aide des champs correspondants dans l’enregistrement de base de données associé, et conformément au mappage défini. Un ou plusieurs de ces paramètres seront ensuite utilisés pour maintenir un lien continu avec la base de données, selon les critères de correspondance définis, permettant une synchronisation ultérieure après le placement.
• Cette méthode de liaison, du fait de sa création dynamique des composants au moment du placement, se prête très bien à une utilisation selon une logique « plusieurs enregistrements de base de données pour un composant Altium Designer ».
• Contrairement au style de liaison de base de données DbLink, dans lequel le fichier DbLink doit être inclus avec le package de bibliothèque (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 disponibles basées sur des fichiers — accessibles via le panneau Components. N’oubliez pas que les bibliothèques disponibles basées sur des fichiers peuvent être constituées de bibliothèques de projet, de bibliothèques installées ou de bibliothèques trouvées le long de chemins de recherche spécifiés.
• Vous configurerez généralement les fichiers DbLib/SVNDbLib selon une logique orientée bibliothèque. Par exemple, vous pourriez en avoir un pour toutes les résistances détaillées dans la base de données de votre entreprise, un autre pour les condensateurs, et ainsi de suite.

DbLib vs SVNDbLib

Une bibliothèque de base de données SVN est une extension du modèle Database Library, la différence étant que le symbole source et les modèles sont stockés sous contrôle de version.

Les bibliothèques source sont créées, enrichies et maintenues dans un dépôt basé sur Subversion. Le lien vers le dépôt, ainsi que vers la base de données externe, est défini dans un fichier SVN Database Library (*.SVNDbLib). Et puisque cette approche est une extension de la Database Library, elle est souvent appelée Version-Controlled Database Library.

Bibliothécaire ou concepteur ?

Il existe essentiellement deux modes de travail avec une bibliothèque de base de données sous contrôle de version : en tant que Librarian ou en tant que Designer.

En tant que bibliothécaire, vous devrez non seulement configurer et maintenir le dépôt externe de contrôle de source des bibliothèques de symboles et de modèles, mais vous serez également responsable de la configuration du fichier SVN Database Library. Cela implique :

• Connexion à la base de données externe des composants.
• Définition du mappage entre les enregistrements de base de données et les paramètres/modèles des composants.
• Spécification du lien vers le dépôt SVN dans lequel sont stockées les bibliothèques de symboles et de modèles.

En tant que concepteur, vous prendrez le fichier SVNDbLib généré par le bibliothécaire et le rendrez disponible 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.

L’utilisation de ces rôles variera d’une entreprise à l’autre. Une grande entreprise peut disposer d’un centre de bibliothèques dédié qui, dans le rôle de bibliothécaire, sera uniquement impliqué dans la configuration et la maintenance des bibliothèques de symboles et de modèles dans le dépôt de contrôle de source, ainsi que dans la génération du ou des fichiers SVN Database Library. Le ou les fichiers SVNDbLib seront ensuite mis à la disposition du ou des concepteurs de cette entreprise, qui installeront et utiliseront les fichiers de bibliothèque pour placer les composants dans leurs conceptions.

Dans une petite entreprise, les deux rôles peuvent être assurés par la même personne. Cette personne configurera et maintiendra non seulement le dépôt de bibliothèques, mais utilisera également le ou les SVNDbLib définis dans son travail de conception.

Le dépôt de contrôle de source

Related article: Utilisation d’un contrôle de version externe

Les fichiers de bibliothèque de symboles et de modèles doivent être ajoutés à un dépôt Subversion (SVN). Altium Designer inclut un fournisseur de contrôle de version SVN ; celui-ci est activé et configuré dans la page Data Management - Version Control page de la boîte de dialogue Preferences. Une fois le fournisseur de contrôle de version SVN activé, un dépôt peut être créé dans la page Data Management - Design Repositories 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. Un dépôt existant peut être connecté dans la Data Management - Design Repositories page de la boîte de dialogue Preferences.

Une chose importante à noter lors de l’ajout de fichiers au dépôt est que chaque symbole et modèle must be stored in its own library file. Dans une bibliothèque classique — qui peut contenir un nombre quelconque de symboles/modèles — la modification d’une seule entrée aurait pour conséquence que tous les éléments seraient marqués comme modifiés par le système de contrôle de version. Le fait d’avoir un symbole/modèle par fichier correspond bien au fonctionnement du contrôle de version, car cela vous permet de suivre précisément ce qui a été modifié et ce qui ne l’a pas été.

Pour les besoins de ce document, on suppose que le dépôt a déjà été créé.

Utilisation de l’assistant de fractionnement de bibliothèques

Si les bibliothèques de symboles et de modèles sont nouvellement créées, il n’y a aucun problème à garantir un seul symbole/modèle par fichier. En général, toutefois, les bibliothèques source existent déjà. Pour simplifier la tâche consistant à séparer ces bibliothèques en fichiers à entité unique afin de les ajouter au dépôt SVN, Altium Designer fournit un outil de fractionnement — le Library Splitter Wizard. L’assistant vous permet de fractionner rapidement des bibliothèques schématiques multi-composants (*.SchLib) et PCB (*.PcbLib) en bibliothèques de composants individuelles. L’assistant est accessible depuis le menu Tools dans l’éditeur de bibliothèques schématiques, l’éditeur de bibliothèques PCB et l’éditeur de bibliothèques de base de données SVN.

Fractionnez les bibliothèques source en un symbole/modèle par fichier à l’aide du Library Splitter Wizard.

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

1. Ajout des fichiers de bibliothèque source requis que vous souhaitez fractionner (ils ne doivent pas nécessairement se trouver dans le même dossier). Utilisez la page Libraries to Split pour choisir la ou les bibliothèques schématiques ou PCB que vous souhaitez fractionner. Cliquez sur le bouton Add pour ouvrir une boîte de dialogue permettant de parcourir et d’ajouter la ou les bibliothèques souhaitées à la liste. Les bibliothèques ajoutées seront ensuite fractionnées en bibliothèques de composants individuelles plus loin dans l’assistant. Les bibliothèques source n’ont pas besoin d’être situées 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 sert à définir le ou les répertoires de sortie des bibliothèques de composants individuelles. Le Output Directory indiqué correspond au chemin où seront placées les bibliothèques fractionnées. Cliquez sur Change Output Directory pour mettre à jour le répertoire affiché et sélectionné, si nécessaire. Une boîte de dialogue s’ouvre alors, dans laquelle vous pouvez parcourir et sélectionner le dossier mis à jour pour le répertoire de sortie.

   Par défaut, le répertoire de sortie sera défini sur le même répertoire que celui dans lequel la bibliothèque source est stockée. Il convient d’être prudent si les bibliothèques source d’origine sont toutes stockées dans le même dossier de répertoire source. Si les répertoires de sortie ne sont pas spécifiés et restent à leurs valeurs par défaut — pointant vers le même dossier de répertoire source — vous risquez de vous retrouver avec un très grand mélange de bibliothèques de symboles et de modèles unitaires. Le tri de celles-ci lors de la création de la structure du dépôt peut s’avérer très long.

   

   Comme les fichiers de bibliothèque fractionnés seront ajoutés au dépôt SVN, il peut être judicieux de configurer localement sur votre disque dur la structure de dossiers que vous souhaitez dans le dépôt — en termes de fichiers de symboles/modèles. Une fois la structure définie, copiez les bibliothèques source dans leurs dossiers respectifs au sein de cette structure. Vous pourrez alors simplement laisser les paramètres de répertoire de sortie de chaque bibliothèque source à leurs valeurs par défaut. Après le fractionnement, les fichiers de bibliothèque unitaires 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 d’utiliser.

3. Configurez des options supplémentaires pour contrôler la manière dont les bibliothèques source sont fractionnées. Celles-ci incluent, pour une bibliothèque de composants schématiques, des options permettant de supprimer les informations de paramètres et/ou de modèles de chaque composant constitutif — en ne laissant que le symbole nu.

    
   Deux itérations de la page Split Libraries ; à gauche : la page Split Libraries lors de la conversion d’un fichier .PCBLib . À droite : la page Split Libraries 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 la manière dont les nouveaux fichiers sont gérés. Choisir Overwrite Existing Files (par défaut) fera en sorte que tous les fichiers nouvellement créés écrasent les fichiers existants. Si Append Incrementing Number To File Names est choisi, l’outil de fractionnement des bibliothèques analysera tous les répertoires de sortie sélectionnés sur la page précédente (Output Directories) et créera une liste de fichiers à protéger afin qu’ils ne soient pas écrasés. Les nouvelles bibliothèques de composants portant le même nom recevront le suffixe « _#Increment Number ».

4. Une fois les bibliothèques source et les options spécifiées, l’assistant effectuera une analyse dont le résultat sera l’ensemble des bibliothèques à symbole/modèle unique qui seront créées, listées pour votre vérification. Le nom de chaque bibliothèque fractionnée à générer est affiché, ainsi que le nom réel du composant schématique/modèle d’empreinte au sein de cette bibliothèque. La bibliothèque source d’origine est également indiquée. Le nom utilisé pour une bibliothèque sera le même que celui utilisé pour le composant/modèle constitutif.

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

   

   Les bibliothèques de composants qui seront créées peuvent être examinées sur la page Review. Les Splitted Library Name, Component Name et Source Library sont répertoriés pour montrer les nouveaux fichiers qui seront créés pendant le processus de 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 lors de l’examen de fichiers provenant de bibliothèques extrêmement volumineuses.

5. Passez en revue la liste des bibliothèques à créer, puis cliquez sur Next pour lancer le processus de fractionnement et obtenir au final les bibliothèques à ajouter au dépôt de contrôle de source. Une fois l’assistant terminé avec succès, cliquez sur Finish pour fermer.

   

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

Une autre approche pour convertir des bibliothèques existantes en bibliothèque de base de données de type SVN consiste à utiliser le SVN Database Library Conversion Wizard. Cet assistant convertit les bibliothèques schématiques, PCB, de base de données et intégrées en bibliothèques de base de données SVN. L’assistant propose un certain nombre d’options liées à la conversion, notamment la manière dont les bibliothèques source doivent être fractionnées, dans quels répertoires de quel dépôt elles doivent être stockées, ainsi que le répertoire de sortie du fichier SVNDbLib créé et du fichier de base de données MDB. 

L’assistant est accessible depuis le menu Tools lors de l’édition d’un document de bibliothèque PCB ou schématique.

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

Et ensuite ?

Consultez les pages suivantes pour en savoir plus sur les différents aspects du travail avec les bibliothèques de base 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 empreintes