Trabajar con el lenguaje de consultas

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.

De un vistazo

Gestionar cientos de objetos de diseño de forma individual puede ralentizar las actualizaciones de esquemas y PCB. Este artículo presenta el lenguaje de consultas de Altium Designer y explica cómo utilizar consultas lógicas para buscar, resaltar, seleccionar y editar grupos específicos de objetos. Abarca el alcance de los filtros, la creación de consultas con Query Helper y Query Builder, los controles de visualización y las formas de reutilizar consultas. En esta página también encontrará listas de operadores de expresiones de consulta lógica y funciones de consulta globales del sistema. Siga leyendo para tener un mayor control sobre sus objetos de diseño y realizar las actualizaciones repetitivas de forma más eficiente.

- Aprenda cómo las consultas permiten localizar objetos específicos y cómo el alcance del filtro determina en qué documentos y objetos se realizan las búsquedas.
- Descubra cómo crear y comprobar expresiones de consulta y, después, controlar la selección, el zoom y el enmascaramiento de los resultados.
- Comprenda cómo aplicar y borrar filtros, reutilizar consultas favoritas y recientes, y utilizar paréntesis para que las expresiones sean más claras.
Profundiza con IA:

¿Qué es una consulta?

Quizás el mayor desafío al trabajar en un diseño electrónico complejo sea gestionar un gran número de objetos de diseño. Desde los componentes, las etiquetas de red y las cadenas de texto de las hojas de esquemático hasta los cientos de componentes y pistas que conforman el trazado de la PCB,  es necesario poder acceder a esos objetos, revisarlos y editarlos. Como en la mayoría de las aplicaciones de Windows, puede hacer doble clic en un objeto y editar sus propiedades. Esto resulta práctico para un solo objeto, pero no es lo más adecuado si necesita editar más de 300 cadenas de designadores de componentes o modificar todas las vías de la PCB. Para este tipo de modificaciones, necesita acceder a varios objetos simultáneamente. 

Los editores de esquemáticos y PCB de Altium Designer cuentan con un potente motor de consultas. Al introducir consultas en este motor, puede filtrar los objetos para encontrar y editar exactamente los que necesita.

El potente sistema de filtrado y edición de datos de Altium Designer le permite indicar al software que devuelva un conjunto específico de objetos. Esta instrucción se introduce en forma de consulta. Una consulta es una cadena que se introduce utilizando palabras clave y una sintaxis específicas, y que devuelve los objetos deseados. Lo que haga con esos objetos depende de usted. Quizás quiera resaltarlos y atenuar todos los demás objetos, o quizás quiera examinar u ordenar sus propiedades y modificar atributos específicos que todos comparten.

Hay varios lugares donde puede aplicar una consulta, pero el centro de control son los paneles Filter que se muestran en las imágenes siguientes. Pulse F12 para mostrar u ocultar el panel Filter .

Los paneles PCB Filter y SCH Filter con consultasLos paneles PCB Filter y SCH Filter con consultas

Los paneles PCBLIB Filter y SCHLIB Filter con consultas
Los paneles PCBLIB Filter y SCHLIB Filter con consultas

Los controles del panel se utilizan para definir a qué objetos se aplicará la consulta y cómo se tratarán tanto los objetos que cumplan sus condiciones como los que no.

El lenguaje de consultas también se utiliza en el cuadro de diálogo PCB Rules and Constraints Editor para definir los ámbitos de las reglas de diseño (consulte la página Definición, delimitación del ámbito y gestión de reglas de diseño de PCB para obtener más información). Tenga en cuenta que el conjunto de objetos incluidos en el ámbito de una regla de diseño depende no solo de la consulta, sino también del tipo de regla (por ejemplo, una regla de Anchura solo abarca pistas, una regla de Estilo de vía de enrutamiento solo abarca vías, etc.), por lo que los resultados al resaltar objetos o delimitar su ámbito mediante la misma expresión de consulta en el panel Filter y en el ámbito de la regla pueden ser diferentes.

¿Dónde están los resultados de la consulta?

