Cette rubrique détaille les différentes méthodes de définition des fonctions utilisées dans des expressions affectées à des articles et liens de cas d'emploi, et qui sont évaluées lors du processus de filtrage d'options effectué par le délégué de filtrage d'options. Les sections ci-après couvrent les aspects suivants :

Définissez une classe Java avec une méthode statique publique (une fonction) récupérant les arguments que vous voulez passer à la fonction. Les seuls arguments de variable que vous pouvez passer aux fonctions sont les choix (leur statut de sélection étant true s'ils sont sélectionnés, et false s'ils ne le sont pas) et l'objet de type com.ptc.windchill.option.model.ATONavigationBean fourni et rempli par la structure de filtrage lors de l'exécution (décrite dans une des sections suivantes). Une fois définie, la méthode statique publique de la classe Java peut être utilisée dans l'expression de différentes matières, selon les formats suivants :

Dans les sections suivantes, vous trouverez des exemples de construction de fonctions et d'expressions présentant ces fonctions, pour chacune des situations décrites ci-dessus. Vous pouvez écrire des fonctions afin de tirer parti de l'objet ATONavigationBean de variable et de permettre l'accès aux critères de navigation actuels, à l'élément ATONavigationFilter, à la date d'entrée en vigueur du filtre d'options, au jeu d'options du filtre d'options, aux choix sélectionnés dans ce dernier, au statut de sélection pour tous les choix du jeu d'options, à l'unité de navigation en cours avec le noeud Filtrable (par exemple, WTPartUsageLink) et aux noeuds de prise en charge (par exemple, l'article enfant du lien de cas d'emploi). Cela permet tout particulièrement d'utiliser d'autres objets (valeurs d'attribut sur les articles, liens de cas d'emploi et occurrences d'utilisation) lors de décisions relatives au filtrage.

Pour définir une fonction, écrivez une classe Java avec une méthode statique publique incluant les arguments souhaités.

Code Java :

Explication :

Voici un exemple de fonction booléenne statique qui récupère quatre arguments booléens et renvoie une valeur, déterminée par le tableau de valeurs suivant (T=True et F=False) :

Tableau de valeurs :

Toutes les autres combinaisons des éléments x1, x2, x3 et x4 produisent la valeur FALSE (F).

Pour parvenir à l'expression correspondante dans chaque ligne, remplacez le nom du paramètre par la valeur T (par exemple, x1), la négation du paramètre pour F (! x1) et concaténez ces résultats avec les opérateurs de conjonction (&&). Par exemple, la première ligne a pour résultat l'expression suivante :

Ensuite, vous concaténez les expressions booléennes des lignes via les opérateurs de disjonction (||) afin de parvenir à l'expression représentant le tableau de valeurs.

La fonction peut renvoyer n'importe quel type (par exemple, l'une des valeurs primitives de nombre comme int, double ou décimale), avant d'être comparée à la constante du même type, afin de produire une expression booléenne similaire à ce qui suit.

Ces types de fonctions vous permettent de filtrer les configurations qui dépassent le coût total indiqué. Une autre méthode consiste à passer l'entier relatif au coût en tant qu'autre paramètre à la fonction et à effectuer une comparaison dans la fonction elle-même. Le résultat est le renvoi d'une valeur booléenne à partir de la fonction.

Dans les exemples suivants, nous partons du principe que nous disposons des choix RED, GREEN, BLUE, WHITE pour l'option COLOR ; des choix UK, US, MX pour l'option COUNTRY ; des choix PLASTIC, STEEL, WOOD pour l'option MATERIAL et des choix SMALL, MEDIUM, LARGE, X_LARGE pour l'option SIZE. Nous employons également les choix hasHD_TV, hasBLUERAY, hasWI_FI.

Dans ce cas, vous utilisez le chemin de classe complète en plus du nom de la méthode pour spécifier la fonction. Vous passez les noms de choix en tant qu'arguments à la fonction, dans cet exemple. Les exemples suivants illustrent cette approche :

Les classes à importer peuvent être spécifiées dans le fichier de propriétés WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties, comme suit :

