IBM FileNet P8, Wersja 5.1.+            

Dostosowywanie opcji wyszukiwania w oprogramowaniu Workplace XT

Istnieje możliwość dostosowania pól wyboru opcji wyszukiwania oprogramowania Workplace XT, pojawiających się na stronach wyszukiwania prostego lub zaawansowanego. Opcje wyszukiwania są wyświetlane na listach Opcje i Typy dokumentów. Istnieje możliwość dostosowania list na następujące sposoby:
  • Dodanie opcji
  • Usunięcie opcji
  • Zmianę nazw opcji
Przed przystąpieniem do wyszukiwania aplikacja Workplace XT przekształca warunki wyszukiwania w zapytanie SQL. Każde pole wyboru opcji wyszukiwania reprezentuje jeden warunek dodawany do klauzuli WHERE w instrukcji SQL. Pola wyboru są definiowane w pliku <WPXT_deploy_path>/FileNet/Config/WC/SimpleSearch.xml. Zgodnie z informacją we fragmencie kodu XML każde pole wyboru jest opisywane w elemencie obiektu searchOption.
<object key="searchOptionGroup">
 <setting key="id">options</setting>
 <list key="searchOptions">
 <object key="searchOption">
 <label key="label" localizationKey="server.SimpleSearch.createdByMe">
 <resource>Added by me</resource>
 </label>
 <setting key="symname">Creator</setting>
 <setting key="value">{CURRENT_USER}</setting>
 <setting key="type">typestring</setting>
 <setting key="operator">eq</setting>
 <setting key="join">and</setting>
 <array key="objectTypes">
 <value>document</value>
 <value>folder</value>
 </array>
 <array key="objectStores"></array>
 <array key="roles"></array>
 </object>
...
Uwagi:
  • Podczas edycji pliku XML należy upewnić się, że praca odbywa się na wdrożonym pliku na serwerze aplikacji, który może być inny niż plik XML w domyślnej lokalizacji instalacji.
  • Utwórz kopię zapasową pliku SimpleSearch.xml przed przystąpieniem do jego modyfikowania.
  • W przypadku modyfikowania pliku w celu uwzględnienia znaków rozszerzonych zapisz plik w formacie UTF-8.
  • Po zmodyfikowaniu pliku SimpleSearch.xml można przeładować go z aplikacji Workplace XT w celu uniknięcia restartowania serwera aplikacji.
W poniższej tabeli opisano elementy w pliku SimpleSearch.xml, korzystając z pola wyboru Dodane przeze mnie jako przykładu. Element jest identyfikowany przez atrybut key. O ile nie określono inaczej, wymagane są następujące elementy.
Tabela 1. W tej tabeli opisano elementy w pliku SimpleSearch.xml, korzystając z pola wyboru Dodane przeze mnie jako przykładu.
Ustawienie Wartość
<object key="searchOptionGroup">
 <setting key="id">options</setting>
Element searchOptionGroup porządkuje opcje wyszukiwania na listach Opcje oraz Typy dokumentów na stronach wyszukiwania prostego i zaawansowanego. Element id określa listę: elementy o wartości options są wyświetlane na liście Opcje; elementy o wartości docTypes są wyświetlane na liście Typy dokumentów.
<object key="searchOption">
 <label key="label"
 localizationKey=
 "server.SimpleSearch.createdByMe">
 <resource>
 Added by me
 </resource>
 <resource locale=fr_FR" >
 Créé par moi
 </resource>
 </label>
Element searchOption definiuje opcję wyszukiwania. Element label definiuje różne atrybuty tekstu używanego do opisu pola wyboru.

Element label wymaga atrybutu localizationKey. Aby określić wartość atrybutu localizationKey podczas tworzenia nowej opcji wyszukiwania, należy użyć łańcucha server.SimpleSearch. i dopisać nazwę opisową. Atrybut localizationKey musi być unikalny w ramach pliku SimpleSearch.xml. Element resource określa tekst służący do opisu pola wyboru.