Ahora que ha escrito una consulta en el panel Filter , ¿cómo accede a los objetos devueltos por ella? Hay dos formas de acceder a los objetos y editarlos en el entorno de Altium Designer.

  • Gráficamente: después de aplicar un filtro, el comportamiento predeterminado consiste en enmascarar (atenuar e impedir la edición de) todos los objetos que no cumplen la consulta, dejando solo aquellos que sí la cumplen. Este modo es excelente para localizar y revisar objetos en el espacio de trabajo. Como los objetos enmascarados no se pueden editar, los comandos como Ctrl+A (seleccionar todo) solo se aplican a los objetos devueltos por la consulta.

  • List panel: el panel List (Shift+F12) es una vista de los datos del diseño similar a una hoja de cálculo. De forma predeterminada, muestra todos los objetos del diseño, pero, una vez aplicado un filtro, muestra únicamente los objetos devueltos por la consulta. El panel List ofrece funciones estándar de ordenación y selección similares a las de una hoja de cálculo, lo que permite editar directamente una o varias celdas. 

El panel PCB List y el panel SCH List  muestran los resultados de las consultas PSB/SCH de la sección anterior.El panel PCB List y el panel SCH List  muestran los resultados de las consultas PSB/SCH de la sección anterior.

Opciones de resaltado

Siempre que se aplica una consulta (o se utiliza de otro modo la función de filtrado de datos), cada objeto del documento de destino pasa a formar parte de los resultados de esa acción de filtrado. Sin embargo, la forma en que se muestran posteriormente los objetos incluidos en los resultados y los que no lo están depende de las opciones de resaltado seleccionadas en el panel Filter . Hay tres opciones de resaltado diferentes, totalmente independientes entre sí, por lo que puede seleccionar una, dos o todas.

Zoom

Cuando la opción Zoom está habilitada al aplicar la consulta, la vista del documento de destino se actualiza para mostrar la región ocupada por todos los objetos incluidos en los resultados. Que cada uno de los objetos restantes se muestre o no en la vista actualizada depende de su ubicación con respecto a esa región, por lo que cada uno de ellos puede acabar mostrándose por completo, parcialmente o no mostrarse en absoluto. 

Esta opción suele seleccionarse junto con una o ambas de las otras opciones. Si la opción Mask no está habilitada, los objetos que no estén incluidos en los resultados seguirán mostrándose en la vista gráfica si se encuentran dentro de los límites actualizados. A primera vista, seleccionar esta opción por sí sola podría parecer inútil, pero puede haber ocasiones en las que desee actualizar la vista gráfica para que abarque determinados objetos, sin cambiar el estado de selección ni de enmascaramiento de ninguno de los objetos del documento.

Seleccionar

Cuando la opción Select está habilitada, todos los objetos incluidos en los resultados quedan seleccionados, mientras que los demás quedan sin seleccionar. Los objetos seleccionados se muestran de forma más destacada que los no seleccionados.

Si la opción Seleccionar está seleccionada al aplicar la consulta actual, todos los objetos que forman parte del conjunto de resultados pasan a estar seleccionados, mientras que los demás objetos (que no forman parte del conjunto de resultados) pasan a estar sin seleccionar. Esta opción suele seleccionarse justo antes de realizar procedimientos de edición global, ya que solo se actualizan las propiedades de los objetos que están seleccionados en ese momento. No obstante, hay otras ocasiones en las que la opción Seleccionar puede resultar útil, como cuando se desea mover, copiar o eliminar determinados objetos.

Enmascarar

La opción de resaltado Mask determina el estado actualizado de la propiedad de enmascaramiento de los objetos del documento de destino. Cuando se selecciona, todos los objetos incluidos en los resultados quedan enmascarados, mientras que los demás quedan sin enmascarar. La principal característica de los objetos enmascarados es que ni ellos ni sus propiedades se pueden editar. (Los objetos enmascarados aparecen atenuados en la vista de lista, pero no se muestran en ella a menos que la opción all objects esté seleccionada en el panel List ). La principal característica de los objetos enmascarados es que ni el objeto ni sus propiedades se pueden editar.

El generador de consultas

El editor de PCB incluye un cuadro de diálogo Query Builder específico. Este cuadro de diálogo permite crear consultas complejas seleccionando condiciones de comprobación en listas desplegables. Una ventaja de Query Builder es que permite crear una consulta dirigida a distintos tipos de objetos.

