Filtro de elementos

El filtro de elementos es una herramienta para filtrar elementos por categorías y/o parámetros, que consta de algoritmos de filtrado y una interfaz de configuración (en adelante, la "herramienta"). La herramienta se utiliza en muchos complementos. Por ejemplo, en los complementos Subproyectos, Coloración de elementos y otros.

La herramienta consta de dos filtros: un filtro por categorías y un filtro por parámetros. En algunos complementos es posible usar solo uno de los filtros. Por ejemplo, en el complemento Lado del mundo se utiliza solo el filtro por parámetros.

En la interfaz del complemento, la herramienta puede tener una forma horizontal:

o una forma vertical:

Si se utilizan ambos filtros en la herramienta, entre ellos aparece un operador lógico Y/O. El operador Y significa que un elemento cumple con las condiciones del filtro si cumple con las condiciones de ambos filtros. El operador O, respectivamente, significa que un elemento cumple con las condiciones del filtro si cumple con las condiciones de al menos uno de los dos filtros.

La lista de categorías del filtro por categorías y la lista de condiciones del filtro por parámetros se pueden copiar al portapapeles y pegarse desde el portapapeles mediante el menú contextual que se abre con el botón derecho del ratón.

Filtro por categorías

El filtro por categorías es una lista jerárquica de categorías permitidas. La edición de la lista de categorías se realiza en el diálogo de la ventana principal (ventana del complemento):

En la parte superior del diálogo hay un campo para buscar categorías. La búsqueda se realiza tanto por el nombre visible de la categoría como por el nombre único del programa. Al introducir un asterisco (*) en el campo de búsqueda, se mostrarán todas las categorías seleccionadas. Los botones a la derecha de la lista permiten deseleccionar todas las categorías , expandir y contraer todas las categorías , mostrar solo las categorías seleccionadas o marcar las categorías cuyos elementos están presentes en la vista actual . Las categorías marcadas pueden guardarse en conjuntos para su aplicación posterior tanto en el complemento actual como en otros complementos que usan el filtro por categorías.

Se puede cargar un conjunto de categorías (marcar categorías del conjunto seleccionado) con el botón .

Filtro por parámetros

El filtro por parámetros es una lista de condiciones separadas por el operador lógico Y o O. En el campo del filtro, las condiciones se escriben con una sintaxis especial, en la que para los operadores de comparación se usan los símbolos:

=	– igual
<	– menos
<=	– menor o igual a
>	– más
>=	– mayor o igual a
<>	– no igual
~	– contiene
!~	– no contiene

La edición de condiciones se realiza en una ventana separada:

Reglas para crear condiciones:

