En este tema se explican distintas formas de definir las características que se utilizan en las expresiones asignadas a los vínculos de uso y los artículos y evaluadas durante el proceso de filtrado de opción realizado por el delegado de filtrado de opción. En las secciones subsiguientes se tratan los aspectos que se indican a continuación:

Defina una clase Java con un método estático público (una función) que tome los argumentos que desee para pasar a la función. Los únicos argumentos de variables que se pueden pasar a las funciones son las elecciones (en concreto, su estatus de selección true, si está seleccionado, y false, si no está seleccionado) y el objeto del tipo com.ptc.windchill.option.model.ATONavigationBean proporcionado y completado por la estructura de filtrado en tiempo de ejecución (descrito en una sección posterior). Una vez definido, el método estático público de la clase Java se puede utilizar en la expresión de varias maneras diferentes mediante los formatos siguientes:

En las siguientes secciones se encontrarán ejemplos para crear algunas funciones y expresiones de muestra con estas funciones para cada una de las situaciones ya mencionadas. Las funciones se pueden escribir para aprovechar la ventaja que ofrece el objeto ATONavigationBean variable, que proporciona acceso al objeto NavigationCriteria actual, el objeto ATONavigationFilter, la fecha de efectividad de filtro de opciones, el conjunto de opciones de filtro de opciones, las elecciones seleccionadas en el filtro de opciones, el estatus de selección de todas las elecciones en el objeto OptionSet, el objeto NavigationUnit actual con el nodo Se puede filtrar (por ejemplo, WTPartUsageLink) y los nodos de soporte (por ejemplo, WTPart hijo del vínculo de uso). En particular, esto permite utilizar otros objetos (tales como valores de atributo en artículos, vínculos de uso y apariciones de uso) en las decisiones de filtrado.

Para definir una función, escriba una clase Java con un método estático público con los argumentos deseados.

Código Java:

Explicación:

Este es un ejemplo de una función booleana estática que toma cuatro argumentos booleanos y devuelve un valor según lo determinado en la siguiente tabla de verdad (T significa verdadero, F significa falso):

Tabla de verdad:

El resto de combinaciones de x1, x2, x3 y x4 producen el valor FALSE (F).

Para llegar a la expresión correspondiente para cada fila, sustituya el nombre del parámetro para T (por ejemplo, x1), la negación del parámetro para F (! x1) y concatene estos resultados con los operadores de conjunción (&&). Por ejemplo, la primera fila da como resultado la siguiente expresión:

A continuación, concatene las expresiones booleanas de la fila con los operadores de disyunción (||) para llegar a la expresión que representa la tabla de verdad.

La función puede devolver cualquier tipo (por ejemplo, cualquier geometría numérica, tal como ent, doble, decimal) y luego compararla con la constante del mismo tipo para producir una expresión booleana, como se indica en el siguiente ejemplo.

Estas clases de funciones permiten filtrar las configuraciones que superen el coste total especificado. Otro enfoque es pasar el entero del coste como otro parámetro a la función y realizar la comparación dentro de la función en sí. Esto devuelve un booleano de la función.

En los ejemplos siguientes, se entiende que existen las elecciones RED, GREEN, BLUE, WHITE de la opción COLOR; UK, US, MX de la opción COUNTRY; PLASTIC, STEEL, WOOD de la opción MATERIAL y SMALL, MEDIUM, LARGE, X_LARGE de la opción SIZE. También se utilizan las elecciones hasHD_TV, hasBLUERAY, hasWI_FI.

En este caso, se utiliza la ruta de clase completa más el nombre del método para especificar la función. Como argumentos para la función en este ejemplo, se pasan los nombres de elecciones. En los siguientes ejemplos se muestra este enfoque:

Las clases que deben importarse se pueden especificar en el fichero de propiedades WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties de la siguiente manera:

En este caso, se puede omitir la ruta del paquete al especificar la función en la expresión:

En este caso, primero se deben especificar las declaraciones de importación estática en el fichero de propiedades WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties, de la siguiente manera:

En este caso, se puede omitir la ruta del paquete y el nombre de clase (dejando solo el nombre del método) al especificar la función en la expresión:

En este caso, se define la asignación entre una abreviatura para un método y la ruta completa al método en el fichero de propiedades en WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties de la siguiente forma:

A continuación, estos alias se pueden utilizar para acceder a la función en la expresión:

A diferencia de las abreviaturas que proporcionan alias para la ruta completa de la función de una única función, una macro es un alias para un fragmento de expresión. Resulta útil cuando un fragmento de expresión se utiliza repetidamente en numerosos objetos como vínculos de uso y artículos. La declaración de abreviaciones, la importación y la importación estática se resuelven a la vez durante el análisis de la expresión. Los fragmentos de macro se sustituyen primero para las macros de la expresión y luego esta se analiza. Como otras propiedades del analizador, las asignaciones de macros se definen en WT_HOME/codebase/com/ptc/wpcfg/exparser/LookUpService.properties de la siguiente manera:

A continuación, las dos últimas expresiones asumen la forma:

Las macros son útiles para indicar el objeto ATONavigationBean que contiene información sobre criterios de navegación y los objetos estructurales que se filtran.

El objeto com.ptc.windchill.option.model.ATONavigationBean es un bean de empaquetador sobre instancias del objeto ATONavigationFilter y NavigationUnit actual proporcionado por la estructura de filtrado. Aparte del filtro y la unidad de navegación, el bean define los métodos para obtener el objeto NavigationCriteria, la fecha de efectividad del filtro de opciones, el objeto OptionSet, las elecciones seleccionadas en el filtro de opción y el estatus de la selección para todas las opciones de OptionSet agrupadas mediante la opción.

Para utilizar el bean, primero se debe definir una función que lo tome como uno de los parámetros. Por ejemplo, hay una clase integrada disponible: com.ptc.windchill.option.filter.NavigationUtils, que proporciona los métodos (las funciones) para comparar las fechas de efectividad del filtro con los límites de fecha superiores o inferiores fijos.

Hay otros tres métodos que realizan un argumento adicional de cadena para especificar el patrón de la fecha (útil para las configuraciones regionales que no sean estadounidenses). Al especificar el objeto concreto en la expresión, se debe pasar un objeto vacío del tipo ATONavigationBean según lo que devuelve el método estático ATONavigationBean.newATONavigationBean(). Es conveniente utilizar una macro para indicar el bean proporcionado por este fragmento. El marco de filtrado rellena el bean con ATONavigationFilter y NavigationUnit, lo que proporciona acceso a los datos actuales de filtrado.

En primer lugar, defina una macro para una instancia de ATONavigationBean y las abreviaturas para los métodos de NavigationUtils en el fichero LookUpService.properties de la siguiente manera:

Ahora se puede definir una expresión que dependa del intervalo de tiempo en el que se encuentre la fecha de efectividad:

Esta expresión toma efectivamente cuatro formas distintas, según lo especificado en cada fila, en función de cuatro intervalos de tiempo inconexos distintos:

RED && SMALL: si la fecha de efectividad es anterior a 05/05/2005.

GREEN && LARGE: si la fecha de efectividad está comprendida entre 05/05/2005 y 06/06/2006.

BLUE && MEDIUM: si la fecha de efectividad está comprendida entre 06/06/2006 y 07/07/2007.

WHITE && X_LARGE: si la fecha de efectividad es posterior a 07/07/2007.