El cuadro de diálogo «Crear consulta» (que forma parte de la función «Generador de consultas») ayuda a quienes tienen menos experiencia en la definición de consultas; se genera automáticamente una consulta cuyo contenido corresponde a las condiciones especificadas por el diseñador.

La sección izquierda de este cuadro de diálogo contiene controles destinados a ayudar al diseñador a especificar qué propiedades debe tener cada objeto del documento para que la consulta generada por este cuadro de diálogo lo devuelva. A medida que se especifica o edita cada una de esas condiciones, el contenido de la consulta correspondiente se actualiza y se muestra en la sección derecha del cuadro de diálogo. Si después se cierra este cuadro de diálogo haciendo clic en el botón Aceptar (o Aplicar), se aplicará la consulta asociada o se copiará su contenido al panel Filtro (según cómo se haya abierto inicialmente este cuadro de diálogo).

El cuadro de diálogo Query Builder se puede abrir desde los siguientes lugares (como se muestra en la imagen siguiente):

  • Desde el panel PCB Filter, haga clic en el botón Query Builder para crear una consulta y cargar la cadena en el panel.
  • Desde el cuadro de diálogo Editor de reglas y restricciones de PCB, haga clic en el botón Builder para crear una consulta que defina a qué objetos se aplica esta regla. 

Cuando se accede al cuadro de diálogo Query Builder desde el cuadro de diálogo PCB Rules and Constraints Editor, solo se muestran opciones adecuadas para ese tipo de regla.

La imagen siguiente muestra cómo se utiliza el cuadro de diálogo Query Builder para crear una consulta dirigida tanto a los pads como a las vías de la red de 5 V.

El cuadro de diálogo Query Builder
El cuadro de diálogo Query Builder

  • Añada más condiciones para delimitar el conjunto de objetos de diseño deseado según sea necesario. Las condiciones se pueden combinar mediante AND u OR. El operador lógico predeterminado es AND.
  • Para cambiar el operador lógico entre condiciones, haga clic en la entrada AND u OR de la columna Condition Type/Operator y seleccione el operador deseado. La vista previa de la consulta se actualizará en consecuencia.
  • El cuadro de diálogo Query Builder (Building Query from Board ) ofrece un método más sencillo para crear una consulta mediante tipos de condición y valores adaptados al contexto, que solo permiten utilizar «bloques de construcción» pertinentes. Para crear consultas avanzadas con especificación completa de palabras clave y sintaxis de operadores, utilice el cuadro de diálogo Asistente de consultas.
  • Puede modificar cualquier condición de la cadena de consulta en cualquier momento haciendo clic en la entrada de esa condición en la columna Condition Type/Operator y eligiendo la nueva condición deseada entre las entradas disponibles en la lista desplegable. La vista previa de la consulta se actualizará en consecuencia.
  • Utilice los métodos abreviados de teclado Ctrl+Up Arrow y Ctrl+Down Arrow para mover la entrada de condición seleccionada hacia arriba o hacia abajo en la estructura. 
  • Utilice los métodos abreviados de teclado Ctrl+Right Arrow y Ctrl+Left Arrow para aumentar o reducir la sangría en la posición seleccionada de la estructura (añadir/eliminar paréntesis).

El Asistente de consultas

El siguiente paso para mejorar sus habilidades de redacción de consultas es utilizar el cuadro de diálogo Query Helper. El cuadro de diálogo Query Helper incluye un cuadro Query en el que puede introducir la consulta deseada y utilizar también los botones de sintaxis situados debajo del campo Query (p. ej., And, Or, <, Not,  Like, etc.), así como una lista completa de todas las palabras clave de consulta en el campo Categories .

El cuadro de diálogo «Asistente de consultas» ayuda a los diseñadores que desean especificar sus propias consultas. Se proporciona una breve descripción de cada palabra clave de la lista, pero se puede acceder a la ayuda en línea pulsando la tecla F1 mientras una palabra clave está resaltada. Esto abre el cuadro de diálogo de la biblioteca de documentación de Altium Designer, que ofrece información sobre qué objetos de un documento devuelve la palabra clave resaltada, cómo utilizarla y uno o varios ejemplos de uso.

