Filtro de objetos

El Filtro de objetos es una herramienta para filtrar objetos por tipo y/o atributos, que consta de algoritmos de filtrado y una interfaz de configuración (en lo sucesivo — la herramienta). La herramienta se utiliza en complementos como Buscar por condición.

La herramienta consta de dos filtros: filtro por tipo y filtro por atributos:

Entre los filtros existe un operador lógico Y/O. El operador Y significa que un objeto satisface las condiciones de filtrado si cumple las condiciones de ambos filtros. El operador O significa que un objeto satisface las condiciones de filtrado si cumple las condiciones de al menos uno de los dos filtros.

La lista de tipos del filtro por tipo y la lista de condiciones del filtro por atributos se pueden copiar al portapapeles y pegar desde el portapapeles mediante el menú contextual (botón derecho del ratón).

Filtro por tipo

El filtro por tipo es una lista en forma de árbol de los tipos de objetos permitidos. La edición de la lista de tipos 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 un tipo por nombre. Al introducir un asterisco (*) en el campo de búsqueda se mostrarán todos los tipos seleccionados. Los botones a la derecha de la lista permiten cancelar la selección de todos los tipos , expandir  y contraer todos los tipos , mostrar solo los tipos seleccionados  o marcar los tipos cuyos objetos están presentes en el proyecto . Los tipos marcados se pueden guardar en conjuntos  para su posterior uso tanto en el complemento actual como en otros complementos que utilicen el filtro por tipo.

Puede cargar un conjunto de tipos (marcar los tipos del conjunto seleccionado) con el botón .

Filtro por atributos

El filtro por atributos 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 los operadores de comparación usan los siguientes símbolos:

=	– igual
<	– menor que
<=	– menor o igual que
>	– mayor que
>=	– mayor o igual que
<>	– distinto de
~	– contiene
!~	– no contiene

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

Reglas para la creación de condiciones:

1. Un atributo es un concepto condicional que combina Propiedades, Parámetros y Características calculadas de los objetos.
2. En el campo "Valores" puede ingresar varios valores permitidos separados por comas. El atributo cumple la condición si su valor coincide con al menos uno de los valores permitidos.
3. Para que la coma no se interprete como separador, debe escaparse con una barra invertida. Por ejemplo, "valor 1\,5".
4. La condición "Presencia del atributo" significa que el objeto se procesará si existe dicho atributo, independientemente de su valor.
5. La condición "Ausencia del atributo" significa que el objeto se procesará si no existe dicho atributo.
6. Los atributos de texto se verifican solo con las condiciones "Igual", "No igual", "Contiene" y "No contiene".
7. Los atributos numéricos se verifican con todas las condiciones excepto "Contiene".
8. La condición "Contiene" comprueba que el atributo del objeto contiene al menos uno de los valores permitidos. La condición "No contiene" comprueba que el atributo no contiene al menos uno de los valores.
9. Para usar la condición "Empieza con", seleccione "Contiene" y agregue un "*" al final del valor. Por ejemplo, "Hormigón*".
10. Para usar la condición "Termina con", seleccione "Contiene" y agregue "*" al comienzo del valor. Por ejemplo, "*hormigón".
11. Para usar la condición "No empieza con", seleccione "No contiene" y agregue "*" al final del valor. Por ejemplo, "Hormigón*".
12. Para usar la condición "No termina con", seleccione "No contiene" y agregue "*" al comienzo del valor. Por ejemplo, "*hormigón".
13. La verificación de valores de texto distingue entre mayúsculas y minúsculas.
14. Para comprobar atributos booleanos, puede usar los valores "Sí/No", "true/false" o 0 (no) y 1 (sí).
15. Si el atributo devuelve una longitud, el valor predeterminado está en milímetros. Para usar otras unidades, especifíquelas en la condición con un espacio: "1 m" en metros, "10 cm" en centímetros, "100 mm" en milímetros.
16. Si el atributo devuelve un área, el valor predeterminado está en metros cuadrados. Para usar otras unidades, especifíquelas en la condición con un espacio: "1 m2" para metros cuadrados, "10 cm2" para centímetros cuadrados, "100 mm2" para milímetros cuadrados.
17. Si el atributo devuelve un volumen, el valor predeterminado está en metros cúbicos. Para usar otras unidades, especifíquelas en la condición con un espacio: "1 m3" para metros cúbicos, "10 cm3" para centímetros cúbicos, "100 mm3" para milímetros cúbicos.
18. Si el atributo devuelve una masa, el valor predeterminado está en kilogramos. Para usar otras unidades, especifíquelas en la condición con un espacio: "1 t" para toneladas, "10 kg" para kilogramos, "100 g" para gramos.
19. Todas las condiciones simples anidadas de una condición de grupo se verifican con el operador "Y", es decir, todas deben coincidir.Un atributo es un concepto general que agrupa Propiedades, Parámetros y Características calculadas de los objetos.

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

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

Este botón aparece si en el filtro por tipo se han definido tipos. En ese caso estarán disponibles tres listas: propiedades, parámetros y características calculadas.

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 objeto satisface la condición de grupo si cumple todas las condiciones simples incluidas. En el campo del filtro la condición de grupo se encierra entre corchetes.

En la parte inferior de la ventana se encuentra la lista desplegable El objeto coincide si, que define el operador lógico usado entre todas las condiciones. El valor todas condiciones coinciden corresponde al operador lógico Y, y el valor al menos una condición concide corresponde al operador lógico O.

El ejemplo de la captura anterior en el campo del filtro se verá de la siguiente manera:

lo que significa que una pared encaja si su atributo "Mark" tiene el valor "W-1" o si su atributo "Mark" tiene el valor "W-2" y el atributo "Nominal length" es mayor que 3000.

Al comprobar los valores de atributos de texto con los operadores "Igual", "Distinto", "Contiene" y "No contiene" se tiene en cuenta la distinción entre mayúsculas y minúsculas.