Managing Content with the Item Manager

Altium Designer, conjointement avec votre Workspace connecté, offre la possibilité de mettre à jour les composants d’une conception de carte existante afin d’utiliser des composants qui résident dans ce Workspace. Les composants provenant de bibliothèques de base de données et de bibliothèques basées sur des fichiers peuvent être mis à jour individuellement vers des composants du Workspace, ou mis à jour par lot à l’aide d’une correspondance automatisée des paramètres via le Item Manager d’Altium Designer.

En utilisant un système de règles hautement configurable pour cibler les composants appropriés dans le Workspace, la boîte de dialogue Item Manager fournit un moyen rapide et efficace de convertir le projet PCB actuel en un projet utilisant des Workspace Components.

Le Item Manager offre deux capacités clés concernant les composants et les feuilles de schématique réutilisables dans un projet de conception de carte :

• Migration – premièrement, il permet de convertir un projet de conception utilisant des composants et des feuilles de schématique fondés sur des approches traditionnelles vers l’utilisation d’entités du Workspace (composants et feuilles gérées). À cet égard, on peut le considérer comme une fonction « convertir pour utiliser les données du Workspace ».
• Synchronization – deuxièmement, une fois qu’une conception a été convertie pour utiliser le contenu du Workspace, le Item Manager fournit un moyen simple de synchroniser le contenu utilisé dans la conception avec tout contenu source correspondant dans le Workspace qui a été mis à jour. À cet égard, on peut le considérer comme une fonctionnalité « mettre à jour à partir des données du Workspace ».

À titre d’information, notez qu’un composant individuel dans une conception peut être mis à jour vers un composant du Workspace directement depuis le Properties panel dans l’éditeur de schémas. Pour ce faire, sélectionnez le composant sur la feuille de schéma, puis utilisez le menu déroulant Source du panneau pour choisir un Workspace comme source de données du composant — vous devez être connecté au Workspace pour y accéder. La boîte de dialogue Component source qui s’ouvre ensuite permet de sélectionner un composant cible dans le Workspace ou simplement de lier le composant au Workspace tout en conservant ou en remplaçant l’identifiant du composant (Design Item ID).

Si le composant du Workspace a été sélectionné, les données du composant récupérées remplaceront le composant et les modèles existants, et mettront à jour les paramètres du composant. Le panneau indiquera également l’état actuel du cycle de vie du composant et le statut de sa révision, comme illustré ci-dessous.

Un composant local peut être converti en composant du Workspace individuellement, ou en masse à l’aide du Item Manager. Ici, vous pouvez voir le composant d’origine. Survolez l’image pour voir le composant remplacé par son équivalent du Workspace.

Sinon, les composants peuvent être remplacés via le document ActiveBOM du projet (BomDoc).

Bien qu’il s’agisse d’une approche laborieuse pour mettre à jour tous les composants locaux d’une conception vers des composants du Workspace, même dans une conception de carte de petite taille, le Item Manager fournit une méthode de conversion simple et automatisée qui utilise une correspondance avancée des paramètres (Automatching) et une approche de mise à jour en masse. Une application typique du Item Manager consiste à mettre à jour une conception de carte existante afin d’utiliser des composants du Workspace et des feuilles de schématique gérées qui ont été migrés vers un Workspace depuis des bibliothèques d’entreprise.

Accès à l’Item Manager

La boîte de dialogue Item Manager est accessible depuis le Tools menu principal d’un document schématique actif (Tools » Item Manager) et présente tous les composants et symboles de feuille trouvés dans le projet actif de conception de carte.

Sélectionnez l’onglet inférieur Unmanaged ou Components de la boîte de dialogue pour remplir la liste des composants de la conception actuelle. En substance, la section de gauche de la boîte de dialogue affiche les paramètres des composants du projet actif (Current Settings), tandis que la section de droite indique comment ils changeront (New Settings) lorsque des composants appropriés du Workspace auront été attribués depuis le Workspace. La région New Settings comporte les mêmes champs que la région Current Settings. Pour afficher et accéder aux symboles de feuille, sélectionnez l’onglet Sheet Symbols.

