Travailler avec les snippets

La fonctionnalité snippets permet d’enregistrer toute sélection de circuit sur une seule feuille de schéma ou tout circuit dans une conception PCB, y compris les composants et le routage, puis de la réutiliser dans n’importe quelle conception. Le panneau Design Reuse vous permet d’accéder rapidement à toutes les commandes nécessaires pour utiliser et gérer votre collection de snippets.

Création d’un snippet

Un nouveau snippet de schéma ou de PCB peut être créé à partir d’un circuit existant sur une feuille de schéma ou un document PCB :

1. Sélectionnez le circuit requis dans l’éditeur de schéma ou PCB.

2. Sélectionnez la commande Tools » Convert » Create Snippet from selected objects dans les menus principaux (dans l’éditeur PCB, vous pouvez également cliquer avec le bouton droit sur la sélection et choisir Snippets » Create Snippet from selected objects dans le menu contextuel).

3. La boîte de dialogue New Schematic Snippet ou New PCB Snippet apparaît, dans laquelle vous pouvez définir le Name, la Description, la destination d’enregistrement (Save to – le Workspace connecté ou un dossier local), ainsi que le dossier dans lequel le nouveau snippet sera enregistré (Path).

   

   Cliquez sur le bouton à droite du champ Path dans la boîte de dialogue pour accéder à la boîte de dialogue Choose Folder (lors de l’enregistrement d’un snippet dans le Workspace) ou à la boîte de dialogue Choose Snippet Folder (lors de l’enregistrement d’un snippet dans un dossier local), qui vous permet de sélectionner un dossier existant dans lequel le snippet sera enregistré ou de créer un nouveau dossier à la volée.

   • Dans la boîte de dialogue Choose Snippet Folder, cliquez sur le bouton   et utilisez la boîte de dialogue Folder Properties qui s’ouvre pour ajouter un nouveau sous-dossier à la structure globale des dossiers de snippets locaux (). Dans cette boîte de dialogue, vous pouvez spécifier un nom pour le nouveau dossier et déterminer sous quel dossier parent il doit être créé.

   • Pour plus d’informations sur l’organisation des snippets locaux dans des dossiers, consultez la section Organizing Local Snippets ci-dessous.

4. Cliquez sur  dans la boîte de dialogue pour enregistrer le snippet.

Recherche et placement d’un snippet

Les snippets du Workspace et les snippets locaux peuvent être placés à partir du panneau Design Reuse.

• Lorsque le panneau est configuré pour afficher les ressources du Workspace (), il peut être utilisé pour accéder aux snippets stockés dans votre Workspace connecté.

• Lorsque le panneau est configuré pour afficher les ressources locales (), il donne accès aux snippets stockés dans des dossiers sur votre disque dur (les dossiers sont configurés comme décrit ci-dessus).

Vous pouvez parcourir les dossiers du Workspace/locaux pour trouver le snippet requis. Vous pouvez également utiliser le champ Search en haut du panneau pour rechercher un snippet par son nom ou sa description.

Cliquez sur la commande Details en bas du panneau pour développer le volet Details, qui affiche les détails du bloc de réutilisation sélectionné, notamment :

• Nom du snippet.

• L’icône d’état du cycle de vie et la révision (pour un snippet du Workspace uniquement ; cliquez sur le lien pour ouvrir la vue détaillée de l’historique de l’élément Reuse Block avec la dernière révision sélectionnée).

• Description du snippet.

• Informations générales sur le snippet.

• Aperçus du snippet.

Avant de placer un snippet, assurez-vous que le document cible correct est ouvert en tant que document actif. La commande de placement ne sera fonctionnelle que si le snippet peut être correctement placé dans ce document, c’est-à-dire que le type de snippet et le type de document doivent être identiques.

Pour placer un snippet, survolez son entrée dans le panneau Design Reuse, cliquez sur le bouton  (ou cliquez avec le bouton droit sur l’entrée), puis sélectionnez la commande Place (pour un snippet de schéma ou PCB) ou Place as Sheet Symbol (pour un snippet de schéma uniquement) dans le menu. Lorsque cette dernière est sélectionnée, le snippet sera placé sur la feuille de schéma active sous forme de symbole de feuille. Le symbole de feuille placé inclura des entrées de feuille correspondant aux ports du snippet. Le contenu du snippet sera placé sur une feuille de schéma enfant créée automatiquement et référencée par le symbole de feuille.

Organisation des snippets locaux

Les snippets locaux peuvent être organisés dans des dossiers de snippets, afin de regrouper les snippets associés et de vous permettre de les retrouver plus facilement. Les dossiers de snippets sont des dossiers Windows existants qui ne peuvent pas être créés depuis le panneau Design Reuse. À la place, ils sont « ouverts » ou « fermés » lors de la navigation parmi les snippets locaux qu’ils contiennent. Ces dossiers ne peuvent être créés directement que sur votre disque dur ou votre réseau, en dehors de Altium Designer.

