Acquérir les données de l’espace de travail à l’aide du panier de contenu
En un coup d'œil
- Découvrez comment ajouter des révisions individuelles, plusieurs éléments ou des dossiers entiers au Content Cart.
- Apprenez à configurer les dossiers cibles, les définitions de cycle de vie et les schémas de nommage avant de transférer les données.
- Comprenez les points essentiels à prendre en compte lors de l’acquisition, notamment les éléments enfants liés, les révisions déjà acquises et les exigences de connexion aux Workspaces.
La fonctionnalité d’acquisition de données d’un espace de travail fournit un utilitaire simplifié permettant essentiellement de copier des données entre deux espaces de travail (voir les informations de compatibilité). Cette opération s’effectue à l’aide du Content Cart, votre interface avec le service d’acquisition de données. Il s’agit du centre de commande permettant de définir les données à acquérir depuis l’espace de travail source et à transférer vers l’espace de travail cible désigné : un véritable véhicule de déménagement qui transporte les données sélectionnées entre vos espaces de travail.
Rien de tel qu’un exemple pour illustrer le fonctionnement d’une fonctionnalité. Pour présenter en détail le Content Cart et son utilisation pour l’acquisition de données, cet article décrit l’acquisition de composants entre les espaces de travail suivants :
-
Source Server – un espace de travail nommé
Company Workspace. -
Target Server – un second espace de travail nommé
Secondary Company Workspace.
Accéder au panier
L’accès à la boîte de dialogue Content Cart s’effectue depuis le panneau Explorer. Lorsque vous parcourez l’espace de travail source dont vous souhaitez obtenir des données, faites un clic droit sur une révision d’élément à acquérir, puis choisissez la commande Operations » Add to Content Cart dans le menu contextuel. Vous pouvez ajouter une ou plusieurs révisions d’éléments sélectionnées, voire un dossier d’éléments. Lors du premier accès au panier, celui-ci est rempli avec les révisions d’éléments sélectionnées dans l’espace de travail source à cet instant :
- Une seule révision spécifique d’un élément.
- Plusieurs révisions spécifiques du même élément.
- Les dernières révisions de plusieurs éléments.
- Les dernières révisions de tous les éléments du dossier sélectionné et de son arborescence. Vous pouvez ainsi charger un dossier entier dans le panier tout en conservant sa structure. Pour acquérir un dossier et son arborescence, sélectionnez-le dans la zone Server Folders de l’espace de travail source (dans le panneau Explorer ), puis faites un clic droit et choisissez la commande Operations » Add to Content Cart dans le menu contextuel.

