In diesem Thema werden verschiedene Methoden zum Definieren von Funktionen erläutert, die in Ausdrücken verwendet werden, die Verwendungs-Links und Teilen zugewiesen sind und die während der Optionsfilterung vom Optionsfilterungs-Delegate ausgewertet werden. Die nächsten Abschnitte behandeln die folgenden Aspekte:

Definieren Sie eine Java-Klasse mit einer öffentlichen statischen Methode (einer Funktion), die Argumente akzeptiert, die Sie an die Funktion übergeben möchten. Die einzigen variablen Argumente, die Sie an die Funktionen übergeben können, sind Wahlmöglichkeiten (insbesondere ihr Auswahlstatus: true, wenn ausgewählt, und false, wenn nicht ausgewählt) und das Objekt des Typs com.ptc.windchill.option.model.ATONavigationBean, das vom Filterungsframework zur Laufzeit bereitgestellt und ausgefüllt wird (Erläuterungen in einem späteren Abschnitt). Nach ihrer Definition kann die öffentliche statische Methode der Java-Klasse im Ausdruck auf verschiedene Weisen in folgenden Formate verwendet werden:

In den folgenden Abschnitten finden Sie Beispiele für die Erstellung einiger Beispielfunktionen und -ausdrücke mit diesen Funktionen für jede der vorstehend genannten Situationen. Sie können Funktionen schreiben, um die Vorteile des variablen ATONavigationBean-Objekts zu nutzen, das Zugriff auf die aktuellen NavigationCriteria, den ATONavigationFilter, das Gültigkeitsdatum des Optionenfilters, den Optionssatz des Optionenfilters, die im Optionenfilter ausgewählten Wahlmöglichkeiten, den Auswahlstatus für alle Wahlmöglichkeiten im OptionSet, die aktuelle NavigationUnit mit dem Knoten "Filterbar" (z.B. WTPartUsageLink) und unterstützende Knoten (z.B. Kind-WTPart des Verwendungs-Links) bietet. Dies erlaubt insbesondere die Verwendung anderer Objekte (z.B. Attributwerte für Teile, Verwendungs-Links und Verwendungsvorkommen) in den Filterungsentscheidungen.

Um eine Funktion zu definieren, schreiben Sie eine Java-Klasse mit einer öffentlichen statischen Methode mit den gewünschten Argumenten.

Java-Code:

Erläuterung:

Dies ist ein Beispiel einer statischen booleschen Funktion, die vier boolesche Argumente verwendet und einen Wert gemäß der folgenden Wahrheitstabelle zurückgibt (T bedeutet wahr, F bedeutet falsch):

Wahrheitstabelle:

Alle anderen Kombinationen von x1, x2, x3 und x4 erzeugen den Wert FALSCH (F).

Um den entsprechenden Ausdruck für jede Zeile zu erhalten, ersetzen Sie T durch den Namen des Parameters (z.B. x1), F durch die Negation des Parameters (! x1), und verketten Sie diese Ergebnisse mit Konjunktionsoperatoren (&&). Die erste Zeile resultiert beispielsweise in folgendem Ausdruck:

Dann verketten Sie boolesche Zeilenausdrücke mit den Disjunktionsoperatoren (||), um den Ausdruck zu erhalten, der die Wahrheitstabelle darstellt.

Die Funktion kann jeden Typ zurückgeben (z.B. alle primitiven Zahlentypen wie int, double, float) und kann dann mit der Konstante desselben Typs verglichen werden, um einen booleschen Ausdruck zu erzeugen, wie im folgenden Beispiel dargestellt.

Mit diesen Arten von Funktionen können Sie solche Konfigurationen herausfiltern, die die angegebenen Gesamtkosten überschreiten. Ein anderer Ansatz besteht darin, die Kostenganzzahl als weiteren Parameter an die Funktion zu übergeben und einen Vergleich innerhalb der Funktion selbst anzustellen. Als Ergebnis wird ein boolescher Wert von der Funktion zurückgegeben.

In den folgenden Beispielen wird davon ausgegangen, dass die folgenden Wahlmöglichkeiten verwendet werden: RED, GREEN, BLUE, WHITE aus der Option COLOR, UK, US, MX aus der Option COUNTRY, PLASTIC, STEEL, WOOD aus der Option MATERIAL und SMALL, MEDIUM, LARGE, X_LARGE aus der Option SIZE. Außerdem werden die Wahlmöglichkeiten hasHD_TV, hasBLUERAY, hasWI_FI verwendet.

In diesem Fall geben Sie die Funktion unter Verwendung des vollständigen Klassenpfads sowie des Methodennamens an. In diesem Beispiel werden Wahlmöglichkeitnamen als Argumente an die Funktion übergeben. In den nachfolgenden Beispielen wird dieser Ansatz veranschaulicht:

