Acquérir les données de l’espace de travail à l’aide du panier de contenu

La fonctionnalité d’acquisition de données d’un Workspace fournit un utilitaire simplifié permettant essentiellement de copier des données entre deux Workspaces (voir les informations de compatibilité). L’outil par lequel cela s’effectue – votre interface avec le service d’acquisition de données – est le Content Cart. Il s’agit du centre de contrôle pour définir ce qui doit être acquis depuis le Workspace source et transféré vers le Workspace cible désigné – un fidèle camion de déménagement qui « transporte » vos données sélectionnées entre des résidences Workspace établies.

Rien de tel qu’un exemple pour illustrer le fonctionnement d’une fonctionnalité. Ainsi, pour montrer les tenants et aboutissants du Content Cart et son utilisation pour acquérir des données, cet article examine l’acquisition de certains composants entre les Workspaces suivants :

• Source Server – un Workspace nommé Company Workspace.
• Target Server – un second Workspace nommé Secondary Company Workspace.

Accéder au panier

L’accès à la boîte de dialogue Content Cart se fait depuis le panneau Explorer panel. Lors de la navigation dans le Workspace source depuis lequel vous souhaitez obtenir des données, cliquez avec le bouton droit sur une révision d’élément que vous souhaitez 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ément sélectionnées, ou même un dossier d’éléments. Lors du premier accès au panier, celui-ci est chargé avec la ou les révisions d’élément sélectionnées dans le Workspace source au moment de l’accès :

• 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 sa structure descendante). Cela vous permet de charger un dossier entier dans le panier tout en préservant sa structure de dossiers. Pour acquérir un dossier (et sa structure descendante), sélectionnez-le dans la région Server Folders du Workspace source (dans le Explorer panel), puis cliquez avec le bouton droit et choisissez la commande Operations » Add to Content Cart dans le menu contextuel.

Exemple d’accès au Content Cart.

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 région supérieure de la boîte de dialogue Content Cart. L’espace de travail source est déterminé automatiquement, en fonction de l’emplacement de résidence des révisions d’Item que vous avez spécifiées pour l’acquisition — généralement 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 le contrôle situé à sa droite, pour accéder à une liste déroulante des espaces de travail actuellement connectés. Basculez d’un espace de travail à l’autre selon les besoins.

Spécification des espaces de travail source et cible impliqués dans l’acquisition.

Notez que l’espace de travail qui recevra les données de contenu (l’espace de travail cible) doit pouvoir se connecter à l’espace de travail source. Cela signifie qu’un Altium Enterprise Server sur site ne peut pas agir comme source de données de contenu pour un espace de travail Altium 365, puisque ce dernier ne peut pas se connecter au premier — celui-ci étant situé dans un LAN/WAN local et non exposé à Internet.

Résumé de l’acquisition de données entre espaces de travail :

SOURCE		CIBLE	PRISE EN CHARGE
Altium 365 Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium Enterprise Server Workspace
Altium Enterprise Server Workspace	→	Altium 365 Workspace
Altium 365 Workspace	→	Altium 365 Workspace

Nommer le panier

Les données acquises depuis l’espace de travail source seront copiées dans de nouvelles révisions d’Items dans l’espace de travail cible. Par défaut, ces Items seront placés dans une structure de dossiers définie et nouvellement créée au sein de cet espace de travail cible. Le dossier de niveau supérieur pour ce contenu acquis est nommé à partir du 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 où le panier est consulté. Il peut être remplacé par un nom plus explicite selon les besoins en cliquant sur le contrôle Change, à droite du nom du panier.

Utilisez ensuite la boîte de dialogue Content Cart Name Selection pour saisir directement le nom souhaité pour le panier. Vous pouvez également choisir un dossier dans l’espace de travail cible dans lequel le contenu du panier doit être livré. 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 , tout à droite du champ Content Cart Name. Ou créez un nouveau dossier dans la structure de dossiers à l’aide des commandes du menu contextuel.

Un Content Cart peut être nommé selon les besoins. Modifiez soit le nom du panier (qui sera livré dans un dossier de niveau supérieur portant ce nom), soit choisissez de déposer le contenu du panier dans un dossier spécifique.