Exemple d’accès au Content Cart.
Éléments pouvant être acquis
Les types d’éléments suivants peuvent être acquis depuis un espace de travail source vers un espace de travail cible à l’aide de la fonctionnalité d’acquisition de données :
- Modèle 3D
- Préférences Altium Designer
- Composant (y compris les choix de pièces associés)
- Modèle de composant
- Fiche technique
- Empreinte
- Feuille de schéma gérée
- Fichier de tâches de sortie
- Modèle de schéma
- Script
- Modèle de simulation
- Symbole
De plus, lors de l’acquisition d’un dossier d’éléments depuis l’espace de travail source, les types de dossiers suivants sont pris en charge :
- Composants
- Dossier générique
Points à prendre en compte pour l’acquisition
Points à prendre en compte lors de l’acquisition de données :
- Seuls les éléments de données à l’état publié dans l’espace de travail source peuvent être acquis.
- Seule la révision choisie d’un élément source est acquise, et non l’ensemble des révisions existantes de cet élément.
-
Lors de l’acquisition d’une révision d’un élément source de type Composant ou Feuille de schéma gérée, tous les éléments enfants liés sont également acquis :
- Component Item – révisions applicables des objets enfants liés suivants : élément Symbole, éléments Empreinte, éléments Modèle 3D, élément Modèle de simulation, élément Modèle de composant, éléments Fiche technique, associations de choix de pièces.
Notez que le paramètre Type de composant n’est pas transféré au cours du processus d’acquisition. Les composants transférés apparaîtront donc à l’emplacement Uncategorized de la cible, à la fois dans le panneau Components d’Altium Designer et sur la page Components de l’espace de travail. Vous pouvez appliquer le type de composant souhaité à une ou plusieurs entrées de composants à l’aide de l’opération Change Component Type dans le panneau Explorer d’Altium Designer.
- Managed Schematic Sheet Item – révisions applicables des objets enfants liés suivants : éléments Composant, éléments Symbole, éléments Empreinte, éléments Modèle 3D, éléments Modèle de simulation, éléments Modèle de composant, éléments Fiche technique, élément Modèle de schéma.
- Le cycle de vie d’une révision d’élément source acquise prendra l’état initial « après publication », tel que défini par la définition de cycle de vie affectée à l’élément cible. Tout historique du cycle de vie de la révision de l’élément source sera simplement ignoré.
- Si un élément enfant d’un élément source sélectionné de type Composant ou Feuille de schéma gérée ne peut pas être acquis, quelle qu’en soit la raison, l’acquisition de cet élément Composant ou Feuille de schéma gérée n’aura pas lieu.
Processus d’acquisition de données – Résumé
Utilisez le Content Cart pour acquérir toutes les données dont vous avez besoin. Le processus d’acquisition d’éléments de données depuis un serveur source est simple et se résume aux étapes suivantes :
-
Le serveur source est automatiquement défini comme le serveur actuellement actif, mais vous pouvez choisir un autre serveur connecté dans le menu de sélection situé en haut à gauche du panneau Explorer.
-
Utilisez le menu déroulant du nom du serveur cible du panier de contenu (en surbrillance bleue) pour sélectionner un autre serveur cible dans la liste des serveurs actuellement connectés. Choisissez l’option Administration des serveurs pour activer ou désactiver les connexions aux serveurs. Pour les composants, la cible peut également être un fichier de bibliothèque intégrée (IntLib) enregistré localement.
-
La révision d’élément initiale figure dans la grille principale. Vous pouvez ajouter autant de révisions d’éléments que nécessaire au panier. Pour ce faire, cliquez sur la commande Add More Items en haut à droite de la boîte de dialogue, puis choisissez l’entrée Select pour accéder à la boîte de dialogue Choose Item (une variante du panneau Explorer). Vous pouvez alors parcourir le serveur source pour rechercher d’autres éléments et les ajouter individuellement ou par lots à l’aide des outils de sélection multiple standard. Vous pouvez également choisir l’entrée Add manually pour accéder à la boîte de dialogue Add new items. Cette boîte de dialogue vous permet de coller une liste externe des éléments dont vous avez besoin (un élément par ligne), puis de les rechercher sur le serveur source selon un critère de recherche choisi (GUID, Item ID, Name ou MPN). Si vous décidez finalement de ne pas acquérir certaines révisions d’éléments, sélectionnez-les et supprimez-les de la liste en cliquant sur le bouton
.
-
Cliquez sur la commande Change Settings en bas à droite de la boîte de dialogue Content Cart pour accéder à la boîte de dialogue Content Cart Structure. Vous pouvez y définir les options par défaut pour chacun des types d’éléments de données dont l’acquisition est prise en charge par cette fonctionnalité. Cela consiste à spécifier un dossier par défaut sur le serveur cible, ainsi qu’une définition de cycle de vie, des schémas de nommage des éléments et des révisions, et un indice de départ par défaut. Vous pouvez également ajouter une note afin de fournir aux autres utilisateurs des informations utiles sur l’acquisition lorsqu’ils parcourent le contenu acquis.
-
Une fois les éléments sources souhaités choisis, cliquez sur le bouton
. Cette opération prépare le serveur cible à l’acquisition en vérifiant l’état des révisions des éléments sélectionnés (au cas où elles auraient déjà été acquises), ainsi que les liens parent-enfant, et en proposant l’action requise qui, pour les nouvelles acquisitions, sera Transfer new revision and item. Les options d’acquisition par défaut définies précédemment sont appliquées pendant cette phase de préparation, mais les propriétés des éléments cibles proposés peuvent être modifiées individuellement, si nécessaire. Pour cela, sélectionnez un élément dans la liste et cliquez sur le bouton
.
-
Une fois la préparation terminée, cliquez sur le bouton
pour lancer l’acquisition. Une première boîte de dialogue de confirmation s’affiche : cliquez sur Yes pour poursuivre le transfert du contenu entre les serveurs source et cible. Une seconde boîte de dialogue confirme le résultat de l’acquisition. Parcourez les éléments acquis sur le serveur cible à l’aide du panneau Explorer.
Les données acquises conservent un lien vers leur source d’origine. Les informations relatives à ce lien de filiation sont visibles en sélectionnant l’onglet de vue Origin de la révision de l’élément cible.
Spécification des espaces de travail source et cible
Les deux espaces de travail impliqués dans l’acquisition sont spécifiés dans la partie supérieure de la boîte de dialogue Content Cart. L’espace de travail source est déterminé automatiquement en fonction de l’emplacement des révisions d’éléments dont vous avez demandé l’acquisition ; il s’agit généralement de l’espace de travail auquel vous êtes actuellement connecté (Company Workspace dans cet exemple). Si vous êtes connecté à plusieurs espaces de travail, cliquez sur le nom de l’espace de travail cible ou sur la commande
à sa droite pour afficher la liste déroulante des espaces de travail actuellement connectés. Changez d’espace de travail selon vos besoins.