Dans ce cas, vous pouvez omettre le chemin du lot lorsque vous spécifiez la fonction dans l'expression :

Dans ce cas, vous devez commencer par spécifier les déclarations d'importation statiques dans le fichier de propriétés WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties, comme suit :

Dans ce cas, vous pouvez omettre le chemin du lot dans le nom de classe (en laissant uniquement le nom de la méthode) lorsque vous spécifiez la fonction dans l'expression :

Dans ce cas, vous définissez le mappage entre une abréviation pour une méthode et le chemin complet vers la méthode dans le fichier de propriétés WT_HOME/codebase/com/ptc/wpcfg/exparser/LookUpService.properties, comme suit :

Ensuite, vous pouvez utiliser ces alias pour accéder à la fonction dans l'expression :

Contrairement aux abréviations qui fournissent des alias pour le chemin d'accès à la fonction complète d'une seule fonction, une macro est un alias correspondant à un fragment d'expression. Elle est utile lorsqu'un fragment d'expression est utilisé plusieurs fois sur de nombreux objets, comme des articles et des liens de cas d'emploi. Les déclarations d'abréviation, d'importation statique et d'importation sont résolues à la volée lors de l'analyse de l'expression. Tout d'abord, les fragments de macro sont remplacés pour les macros de l'expression. Ensuite, cette dernière est analysée. Comme les autres propriétés du parseur, les mappages de macro sont définis dans le fichier WT_HOME/codebase/com/ptc/wpcfg/exparser/LookUpService.properties, comme suit :

Ensuite, les deux dernières expressions prennent la forme suivante :

Les macros sont utiles pour indiquer l'élément ATONavigationBean qui contient des informations sur les critères de navigation et les objets structurels filtrés.

L'objet com.ptc.windchill.option.model.ATONavigationBean est un wrapper de bean sur des instances des éléments ATONavigationFilter et NavigationUnit en cours, fournies par la structure de filtrage. Indépendamment du filtre et de l'unité de navigation, le bean définit les méthodes permettant d'obtenir l'élément NavigationCriteria, la date d'entrée en vigueur de l'élément du filtre d'options, l'élément OptionSet, les choix sélectionnés dans le filtre d'options et le statut de sélection pour tous les choix de l'élément OptionSet regroupés par l'option.

Pour pouvoir utiliser le bean, vous devez d'abord définir une fonction qui l'inclue en tant que paramètre. Voici un exemple de classe intégrée mise à votre disposition : com.ptc.windchill.option.filter.NavigationUtils. Cette classe propose des méthodes (fonctions) dédiées à la comparaison des dates d'entrée en vigueur du filtre avec les limites d'horodatage inférieures et/ou supérieures fixes.

Il existe trois autres méthodes qui utilisent un argument de chaîne supplémentaire pour spécifier le modèle de date (utile pour les paramètres régionaux autres qu'américains). Lorsque vous indiquez l'objet concret dans l'expression, vous devez passer un objet vide du type ATONavigationBean, tel qu'il est renvoyé par la méthode statique ATONavigationBean.newATONavigationBean(). L'utilisation d'une macro pour indiquer le bean fourni par ce fragment est pratique. La structure de filtrage renseigne le bean via les éléments ATONavigationFilter et NavigationUnit, ce qui vous permet d'accéder aux données de filtrage en cours.

Tout d'abord, définissez une macro pour une instance de l'élément ATONavigationBean et des abréviations pour les méthodes NavigationUtils dans le fichier LookUpService.properties, comme suit :

Vous pouvez à présent définir une expression dépendant de l'intervalle défini pour la date d'entrée en vigueur :

En effet, cette expression inclut quatre formes différentes, comme indiqué dans chaque ligne, sur la base des quatre différents intervalles non consécutifs :

RED && SMALL : si la date d'entrée en vigueur est antérieure à 05/05/2005

GREEN && LARGE : si la date d'entrée en vigueur est incluse entre 05/05/2005 et 06/06/2006

BLUE && MEDIUM : si la date d'entrée en vigueur est incluse entre 06/06/2006 et 07/07/2007

WHITE && X_LARGE : si la date d'entrée en vigueur est ultérieure à 07/07/2007