Accédez au Item Manager depuis le Tools menu principal de l’éditeur de schémas. La boîte de dialogue se remplira automatiquement avec les composants actuels de la conception (et les feuilles schématiques).

La manière dont les données des composants sont présentées dans la boîte de dialogue Item Manager est hautement configurable, en fonction des colonnes de données activées et/ou groupées. Cela permet d’afficher la liste du contenu de conception et leurs paramètres système/utilisateur associés d’une manière correspondant à des approches spécifiques d’identification des composants — tous les paramètres d’élément, tels que les références internes propriétaires de l’entreprise, par exemple, peuvent être affichés selon les besoins.

Colonnes

Pour configurer les colonnes affichées dans le Item Manager, cliquez avec le bouton droit dans la zone d’en-tête des colonnes de la boîte de dialogue et sélectionnez Columns » Select Columns dans le menu contextuel. La boîte de dialogue Select columns proposera tous les paramètres disponibles, y compris ceux provenant spécifiquement de la conception locale ([Current Settings]) et du contenu du Workspace ([New Settings]). Utilisez le contrôle en forme d’« œil » à gauche d’une entrée pour afficher la colonne () ou non ().

Les colonnes affichées, ainsi que leur ordre, peuvent être configurées pour s’adapter à vos systèmes de Workspace/bibliothèques et à vos préférences.

Survolez un en-tête de colonne pour faire apparaître son icône de filtre qui, une fois sélectionnée, permet de limiter la liste dans le Item Manager à des types d’entrée spécifiques ou à un filtre personnalisé.

Regroupement

Pour regrouper les données de contenu répertoriées selon une colonne de paramètre particulière, telle que la catégorie de type de composant ou le document schématique, etc., faites glisser l’entrée d’en-tête de colonne souhaitée vers la ligne de titre supérieure de la boîte de dialogue (comme indiqué par le texte d’aide). La liste du contenu se reconfigurera pour regrouper ses entrées selon la colonne de paramètre attribuée.

N’importe quel en-tête de colonne de données peut être glissé vers la ligne supérieure de la boîte de dialogue afin de regrouper les entrées répertoriées selon ce paramètre.

Migration vers le contenu de conception du Workspace

En supposant que le Workspace connecté soit rempli de collections de components et de managed schematic sheets, le projet de conception de carte actuel peut être converti pour utiliser ce contenu lorsqu’une correspondance appropriée est disponible. La correspondance local-vers-Workspace peut être effectuée manuellement, ou sous forme de processus automatisé via le Item Manager sur la base d’une correspondance de paramètres configurable. Une fois terminée, les définitions de composants locaux seront mises à jour vers leurs équivalents du Workspace.

Choix manuel du contenu du Workspace

Pour remplacer manuellement un composant local (ou un schéma) par une version du Workspace, sélectionnez son entrée dans la liste Item Manager, puis choisissez Choose manually dans ses options du menu contextuel accessibles par clic droit. Vous pouvez également double-cliquer sur un élément de la grille pour choisir manuellement un élément. Dans la boîte de dialogue suivante Replace Component dialog, parcourez et sélectionnez un Item du Workspace présentant une correspondance appropriée (la dernière révision de cet Item sera utilisée).

Exemple de sélection manuelle d’un composant du Workspace à utiliser comme source pour le composant de conception existant dans une conception.

Lorsque la boîte de dialogue est fermée (OK), les informations du composant du Workspace sélectionné rempliront la zone New Settings de l’entrée dans la liste. Notez que, puisque l’entrée est désormais une entité Workspace en attente, l’entrée mise à jour est transférée de la liste sous l’onglet Unmanaged vers la liste sous l’onglet Managed.

Les détails concernant l’Item du Workspace choisi apparaissent dans la zone New Settings de la grille, sous l’onglet Managed.

Correspondance automatique des composants

Pour automatiser le processus de choix du contenu correspondant du Workspace, le Item Manager fournit une capacité configurable de correspondance automatique qui tente d’associer chaque composant de conception local à un composant du Workspace connecté. Lorsqu’une correspondance est trouvée, ce composant du Workspace sera proposé pour la mise à jour.