Spécification des espaces de travail source et cible impliqués dans l’acquisition.
Nommage du panier
Les données acquises depuis l’espace de travail source seront copiées dans de nouvelles révisions d’éléments de l’espace de travail cible. Par défaut, ces éléments seront placés dans une arborescence de dossiers définie et nouvellement créée dans cet espace de travail cible. Le dossier de premier niveau contenant ces données acquises porte le nom du panier lui-même. Le nom par défaut est au format Content Cart - <Current Date> - <Current Time> et est déterminé au moment de l’accès au panier. Vous pouvez le remplacer par un nom plus explicite si nécessaire en cliquant sur la commande Change, à droite du nom du panier.
Utilisez la boîte de dialogue Content Cart Name Selection qui s’affiche ensuite pour saisir directement le nom souhaité pour le panier. Vous pouvez également choisir un dossier dans l’espace de travail cible dans lequel sera déposé le contenu du panier. Il peut s’agir d’un dossier existant ou d’un tout nouveau dossier créé à la volée. Parcourez et sélectionnez un dossier existant pour le panier à l’aide de la boîte de dialogue Choose Folder, accessible en cliquant sur le bouton
situé à l’extrémité droite du champ Content Cart Name. Vous pouvez aussi créer un dossier dans l’arborescence à l’aide des commandes du menu contextuel.

Vous pouvez nommer un Content Cart selon vos besoins. Modifiez le nom du panier (dont le contenu sera déposé dans un dossier de premier niveau portant ce nom) ou choisissez de déposer le contenu du panier dans un dossier spécifique.
Spécification des éléments à acquérir
La zone principale de la boîte de dialogue Content Cart présente une « grille d’acquisition » répertoriant toutes les révisions d’éléments que vous avez choisi d’acquérir depuis l’espace de travail source. Vous pouvez « charger » autant de révisions d’éléments de données que nécessaire dans le Content Cart en vue de leur acquisition depuis l’espace de travail source. Lors du premier accès au panier, celui-ci est chargé avec les révisions d’éléments sélectionnées dans l’espace de travail source au moment de l’accès, mais vous pouvez y ajouter autant d’éléments supplémentaires que nécessaire. Pour ce faire, cliquez sur la commande Add More Items en haut à droite de la boîte de dialogue et choisissez l’entrée Select pour accéder à la boîte de dialogue Choose Item (une version « simplifiée » du panneau Explorer). Vous pouvez alors parcourir l’espace de travail source pour rechercher d’autres éléments. Pour rappel, vous pouvez ajouter :
- Une seule révision spécifique d’un élément.
- Plusieurs révisions spécifiques d’un même élément.
- Les dernières révisions de plusieurs éléments.
- Les dernières révisions de tous les éléments du dossier sélectionné (et de toute son arborescence).
Vous pouvez également choisir l’entrée Add manually pour accéder à la boîte de dialogue Add new items. Cette boîte de dialogue vous permet de coller une liste externe des éléments dont vous avez besoin (un élément par ligne), puis de les rechercher dans l’espace de travail source à l’aide du critère de recherche choisi (GUID, Item ID, Name ou MPN).