Spécification des Items à 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’Item que vous avez choisi d’acquérir depuis l’espace de travail source. N’importe quel nombre de révisions de Data Item peut être « chargé » dans le Content Cart pour acquisition depuis l’espace de travail source. Le premier accès au panier le charge avec la ou les révisions d’Item sélectionnées dans l’espace de travail source au moment de l’accès, mais n’importe quel nombre d’Items supplémentaires peut être chargé. Pour ce faire, cliquez sur le contrôle 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 « allégée » du panneau Explorer panel). À partir de là, vous pouvez parcourir l’espace de travail source pour trouver d’autres Items. N’oubliez pas que vous pouvez choisir d’ajouter :

• Une seule révision spécifique d’un Item.
• Plusieurs révisions spécifiques du même Item.
• Les dernières révisions de plusieurs Items.
• Les dernières révisions de tous les Items du dossier sélectionné (et de sa structure descendante).

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 d’items requis (un item par ligne), qui pourront ensuite être recherchés dans l’espace de travail source à l’aide d’un critère de recherche choisi (GUID, Item ID, Name ou MPN).

La grille d’acquisition principale, répertoriant toutes les révisions d’Item choisies pour acquisition depuis l’espace de travail source.

Toute révision d’Item peut être retirée de la liste en la sélectionnant puis en cliquant sur le bouton .

Préparation du panier

Une fois les révisions d’Item source choisies, le Content Cart doit maintenant être « préparé pour livraison » vers l’espace de travail cible. Pour ce faire, cliquez sur le bouton . Cela prépare l’espace de travail cible à l’acquisition — en vérifiant l’état des révisions d’Item choisies impliquées (au cas où elles auraient déjà été acquises), les liens parent-enfant, et en proposant l’action à entreprendre. 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 livraison vers l’espace de travail cible.

Pour chaque révision d’Item impliquée dans l’acquisition, la région Source de la grille se développe pour présenter toutes les révisions d’Item enfant applicables et, éventuellement, le dossier dans lequel elles résident dans l’espace de travail source. Pour chaque révision d’Item (parent et enfant), les informations suivantes peuvent être présentées dans la région Target de la grille :

• Revision ID – l’identifiant complet de la révision d’Item dans l’espace de travail cible, basé sur le schéma de nommage d’Item et de révision défini pour ce type d’Item.
• Folder – le dossier de destination dans l’espace de travail cible dans lequel la révision d’Item acquise sera créée/livrée.
• Life Cycle – la définition de cycle de vie définie pour l’Item parent.
• Naming Scheme – le schéma de nommage des révisions défini pour identifier les révisions de l’Item parent.
• Note – une note facultative pouvant être utilisée pour fournir des informations utiles sur l’acquisition à d’autres personnes lors de la consultation du contenu acquis dans votre espace de travail.

• Status – l’état actuel de la révision d’Item dans l’espace de travail cible. Les états possibles sont :

  • Not found – la révision d’Item n’a jamais été acquise.
  • Already Exists – la révision d’Item a déjà été acquise.

• Action – l’action à entreprendre afin d’assurer la synchronisation entre les espaces de travail source et cible. Les actions possibles sont :

  • Transfer new revision and item – pour les acquisitions entièrement nouvelles, lorsque l’Item n’a jamais été acquis auparavant. En d’autres termes, créer un Item de ce type et une nouvelle révision planifiée pour accueillir les données source.
  • Transfer new revision of existing item – lors de l’acquisition d’une autre révision d’un Item, lorsqu’une révision de cet Item a déjà été acquise auparavant.
  • Nothing to do – la révision d’Item choisie a déjà été acquise auparavant.

Structure du panier

Dans le cadre de la phase de préparation, le panier utilise les paramètres par défaut définis pour chaque type d’Item pouvant être acquis. Ces paramètres sont définis dans la boîte de dialogue Content Cart Structure, accessible en cliquant sur le contrôle 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 sont utilisés pour déterminer les propriétés des révisions d’Item nouvellement créées dans l’espace de travail cible — créées prêtes, et à l’état planifié, à recevoir les données des révisions d’Item d’origine dans l’espace de travail source. Ils incluent un dossier par défaut dans l’espace de travail cible, ainsi qu’une définition de cycle de vie par défaut, des schémas de nommage d’Item et de révision, et un index de départ. 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’Item sera acquis dans un dossier distinct sous :

• Un dossier parent de niveau supérieur, nommé d’après le Content Cart lui-même
• Un dossier existant, défini via la boîte de dialogue de sélection Content Cart Name selection dialog.