La clé des capacités de correspondance automatique des paramètres de l’Item Manager réside dans les règles et options de mise à jour disponibles dans la boîte de dialogue Item Manager Options, accessible depuis le bouton Item Manager de la boîte de dialogue . Les règles configurables déterminent quels paramètres de composant dans la conception active (locale) sont mis en correspondance avec les paramètres de tous les composants du Workspace dans le Source server sélectionné.

Créez des règles simples ou complexes pour faire correspondre avec précision les composants locaux aux composants appropriés dans le Workspace.

L’efficacité de ces règles pour obtenir une correspondance de composant local-vers-Workspace dépendra des paramètres de composant disponibles, qui seront propres aux systèmes de l’entreprise ou aux préférences individuelles. Dans le scénario le plus simple, mais peut-être peu probable, les entrées de paramètre Comment ou Component Name peuvent correspondre entre les composants locaux et les composants équivalents du Workspace. Dans le cas idéal, cependant, les composants locaux et ceux du Workspace partageront un paramètre de référence d’entreprise ou de numéro de pièce fabricant.

Pour créer une telle règle de numéro de pièce, par exemple, sélectionnez et modifiez une règle existante (qui peut également être renommée) ou utilisez le bouton pour créer une nouvelle règle – une règle doit être sélectionnée (cochée) pour pouvoir être modifiée. Notez que les listes déroulantes de sélection Local Parameter et Server Parameter sont indépendantes, ce qui permet de désigner des paramètres portant des noms différents – dans l’exemple ci-dessous, le paramètre local Libray Reference et le paramètre Workspace Part Number représentent un numéro de référence de pièce d’entreprise.

Les règles complexes à paramètres multiples exigent que tous les paramètres de composant désignés correspondent à ceux d’un composant du Workspace.

L’exécution d’une règle de correspondance de numéro de pièce/référence telle que celle ci-dessus est susceptible de créer une correspondance presque complète entre les composants locaux et ceux du Workspace. Une fois la règle établie, le processus de correspondance est lancé par le bouton dans la boîte de dialogue Item Manager.

La boîte de dialogue Automatching items qui suit indiquera les correspondances positives avec l’icône d’état et inclura une référence au nom de la règle ayant réussi.

Exemple d’obtention d’une correspondance locale-vers-Workspace réussie pour de nombreux composants à l’aide d’une seule règle basée sur un numéro de pièce commun.

Lorsqu’aucune correspondance ne peut être trouvée, l’entrée apparaît avec l’icône d’état , en texte rouge, avec une référence indiquant la raison de l’erreur ou de l’échec de la correspondance – une règle différente ou supplémentaire devra être créée pour obtenir une correspondance réussie pour ces composants. Notez également qu’une règle peut détecter plusieurs composants Workspace comme correspondance, ce qui est considéré comme un résultat réussi mais nécessite une intervention manuelle pour être résolu. Ce conflit est considéré comme un résultat « ambigu » et peut être résolu dans la boîte de dialogue Item Manager – voir ci-dessous.

Lorsque le processus de correspondance automatique est terminé, fermez la boîte de dialogue Automatching items (OK) pour renseigner la boîte de dialogue Items Manager avec les nouveaux paramètres de composant proposés. Le contenu Workspace en attente qui sera appliqué aux entrées correspondantes est répertorié dans la zone New Settings sous l’onglet Managed de la boîte de dialogue, ou sous l’onglet Components avec le contenu qui n’a pas été mis en correspondance.

Les modifications en attente du contenu Workspace sont détaillées dans la zone New Settings de la boîte de dialogue.

Pour résoudre tout contenu ambigu, généralement causé par plusieurs correspondances, sélectionnez l’onglet Ambiguous Items (ou Ambiguous Footprints) et faites un choix approprié dans le menu déroulant de la cellule Revision HRID dans la section New Settings de la boîte de dialogue (qui s’affiche par défaut comme <Not selected>). Notez que plusieurs correspondances, et donc les choix disponibles, peuvent en réalité faire référence à différentes révisions du même composant. Lorsque le problème est résolu (il n’est plus classé comme ambigu), l’entrée du composant sera déplacée vers les listes des onglets Managed/Components.

