Working with Items

Dans un Workspace connecté, chaque entité de conception pouvant être stockée, gérée et réutilisée est représentée comme un type spécifique de Item. Afin de répondre au besoin de pouvoir mettre à jour un Item au fil du temps, ce qui est réellement stocké dans le Workspace est une série de révisions d’Item, qui sont des révisions spécifiques de cet Item dont le nom est basé sur le schéma de nommage de révision choisi. Chaque nouvel Item est créé dans un dossier et, une fois les dossiers requis définis dans un Workspace, vous pouvez créer de nouveaux Items dans le dossier sélectionné dans la région Item du panneau Explorer.

Types de contenu pris en charge

Différents Items sont utilisés pour stocker et représenter différents types de données. Un Item peut représenter un symbole schématique, un autre un modèle de composant PCB, tandis qu’un autre encore peut contenir les données de fabrication générées à partir d’une conception de carte publiée. Pour déclarer le type de contenu qu’un Item (ou plus précisément ses révisions) sera utilisé pour contenir, sa propriété Content Type doit être spécifiée lors de la création ou de la modification de cet Item. Autrement dit, vous spécifiez essentiellement le Item Type.

Le tableau suivant répertorie les différents types de contenu (types d’Item) pouvant être créés manuellement par un utilisateur dans un Workspace connecté, ainsi que leur :

• Associated Folder Type – le type de dossier dédié, lorsqu’il existe, dans lequel stocker le contenu de ce type. Cela n’a aucune incidence sur le contenu du dossier. Cela fournit simplement un « indice » visuel sur ce qui est stocké dans un dossier et peut être utile lors de la navigation dans un Workspace à la recherche d’un contenu particulier. Le contenu peut être stocké dans n’importe quel type de dossier, y compris le Generic Folder.

• Content Type Code – le code utilisé lors de l’attribution de l’ID unique à un Item créé de ce type de contenu, lorsque le schéma de nommage des Items du dossier parent utilise l’entrée $CONTENT_TYPE_CODE.

• Folder Type Code – le code utilisé lors de l’attribution de l’ID unique à un Item créé de ce type de contenu, lorsque le schéma de nommage des Items du dossier parent utilise l’entrée $FOLDER_TYPE_CODE.

Révisions d’Item

Un Item peut avoir un nombre quelconque de révisions, qui constituent essentiellement l’évolution de cet Item au fil du temps. Une modification est effectuée et le nouveau contenu de données est enregistré/téléversé/publié dans une nouvelle révision, garantissant qu’aucune révision existante ne puisse jamais être écrasée, et assurant ainsi la plus haute intégrité. Les données stockées dans chaque révision d’un Item sont donc généralement différentes. Pour distinguer ces différentes révisions d’un Item, un identifiant de révision (ID) est utilisé qui, combiné à l’ID de l’Item, crée un identifiant unique pour chaque publication d’un Item. Cela nous donne le Item-Revision.

Un ID complet Item-Révision identifie donc simplement une révision spécifique d’un Item parent. Il y aura toujours au moins une révision d’un Item (la première publication), mais il peut y en avoir beaucoup, selon le nombre de fois où les données de cet Item ont été enregistrées/téléversées/publiées. Un point important à souligner ici est que vous ne pouvez publier vers un Item-Révision particulier qu’une seule fois. S’il y a une modification, un nouvel Item-Révision doit alors être créé. Cela garantit la plus haute intégrité, car les données contenues dans une révision donnée ne peuvent jamais être écrasées par une nouvelle publication vers cette même révision. Pour publier à nouveau, un nouvel Item-Révision doit être utilisé.

La manière la plus simple de comprendre le concept d’un Item et de ses révisions est d’imaginer une « boîte » dans laquelle sont stockées toutes les données de cette révision particulière de cet Item particulier. Lorsque l’Item est publié, les données sont placées dans la boîte et la boîte est fermée. L’ID de l’Item et l’ID de révision deviennent des étiquettes sur le côté de cette boîte : elles permettent de reconnaître instantanément à quoi sert le contenu de la boîte. Si les données doivent être mises à jour et publiées à nouveau, l’ID de révision est incrémenté, créant une nouvelle boîte.