La grille d’acquisition principale, qui répertorie toutes les révisions d’éléments choisies pour l’acquisition depuis l’espace de travail source.
Préparation du panier
Une fois les révisions d’éléments sources choisies, le Content Cart doit être « préparé pour la livraison » à l’espace de travail cible. Pour ce faire, cliquez sur le bouton
. Cette opération prépare l’espace de travail cible à l’acquisition : elle vérifie le statut des révisions d’éléments choisies (au cas où elles auraient déjà été acquises), ainsi que les liens parent-enfant, et propose l’action à effectuer. Les résultats de cette phase de préparation sont ensuite présentés dans la grille d’acquisition principale.

Exemple de Content Cart, préparé pour la livraison à l’espace de travail cible.
Pour chaque révision d’élément concernée par l’acquisition, la zone Source de la grille se développe pour présenter toutes les révisions d’éléments enfants applicables et, éventuellement, le dossier dans lequel elles se trouvent dans l’espace de travail source. Pour chaque révision d’élément (parent ou enfant), les informations suivantes peuvent être présentées dans la zone Target de la grille :
- Revision ID – l’identifiant complet de la révision d’élément dans l’espace de travail cible, basé sur les schémas de nommage des éléments et des révisions définis pour ce type d’élément.
- Folder – le dossier de destination dans l’espace de travail cible, dans lequel la révision d’élément acquise sera créée/livrée.
- Life Cycle – la définition du cycle de vie définie pour l’élément parent.
- Naming Scheme – le schéma de nommage des révisions défini pour identifier les révisions de l’élément parent.
- Note – une note facultative permettant de fournir aux autres utilisateurs des informations utiles sur l’acquisition lorsqu’ils parcourent le contenu acquis dans votre espace de travail.
-
Status – l’état actuel de la révision d’élément dans l’espace de travail cible. Les états possibles sont les suivants :
-
Not found– la révision d’élément n’a jamais été acquise. -
Already Exists– la révision d’élément a déjà été acquise.
-
-
Action – l’action à effectuer pour synchroniser les espaces de travail source et cible. Les actions possibles sont les suivantes :
-
Transfer new revision and item– pour les acquisitions entièrement nouvelles, lorsque l’élément n’a jamais été acquis auparavant. Autrement dit, créer un élément de ce type et une nouvelle révision à l’état planifié pour accueillir les données sources. -
Transfer new revision of existing item– lors de l’acquisition d’une autre révision d’un élément dont une révision a déjà été acquise. -
Nothing to do– la révision d’élément choisie a déjà été acquise.
-
Structure du panier
Lors de la phase de préparation, le panier utilise les paramètres par défaut définis pour chaque type d’élément pouvant être acquis. Ces paramètres sont définis dans la boîte de dialogue Content Cart Structure, accessible en cliquant sur la commande Change Settings en bas à droite de la boîte de dialogue Content Cart.

Les paramètres d’acquisition par défaut sont définis dans la boîte de dialogue Content Cart Structure.
Ces paramètres servent à déterminer les propriétés des révisions d’éléments nouvellement créées dans l’espace de travail cible, prêtes à recevoir, à l’état planifié, les données des révisions d’éléments d’origine de l’espace de travail source. Ils comprennent un dossier par défaut dans l’espace de travail cible, ainsi qu’une définition du cycle de vie, des schémas de nommage des éléments et des révisions et un indice de départ par défaut. Une note par défaut est également définie au format Acquired from <SourceWorkspaceName>.
En ce qui concerne les dossiers de destination dans l’espace de travail cible, chaque type d’élément sera acquis dans un dossier distinct sous :
- Un dossier parent de premier niveau, portant le nom du Content Cart lui-même.
- Un dossier existant, défini dans la boîte de dialogue de sélection Content Cart Name.
Modifiez ces paramètres d’acquisition par défaut pour les adapter aux schémas utilisés (et privilégiés !) pour ces types d’éléments dans votre espace de travail cible. Cliquez sur une cellule pour accéder aux commandes de modification.
Les paramètres d’acquisition de la boîte de dialogue Content Cart Structure sont des valeurs par défaut générales. Pour les éléments qui n’ont jamais été acquis, et pour lesquels l’élément parent et la révision initiale sont donc nouvellement créés (Action est défini sur Transfer new revision and item), vous pouvez, si nécessaire, définir les propriétés de chaque élément individuellement afin de bénéficier d’un contrôle plus précis. Pour ce faire, sélectionnez une révision d’élément dans la grille d’acquisition principale et cliquez sur le bouton
. Vous accéderez ainsi à la boîte de dialogue Edit Item, dans laquelle vous pourrez modifier les propriétés de l’élément selon vos besoins, en remplaçant les paramètres par défaut.