1. Puede introducir varios valores válidos en campo "Valores", delimitándolos con coma. Se considera que un parámetro satisface condición si su valor coincide con al menos un valor válido.
2. Para evitar que una coma se perciba como un símbolo delimitador, se debe escapar con una barra diagonal inversa. Por ejemplo, "valor 1\,5".
3. Condición "Con parámetro" significa que elemento se procesará si dicho parámetro está presente, independientemente de valor del parámetro.
4. Condición "Sin parámetro" significa que elemento se procesará en ausencia de dicho parámetro.
5. La condición "Solo lectura" con el valor "No" significa que el elemento se procesará si el parámetro está disponible para su edición. La condición "Solo lectura" con el valor "Sí" significa que el elemento se procesará si el parámetro no está disponible para su edición. Un parámetro puede no estar disponible para su edición si es un parámetro de sistema no editable (por ejemplo, el parámetro "Volumen"), el elemento se encuentra en un conjunto de trabajo no accesible o en otras condiciones.
6. Parámetros de cadena sólo se verifican si cumplen condiciones "Igual", "No igual", "Contiene", "No contiene".
7. Condición "Contiene" verifica que parámetro del elemento contenga al menos uno de valores válidos. Condición "No contiene", respectivamente, verifica que parámetro no contiene al menos uno de valores.
8. Para utilizar condición "Comienza con", seleccione condición "Contiene" y añade un "*" al final del valor. Por ejemplo, "Muro*".
9. Para utilizar condición "Termina con", seleccione condición "Contiene" y añade un "*" al comienzo del valor. Por ejemplo, "*Muro".
10. Para utilizar condición "No comienza con", seleccione condición "No contiene" y añade un "*" al final del valor. Por ejemplo, "Muro*".
11. Para utilizar condición "No termina en", seleccione condición "No contiene" y agregue un "*" al comienzo del valor. Por ejemplo, "*Muro".
12. Verificación de parámetros de cadena distingue entre mayúsculas y minúsculas.
13. Parámetros del tipo "on/off" se verifican como un número entero (0 – off, 1 – on).
14. Condiciones "Con parámetro" y "Sin parámetro" al verificar parámetro clave "Group" (grupo primario) respectivamente verifican si elemento está en grupo o no. Es decir, la condición "Con parámetro" interpreta la verificación "El elemento debe estar en el grupo", y la condición "Sin parámetro" interpreta la verificación "El elemento no debe estar en el grupo". Cualquier otra condición, si el elemento está en un grupo, verifica el nombre del grupo según las reglas para cadenas.
15. Condiciones "Con parámetro" y "Sin parámetro" al verificar parámetro clave "Assembly" (ensamblaje primario) respectivamente verifican si elemento está en ensamblaje o no. Es decir, la condición "Con parámetro" interpreta la verificación "El elemento debe estar en el ensamblaje", y la condición "Sin parámetro" interpreta la verificación "El elemento no debe estar en el ensamblaje". Cualquier otra condición, si el elemento está en un grupo, verifica el nombre del ensamblaje según las reglas para cadenas.
16. Condiciones "Con parámetro" y "Sin parámetro" al verificar parámetro clave "Curtain" (es un muro cortina) respectivamente verifican si el muro esté un muro cortina o no. Es decir, la condición "Con parámetro" interpreta la verificación "El muro debe estar un muro cortina", y la condición "Sin parámetro" interpreta la verificación "El muro no debe estar un muro cortina".
17. Condiciones "Con parámetro" y "Sin parámetro" al verificar parámetro clave "Nested" (familia es anidada) respectivamente verifican si la familia está anidada o no. Es decir, la condición "Con parámetro" interpreta la verificación "La familia debe estar anidada", y la condición "Sin parámetro" interpreta la verificación "La familia no debe estar anidada".
18. Condiciones "Con parámetro" y "Sin parámetro" al verificar parámetro clave "Parent" (familia es primaria) respectivamente verifican si la familia está primaria (contiene familias anidadas) o no. Es decir, la condición "Con parámetro" interpreta la verificación "La familia debe estar primaria", y la condición "Sin parámetro" interpreta la verificación "La familia no debe estar primaria".
19. Al utilizar los parámetros clave "BottomZ" y "TopZ", se comprueban respectivamente las marcas más bajas y más altas de la geometría del elemento. Los parámetros clave "BottomZ" y "TopZ" se consideran numéricos y se comprueban mediante las condiciones correspondientes. Los valores de las marcas se toman en milímetros, redondeados a tres decimales. En el campo "Valor" se pueden especificar los nombres de los niveles. Si se encuentra el nivel especificado, se utilizará su marca en milímetros, redondeada a 3 decimales.
20. El parámetro clave AreaScheme devuelve el nombre del esquema de áreas al que pertenece el Área. El valor del parámetro clave AreaScheme se comprueba según las reglas de cadena.
21. Condiciones "Con parámetro" y "Sin parámetro" al verificar el parámetro clave "InMEPSystem" (el elemento forma parte de un sistema de ingeniería) respectivamente verifican si el elemento forma parte de un sistema de ingeniería o no. Es decir, la condición "Con parámetro" interpreta la verificación "El elemento forma parte de un sistema de ingeniería", y la condición "Sin parámetro" interpreta la verificación "El elemento no forma parte de un sistema de ingeniería".
22. Las condiciones "Con parámetro" y "Sin parámetro" al comprobar el parámetro clave "InRebarSystem" (la armadura está en un sistema de armaduras) determinan respectivamente si la armadura forma parte de un sistema de armaduras o no. Es decir, la condición "Existe el parámetro" interpreta la comprobación como "La armadura forma parte de un sistema de armaduras", y la condición "No existe el parámetro" interpreta la comprobación como "La armadura no forma parte de un sistema de armaduras".
23. El parámetro clave DocumentTitle devuelve el nombre del documento actual. El valor del parámetro clave DocumentTitle se comprueba según las reglas para cadenas. Si el documento no está guardado o está desvinculado, se devolverá el valor predeterminado o una cadena vacía.
24. Operador "Y" verifica todas subcondiciones simples de condición de grupo, es decir, todas subcondiciones deben coincidir.

A la derecha hay dos enlaces que funcionan como botones para añadir una nueva condición simple o de grupo a la lista de condiciones.

En el campo de entrada del identificador de parámetro puede aparecer un botón que permite seleccionar un parámetro de una lista:

Este botón aparece si en el filtro por categorías se seleccionaron categorías. Si en el documento actual existen instancias de elementos de esas categorías, estarán disponibles dos listas: parámetros de instancia y parámetros de tipo. Si no hay instancias pero sí tipos, solo estará disponible la lista de parámetros de tipo.

Como identificador de parámetro se puede usar el nombre del parámetro, el GUID de un parámetro compartido o el nombre del sistema de un parámetro incorporado.

Además de los parámetros, en las condiciones se pueden usar el identificador del elemento (ID), el identificador del tipo de elemento (TypeID), así como el grupo padre del elemento (Group) y el ensamblaje padre del elemento (Assembly) si están disponibles.

Al seleccionar las condiciones "Igual" y "No igual", se activa el botón para buscar valores del parámetro en el proyecto actual :

Una condición de grupo es una lista de condiciones simples. Todas las condiciones simples dentro de una condición de grupo se verifican mediante el operador lógico Y. Es decir, un elemento cumple la condición de grupo si cumple todas las condiciones simples anidadas. En el campo del filtro, la condición de grupo se resalta con corchetes.

En la parte inferior de la ventana hay una lista desplegable El elemento es válido si, que determina el operador lógico usado entre todas las condiciones. El valor todas las condiciones coinciden corresponde al operador lógico Y, y el valor al menos una condición coincide corresponde al operador lógico O.

El ejemplo de la captura de pantalla anterior se verá así en el campo del filtro:

Esto significa que una pared es válida si tiene en el parámetro "Marca" el valor "C-1" o si tiene en el parámetro "Marca" el valor C-2 y en el parámetro "Estructuras portantes" el valor "1".

La búsqueda de parámetros en el elemento verificado se realiza por el nombre del parámetro. Primero se busca en la lista de parámetros de instancia y luego (si no se encuentra) en la lista de parámetros de tipo.

Al verificar los valores de los parámetros de cadena con los operadores "Igual", "Diferente", "Contiene" y "No contiene" se tiene en cuenta la distinción entre mayúsculas y minúsculas.