IBM FileNet P8, Wersja 5.1.+            

Uzyskiwanie dostępu do obiektów za pomocą adresów URL

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

gdzie:
  • serwer to nazwa serwera Application Engine lub Workplace XT, na którym rezyduje aplikacja kliencka FileNet P8.
  • aplikacja_WWW to nazwa aplikacji klienckiej FileNet P8; na przykład Workplace XT.
  • id_składnicy_obiektów to identyfikator składnicy obiektów, który może stanowić identyfikator GUID lub nazwa składnicy obiektów. Nazwa składnicy obiektów jest unikalna w ramach pojedynczej domeny, lecz niekoniecznie w ramach katalogu Active Directory. Jeśli nazwa jest używana jako odniesienie do składnicy obiektów, zwracana jest pierwsza zgodna składnica treści w ramach katalogu Active Directory. Jeśli w ramach katalogu Active Directory mogą występować inne składnice obiektów o tej samej nazwie, należy zakwalifikować nazwę składnicy obiektów z nazwą domeny z użyciem znaku „@”; na przykład: objectStoreName@domainName.
  • nazwa_ścieżki to nazwa ścieżki zawierania się.
  • Parametr mode=download (opcjonalny) umożliwia zapisanie treści lokalnie.
    Uwaga: Adresy URL oparte na ścieżce dla dokumentu, zapisane wyszukiwania, szablony wyszukiwania oraz szablony publikowania zawsze zawierają odniesienia do najnowszej wersji.

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.


Opinia

Data ostatniej aktualizacji: Lipiec 2011


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