Utilisation du langage de requête

Altium Training

Altium Essentials: PCB Global Editing and List Panel

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

En un coup d'œil

Gérer individuellement des centaines d’objets de conception peut ralentir les mises à jour des schémas et des PCB. Cet article présente le langage de requête d’Altium Designer et explique comment utiliser des requêtes logiques pour rechercher, mettre en surbrillance, sélectionner et modifier des groupes d’objets ciblés. Il aborde la portée des filtres, la création de requêtes avec les outils Query Helper et Query Builder, les commandes d’affichage et les méthodes de réutilisation des requêtes. Cette page répertorie également les opérateurs des expressions de requêtes logiques et les fonctions de requête système globales. Poursuivez votre lecture pour mieux maîtriser vos objets de conception et effectuer plus efficacement les mises à jour répétitives.

- Découvrez comment les requêtes ciblent des objets spécifiques et comment la portée des filtres détermine les documents et les objets dans lesquels la recherche est effectuée.
- Apprenez à créer et à vérifier des expressions de requête, puis à contrôler la sélection, le zoom et le masquage des résultats.
- Découvrez comment appliquer et supprimer des filtres, réutiliser les requêtes favorites et récentes, et utiliser des parenthèses pour rendre les expressions plus claires.
Approfondissez avec l'IA :

Qu'est-ce qu'une requête ?

Le plus grand défi lors du travail sur une conception électronique complexe est peut-être la gestion d'un grand nombre d'objets de conception. Des composants, étiquettes de nets et chaînes de texte sur les feuilles de schéma aux centaines de composants et de pistes qui constituent le routage du PCB,  vous devez pouvoir accéder à ces objets, les examiner et les modifier. Comme dans la plupart des applications Windows, vous pouvez double-cliquer sur un objet pour modifier ses propriétés. Cela convient pour un seul objet, mais ce n'est pas une méthode adaptée si vous devez modifier plus de 300 chaînes de désignateurs de composants ou modifier tous les vias du PCB. Pour ce type de mise à jour, vous devez accéder à plusieurs objets simultanément. 

Les éditeurs de schémas et de PCB d'Altium Designer s'appuient sur un puissant moteur de requêtes. En saisissant des requêtes dans ce moteur, vous pouvez filtrer les objets pour trouver et modifier précisément ceux dont vous avez besoin.

Le puissant système de filtrage et de modification des données d'Altium Designer vous permet de demander au logiciel de renvoyer un ensemble précis d'objets. Cette instruction est saisie sous la forme d'une requête. Une requête est une chaîne que vous saisissez à l'aide de mots-clés et d'une syntaxe spécifiques, et qui renvoie les objets ciblés. Libre à vous ensuite de choisir ce que vous en faites. Vous pouvez, par exemple, les mettre en surbrillance et estomper tous les autres objets, ou encore parcourir ou trier leurs propriétés et modifier certains attributs qu'ils ont en commun.

Vous pouvez appliquer une requête à plusieurs endroits, mais les principaux outils sont les panneaux Filter présentés dans les images ci-dessous. Appuyez sur F12 pour afficher/masquer le panneau Filter .

Les panneaux PCB Filter et SCH Filter avec des requêtesLes panneaux PCB Filter et SCH Filter avec des requêtes

Les panneaux PCBLIB Filter et SCHLIB Filter avec des requêtes
Les panneaux PCBLIB Filter et SCHLIB Filter avec des requêtes

Les commandes du panneau permettent de définir les objets auxquels la requête sera appliquée et la façon de traiter les objets qui répondent à ses critères, ainsi que ceux qui n'y répondent pas.

Le langage de requête est également utilisé dans la boîte de dialogue PCB Rules and Constraints Editor pour définir les périmètres d’application des règles de conception (consultez la page Définition, périmètre d’application et gestion des règles de conception PCB pour en savoir plus). Notez que l’ensemble des objets auxquels s’applique une règle de conception dépend non seulement de la requête, mais aussi du type de règle (par exemple, une règle de largeur ne s’applique qu’aux pistes, une règle de style de via de routage ne s’applique qu’aux vias, etc.). Les résultats de la mise en surbrillance ou de la définition du périmètre des objets peuvent donc différer entre le panneau Filter et le périmètre d’application de la règle, même avec une expression de requête identique.

Où se trouvent les résultats de la requête ?