Die zu importierenden Klassen können wie folgt in der Eigenschaftendatei WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties angegeben werden:

In diesem Fall können Sie den Paketpfad weglassen, wenn Sie die Funktion im Ausdruck angeben:

In diesem Fall geben Sie zuerst die statischen Importdeklarationen wie folgt in der Eigenschaftendatei WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties an:

In diesem Fall können Sie den Paketpfad und den Klassennamen weglassen (sodass nur der Methodenname übrig bleibt), wenn Sie die Funktion im Ausdruck angeben:

In diesem Fall definieren Sie die Zuordnung zwischen einer Abkürzung für eine Methode und dem vollständigen Pfad zur Methode wie folgt in der Eigenschaftendatei WT_HOME/codebase/ com/ptc/wpcfg/exparser/LookUpService.properties:

Anschließend können Sie diese Aliasnamen verwenden, um auf die Funktion im Ausdruck zuzugreifen:

Im Gegensatz zu Abkürzungen, die Aliasnamen für den vollständigen Funktionspfad einer einzelnen Funktion bereitstellen, ist ein Makro ein Alias für ein Ausdrucksfragment. Es ist nützlich, wenn ein Ausdrucksfragment wiederholt für mehrere Objekte wie Verwendungs-Links und Teile verwendet wird. Import-, statische Import- und Abkürzungsdeklarationen werden direkt während der Ausdrucksanalyse gelöst. Makrofragmente werden zunächst anstelle von Makros im Ausdruck eingesetzt, und anschließend wird der Ausdruck analysiert. Wenn andere Parser-Eigenschaften werden auch Makrozuordnungen in der Eigenschaftendatei WT_HOME/codebase/com/ptc/wpcfg/exparser/LookUpService.properties definiert, wie folgt:

Dann nehmen die letzten beiden Ausdrücke die folgende Form an:

Die Makros sind nützlich zum Kennzeichnen der ATONavigationBean, die Informationen zu Navigationskriterien und den gefilterten strukturellen Objekten enthält.

Das Objekt com.ptc.windchill.option.model.ATONavigationBean ist ein Wrapper-Bean für Varianten des ATONavigationFilter und der aktuellen NavigationUnit, die vom Filterungsframework bereitgestellt werden. Abgesehen von dem Filter und der Navigationseinheit definiert die Bean die Methoden für den Abruf der NavigationCriteria, des Gültigkeitsdatum des Optionenfilters, des OptionSet, der im Optionenfilter ausgewählten Wahlmöglichkeiten und des Auswahlstatus für alle Wahlmöglichkeiten in dem von der Option gruppierten OptionSet.

Um die Bean zu verwenden, müssen Sie zunächst eine Funktion definieren, die die Bean als Parameter verwendet. Als Beispiel steht Ihnen die integrierte Klasse com.ptc.windchill.option.filter.NavigationUtils mit Methoden (Funktionen) zur Verfügung, um die Filtergültigkeitsdaten mit den festen oberen und/oder unteren Zeitstempelgrenzen zu vergleichen.

Es gibt drei andere Methoden, die ein zusätzliches Zeichenfolgenargument verwenden, um das Datumsmuster anzugeben (nützlich für nicht-amerikanische Gebietsschemata). Wenn Sie das konkrete Objekt im Ausdruck angeben, müssen Sie ein leeres Objekt des Typs ATONavigationBean übergeben, wie von der statischen Methode ATONavigationBean.newATONavigationBean() zurückgegeben. Es ist nützlich, ein Makro zum Bezeichnen der Bean zu verwenden, die von diesem Fragment bereitgestellt wird. Das Filterungsframework füllt die Bean mit ATONavigationFilter und NavigationUnit und gibt Ihnen damit Zugriff auf die aktuellen Filterungsdaten.

Definieren Sie zunächst ein Makro für eine Variante der ATONavigationBean und Abkürzungen für die Methoden von NavigationUtils in der Datei LookUpService.properties, wie im Folgenden gezeigt:

Jetzt können Sie einen Ausdruck definieren, der von dem Zeitintervall abhängt, in das das Gültigkeitsdatum fällt:

Dieser Ausdruck verwendet tatsächlich vier verschiedene Formen, wie in den einzelnen Zeile angegeben; diese basieren auf den vier verschiedenen Zeitintervallen:

RED && SMALL: wenn das Gültigkeitsdatum vor dem 05.05.2005 liegt

GREEN && LARGE: wenn das Gültigkeitsdatum zwischen dem 05.05.2005 und dem 06.06.2006 liegt

BLUE && MEDIUM: wenn das Gültigkeitsdatum zwischen dem 06.06.2006 und dem 07.07.2007 liegt

WHITE && X_LARGE: wenn das Gültigkeitsdatum nach dem 07.07.2007 liegt