Se puede acceder al cuadro de diálogo de las siguientes maneras:

  • Haga clic en el botón Helper del panel Filter .

PCB Filter acceso al panel 

SCH Filter acceso al panel

El botón Helper está disponible después de hacer clic en Advanced en el cuadro de diálogo File-based Libraries Search.

File-based Libraries Search acceso al cuadro de diálogoFile-based Libraries Search acceso al cuadro de diálogo

Utilice la sección Query de la parte superior del cuadro de diálogo para componer una expresión de consulta mediante las funciones disponibles. En el cuadro de texto, puede revisar o seguir editando la expresión de búsqueda. Escriba directamente en el cuadro de texto para editar la expresión de búsqueda. Para buscar palabras clave concretas que desee añadir, comience a escribir. Mientras escribe, el cuadro de diálogo ofrecerá un menú desplegable con las palabras clave disponibles que coincidan con el texto que haya escrito hasta ese momento. Haga clic en una palabra clave para completar automáticamente la selección. Si la palabra clave deseada está resaltada, al pulsar Enter también se completará automáticamente la selección.

Explore la Categories de palabras clave disponibles para encontrar la que desee. Utilice el campo Mask si no está seguro de cuál es la palabra clave exacta. Por ejemplo, en Query Helper del editor de esquemas, al introducir *har en el campo Mask se encontrarán palabras clave que se aplican específicamente a los arneses, tal como se muestra en la imagen siguiente. Tenga en cuenta que el campo Mask busca tanto en el campo Name de la palabra clave como en el campo Description , por lo que puede ser la forma más rápida de encontrar posibles palabras clave.

Si pulsa F1 cuando una palabra clave está resaltada o el cursor se encuentra dentro de una palabra clave que haya introducido, se abrirá la documentación de esa palabra clave. Este es el recurso más valioso para aprender el comportamiento básico de cada palabra clave de consulta.

Haga doble clic en una palabra clave de la cuadrícula para añadirla a la consulta en la posición actual del cursor.

La región central del cuadro de diálogo incluye botones de sintaxis que proporcionan diversos operadores para crear una expresión. Para obtener más información sobre la función individual de cada botón de sintaxis, consulte la sección Operadores de expresiones lógicas de consulta que aparece a continuación. Utilice el botón Check Syntax (en la parte inferior izquierda del cuadro de diálogo) para verificar que una expresión sea sintácticamente correcta.

Historial de consultas

A medida que introduzca y aplique una nueva consulta desde un panel de filtrado (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter), esta se añadirá a una lista del historial de consultas. Haga clic en el botón History del panel para acceder a esta lista. Se abrirá el cuadro de diálogo Expression Manager con la pestaña History activa.

La pestaña Historial del cuadro de diálogo Expression Manager proporciona una lista de las expresiones de consulta utilizadas anteriormente. Aquí se muestra un ejemplo del historial de consultas del esquema. Pase el ratón sobre la imagen para ver una lista de ejemplo similar para la PCB.La pestaña Historial del cuadro de diálogo Expression Manager proporciona una lista de las expresiones de consulta utilizadas anteriormente. Aquí se muestra un ejemplo del historial de consultas del esquema. Pase el ratón sobre la imagen para ver una lista de ejemplo similar para la PCB.

Para utilizar una consulta del historial, seleccione su entrada y haga clic en el botón Apply Expression o haga doble clic directamente en la entrada. El cuadro de diálogo se cerrará y la expresión de la consulta se cargará en la región central del panel de filtrado correspondiente.

Puede añadir una consulta del historial a la lista de consultas favoritas seleccionando su entrada y haciendo clic en el botón Add To Favorites. Utilice el botón Clear History si desea vaciar la lista del historial.

Hasta nueve de las expresiones de consulta utilizadas más recientemente de la lista estarán disponibles en el submenú History del menú contextual del panel de filtrado.