La « boîte » Item-Révision — étiquetée avec l’ID de l’Item et l’ID de révision. Le contenu correspond aux données nécessaires pour construire ou représenter cette révision de cet Item. L’action de publication ferme la boîte, empêchant toute autre donnée d’être publiée vers cette révision à l’avenir. L’ID complet Item-Révision, dans ce cas, serait : D-820-1001-01.A.1.

Le format de l’ID d’une révision est déterminé par le Revision Naming Scheme utilisé pour l’Item parent. Le format spécifique utilisé dans un schéma est configurable et dépend des besoins de chaque organisation.

Notes de changement d’état et de publication

Pour améliorer la piste d’audit du contenu dans un Workspace, Altium Designer permet de saisir des notes lors du changement de l’état du cycle de vie d’un Item-Révision et, pour de nombreux types de contenu, lors de la publication des données source dans des révisions planifiées du Workspace.

Notes de changement d’état

Lors du changement de l’état du cycle de vie d’un Item-Révision dans un Workspace, utilisez la région State change note de la boîte de dialogue de changement d’état qui s’ouvre ensuite pour saisir une note pertinente concernant ce changement.

Ajout d’une note pour expliquer le changement d’état du cycle de vie d’un Item-Révision.

Notes de publication

Lors de la publication des données source dans une nouvelle révision planifiée d’un Item dans un Workspace, utilisez la région Release notes de la boîte de dialogue Create Revision qui s’ouvre ensuite pour saisir une note pertinente concernant cette publication. Cette fonctionnalité est disponible lors de la republication de tout type d’Item prenant en charge le paradigme Direct Editing.

Exemple d’ajout d’une note de publication lors de la republication d’un empilage de couches vers un Workspace cible.

Affichage des notes associées aux révisions d’un Item

Les notes ajoutées pour toute révision d’un Item peuvent être consultées aux emplacements suivants :

• Detailed Item view – affichez la note de publication associée, ainsi que les notes relatives aux changements d’état de la révision, dans la colonne Note de la région Timeline. Pour chaque état dans la vie d’une révision, la note applicable (si elle a été ajoutée) peut également être consultée dans la vue graphique du cycle de vie de la révision.
• Explorer panel – basculez vers l’onglet de vue d’aspect Lifecycle pour un Item-Revision sélectionné. Pour chaque état dans la vie d’une révision, la note applicable (si elle a été ajoutée) peut être consultée dans la représentation graphique du cycle de vie de la révision. En outre, affichez la note de publication associée, ainsi que la note du dernier changement d’état de la révision, dans la colonne Note, au sein de la région principale Item du panneau (il peut être nécessaire d’activer l’affichage de cette colonne).

Affichage des notes associées aux révisions d’un composant.

Commandes générales des Items

En plus des options d’affichage, la zone d’options du panneau Explorer comprend également le bouton de commande Add <item>, qui s’applique au type de dossier actuellement sélectionné.

Cette commande lance la création d’un nouvel Item Workspace du type sélectionné. Lorsqu’un type de dossier de composant est sélectionné dans le panneau, par exemple, un bouton est proposé. Cela ouvrira un composant nouvellement créé de ce type dans le Component Editor. De même, un bouton s’affiche lorsqu’un dossier de type Output Job a été sélectionné, et ainsi de suite. Le bouton apparaîtra après une recherche de composant, telle que saisie dans le champ de chemin du composant en haut du panneau, ce qui crée une activité Part Request s’appliquant au composant sélectionné dans les résultats de recherche.

Placement par glisser-déposer

Le placement de certains Items du Workspace dans un projet de conception PCB dans Altium Designer est simplifié grâce à la possibilité de glisser-déposer des révisions de ces types d’Item sur le document actif (et applicable), directement depuis le panneau Explorer. Il est possible de faire glisser :

