Wprowadzenie
Aby wyświetlić, wyeksportować/zaimportować i zreorganizować ustawienia wyszukiwania na konfigurowalnych listach należy użyć narzędzia wrksrh.
Grupa docelowa
- Twórcy aplikacji
- Administratorzy systemu
Polecenie
Poniżej znajduje się polecenie wraz ze wszystkimi możliwymi parametrami.
| wrksrh | [-db:<id>][-all][-o:<str-1> … -o:<str-n>]
[-lastInstallation:<str>] [-check] [-export] [-import:<str-1> … -import:<str-n>] [-delete] [-display] [-reorganise] [-migrate:<str>] [-log:<str>] [-verbose] [-batchJobs] |
Parametry
Parametry polecenia zostały wyjaśnione w poniższej tabeli. Parametry w nawiasach kwadratowych są opcjonalne, podczas gdy pozostałe są parametrami obowiązkowymi. Gwiazdka (*) może być określona jako symbol zastępczy dla niektórych parametrów, aby móc wyświetlić wszystkie możliwe wartości. Nie wszystkie parametry mogą być określone więcej niż jeden raz; tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego określenia: <str-1> … <str-n>.
| Parametr | Opis |
|---|---|
-db:<id> |
Określa bazę danych, dla której ma zostać wykonana operacja. |
-all |
Bazuje na wszystkich wyszukiwaniach w wybranych bazach danych. |
-o:<str-1> … <str-n> |
Wybiera wyszukiwania o określonych nazwach technicznych. |
-lastInstallation:<str> |
Określa wyszukiwania z ostatniej instalacji dla podanej klasy kodu. |
-check |
Sprawdza wybrane wyszukiwania pod kątem kompatybilności ich rozszerzeń wyszukiwania i zapisuje wyniki do pliku wyjściowego (parametr -log). Jeśli parametr -verbose jest podany, wszystkie wyniki kontroli kompatybilności są wyświetlane. W przeciwnym razie do pliku są zapisywane tylko wpisy dla tych wyszukiwań i rozszerzeń wyszukiwania, dla których stwierdzono zmiany podczas kontroli kompatybilności. |
-export |
Eksportuje dostosowania wyszukiwań dla wszystkich wybranych wyszukiwań. (rozdział Eksportowanie dostosowań wyszukiwania) |
-import:<str-1> … <str-n> |
Importuje podane pliki z wyeksportowanymi dostosowaniami wyszukiwań do wybranej bazy danych. Jeśli w tej bazie danych już istnieją dostosowania dla importowanych wyszukiwań, zostaną one nadpisane. |
-delete |
Usuwa dostosowania wyszukiwań dla wybranych wyszukiwań. |
-display |
Wyświetla dane dostosowań wyszukiwań dla wybranych wyszukiwań. |
-reorganize |
Sprawdza, czy dostosowania wyszukiwań dla wybranych wyszukiwań są nadal ważne. Nieważne dostosowania są albo przenoszone do aktualnej wersji wyszukiwania, albo, jeśli to nie jest możliwe, usuwane (rozdział „Przenoszenie dostosowań wyszukiwania). |
-migrate:<str> |
Przenosi dostosowania wyszukiwań dla wszystkich wybranych wyszukiwań do aktywnej wersji wyszukiwania. Podaj nazwę pliku dziennika HTML jako parametr (rozdział „Przenoszenie dostosowań wyszukiwania). |
-log:<str> |
Wyniki są zapisywane w formacie HTML do podanego pliku. |
-verbose |
Jeśli parametr jest ustawiony, wyświetlane są bardziej szczegółowe informacje. |
-batchJobs |
Wyświetla, które zadania przetwarzania w tle używają których wyszukiwań. |
Przenoszenie dostosowań wyszukiwania
Wyszukiwania mogą być rozszerzane o nowe pola za pomocą dostosowań wyszukiwań. Dostosowanie wyszukiwania jest tworzone dla aktualnie aktywnej wersji wyszukiwania. Jeśli nowa wersja tego wyszukiwania zostanie aktywowana, na przykład poprzez aktualizację oprogramowania, możliwe jest, że dostosowanie wyszukiwania nie będzie już pasować do nowej wersji wyszukiwania. W takim przypadku, podczas przenoszenia dostosowania wyszukiwania, usuwane są te części, które nie mogą już bezbłędnie współpracować z nową wersją. W zależności od zmian między wersją wyszukiwania, na podstawie której utworzono dostosowanie, a nową wersją wyszukiwania, w tym kroku dostosowanie wyszukiwania może zostać również całkowicie usunięte.
Dostosowanie wyszukiwania pozostaje niezmienione w przypadku następujących zmian:
-
Atrybut został usunięty w nowej wersji wyszukiwania (atrybut nie był używany w dostosowaniu wyszukiwania).
-
Nowy atrybut został dodany w nowej wersji wyszukiwania.
-
Atrybut wyszukiwania został zmieniony pod względem treści.
-
Nowy obiekt biznesowy został dodany w nowej wersji wyszukiwania.
-
Obiekt biznesowy został usunięty z nowej wersji wyszukiwania. Ten obiekt biznesowy nie był używany w dostosowaniu wyszukiwania.
Części dostosowania wyszukiwania są usuwane w przypadku następujących zmian:
-
Atrybut został usunięty w nowej wersji wyszukiwania. Etykieta tego atrybutu została zmieniona w dostosowaniu wyszukiwania.
-
Tylko zmieniony atrybut zostanie usunięty z dostosowania wyszukiwania. Wszystkie pozostałe atrybuty dostosowania wyszukiwania pozostaną bez zmian.
-
Obiekt biznesowy został usunięty z nowej wersji wyszukiwania. Ten obiekt biznesowy był używany w dostosowaniu wyszukiwania.
-
Wszystkie atrybuty tego obiektu biznesowego oraz atrybuty wszystkich zależnych obiektów biznesowych zostaną usunięte z dostosowania wyszukiwania.
Można generować zadania przetwarzania oparte na dostosowaniu wyszukiwania. Jeśli w aktywnej wersji wyszukiwania zmieniono lub usunięto istniejące atrybuty lub używane obiekty biznesowe wyszukiwania, istnieje ryzyko, że zadania przetwarzania zostaną wykonane na innych danych, niż zamierzał użytkownik, lub że podczas wykonywania wystąpią błędy. W takim przypadku zadania przetwarzania, które jeszcze nie zostały wykonane i które wykorzystują dostosowanie wyszukiwania, zostaną anulowane.
Eksportowanie dostosowań wyszukiwania
Dostosowania wyszukiwania można eksportować jawnie za pomocą parametru -export. Dostosowania wyszukiwania są jednak również eksportowane automatycznie przed ich przeniesieniem przy użyciu parametru -migrate lub polecenia upgaps -release.
Każde dostosowanie wyszukiwania jest eksportowane w postaci binarnej do pliku. Pliki są eksportowane do folderu servers/_etc/SearchExtensions/{Database} względem katalogu instalacyjnego. Nazwa pliku składa się z nazwy wyszukiwania i znacznika czasu.
Przenoszenie wszystkich dostosowań wyszukiwania
Za pomocą parametru -migrate lub polecenia upgaps -release wszystkie dostosowania wyszukiwania we wszystkich bazach danych są przenoszone do aktywnej wersji wyszukiwania. Zanim dostosowanie wyszukiwania zostanie zmienione, stan sprzed zmiany jest eksportowany i można go ponownie zaimportować w dowolnym momencie. Każda zmiana dostosowania wyszukiwania jest rejestrowana w pliku dziennika HTML. Wszystkie aplikacje list, których to dotyczy, są wymienione w pliku dziennika. W takim przypadku należy sprawdzić i poprawić układy aplikacji list, których to dotyczy.
Po zakończeniu wszystkich dostosowań wyszukiwania uruchamiane jest zdarzenie Workflow com.cisag.pgm.search.SearchMigration. W dostarczonej definicji aktywności cis.sys.SearchExtension znajduje się przykład użycia tego zdarzenia. Należy aktywować tę definicję aktywności, aby otrzymywać powiadomienia o migracji dostosowań wyszukiwania.