Lorsqu’une règle détecte plus d’une correspondance, l’onglet Ambiguous Items permet de désigner un choix. Plus de six correspondances entraîneront une erreur de règle.

Règles de correspondance avancées

Comme indiqué ci-dessus, les règles Item Manager établissent des correspondances de paramètres entre les composants du projet local et les composants Workspace. Il est possible de créer autant de règles que nécessaire, et celles-ci fonctionnent par ordre de priorité décroissant. Si la première règle (en haut) échoue, la règle suivante est appliquée – ce qui revient à une relation booléenne OU séquentielle. Une règle n’est active que lorsque sa case associée est cochée.

Lorsque le processus de correspondance automatique est exécuté, la colonne State Notes dans la boîte de dialogue Automatching items indique quelles règles n’ont pas réussi à trouver une correspondance. Dans ce cas, une règle différente ou nouvelle est nécessaire pour faire correspondre de manière satisfaisante les paramètres disponibles.

Bien que des règles de base puissent ne pas trouver de correspondance pour tous les composants, des règles paramétriques plus spécifiques peuvent être créées pour obtenir un résultat entièrement mis en correspondance.

Utilisez le bouton Item Manager Options de la boîte de dialogue Add Rule pour créer une nouvelle règle, ainsi que le associé pour appliquer plusieurs conditions de correspondance de paramètres. Cliquez sur pour supprimer la valeur sélectionnée. À mesure que chaque condition de paramètre est ajoutée, la règle devient de plus en plus spécifique, et toutes les conditions doivent être satisfaites pour que la correspondance de la règle réussisse – ce qui revient à une condition booléenne ET. Cliquez sur le bouton Remove pour supprimer la règle de correspondance sélectionnée.

En prenant l’exemple présenté ici, où (disons) les composants ne peuvent pas être mis en correspondance par les paramètres de numéro de pièce/référence, une nouvelle règle peut être créée pour faire correspondre des spécifications appropriées aux condensateurs non appariés listés ci-dessus.

Les règles fonctionnent de haut en bas jusqu’à ce qu’une correspondance soit trouvée. Les règles à paramètres multiples doivent satisfaire toutes les conditions pour qu’une correspondance soit établie.

Options de mise à jour

La boîte de dialogue Item Manager Options fournit une gamme d’options de mise à jour du contenu qui peuvent être utilisées pour affiner davantage la manière dont les composants Workspace mis en correspondance automatiquement sont appliqués à la conception de carte actuelle.

La zone Matching rules affiche les règles actuellement définies pour la correspondance. Reportez-vous à la section Correspondance automatique des composants pour en savoir plus. 

Les Update options de l’Item Manager offrent un moyen flexible de déterminer quels paramètres sont mis à jour, et dans quelles conditions.

Les options sont appliquées à la conception actuelle via le processus ECO, et se comportent comme suit :

• Update ‘Lock Designator’ field – lorsqu’elle est cochée, l’état Locked du composant local pour le champ Designator sera remplacé par son état dans le composant Workspace lié.
• Update ‘Lock Part-ID’ field – lorsqu’elle est cochée, l’état Locked du sélecteur d’ID de dispositif multipartie du composant local adoptera celui du composant Workspace lié.
• Update Parameters – cochez cette option pour autoriser la mise à jour des paramètres d’un composant vers ceux du composant Workspace lié. Active les options ci-dessous.
  • bouton – ouvre la boîte de dialogue Library Update Settings (voir ci-dessous).
  • Preserve parameter location – lorsqu’elle est cochée, la position d’un paramètre visible sur la feuille de schéma reste inchangée, au lieu d’être réinitialisée à la position par défaut du composant Workspace lié.
  • Preserve parameter visibility – lorsqu’elle est cochée, le statut Visible d’un paramètre reste inchangé, au lieu d’adopter celui du composant Workspace lié.

La boîte de dialogue Library Update Settings comprend une liste de tous les paramètres disponibles, pour tous les composants, dans le projet de carte actuel (clic droit pour accéder aux fonctions d’activation/désactivation en masse). Les paramètres cochés dans la liste seront mis à jour lorsqu’un composant local sera remplacé par/mis à jour vers un composant Workspace – le comportement de cette mise à jour est déterminé par les options décrites ci-dessous.