Tenga en cuenta que el contenido de la lista History es común a los paneles de filtrado de un dominio de diseño (y accesible desde ellos) (SCH Filter / SCHLIB Filter en el dominio de edición de esquemas; PCB Filter / PCBLIB Filter en el dominio de edición de PCB). Es posible que algunas expresiones de consulta no devuelvan resultados al utilizarse en el editor de esquemas, especialmente si se han creado para buscar objetos que solo están disponibles en el editor de bibliotecas de esquemas.

Consultas favoritas

Cualquier consulta definida puede añadirse a una lista de consultas favoritas de dos maneras:

  • Haga clic en el botón Add To Favorites o haga clic con el botón derecho en la región principal Query Expression y seleccione el comando Add to Favorites en el menú contextual para añadir la expresión de consulta definida actualmente en la región central del panel de filtrado activo.
  • Seleccione una entrada del historial de consultas en la pestaña History del cuadro de diálogo Expression Manager y, a continuación, haga clic en el botón Add To Favorites.

Las expresiones de consulta favoritas se guardan y se gestionan desde la pestaña Favorites del cuadro de diálogo Expression Manager. Se puede acceder a ella mediante el botón Favorites de un panel de filtrado (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) o haciendo clic con el botón derecho en la región principal Query Expression de un panel de filtrado y seleccionando el comando Organize Favorites en el menú contextual. Desde el espacio de diseño, se puede acceder al cuadro de diálogo mediante el atajo de teclado Y y seleccionando después Organize Favorites en el menú emergente de filtrado.

Acceda a una lista de sus consultas favoritas desde el panel de filtrado del editor o desde el espacio de diseño, mediante el menú emergente de filtrado.Acceda a una lista de sus consultas favoritas desde el panel de filtrado del editor o desde el espacio de diseño, mediante el menú emergente de filtrado.

Cuando se añade una expresión de consulta a la lista Favorites , se le asigna un nombre único. De forma predeterminada, se asigna un nombre genérico, Favorite_n, donde n es el siguiente número disponible sin utilizar. El nombre de una entrada puede cambiarse en cualquier momento mediante uno de los siguientes métodos:

  • Seleccione la entrada de la consulta y haga clic en el botón Rename.
  • Seleccione la entrada de la consulta y elija el comando Editar en el menú contextual.
  • Seleccione la entrada de la consulta y vuelva a hacer clic dentro del campo Name.

En cada caso, escriba el nuevo nombre que desee y haga clic fuera del campo Name para aplicar el cambio.

Para editar una expresión de consulta favorita, seleccione su entrada en la lista y haga clic en el botón Edit (o haga clic con el botón derecho y seleccione Edit en el menú contextual). Se abrirá el cuadro de diálogo Edit Favorite. Utilice este cuadro de diálogo para modificar el nombre de la consulta favorita, cambiar la propia expresión y también determinar cómo se gestionan los objetos de diseño (tanto los que cumplen el filtro como los que no).

Modifique una consulta favorita existente mediante el cuadro de diálogo Edit Favorite, que se muestra aquí para esquemas (izquierda) y PCB (derecha).Modifique una consulta favorita existente mediante el cuadro de diálogo Edit Favorite, que se muestra aquí para esquemas (izquierda) y PCB (derecha).

Para eliminar una consulta de la lista Favorites , seleccione su entrada en la lista y haga clic en el botón Remove o seleccione el comando Remove en el menú contextual. Aparecerá un cuadro de diálogo solicitando que confirme la eliminación.

Tenga en cuenta que el contenido de la lista Favorites es común a los paneles de filtrado de un dominio de diseño (y accesible desde ellos) (SCH Filter / SCHLIB Filter en el dominio de edición de esquemas; PCB Filter / PCBLIB Filter en el dominio de edición de PCB). Es posible que algunas expresiones de consulta no devuelvan resultados al utilizarse en el editor de esquemas, especialmente si se han creado para buscar objetos que solo están disponibles en el editor de bibliotecas de esquemas.

Uso de consultas favoritas