Maintenant que vous avez rédigé une requête dans le panneau Filter , comment accéder aux objets renvoyés par celle-ci ? Il existe deux façons d’accéder aux objets et de les modifier dans l’environnement Altium Designer.

  • Graphiquement : après l’application d’un filtre, le comportement par défaut consiste à masquer (estomper et rendre non modifiables) tous les objets qui ne répondent pas à la requête, pour ne laisser que ceux qui y répondent. Ce mode est idéal pour localiser et examiner les objets dans l’espace de travail. Les objets masqués n’étant pas modifiables, les commandes telles que Ctrl+A (tout sélectionner) ne s’appliquent qu’aux objets renvoyés par la requête.

  • List panneau - le panneau List (Shift+F12) présente les données de votre conception sous une forme semblable à celle d’une feuille de calcul. Par défaut, il affiche tous les objets de conception, mais une fois un filtre appliqué, il affiche uniquement les objets renvoyés par la requête. Le panneau List offre les fonctions classiques de tri et de sélection d’une feuille de calcul, ce qui vous permet de modifier directement une ou plusieurs cellules. 

Les panneaux PCB List et SCH List  affichent les résultats des requêtes PCB/SCH de la section précédente.Les panneaux PCB List et SCH List  affichent les résultats des requêtes PCB/SCH de la section précédente.

Options de mise en évidence

Chaque fois qu’une requête est appliquée (ou que la fonction de filtrage des données est utilisée d’une autre manière), chaque objet du document cible est évalué dans le cadre de cette opération de filtrage. Toutefois, l’affichage ultérieur des objets inclus dans les résultats et de ceux qui n’y figurent pas dépend des options de mise en évidence sélectionnées dans le panneau Filter . Trois options de mise en évidence sont disponibles. Elles sont totalement indépendantes les unes des autres : vous pouvez donc en sélectionner une, deux ou les trois.

Zoom

Lorsque l’option Zoom est activée au moment de l’application de la requête, la vue du document cible est actualisée pour afficher la zone occupée par l’ensemble des objets figurant dans les résultats. L’affichage de chacun des autres objets dans la vue actualisée dépend de sa position par rapport à cette zone : ces objets peuvent donc être entièrement visibles, partiellement visibles ou totalement hors du champ d’affichage. 

Cette option est souvent sélectionnée en association avec l’une ou les deux autres options. Si l’option Mask n’a pas été activée, les objets qui ne figurent pas dans les résultats restent affichés dans la vue graphique s’ils se trouvent dans les nouvelles limites de la vue. À première vue, sélectionner cette option seule peut sembler inutile, mais il peut arriver que vous souhaitiez actualiser la vue graphique pour qu’elle englobe certains objets, sans modifier l’état de sélection ou de masquage des objets du document.

Sélection

Lorsque l’option Select est activée, tous les objets figurant dans les résultats sont sélectionnés, tandis qu’aucun des autres objets ne l’est. Les objets sélectionnés sont affichés de manière à mieux se distinguer des objets non sélectionnés.

Si l’option Sélection est activée lors de l’application de la requête en cours, tous les objets appartenant à l’ensemble des résultats passent à l’état sélectionné, tandis que tous les autres objets (qui n’appartiennent pas à cet ensemble) passent à l’état non sélectionné. Cette option est généralement activée juste avant des opérations de modification globale, car seules les propriétés des objets alors sélectionnés sont mises à jour. L’option Sélection peut toutefois être utile dans d’autres situations, par exemple pour déplacer, copier ou supprimer certains objets.

Masquage

L’option de mise en évidence Mask détermine le nouvel état de masquage des objets dans le document cible. Lorsqu’elle est sélectionnée, tous les objets figurant dans les résultats sont masqués, tandis que tous les autres objets ne le sont pas. La principale caractéristique des objets masqués est qu’il est impossible de les modifier ou de modifier leurs propriétés. (Les objets masqués apparaissent grisés dans la vue en liste, mais ils n’y sont affichés que si l’option all objects est sélectionnée dans le panneau List .) La principale caractéristique des objets masqués est qu’il est impossible de modifier l’objet ou ses propriétés.

Le générateur de requêtes

L’éditeur PCB comprend une boîte de dialogue dédiée, Query Builder. Cette boîte de dialogue vous permet de créer des requêtes complexes en choisissant des conditions de test dans des listes déroulantes. L’un des avantages de Query Builder est de vous permettre de créer une requête ciblant différents types d’objets.