Element label obsługuje zlokalizowane łańcuchy. Można dysponować więcej niż jednym elementem resource o atrybucie locale. Wartość tego atrybutu wymaga użycia standardowego języka ISO oraz kodów językowych obsługiwanych przez przeglądarki.
<setting key="symname"> 
 Creator
</setting>
Element symname określa nazwę symboliczną (identyfikator programowy) właściwości powiązanej z polem wyboru. Istnieje możliwość uzyskania nazwy symbolicznej właściwości za pośrednictwem menedżera Enterprise Manager.
<setting key="value">
 {CURRENT_USER}
</setting>
Element value określa wartość właściwości określonej w zapytaniu SQL. Tam, gdzie ma to zastosowanie, obsługiwane są następujące makra:
  • {CURRENT_USER} to skrócona nazwa wersji bieżąco zalogowanego użytkownika.
  • {DATE}[ + | - ][days] to bieżąca data +/- liczba dni. Na przykład, " {DATE}-7" oznacza bieżący dzień minus 7 dni. Nie są dozwolone żadne spacje.
<setting key="type">
 typestring
</setting>
Element type określa typ danych właściwości. Poprawne typy danych to: typestring, typeboolean i typedate. Istnieje możliwość określenia typu danych właściwości za pośrednictwem menedżera Enterprise Manager.
<setting key="operator">
 eq
</setting>
Element operator określa operator relacyjny używany w zapytaniu SQL. Poprawne wartości są następujące: eq, lt, gt, lte, gte, neq, in, isnull, isnotnull, like.
<setting key="join">
  and
</setting>
Element join określa sposób połączenia tej opcji wyszukiwania z innymi. Ta opcja przyjmuje wartość domyślną or dla pól wyboru Typ dokumentu oraz wartość and dla wszystkich pozostałych pól. Na przykład, jeśli użytkownik wybierze typy dokumentów Word, Excel czy PDF, wyszukiwanie zwraca dowolny dokument zgodny z typem Word lub Excel lub PDF. Alternatywnie, jeśli użytkownik zaznaczy pola wyboru Utworzone przeze mnie oraz Pobrano, wyszukiwanie zwraca dokumenty utworzone przez użytkownika oraz pobrane.

Po przekształceniu przez oprogramowanie Workplace XT opcji wyszukiwania w zapytanie SQL następuje zgrupowanie wszystkich warunków and razem, a za nimi wszystkich warunków or. Na przykład, korzystając z ustawień domyślnych, jeśli użytkownik wybierz opcje Word, PDF, Utworzone przeze mnie oraz Pobrano, wyszukiwanie przesyła zapytanie podobne do następującego: „utworzone przeze mnie and pobrano and (Word or PDF)."

<array key="objectTypes">
 <value>document</value>
 <value>folder</value>
</array>
Element objectTypes określa listę typów obiektów, dla których ta opcja wyszukiwania obowiązuje. Obsługiwane wartości to document i folder.
<array key="objectStores">
 <value>Claims</value>
</array>
Element objectStores określa listę składnic obiektów, w których ta właściwość obowiązuje. Jeśli użytkownik wyszukuje w składnicy obiektów, w której ta właściwość nie obowiązuje, powiązana opcja wyszukiwania nie jest wyświetlana. W celu wyświetlenia opcji wyszukiwania dla wszystkich składnic obiektów należy pominąć obiekt value.
<array key="roles">
 <value>Adjustor</value>
</array>
Element roles określa listę ról, które mają dostęp do tej opcji wyszukiwania. Jeśli użytkownik nie jest członkiem określonej roli, powiązana opcja wyszukiwania nie jest wyświetlana. W celu wyświetlenia opcji wyszukiwania dla wszystkich użytkowników należy pominąć obiekt value.


Opinia

Data ostatniej aktualizacji: Lipiec 2011


© Copyright IBM Corp. 2011.
To centrum informacyjne jest oparte na technologii Eclipse. (http://www.eclipse.org)