Les paramètres de composant mis à jour peuvent être spécifiés avec précision. Faites un clic droit pour accéder aux options de sélection.

Le comportement de remplacement (ou d’ajout) des paramètres est déterminé par les deux options inférieures de la boîte de dialogue :

• Library parameters not in sheet – définit le comportement de mise à jour lorsqu’un paramètre de composant Workspace (bibliothèque) n’existe pas dans le composant local (feuille).
  • Add – le paramètre est ajouté au composant pendant la mise à jour.
  • Do not add – le paramètre n’est pas ajouté au composant pendant la mise à jour.
  • Add if not blank – le paramètre n’est ajouté au composant pendant la mise à jour que s’il contient des données valides (son entrée Value n’est pas vide).
• Sheet parameters not in library – définit le comportement de mise à jour lorsqu’un paramètre de composant local (feuille) n’existe pas dans le composant Workspace lié (bibliothèque).
  • Remove – le paramètre existant (local) est supprimé du composant pendant la mise à jour.
  • Do not remove – le paramètre existant n’est pas supprimé du composant pendant la mise à jour.
  • Remove if blank – le paramètre existant est supprimé du composant pendant la mise à jour s’il ne contient pas de données valides (son entrée Value est vide).

Application de la mise à jour

Les modifications proposées qui ont été configurées dans le Item Manager sont appliquées à la conception de carte actuelle en générant et en exécutant un Engineering Change Order (ECO). Sélectionnez la plage de composants répertoriés que vous souhaitez mettre à jour, puis l’option ECO souhaitée dans le menu du bouton – les options sont :

• Generate ECO – utilisez cette commande pour générer et exécuter un ECO via la boîte de dialogue Engineering Change Order. Dans cette boîte de dialogue, vous pouvez parcourir les actions qui seront effectuées pour mettre en œuvre ces modifications et désactiver toute action si nécessaire. Une fois satisfait, exécutez l’ECO et les modifications seront appliquées.
• Apply ECO – utilisez cette commande pour créer et exécuter directement un ECO « silencieusement » (sans que la boîte de dialogue Engineering Change Order n’apparaisse).

Les modifications sont mises en œuvre au moyen d’un Engineering Change Order (ECO), qui peut être exécuté silencieusement ou via une boîte de dialogue (comme illustré).

Le processus ECO exécuté mettra à jour les composants du projet en conséquence, qui seront alors répertoriés dans la boîte de dialogue Item Manager comme composants Workspace actuellement à jour. Notez que l’icône précédente de chaque entrée () a changé pour indiquer la référence à un composant Workspace ().

Le Item Manager affichant les nouveaux paramètres actuels du contenu de conception dans le projet PCB. Les composants de conception auparavant locaux ont été entièrement remplacés par des composants Workspace.

Dans l’éditeur de schéma, les composants mis à jour sont liés à leurs composants correspondants dans le Workspace – les informations de liaison active détecteront un changement dans l’état de révision du composant Workspace lorsqu’il sera ensuite mis à jour. Sélectionnez un composant dans l’espace de conception et notez son Source ainsi que les informations associées dans le panneau Properties panel.

Exemple montrant le remplacement réussi d’un composant local, où le panneau Properties affiche la source Workspace et l’état de révision du composant de remplacement.

Synchronisation avec le contenu Workspace modifié

Au cours du développement d’un produit, il est très probable que des modifications surviennent dans les composants source de la conception ou dans les feuilles schématiques gérées. Par exemple, les modèles de composants peuvent être mis à jour vers une nouvelle norme de dessin, ou les définitions de composants peuvent avoir été mises à jour pour ajouter de nouveaux paramètres. Toute modification de ce type apportée aux composants du Workspace et aux feuilles gérées utilisés dans une conception doit être détectée et répercutée sur toutes les feuilles schématiques concernées.

Détection des mises à jour requises