La boîte de dialogue « Building Query » (qui fait partie de la fonction « Query Builder ») aide les utilisateurs moins expérimentés à définir des requêtes : une requête est générée automatiquement à partir des conditions spécifiées par le concepteur.

La partie gauche de cette boîte de dialogue contient des commandes destinées à aider le concepteur à définir les propriétés que doit posséder chaque objet du document pour être renvoyé par la requête générée. À mesure que ces conditions sont définies ou modifiées, le contenu de la requête correspondante est actualisé et affiché dans la partie droite de la boîte de dialogue. Si vous fermez ensuite cette boîte de dialogue en cliquant sur le bouton OK (ou Apply), la requête associée est appliquée ou son contenu est recopié dans le panneau Filter, selon la manière dont la boîte de dialogue a été ouverte.

La boîte de dialogue Query Builder peut être ouverte depuis les emplacements suivants (comme illustré dans l’image ci-dessous) :

  • Dans le panneau PCB Filter, cliquez sur le bouton Query Builder pour créer une requête et charger la chaîne correspondante dans le panneau.
  • Dans la boîte de dialogue PCB Rules and Constraints Editor, cliquez sur le bouton Builder pour créer une requête définissant les objets auxquels cette règle s’applique. 

Lorsque la boîte de dialogue Query Builder est ouverte depuis la boîte de dialogue PCB Rules and Constraints Editor, elle affiche uniquement les options adaptées à ce type de règle.

L’image ci-dessous montre l’utilisation de la boîte de dialogue Query Builder pour créer une requête ciblant à la fois les pastilles et les vias du réseau 5V.

La boîte de dialogue Query Builder
La boîte de dialogue Query Builder

  • Ajoutez d’autres conditions pour affiner, si nécessaire, l’ensemble d’objets de conception ciblés. Les conditions peuvent être combinées à l’aide des opérateurs AND ou OR. L’opérateur logique par défaut est AND.
  • Pour modifier l’opérateur logique entre les conditions, cliquez sur l’entrée AND ou OR dans la colonne Condition Type/Operator , puis sélectionnez l’opérateur souhaité. L’aperçu de la requête sera mis à jour en conséquence.
  • La boîte de dialogue Query Builder (Building Query from Board ) offre une méthode plus simple pour créer une requête à l’aide de types de conditions et de valeurs adaptés au contexte, qui vous permettent d’utiliser uniquement des « blocs de construction » pertinents. Pour créer des requêtes avancées en spécifiant librement les mots-clés et la syntaxe des opérateurs, utilisez la boîte de dialogue Assistant de requête.
  • Vous pouvez modifier à tout moment n’importe quelle condition de votre chaîne de requête en cliquant sur son entrée dans la colonne Condition Type/Operator , puis en choisissant la nouvelle condition souhaitée parmi les entrées de la liste déroulante. L’aperçu de la requête sera mis à jour en conséquence.
  • Utilisez les raccourcis clavier Ctrl+Up Arrow et Ctrl+Down Arrow pour déplacer la condition sélectionnée vers le haut ou vers le bas dans la structure. 
  • Utilisez les raccourcis clavier Ctrl+Right Arrow et Ctrl+Left Arrow pour augmenter ou diminuer le retrait à la position sélectionnée dans la structure (ajouter/supprimer des parenthèses).

L’Assistant de requête

L’étape suivante pour améliorer vos compétences en rédaction de requêtes consiste à utiliser la boîte de dialogue Query Helper . La boîte de dialogue Query Helpercomprend une zone Query dans laquelle vous pouvez saisir la requête souhaitée, tout en utilisant les boutons de syntaxe situés sous le champ Query (par exemple, And, Or, <, Not,  Like, etc.), ainsi qu’une liste complète de tous les mots-clés de requête dans le champ Categories .

La boîte de dialogue « Assistant de requête » aide les concepteurs qui souhaitent définir leurs propres requêtes. Une brève description est fournie pour chaque mot-clé répertorié, mais vous pouvez accéder à l’aide en ligne en appuyant sur la touche F1 lorsqu’un mot-clé est sélectionné. Cela ouvre la boîte de dialogue de la bibliothèque de documentation d’Altium Designer, qui précise quels objets d’un document sont renvoyés par le mot-clé sélectionné, comment l’utiliser, et fournit un ou plusieurs exemples d’utilisation.

Vous pouvez accéder à cette boîte de dialogue des manières suivantes :

  • Cliquez sur le bouton Helper dans le panneau Filter .

