Adresowalność URL udostępnia użytkownikowi bezpośredni dostęp do obiektów bez potrzeby nawigacji przez interfejsu użytkownika
klienta programu IBM® FileNet P8. Po zalogowaniu się do
klienta FileNet P8, takiego jak Workplace XT, użytkownik po prostu wprowadza adres URL obiektu w
pasku adresu przeglądarki.
(Administrator może
utworzyć zakładki lub dodać adresy do Ulubionych w celu pobrania folderu lub obiektu z wersją.)
Korzystając z adresowalności, można:
- Pobierać dokumenty, foldery, zapisane wyszukiwania, szablony wyszukiwań, definicje przepływu pracy oraz publikować szablony.
- Pobierać następujące typy obiektów i zapisywać je lokalnie na komputerze PC. Te typy obiektów to: dokument, zapisane wyszukiwanie, szablon wyszukiwania,
szablon publikacji oraz definicja przepływu pracy.
- Wprowadzać adres URL oparty na ścieżce lub identyfikatorze, zgodnie z przykładem poniżej.
Adres URL oparty na ścieżce korzysta ze ścieżki
zawierania się w celu określenia lokalizacji obiektu w składnicy obiektów. Na przykład, w celu pobrania dokumentu o nazwie
Bieżące prace, który rezyduje w folderze Projekty w składnicy obiektów Transport, użytkownik
wprowadza adres URL podobny do następującego:
http://nazwa_serwera_klienta_P8/nazwa_aplikacji:port/getContent/Transportation/Projects/Current+Works
W celu
pobrania obiektów za pomocą adresów URL opartych na ścieżce konieczne jest ustawienie preferencji serwisu Użyj adresów URL opartych na ścieżce.
Adres URL oparty na ścieżce korzysta z
identyfikatorów
GUID w celu określenia lokalizacji obiektu w składnicy obiektów. Lokalizację dokumentu określa identyfikator GUID składnicy obiektów, w
której rezyduje dokument, oraz identyfikator GUID dokumentu. Na przykład, w celu pobrania dokumentu użytkownik wprowadza adres URL podobny do
następującego:
http://nazwa_serwera_klienta_P8/nazwa_aplikacji:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}
Adresy oparte na identyfikatorze działają generalnie szybciej niż adresy oparte na ścieżce; jednak tylko adres URL oparty na ścieżce rozwiązuje referencje względne
w obrębie dokumentu.
Na przykład, w przypadku żądania pliku „example.html” z adresem URL opartym na ścieżce plik jest pobierany, zaś przeglądarka rozwiązuje wszelkie
dodatkowe adresy URL potrzebne w ramach dokumentu example.html (na przykład znaczniki <script>, <img> i <link>). Wszelkie odsyłacze (<a
href=...>) są rozwiązywane przez przeglądarkę z chwilą ich kliknięcia przez użytkownika.
W poniższej tabeli wymieniono domyślne odpowiedzi na różne typy
obiektów, które można określić w adresie URL.
Typ obiektu |
Odpowiedź |
Folder |
Zwraca stronę wyświetlającą nazwę folderu. |
Dokument |
Jeśli dokument zawiera treść, jest ona zwracana. Jeśli dokument zawiera odniesienie do dokumentu zewnętrznego, klient
FileNet P8 przekierowuje klienta odpowiednio do potrzeb. Jeśli dokument nie zawiera treści,
klient FileNet P8 zgłasza błąd. |
Definicja przepływu pracy |
Otwiera aplet Projektant procesu. |
Zapisane wyszukiwanie |
Zwraca stronę wyświetlającą nazwę zapisanego wyszukiwania. |
Szablon wyszukiwania |
Zwraca stronę wyświetlającą szablon wyszukiwania. |
Szablon publikowania |
Zwraca treść szablonu publikowania w formacie XML. |
Reguły składni URL bazujące na ścieżce
Adres URL bazujący na ścieżce wymaga identyfikatora składnicy obiektów oraz nazwy ścieżki
zawierania się. Parametr
mode=download jest opcjonalny. Przykład:
http://serwer/aplikacja_WWW/getContent/id_składnicy_obiektów/nazwa_ścieżki?mode=download
Przykładowe adresy URL oparte na ścieżce
Korzystając z tego adresu URL można wyświetlić stronę oprogramowania Workplace XT zawierającą
określony szablon wyszukiwania.
Składnica obiektów jest identyfikowana przez nazwę (Forms):
http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download
Za pomocą tego adresu URL następuje kwalifikacja składnicy obiektów Forms za
pośrednictwem nazwy domeny, Midwest:
http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download
Reguły składni URL bazujące na identyfikatorze
Adres URL oparty na identyfikatorze pobiera trzy wymagane parametry łańcucha zapytań na potrzeby
obiektu typu folder: objectStoreName, objectType oraz id. Na przykład:
http://serwer/aplikacja_WWW/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}
Dla obiektów dokumentu, zapisanego wyszukiwania, szablonu wyszukiwania, szablonu publikacji oraz
definicji przepływu pracy adres URL przyjmuje parametry objectStoreName, objectType, id oraz
fsld. Parametr
mode=download jest opcjonalny. Oto przykład:
http://serwer/aplikacja_WWW/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download
lub
http://serwer/aplikacja_WWW/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}
lub
http://serwer/aplikacja_WWW/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download
gdzie:
- serwer to nazwa serwera Application Engine lub Workplace XT, na którym uruchomiona jest aplikacja kliencka
FileNet P8.
- aplikacja_WWW to nazwa aplikacji klienckiej FileNet P8.
- objectStoreName=objectStoreGUID to identyfikator GUID składnicy obiektów, w której rezyduje obiekt. Należy ujmować go w nawiasy klamrowe.
- objectType=type to typ obiektu do pobrania. Wprowadź odpowiednią wartość objectType:
Dla: |
objectType= |
Dokument |
document |
Folder |
folder |
Zapisane wyszukiwanie |
storedsearch |
Szablon wyszukiwania |
searchtemplate |
Definicja przepływu pracy |
document |
Szablon publikowania |
publishtemplate |
- id=objectGUID to identyfikator GUID identyfikujący obiekt w składnicy obiektów. Jest to parametr wymagany dla obiektu folderu.
W przypadku dokumentów, zapisanych wyszukiwań, szablonów wyszukiwań, definicji przepływu pracy oraz szablonów publikowania identyfikator jest opcjonalny i jest używany
do pobierania określonej wersji. Należy ujmować go w nawiasy klamrowe.
- vsId=versionSeriesGUID to identyfikator GUID służący do pobierania najnowszej wersji w ramach serii wersji dla następujących obiektów: dokument,
zapisane wyszukiwanie, szablon wyszukiwania, definicja przepływu pracy oraz szablon publikowania.
Uwaga: Jeśli w adresie URL występują
zarówno identyfikator, jak i vsld, aplikacja kliencka FileNet P8 korzysta z identyfikatora do
pobrania określonej wersji.
Jeśli określonej wersji nie można znaleźć, aplikacja kliencka FileNet
P8 zgłasza błąd i udostępnia użytkownikowi opcję pobierania najnowszej wersji określonej parametrem vsld.
- Parametr mode=download jest opcjonalny i umożliwia zapisanie treści lokalnie.
Uwaga: Istnieje możliwość
skonfigurowania aplikacji klienckiej FileNet P8 w celu używania adresów URL opartych na ścieżce na potrzeby żądań dokumentów. Dlatego w przypadku wprowadzenia adresu URL opartego na identyfikatorze aplikacja kliencka FileNet P8 przekształca adres URL oparty na
identyfikatorze na adres URL oparty na ścieżce, o ile jest to możliwe, w celu zachowania integralności wszelkich względnych odniesień
adresu URL osadzonych w treści dokumentu.