Hay tres formas de utilizar sus consultas favoritas:

  1. Desde la pestaña Favorites del cuadro de diálogo Expression Manager: seleccione su entrada y haga clic en el botón Apply Expression o haga doble clic en la entrada. El cuadro de diálogo se cerrará y la expresión de la consulta se cargará en la región central del panel de filtrado correspondiente.

  2. Desde la parte superior del menú contextual del panel de filtrado (están disponibles hasta diez de las expresiones de consulta añadidas más recientemente a la lista Favorites ).

  3. Desde el menú emergente de filtrado del espacio de diseño (pulse Y): en la parte superior del menú se muestran hasta diez expresiones de consulta favoritas. La expresión de consulta seleccionada se cargará en la región central del panel de filtrado correspondiente.

También puede definir un atajo de teclado para una consulta favorita personalizando el menú Filtro. Para obtener más información sobre cómo personalizar el entorno de Altium Designer, consulte Configuración y personalización de Altium Designer.

Uso de ejemplos predefinidos

Tanto el editor de esquemas como el de PCB incluyen un conjunto de consultas de ejemplo predefinidas. Estos ejemplos están disponibles en el menú de filtrado, al que se accede haciendo clic con el botón derecho en la región de expresiones del panel de filtrado o mediante el atajo de teclado Y en el espacio de diseño. Sitúe el cursor sobre Examples para ver el submenú.

Al seleccionar una entrada en el submenú, se aplica la consulta correspondiente a ese filtro. Para ver la consulta subyacente de uno de los ejemplos, consulte la lista History después de aplicarlo. También puede acceder a esta lista desde el menú emergente de filtrado.

Para borrar el filtrado, pulse Shift+C en el espacio de diseño o haga clic con el botón derecho en el espacio de diseño y seleccione el comando Clear Filter en el menú contextual.

Herramientas de creación de consultas

¡Quizá la forma más sencilla de escribir una consulta sea dejar que Altium Designer la escriba por usted! Puede hacerlo mediante el cuadro de diálogo Find Similar Objects  o el cuadro de diálogo Query Builder .

Cuadro de diálogo Buscar objetos similares

Al utilizar el cuadro de diálogo Buscar objetos similares, se genera una consulta para encontrar los objetos necesarios. Si la opción Create Expression está habilitada, esa consulta se mostrará en el panel Filter . Esta es una técnica excelente para aprender distintas palabras clave de consulta.

El cuadro de diálogo Find Similar Objects se abre al hacer clic con el botón derecho en cualquier objeto no enmascarado del documento de diseño y seleccionar Find Similar Objects en el menú contextual.

Imagen izquierda: versión de PCB; imagen derecha: versión de SCHImagen izquierda: versión de PCB; imagen derecha: versión de SCH

Este cuadro de diálogo permite buscar objetos similares a aquel sobre el que ha hecho clic con el botón derecho y, a continuación, definir qué atributos del objeto deben ser iguales (o diferentes) para que haya una coincidencia. Supongamos que desea modificar todos los pads GND de su diseño. Puede hacer clic con el botón derecho en uno de esos pads, elegir Find Similar Objects y cambiar el campo Net de Any (el ajuste predeterminado) a Same. Todos los pads GND se seleccionarán cuando haga clic en Apply en el cuadro de diálogo. Si la opción Create Expression está habilitada, aparecerá la siguiente consulta en el panel Filter : (ObjectKind = 'Pad') And (Net = 'GND').

Como ejemplo en un esquema, puede cambiar la propiedad Color de todos los objetos de alimentación que tengan una propiedad Text determinada (p. ej., 'GND') dentro de un documento y asignarles el mismo valor. Como ejemplo en una PCB, puede cambiar la propiedad Hole Size de todas las vías que tengan una propiedad Via Diameter determinada dentro de un documento y asignarles el mismo valor.

Para obtener más información sobre el uso del cuadro de diálogo Find Similar Objects, consulte Uso de las herramientas de búsqueda de objetos similares.

Opción de borrar lo existente

Habilite la opción Clear Existing para borrar cualquier selección o máscara de edición existente antes de aplicar la búsqueda. Deshabilite esta opción si va a realizar búsquedas sucesivas y desea que los resultados se acumulen.

Barra de herramientas de filtro