PCB Filter accès au panneau 

SCH Filter accès au panneau

Le bouton Helper est disponible après avoir cliqué sur Advanced dans la boîte de dialogue File-based Libraries Search.

File-based Libraries Search accès à la boîte de dialogueFile-based Libraries Search accès à la boîte de dialogue

Utilisez la section Query située en haut de la boîte de dialogue pour composer une expression de requête à l’aide des fonctions disponibles. Dans la zone de texte, vous pouvez vérifier et/ou modifier davantage l’expression de recherche. Saisissez directement du texte dans cette zone pour modifier l’expression de recherche. Pour rechercher des mots-clés spécifiques à ajouter, commencez à saisir du texte. Pendant la saisie, la boîte de dialogue propose un menu déroulant de mots-clés disponibles correspondant au texte déjà saisi. Cliquez sur un mot-clé pour compléter automatiquement votre saisie. Si le mot-clé souhaité est sélectionné, appuyez sur Enter pour compléter également votre sélection automatiquement.

Parcourez la Categories des mots-clés disponibles pour trouver celui que vous souhaitez. Utilisez le champ Mask si vous ne connaissez pas le mot-clé exact. Par exemple, dans Query Helperde l’éditeur de schémas, saisir *har dans le champ Mask permet de trouver les mots-clés qui s’appliquent spécifiquement aux faisceaux, comme illustré dans l’image ci-dessous. Notez que le champ Mask effectue la recherche à la fois dans le champ Name du mot-clé et dans le champ Description ; il peut donc constituer le moyen le plus rapide de trouver des mots-clés possibles.

Si vous appuyez sur F1 lorsqu’un mot-clé est sélectionné ou que le curseur se trouve dans un mot-clé que vous avez saisi, la documentation de ce mot-clé s’ouvre. C’est la ressource la plus utile pour découvrir le fonctionnement de base de chaque mot-clé de requête.

Double-cliquez sur un mot-clé dans la grille pour l’ajouter à la requête à la position actuelle du curseur.

La zone centrale de la boîte de dialogue comprend des boutons de syntaxe qui proposent différents opérateurs à utiliser lors de la création d’une expression. Pour plus d’informations sur la fonction de chaque bouton de syntaxe, consultez la section Opérateurs logiques des expressions de requête ci-dessous. Utilisez le bouton Check Syntax (en bas à gauche de la boîte de dialogue) pour vérifier qu’une expression est syntaxiquement correcte.

Historique des requêtes

Lorsque vous saisissez et appliquez une nouvelle requête depuis un panneau de filtrage (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter), elle est ajoutée à l’historique des requêtes. Cliquez sur le bouton History du panneau pour accéder à cette liste. La boîte de dialogue Expression Manager s’ouvre avec l’onglet History actif.

L’onglet Historique de la boîte de dialogue Expression Manager présente la liste des expressions de requête utilisées précédemment. Un exemple d’historique des requêtes pour le schéma est présenté ici. Survolez l’image avec la souris pour afficher un exemple de liste similaire pour le PCB.L’onglet Historique de la boîte de dialogue Expression Manager présente la liste des expressions de requête utilisées précédemment. Un exemple d’historique des requêtes pour le schéma est présenté ici. Survolez l’image avec la souris pour afficher un exemple de liste similaire pour le PCB.

Pour utiliser une requête de l’historique, sélectionnez son entrée et cliquez sur le bouton Apply Expression ou double-cliquez directement sur l’entrée. La boîte de dialogue se ferme et l’expression de la requête est chargée dans la zone centrale du panneau de filtrage concerné.

Une requête de l’historique peut être ajoutée à la liste des requêtes favorites en sélectionnant son entrée, puis en cliquant sur le bouton Add To Favorites. Utilisez le bouton Clear History si vous souhaitez vider l’historique.

Jusqu’à neuf des expressions de requête les plus récemment utilisées dans la liste sont accessibles depuis le sous-menu History du menu contextuel du panneau de filtrage.

Notez que le contenu de la liste History est commun aux panneaux de filtrage d’un même domaine de conception et accessible depuis ceux-ci (SCH Filter / SCHLIB Filter dans le domaine d’édition de schémas ; PCB Filter / PCBLIB Filter dans le domaine d’édition de PCB). Certaines expressions de requête peuvent ne renvoyer aucun résultat lorsqu’elles sont utilisées dans l’éditeur de schémas, notamment si elles ont été créées pour cibler des objets disponibles uniquement dans l’éditeur de bibliothèques de schémas.