• Une révision d’un Component Item sur le document schématique actif (ou le document PCB). Le modèle applicable pour le domaine choisi apparaîtra alors flottant sur le curseur.
• Une révision d’un Managed Schematic Sheet Item sur le document schématique actif. Un symbole de feuille référençant cette feuille flottera attaché au curseur.
• Une révision d’un 3D Model Item sur un document PCB ou une bibliothèque PCB, créant un objet 3D Body qui référence cette révision d’Item.

Parcourez votre Workspace pour trouver l’Item requis à placer. Le placement implique une révision spécifique de cet Item ; veillez donc à développer l’entrée principale de l’Item pour lister toutes ses révisions disponibles (cliquez sur le bouton en haut à droite du panneau et désactivez l’option Show only latest pour voir toutes les révisions précédentes). Cliquez ensuite sur la révision requise et faites glisser une instance de celle-ci sur le document de conception.

En outre, Altium Designer prend en charge l’accès aux composants depuis le Components panel, ainsi que leur placement.

Téléchargement des données de contenu

Téléchargez les données stockées dans une révision d’un Item en cliquant avec le bouton droit sur cette révision et en choisissant la commande Operations » Download dans le menu contextuel. 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’Item. Les fichiers se trouvent dans le dossier Released qu’il contient.

Type de contenu Binary File

Altium Designer, en conjonction avec votre Workspace connecté, permet de stocker des fichiers libres dans un type de contenu spécial – l’Item Binary File. De tels Items peuvent être créés pour contenir un ou plusieurs fichiers de n’importe quel format. Cela vous permet de tirer pleinement parti de la nature sécurisée du Workspace et souligne que le Workspace est l’endroit idéal pour stocker n’importe quoi, y compris vos fichiers binaires source réunis dans une seule entité. Et pour faciliter le flux rationalisé des fichiers de données, une fonctionnalité bidirectionnelle de glisser-déposer est fournie, vous permettant de déplacer rapidement des fichiers entre des dossiers de votre Workspace et des dossiers de votre Explorateur Windows.

• Créez un Item du type de contenu Binary File dans le Workspace. Une nouvelle révision d’un Binary File Item peut être créée en téléversant le ou les fichiers applicables. Cela peut être effectué de plusieurs façons – voir Uploading Data into a New Revision of an Item pour plus d’informations.
• Si vous devez modifier le ou les fichiers stockés dans un Binary File Item, téléversez le ou les nouveaux fichiers requis vers cet Item – les nouveaux fichiers seront stockés dans la révision suivante de cet Item.
• Pour ouvrir un fichier stocké dans une révision d’un Binary File Item, sélectionnez ce fichier – dans l’onglet de vue d’aspect Details de la révision – puis cliquez avec le bouton droit et choisissez la commande Open dans le menu contextuel. L’application appropriée (ou Altium Designer lui-même) sera utilisée pour présenter le fichier, lorsque cela est possible.

Utilisation d’un Binary File avec les préférences de modèles

Dans le cadre des préférences d’Altium Designer, vous pouvez définir les documents modèles par défaut utilisés lors de la création d’un nouveau document d’un type particulier. Cela s’effectue depuis l’onglet Defaults de la page Data Management – Templates page de la boîte de dialogue Preferences. Un document modèle par défaut peut être basé sur un fichier ou provenir d’un Workspace connecté.

Pour certains types de documents (ActiveBOM Document, Out Job File, Multi-board Schematic et Multi-board Assembly), un document modèle par défaut basé sur le Workspace ne peut provenir que d’un fichier binaire. Vous devez donc téléverser le document modèle requis dans la révision d’un fichier binaire, puis l’utiliser comme valeur par défaut pour le nouveau document.

Téléversez un document nécessaire (par exemple, un fichier OutputJob) dans la révision initiale d’un nouveau fichier binaire.

Ensuite, lorsque vous essayez de définir une nouvelle valeur par défaut de document depuis le Workspace connecté, vous pouvez rechercher le fichier binaire, et l’entrée de préférence se renseignera en conséquence.

Utilisation réussie d’un OutputJob comme nouvelle valeur par défaut de document, via le fichier binaire qui le contient.