La Filter Toolbar está disponible para los documentos PCB y permite enmascarar todos los objetos de un documento excepto aquellos que tengan una propiedad especificada o que formen parte de un componente especificado. El campo situado más a la derecha de la barra de herramientas se utiliza para especificar el contenido de una consulta. Puede introducir la consulta en el campo o utilizar el menú desplegable para seleccionar una de las consultas recientes (una que exista en la lista de consultas History ). No es posible especificar qué opciones utilizar cuando las consultas se aplican desde Filter Toolbar y, en todos los casos, se borra cualquier consulta anterior y se utilizan las opciones de máscara y zoom con la consulta actual. Para utilizar las opciones de consulta, utilice el panel Filter , el cuadro de diálogo Query Builder, el cuadro de diálogo Query Helper o el cuadro de diálogo Find Similar Objects .

  • Si la placa está sin enrutar, las conexiones lógicas asociadas a la red elegida se harán visibles al aplicar el filtro. Si la placa está enrutada, la pista enrutada asociada a la red elegida se hará visible al aplicar el filtro.
  • Con el enmascaramiento aplicado, no se podrán seleccionar ni editar los objetos que queden fuera del alcance del filtro. El grado de enmascaramiento aplicado puede ajustarse manualmente mediante el control deslizante Masked Objects, al que se accede desde la sección Mask and Dim Settings de la pestaña View Options del panel Configuración de vista.
  • Puede borrar manualmente un filtro existente (y aplicado) en cualquier momento mediante el método abreviado de teclado Shift+C o haciendo clic en el botón  de la barra de herramientas Filter .

Operadores de expresiones lógicas de consulta

A continuación se ofrece un resumen de los operadores que pueden utilizarse al definir expresiones lógicas de consulta con el lenguaje de consultas.

Operadores aritméticos

Operador Descripción Ejemplo
+ Operador de suma NetPinCount + NetViaCount
- Operador de resta ArcStopAngle - ArcStartAngle
* Operador de multiplicación PadXSize_BottomLayer * PadYSize_BottomLayer
/ Operador de división HoleDiameter / ViaDiameter
Div Operador de división entera Color Div 65536
Calcula Color dividido entre 65536 y descarta la parte fraccionaria del resultado
Mod Operador de módulo Color Mod 256
Calcula el resto de dividir Color entre 256, sin determinar la parte fraccionaria del resultado

Operadores lógicos

Operador Descripción Ejemplo
And Operador lógico AND IsPad And OnMultiLayer
Para que se devuelva un objeto, este debe ser un pad y estar en la capa Multi-Layer
&& Operador lógico AND
(menor precedencia)
IsPad && OnMultiLayer
Para que se devuelva un objeto, este debe ser un pad y estar en la capa Multi-Layer
Or Operador lógico OR IsPad Or IsVia
Para que se devuelva un objeto, este debe ser un pad o una vía
|| Operador lógico OR
(menor precedencia)
IsPad || IsVia
Para que se devuelva un objeto, este debe ser un pad o una vía
Xor Operador lógico OR EXCLUSIVO OnMultiLayer Xor (HoleDiameter <> 0)
Para que se devuelva un objeto, este debe estar en la capa Multi-Layer y tener un valor de Hole Diameter igual a cero, o no
estar en la capa Multi-Layer y tener un valor de Hole Diameter distinto de cero.
Not Operador lógico NOT Not OnMultiLayer
Para que se devuelva un objeto, este no debe estar en la capa Multi-Layer

Al utilizar el operador Not en expresiones de consulta del editor de PCB para excluir primitivas de un tipo específico, tenga en cuenta que estas primitivas no se excluirán si forman parte de objetos de grupo y la expresión no excluye también dichos objetos de grupo. Por ejemplo, la expresión de consulta Not IsPad devuelve todos los objetos excepto los pads libres, pero devuelve objetos de componente que podrían incluir pads, por lo que esta expresión devolverá los pads de los componentes. Además, los pads pueden estar incluidos en redes, que también se consideran objetos de grupo en el editor de PCB. Para excluir todos los objetos de pad, debe utilizarse la expresión de consulta Not IsPad And Not IsComponent And Not IsNet.

Operadores de comparación