Requêtes favorites

Toute requête définie peut être ajoutée à une liste de requêtes favorites de deux manières :

  • Cliquez sur le bouton Add To Favorites ou faites un clic droit dans la zone principale Query Expression et choisissez la commande Add to Favorites dans le menu contextuel pour ajouter l’expression de requête actuellement définie dans la zone centrale du panneau de filtrage actif.
  • Sélectionnez une entrée de l’historique des requêtes dans l’onglet History de la boîte de dialogue Expression Manager, puis cliquez sur le bouton Add To Favorites.

Les expressions de requêtes favorites sont enregistrées et gérées dans l’onglet Favorites de la boîte de dialogue Expression Manager. Vous pouvez y accéder à l’aide du bouton Favorites d’un panneau de filtrage (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) ou en faisant un clic droit dans la zone principale Query Expression d’un panneau de filtrage, puis en choisissant la commande Organize Favorites dans le menu contextuel. Depuis l’espace de conception, vous pouvez accéder à cette boîte de dialogue à l’aide du raccourci clavier Y, puis en sélectionnant Organize Favorites dans le menu de filtrage contextuel.

Accédez à la liste de vos requêtes favorites depuis le panneau de filtrage de l’éditeur ou depuis l’espace de conception, à l’aide du menu de filtrage contextuel.Accédez à la liste de vos requêtes favorites depuis le panneau de filtrage de l’éditeur ou depuis l’espace de conception, à l’aide du menu de filtrage contextuel.

Lorsqu’une expression de requête est ajoutée à la liste Favorites , un nom unique lui est attribué. Par défaut, un nom générique est attribué — Favorite_n — où n est le prochain numéro disponible non utilisé. Le nom d’une entrée peut être modifié à tout moment à l’aide de l’une des méthodes suivantes :

  • Sélectionnez l’entrée de la requête, puis cliquez sur le bouton Rename.
  • Sélectionnez l’entrée de la requête, puis choisissez la commande Modifier dans le menu contextuel.
  • Sélectionnez l’entrée de la requête, puis cliquez à nouveau dans le champ Name.

Dans chaque cas, saisissez le nouveau nom souhaité, puis cliquez en dehors du champ Name pour appliquer la modification.

Pour modifier une expression de requête favorite, sélectionnez son entrée dans la liste, puis cliquez sur le bouton Edit (ou faites un clic droit et choisissez Edit dans le menu contextuel). La boîte de dialogue Edit Favorite s’ouvre. Utilisez cette boîte de dialogue pour modifier le nom du favori, modifier l’expression elle-même et définir le traitement des objets de conception (aussi bien ceux qui répondent aux critères du filtre que ceux qui n’y répondent pas).

Modifiez une requête favorite existante à l’aide de la boîte de dialogue Edit Favorite, illustrée ici pour les schémas (à gauche) et les PCB (à droite).Modifiez une requête favorite existante à l’aide de la boîte de dialogue Edit Favorite, illustrée ici pour les schémas (à gauche) et les PCB (à droite).

Pour supprimer une requête de la liste Favorites , sélectionnez son entrée dans la liste, puis cliquez sur le bouton Remove ou choisissez la commande Remove dans le menu contextuel. Une boîte de dialogue vous demande de confirmer la suppression.

Notez que le contenu de la liste Favorites  est commun aux panneaux de filtrage d’un même domaine de conception et accessible depuis ceux-ci (SCH Filter / SCHLIB Filter dans le domaine d’édition de schémas ; PCB Filter / PCBLIB Filter dans le domaine d’édition de PCB). Certaines expressions de requête peuvent ne renvoyer aucun résultat lorsqu’elles sont utilisées dans l’éditeur de schémas, notamment si elles ont été créées pour cibler des objets disponibles uniquement dans l’éditeur de bibliothèques de schémas.

Utilisation des requêtes favorites

Vous pouvez utiliser vos requêtes favorites de trois manières :

  1. Depuis l’onglet Favorites de la boîte de dialogue Expression Manager : sélectionnez l’entrée de la requête, puis cliquez sur le bouton Apply Expression, ou double-cliquez sur son entrée. La boîte de dialogue se ferme et l’expression de la requête est chargée dans la zone centrale du panneau de filtrage concerné.

  2. Depuis le haut du menu contextuel du panneau de filtrage (jusqu’à dix des expressions de requête les plus récemment ajoutées à la liste Favorites sont disponibles).

  3. Depuis le menu de filtrage contextuel de l’espace de conception (appuyez sur Y) : jusqu’à dix expressions de requêtes favorites sont répertoriées en haut du menu. L’expression de requête choisie est chargée dans la zone centrale du panneau de filtrage concerné.