Pour un contrôle plus précis, vous pouvez définir les propriétés de chaque élément individuellement.
Livraison du panier
Une fois la préparation terminée, cliquez sur le bouton
pour procéder à l’acquisition. Une boîte de dialogue de confirmation s’affiche pour vous informer que le Content Cart va être transféré de l’espace de travail source vers l’espace de travail cible ; cliquez sur Yes pour continuer. Une seconde boîte de dialogue de confirmation indique le résultat de l’acquisition. Les éléments acquis peuvent alors être consultés dans l’espace de travail cible à l’aide du panneau Explorer.
Acquisition de données au format IntLib
Vous pouvez également acquérir des composants de votre espace de travail dans une bibliothèque intégrée (*.IntLib). Lorsque vous placez des composants provenant d’une telle bibliothèque intégrée, les liens pointent vers les composants de l’espace de travail. Vous pouvez ainsi utiliser les composants de l’espace de travail de votre entreprise hors ligne, tout en veillant à ce que la conception conserve un lien réel avec ces composants dans l’espace de travail source.
Acquisition dans une IntLib
Depuis la boîte de dialogue Content Cart, la procédure d’acquisition dans une IntLib est la suivante :
-
Cliquez sur le lien Select target server et choisissez IntLib file dans le menu.
-
Indiquez le nom et l’emplacement du fichier IntLib à générer. Par défaut, le nom du fichier sera au format
Integrated_Library - <Date> - <Time>.IntLibet le fichier sera généré à l’emplacement\Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib. Modifiez ces paramètres si nécessaire dans la boîte de dialogue Save As, accessible en cliquant sur le lien Change .
Acceptez le dossier cible et le nom de fichier par défaut, ou modifiez-les selon vos besoins. -
Si vous devez acquérir des composants supplémentaires dans la même IntLib, cliquez sur le lien Add More Items, puis choisissez l’entrée Select pour accéder à la boîte de dialogue Choose Item (une version simplifiée du panneau Explorer). Vous pouvez alors parcourir l’espace de travail source pour rechercher d’autres éléments. Vous pouvez également choisir l’entrée Add manually pour accéder à la boîte de dialogue Add new items. Cette boîte de dialogue vous permet de coller une liste externe des éléments dont vous avez besoin (un élément par ligne), puis de les rechercher dans l’espace de travail source à l’aide du critère de recherche de votre choix (GUID, Item ID, Name ou MPN).
-
Lorsque vous êtes prêt, cliquez sur le bouton
pour lancer la génération de l’IntLib. Un package de bibliothèque intégrée temporaire (*.LibPkg) sera créé, auquel seront ajoutés les fichiers sources SchLib (contenant les symboles, les paramètres et les liens vers les modèles) et PcbLib (contenant les modèles d’empreintes) générés. Ce package sera ensuite compilé pour produire le fichier IntLib dans le dossier spécifié. Une boîte de dialogue d’information confirmera que le fichier a bien été généré.
Transférez le panier vers le dossier cible, qui contiendra le fichier de bibliothèque intégrée requis.
Utilisation de l’IntLib
Une fois générée, l’IntLib peut être ajoutée aux bibliothèques disponibles dans le logiciel en dehors de l’espace de travail (via l’onglet Installed de la boîte de dialogue Bibliothèques disponibles basées sur des fichiers). Elle sera alors accessible depuis le panneau Composants. Placez les composants de l’IntLib dans votre conception selon vos besoins. Même lorsque vous travaillez avec les composants « hors ligne », les liens vers les composants d’origine de l’espace de travail assurent la continuité lorsque vous reprenez votre travail « en ligne », directement depuis votre espace de travail.