Lorsque le panneau Design Reuse est configuré pour afficher les ressources locales (cliquez sur l’icône la plus à gauche dans la barre d’adresse en haut du panneau et sélectionnez l’entrée Local – l’icône s’affichera comme ), les dossiers de snippets peuvent être ouverts et fermés depuis la boîte de dialogue Available Snippets Folders, accessible en cliquant sur le bouton en haut à droite du panneau puis en sélectionnant la commande Snippet Folders dans le menu.

• Cliquez sur  pour rechercher le dossier requis sur votre disque dur ou votre réseau. Le dossier sélectionné sera ajouté à la liste dans la boîte de dialogue et apparaîtra ensuite dans le panneau Design Reuse.

• Pour supprimer un dossier de snippets de la liste (ce qui revient essentiellement à le fermer du point de vue de la navigation), sélectionnez le dossier dans la liste de la boîte de dialogue Available Snippets Folders, puis cliquez sur .

Modification d’un snippet

Pour modifier un snippet du Workspace, survolez son entrée dans le panneau Design Reuse, cliquez sur le bouton  (ou cliquez avec le bouton droit sur l’entrée), puis sélectionnez la commande Edit dans le menu. Un éditeur temporaire s’ouvrira, avec le document snippet contenu dans la dernière révision de l’élément Snippet ouvert pour modification. Apportez les modifications nécessaires, puis enregistrez le snippet dans la révision suivante de l’élément (File » Save to Server).

Pour modifier le contenu d’un snippet local, ouvrez le document <SCHSnippetName>.SchDoc ou <PCBSnippetName>.PcbDoc depuis le dossier Windows où le snippet est stocké (à l’aide de la commande File » Open dans les menus principaux de Altium Designer ou via le Windows Explorer), apportez les modifications nécessaires, puis enregistrez le document (File » Save).

Les propriétés d’un snippet local (son nom, sa description et son chemin) peuvent être modifiées à l’aide de la boîte de dialogue Snippet Properties. Pour accéder à cette boîte de dialogue,  survolez son entrée dans le panneau Design Reuse et cliquez sur le bouton  (ou cliquez avec le bouton droit sur l’entrée), puis sélectionnez la commande Edit dans le menu contextuel. Utilisez la boîte de dialogue pour effectuer les modifications requises.

Autres actions sur les snippets

Le menu du bouton (et le menu contextuel) d’une entrée de snippet dans le panneau Design Reuse donne également accès aux commandes suivantes :

• Move (pour un snippet du Workspace uniquement) – permet de modifier l’emplacement de l’élément Snippet dans la structure de dossiers du Workspace. Le lancement de cette commande donne accès à la boîte de dialogue Move Item, dans laquelle sélectionner le dossier cible sous lequel l’élément doit être placé.

• Share (pour un snippet du Workspace uniquement) – permet de définir les autorisations de partage du snippet. Après avoir sélectionné la commande, la boîte de dialogue Share For Item s’ouvre, dans laquelle vous pouvez configurer le partage selon vos besoins. Pour en savoir plus sur le partage au niveau de l’élément.

• Operations (pour un snippet du Workspace uniquement) – permet d’accéder à un menu déroulant de fonctions supplémentaires pour les snippets, comme décrit ci-dessous.

  • Make a Copy – utilisez cette commande pour copier l’extrait de code. Un éditeur temporaire de l’extrait s’ouvrira, avec le même contenu que dans l’extrait d’origine. Effectuez les modifications nécessaires et enregistrez l’extrait dans le Workspace. 

  • Change Revision State – utilisez cette commande pour modifier l’état de révision de la dernière révision de l’extrait. Après avoir sélectionné la commande, la boîte de dialogue Batch state change dialog s’ouvre, ce qui vous permet de modifier l’état de révision de l’extrait.

  • Download – utilisez cette commande pour télécharger les données stockées dans l’extrait. Les données associées seront téléchargées dans un sous-dossier du répertoire choisi, nommé à l’aide de l’ID de révision de l’élément. Le fichier se trouve dans le(s) dossier(s) Released qui s’y trouvent.

• Delete – utilisez cette commande pour supprimer l’extrait.

  • Pour un extrait du Workspace, la boîte de dialogue Delete Items s’affichera pour confirmer la suppression.

    L’action est en réalité une « suppression logicielle », par laquelle l’extrait sera déplacé vers la zone Trash du Workspace. Pour en savoir plus, consultez soft deletion.

  • Pour un extrait local, la boîte de dialogue Confirm s’affichera pour confirmer la suppression. L’action supprimera les fichiers de l’extrait du disque dur.

• History (pour un extrait du Workspace uniquement) – utilisez cette commande pour accéder à une vue détaillée de l’extrait, ouverte dans un nouvel onglet dans Altium Designer.