Vous pouvez également définir un raccourci clavier pour un favori en personnalisant le menu de filtrage. Pour plus d’informations sur la personnalisation de l’environnement Altium Designer, consultez Configuration et personnalisation d’Altium Designer.

Utilisation des exemples prédéfinis

Les éditeurs de schémas et de PCB sont tous deux fournis avec un ensemble d’exemples de requêtes prédéfinis. Ces exemples sont disponibles dans le menu de filtrage, accessible soit par un clic droit dans la zone d’expression du panneau de filtrage, soit à l’aide du raccourci clavier Y dans l’espace de conception. Survolez Examples pour afficher le sous-menu.

Lorsque vous sélectionnez une entrée du sous-menu, la requête correspondant à ce filtre est appliquée. Pour consulter la requête réelle correspondant à l’un des exemples, examinez la liste History après l’avoir appliquée. Vous pouvez également accéder à cette liste depuis le menu de filtrage contextuel.

Pour effacer le filtrage, appuyez sur Shift+C dans l’espace de conception ou faites un clic droit dans l’espace de conception et sélectionnez la commande Clear Filter dans le menu contextuel.

Outils de création de requêtes

Le moyen le plus simple d’écrire une requête est peut-être de laisser Altium Designer le faire pour vous ! Pour cela, vous pouvez utiliser la boîte de dialogue Find Similar Objects ou la boîte de dialogue Query Builder .

Boîte de dialogue Rechercher des objets similaires

Lorsque vous utilisez la boîte de dialogue Rechercher des objets similaires, celle-ci génère une requête pour rechercher les objets souhaités. Si l’option Create Expression est activée, cette requête s’affiche dans le panneau Filter . Il s’agit d’une excellente méthode pour apprendre les différents mots-clés de requête.

La boîte de dialogue Find Similar Objects s’ouvre lorsque vous faites un clic droit sur un objet non masqué de votre document de conception, puis sélectionnez Find Similar Objects dans le menu contextuel.

Image de gauche : version PCB ; image de droite : version SCHImage de gauche : version PCB ; image de droite : version SCH

Cette boîte de dialogue vous permet de rechercher des objets similaires à celui sur lequel vous avez effectué un clic droit, puis de définir les attributs de l'objet qui doivent être identiques (ou différents) pour qu'une correspondance soit établie. Supposons que vous souhaitiez modifier toutes les pastilles GND de votre conception. Vous pouvez effectuer un clic droit sur l'une de ces pastilles, choisir Find Similar Objects, puis remplacer la valeur du champ Net , initialement définie sur Any (valeur par défaut), par Same. Toutes les pastilles GND seront sélectionnées lorsque vous cliquerez sur Apply dans la boîte de dialogue. Si l'option Create Expression est activée, la requête suivante s'affichera dans le panneau Filter : (ObjectKind = 'Pad') And (Net = 'GND').

Dans un schéma, par exemple, vous pouvez attribuer une même valeur à la propriété Color de tous les objets d'alimentation dont la propriété Text possède une valeur particulière (par exemple « GND ») dans un document. Dans un PCB, par exemple, vous pouvez attribuer une même valeur à la propriété Hole Size de tous les vias dont la propriété Via Diameter possède une valeur particulière dans un document.

Pour plus d'informations sur l'utilisation de la boîte de dialogue Find Similar Objects, consultez Utilisation des outils de recherche d'objets similaires.

Option d'effacement de la sélection existante

Activez l'option Clear Existing pour effacer toute sélection ou tout masque d'édition existant avant d'appliquer la recherche. Désactivez cette option si vous effectuez des recherches successives et souhaitez cumuler les résultats.

Barre d'outils de filtrage