Operador Descripción Ejemplo
< Operador menor que HoleDiameter < 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter menor que 40
<= Operador menor o igual que HoleDiameter <= 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter menor o igual que 40
>= Operador mayor o igual que HoleDiameter >= 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter mayor o igual que 40
> Operador mayor que HoleDiameter > 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter mayor que 40
<> Operador distinto de HoleDiameter <> 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter distinto de 40
= Operador igual a HoleDiameter = 40
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter igual a 40
Between...And... Operador de intervalo inclusivo HoleDiameter Between 30 And 50
Para que se devuelva un objeto, este debe tener un valor de Hole Diameter mayor o igual que 30 y
menor o igual que 50.
Like Operador Like Name Like 'ADDR?*'
Devuelve los objetos que tienen una propiedad Name cuya cadena (de texto) asociada comienza por ADDR y
contiene al menos un carácter más

Caracteres comodín

Los caracteres comodín permiten definir cadenas que no se especifican de forma exacta. Estos caracteres suelen utilizarse junto con otros caracteres, lo que permite definir cadenas parcialmente especificadas. Algunas palabras clave excepcionales aceptan parámetros de cadena que no se especifican de forma exacta, pero, en general, las cadenas solo pueden contener caracteres comodín cuando se comparan mediante el operador Like.

Operador Descripción Ejemplo
? Puede sustituirse por un único carácter de cualquier tipo Footprint Like 'DIP1?'
Devuelve los objetos cuya propiedad Footprint tiene el valor DIP10, DIP12, DIP14, etc.
* Puede sustituirse por cualquier número de caracteres, cada uno de los cuales puede ser de cualquier tipo Footprint Like 'SIP*'
Devuelve los objetos cuya propiedad Footprint tiene el valor SIP1, SIP12, SIP216, etc. (También se devuelven los objetos cuya propiedad Footprint tiene el valor SIP, porque '*' también puede sustituirse por no caracteres).

Cadenas booleanas

Operador Descripción Ejemplo
True Afirma el significado de una palabra clave IsPad = True
Para que se devuelva un objeto, debe ser un pad
False Niega el significado de una palabra clave IsVia = False
Para que se devuelva un objeto, no debe ser una vía

Paréntesis y orden de precedencia

Conviene examinar el orden de precedencia establecido para los operadores utilizados en las expresiones lógicas de consulta. Al fin y al cabo, sin este conocimiento, una expresión podría no seleccionar los objetos deseados.

Los paréntesis tienen la máxima precedencia dentro del orden de precedencia definido para los distintos operadores, que determina cómo interpreta el software las consultas cuando el usuario no ha incluido paréntesis. La secuencia de este orden, de mayor a menor precedencia, es la siguiente:

  1. Paréntesis ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
Este orden de precedencia es similar al utilizado en los lenguajes de tipo Pascal. Las ambigüedades se resuelven de izquierda a derecha. Los paréntesis se evalúan de dentro hacia fuera, y los elementos del mismo nivel se evalúan de izquierda a derecha.
Es muy recomendable utilizar paréntesis siempre que exista cualquier posibilidad de que la consulta no se interprete correctamente. El uso abundante de paréntesis elimina las dudas y facilita que otras personas lean las consultas resultantes.

Funciones de consulta globales del sistema

Funciones de consulta globales del sistema que se muestran en el cuadro de diálogo Query Helper
Funciones de consulta globales del sistema que se muestran en el cuadro de diálogo Query Helper

Esta sección detalla las palabras clave del lenguaje de consulta disponibles en los documentos de esquemáticos, PCB y bibliotecas de Altium Designer. Para obtener ayuda sobre una palabra clave de consulta específica, utilice las siguientes secciones desplegables o seleccione una palabra clave (o haga clic en ella), en Query Helper, en un panel Filter o en el campo Query de una regla de diseño de PCB, y pulse F1 para acceder directamente a su sección.

Para obtener más información sobre las palabras clave del lenguaje de consulta disponibles en editores y herramientas específicos de Altium Designer, consulte las siguientes páginas:

Funciones aritméticas

Funciones trigonométricas

Funciones exponenciales y logarítmicas

Funciones de agregación

Funciones del sistema

AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Nav
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

Documentación heredada

La documentación de Altium Designer ya no está versionada. Si necesita acceder a la documentación de versiones anteriores de Altium Designer, visite la sección Documentación heredada de la página de Otros instaladores.

Contents