Pour un composant individuel sélectionné ou un symbole de feuille, le mode approprié Component ou Sheet Symbol du Properties panneau fournit une indication immédiate qu’un objet n’est pas à jour par rapport à ses données source du Workspace. Utilisez le bouton associé ou pour mettre à jour les données de cet objet depuis son Workspace source.

L’état obsolète d’un composant ou d’une feuille schématique gérée est indiqué dans le Properties panneau lorsque l’objet est sélectionné. Un bouton permettant de mettre à jour l’objet sélectionné vers sa dernière révision est fourni.

En plus d’être utilisé pour détecter et gérer les composants et feuilles schématiques qui sont actuellement des entités non-Workspace (indiquées comme [Not Managed] et non issues d’un Workspace), le Item Manager est également utilisé pour détecter et gérer tout le contenu qui est obsolète.

Lorsque le Item Manager est ouvert, il détecte et répertorie automatiquement tous les composants et feuilles schématiques gérées (en indiquant s’ils proviennent d’un Workspace ou non), puis compare l’Item-Revision de chaque contenu Workspace présent dans les schémas avec les révisions disponibles de ce contenu dans le Workspace. S’il existe du contenu pour lequel une révision plus récente est disponible dans le Workspace, cela est signalé comme Out of date dans la colonne Revision Status de l’Item Manager.

Repérez les composants et feuilles schématiques gérées qui ont été détectés comme étant Out of Date, sélectionnez-les, puis cliquez avec le bouton droit pour effectuer une mise à jour.

Mise à jour du contenu

Pour mettre à jour le contenu obsolète, il doit être sélectionné, puis la commande Update to latest revision doit être appliquée depuis le menu contextuel accessible par clic droit. La zone New Settings de la boîte de dialogue affichera alors le détail de chaque nouvelle Item-Revision.

Une fois les modifications configurées comme souhaité, elles doivent être appliquées. Cela se fait au moyen d’un Engineering Change Order (ECO). Le menu déroulant associé au bouton ECO , en bas du Item Manager, propose deux façons d’effectuer une mise à jour :

• Generate ECO - utilisez cette commande pour générer et exécuter un ECO via la boîte de dialogue Engineering Change Order. À l’aide de cette boîte de dialogue, vous pouvez parcourir les actions qui seront entreprises pour appliquer ces modifications. Vous pouvez désactiver n’importe quelle action selon vos besoins : vous gardez toujours le contrôle total sur ce qui est modifié. Lorsque vous êtes prêt, exécutez l’ECO et les modifications seront appliquées.
• Apply ECO - utilisez cette commande pour créer et exécuter directement un ECO en mode silencieux, sans afficher la boîte de dialogue Engineering Change Order.

Sélectionnez le contenu obsolète et utilisez la commande par clic droit Update to latest revision pour charger la zone New Settings avec les détails de la révision mise à jour. Appliquez ensuite la mise à jour – via un ECO – au(x) composant(s) et à la/aux feuille(s) schématique(s) gérée(s) dans la conception.

La vérification que le remplacement a bien réussi peut être effectuée au niveau de chaque composant/symbole de feuille dans les feuilles schématiques du projet de conception de carte. Accédez au Properties panneau pour un élément sélectionné, qui affichera désormais un lien vers l’élément géré source correspondant. Sinon, la vérification peut être effectuée rapidement dans le Item Manager, qui se met à jour pour refléter les nouveaux paramètres des éléments du projet de conception de carte, dans la zone Current Settings de la grille.

Rapport de l’Item Manager

Avant de valider un processus de mise à jour ou de modification de composant dans le Item Manager, il peut être judicieux de générer un instantané des informations de la liste actuelle à l’aide de la fonction Export de la boîte de dialogue. Pour ce faire, cliquez avec le bouton droit n’importe où dans le Item Manager et sélectionnez Export dans le menu contextuel, puis accédez à un emplacement approprié et donnez au rapport le nom souhaité. Le rapport est généré sous forme de fichier HTML et présenté avec la même disposition que l’affichage actuel du Item Manager.

Sélectionnez Export dans le menu contextuel pour générer un rapport à partir du Item Manager. Le rapport est généré au format HTML et représente un instantané de la liste complète du Item Manager.