La barre d'outils Filter Toolbar est disponible pour les documents PCB et permet de masquer tous les objets d'un document, à l'exception de ceux possédant une propriété donnée ou de ceux faisant partie d'un composant donné. Le champ situé à l'extrémité droite de la barre d'outils permet de définir le contenu d'une requête. Vous pouvez saisir la requête dans ce champ ou utiliser la liste déroulante pour sélectionner une requête récente (présente dans la liste History  des requêtes). Il n'est pas possible de spécifier les options à utiliser lorsque les requêtes sont appliquées depuis Filter Toolbar et, dans tous les cas, toute requête précédente est effacée, puis les options de masquage et de zoom sont utilisées avec la requête actuelle. Pour utiliser les options de requête, utilisez le panneau Filter , la boîte de dialogue Query Builder, la boîte de dialogue Query Helper ou la boîte de dialogue Find Similar Objects .

  • Si la carte n'est pas routée, les connexions logiques associées au net choisi deviennent visibles lors de l'application du filtre. Si la carte est routée, la piste routée associée au net choisi devient visible lors de l'application du filtre.
  • Lorsqu'un masque est appliqué, tous les objets ne correspondant pas au filtre ne peuvent plus être sélectionnés ni modifiés. Le niveau de masquage appliqué peut être ajusté manuellement à l'aide du curseur Masked Objects, accessible dans la section Mask and Dim Settings de l'onglet View Options du panneau View Configuration.
  • Vous pouvez supprimer manuellement un filtre existant (et appliqué) à tout moment à l'aide du raccourci clavier Shift+C ou en cliquant sur le bouton  de la barre d'outils Filter .

Opérateurs des expressions de requête logiques

Vous trouverez ci-dessous un récapitulatif des opérateurs utilisables pour définir des expressions de requête logiques avec le langage de requête.

Opérateurs arithmétiques

Opérateur Description Exemple
+ Opérateur d'addition NetPinCount + NetViaCount
- Opérateur de soustraction ArcStopAngle - ArcStartAngle
* Opérateur de multiplication PadXSize_BottomLayer * PadYSize_BottomLayer
/ Opérateur de division HoleDiameter / ViaDiameter
Div Opérateur de division entière Color Div 65536
Calcule le quotient de Color par 65536 en supprimant la partie décimale du résultat
Mod Opérateur modulo Color Mod 256
Calcule le reste de la division de Color par 256, sans déterminer la partie décimale du résultat

Opérateurs logiques

Opérateur Description Exemple
And Opérateur logique ET IsPad And OnMultiLayer
Pour être renvoyé, un objet doit être une pastille et se trouver sur la couche Multi-Layer
&& Opérateur logique ET
(priorité inférieure)
IsPad && OnMultiLayer
Pour être renvoyé, un objet doit être une pastille et se trouver sur la couche Multi-Layer
Or Opérateur logique OU IsPad Or IsVia
Pour être renvoyé, un objet doit être une pastille ou un via
|| Opérateur logique OU
(priorité inférieure)
IsPad || IsVia
Pour être renvoyé, un objet doit être une pastille ou un via
Xor Opérateur logique OU EXCLUSIF OnMultiLayer Xor (HoleDiameter <> 0)
Pour être renvoyé, un objet doit soit se trouver sur la couche Multi-Layer et avoir une valeur de Hole Diameter égale à zéro, soit ne pas
se trouver sur la couche Multi-Layer et avoir une valeur de Hole Diameter différente de zéro.
Not Opérateur logique NON Not OnMultiLayer
Pour être renvoyé, un objet ne doit pas se trouver sur la couche Multi-Layer

Lorsque vous utilisez l'opérateur Not dans des expressions de requête de l'éditeur PCB pour exclure des primitives d'un type donné, notez que ces primitives ne seront pas exclues si elles font partie d'objets de groupe et que ces objets de groupe ne sont pas eux aussi exclus par l'expression. Par exemple, l'expression de requête Not IsPad renvoie tous les objets, à l'exception des pastilles libres, mais elle renvoie les objets composants susceptibles de contenir des pastilles. Les pastilles des composants seront donc renvoyées par cette expression. Les pastilles peuvent également être incluses dans des nets, qui sont eux aussi considérés comme des objets de groupe dans l'éditeur PCB. Pour exclure toutes les pastilles, il convient d'utiliser l'expression de requête Not IsPad And Not IsComponent And Not IsNet.

Opérateurs de comparaison