Modifiez ces paramètres d’acquisition par défaut en fonction des schémas utilisés (et préférés !) pour ces types d’Item dans votre espace de travail cible. Cliquez sur une cellule pour accéder aux commandes d’édition.

Les paramètres d’acquisition dans la boîte de dialogue Content Cart Structure sont des valeurs par défaut de niveau global. Pour les éléments qui n’ont jamais été acquis auparavant — de sorte que l’élément parent et la révision initiale sont créés pour la première fois (Action est Transfer new revision and item) — des propriétés peuvent être définies au niveau de chaque élément si nécessaire, offrant un contrôle plus fin. Pour ce faire, sélectionnez une révision d’élément dans la grille principale d’acquisition, puis cliquez sur le bouton . Vous accéderez alors à la boîte de dialogue Edit Item, à partir de 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 accru, vous pouvez définir des propriétés au niveau de chaque élément.

Livraison du panier

Une fois la préparation terminée, cliquez sur le bouton pour lancer l’acquisition. Une boîte de dialogue de confirmation apparaîtra 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 confirmera le résultat de l’acquisition, et les éléments acquis pourront être consultés dans l’espace de travail cible via le panneau Explorer.

Si, avant de fermer la boîte de dialogue Content Cart, vous relancez la préparation — en cliquant sur — les champs Status et Action seront mis à jour pour refléter le résultat, en affichant respectivement Already Exists et Nothing to do.

Les données acquises pointent vers leur source d’origine. Ces informations de lien ancestral peuvent être consultées en basculant vers l’onglet de vue d’aspect Origin pour la révision d’élément cible. Pour accéder rapidement à la révision d’élément source d’origine, cliquez sur le bouton .

Acquisition de données au format IntLib

Vous avez également la possibilité d’acquérir des composants depuis votre espace de travail dans une bibliothèque intégrée (*.IntLib). Et lorsque vous placez des composants à partir d’une telle bibliothèque intégrée, les liens réels renvoient aux composants de l’espace de travail. Cela vous permet d’utiliser efficacement les composants du Workspace de votre entreprise en mode hors ligne, tout en garantissant que la conception conserve une véritable connexion avec ces composants dans l’espace de travail source.

Acquisition vers une IntLib

Depuis la boîte de dialogue Content Cart, le processus d’acquisition vers une IntLib est le suivant :

1. Cliquez sur le lien Select target server et choisissez IntLib file dans le menu.

   
   Définissez la cible du Content Cart comme étant un fichier IntLib.

2. Spécifiez le nom et l’emplacement du fichier IntLib généré. Par défaut, le fichier sera nommé au format Integrated_Library - <Date> - <Time>.IntLib et généré à l’emplacement \Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib. Modifiez cela selon vos besoins via 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.

3. Si vous devez acquérir des composants supplémentaires dans la même IntLib, cliquez sur le lien Add More Items et choisissez l’entrée Select pour accéder à la boîte de dialogue Choose Item (une version « allégée » du panneau Explorer panel). À partir de là, vous pouvez parcourir l’espace de travail source pour trouver 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 requis (un élément par ligne), qui pourront ensuite être recherchés dans l’espace de travail source à l’aide d’un critère de recherche choisi (GUID, Item ID, Name ou MPN).

4. Une fois prêt, cliquez sur le bouton pour lancer la génération de l’IntLib. Un package temporaire de bibliothèque intégrée (*.LibPkg) sera créé, avec des fichiers source SchLib (contenant les symboles, paramètres et liens de modèle) et PcbLib (contenant les modèles d’empreinte) générés et ajoutés. Celui-ci est ensuite compilé pour produire le fichier IntLib, qui est généré dans le dossier spécifié. Une boîte de dialogue d’information confirmera la génération réussie du fichier.

   
   Livrez le panier dans le dossier cible, qui contiendra le fichier de bibliothèque intégrée requis.

Utilisation de l’IntLib

Après génération, l’IntLib peut être ajoutée aux bibliothèques disponibles hors Workspace pour le logiciel (via l’onglet Installed de la boîte de dialogue Available File-based Libraries dialog). Elle sera alors disponible depuis le panneau Components panel. Placez les composants de l’IntLib dans votre conception selon vos besoins. Bien que vous travailliez effectivement avec les composants « hors ligne », les liens vers les composants d’origine du Workspace assurent la continuité lorsque vous revenez à un travail « en ligne » directement depuis votre Workspace.