Opérateur Description Exemple
< Opérateur strictement inférieur à HoleDiameter < 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter strictement inférieure à 40
<= Opérateur inférieur ou égal à HoleDiameter <= 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter inférieure ou égale à 40
>= Opérateur supérieur ou égal à HoleDiameter >= 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter supérieure ou égale à 40
> Opérateur strictement supérieur à HoleDiameter > 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter strictement supérieure à 40
<> Opérateur différent de HoleDiameter <> 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter différente de 40
= Opérateur égal à HoleDiameter = 40
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter égale à 40
Between...And... Opérateur d'intervalle inclusif HoleDiameter Between 30 And 50
Pour être renvoyé, un objet doit avoir une valeur de Hole Diameter supérieure ou égale à 30 et
inférieure ou égale à 50.
Like Opérateur Like Name Like 'ADDR?*'
Renvoie les objets dont la propriété Name possède une chaîne de texte commençant par ADDR et
contenant au moins un caractère supplémentaire

Caractères génériques

Les caractères génériques permettent de définir des chaînes qui ne sont pas entièrement spécifiées. Ils sont généralement utilisés avec d’autres caractères, ce qui permet de définir des chaînes partiellement spécifiées. Quelques mots-clés particuliers acceptent des paramètres de chaîne qui ne sont pas entièrement spécifiés, mais, dans la plupart des cas, les chaînes ne peuvent contenir des caractères génériques que lorsqu’elles sont comparées à l’aide de l’opérateur Like.

Opérateur Description Exemple
? Peut être remplacé par un seul caractère de n’importe quel type Footprint Like 'DIP1?'
Renvoie les objets dont la propriété Footprint a pour valeur DIP10, DIP12, DIP14, etc.
* Peut être remplacé par un nombre quelconque de caractères, chacun pouvant être de n’importe quel type Footprint Like 'SIP*'
Renvoie les objets dont la propriété Footprint a pour valeur SIP1, SIP12, SIP216, etc. (Les objets dont la propriété Footprint a pour valeur SIP sont également renvoyés, car « * » peut aussi être remplacé par no caractères.)

Chaînes booléennes

Opérateur Description Exemple
True Confirme le sens d’un mot-clé IsPad = True
Pour être renvoyé, un objet doit être une pastille
False Inverse le sens d’un mot-clé IsVia = False
Pour être renvoyé, un objet ne doit pas être un via

Parenthèses et ordre de priorité

Il est utile d’examiner l’ordre de priorité des opérateurs utilisés dans les expressions logiques de requête. Sans cette connaissance, une expression risque en effet de ne pas cibler les objets souhaités.

Les parenthèses ont la priorité la plus élevée dans l’ordre de priorité défini pour les différents opérateurs, lequel détermine la manière dont le logiciel interprète les requêtes lorsque l’utilisateur n’a pas ajouté de parenthèses. Cet ordre, de la priorité la plus élevée à la plus faible, est le suivant :

  1. Parenthèses ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
Cet ordre de priorité est similaire à celui utilisé dans les langages de type Pascal. Les ambiguïtés sont résolues de gauche à droite. Les expressions entre parenthèses sont évaluées de l’intérieur vers l’extérieur, et celles de même niveau sont évaluées de gauche à droite.
Il est vivement recommandé d’utiliser des parenthèses dès qu’il existe le moindre risque que la requête soit mal interprétée. Un usage généreux des parenthèses lève les doutes et facilite la lecture des requêtes par d’autres personnes.

Fonctions de requête système globales

Fonctions de requête système globales affichées dans la boîte de dialogue Query Helper
Fonctions de requête système globales affichées dans la boîte de dialogue Query Helper

Cette section décrit les mots-clés du langage de requête disponibles dans les documents de schéma, de PCB et de bibliothèque d’Altium Designer. Pour obtenir de l’aide sur un mot-clé de requête particulier, utilisez les sections dépliables suivantes ou sélectionnez ce mot-clé (ou cliquez à l’intérieur), dans Query Helper, dans un panneau Filter ou dans le champ Query d’une règle de conception de PCB, puis appuyez sur F1 pour accéder directement à la section correspondante.

Pour plus de détails sur les mots-clés du langage de requête disponibles dans les différents éditeurs et outils d’Altium Designer, consultez les pages suivantes :

Fonctions arithmétiques

Fonctions trigonométriques

Fonctions exponentielles et logarithmiques

Fonctions d’agrégation

Fonctions système

AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.
Nav
Contents
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.

Documentation héritée

La documentation d’Altium Designer n’est plus versionnée. Si vous devez accéder à la documentation des versions antérieures d’Altium Designer, consultez la section Documentation héritée de la page Other Installers.

Contents