...
Opisywane narzędzie służy do dodawania plików do publikacji planowanejobiektu planowanego. Pliki jakie mają zostać dodane, użytkownika w imieniu którego pliki będą dodawane oraz publikację obiekt do której którego pliki zostaną dodane wskazywane są w parametrach konfiguracyjnych tego narzędzia. Narzędzie to uruchamiane jest z linii poleceń i jest dedykowane do wykorzystania w mechanizmach automatyzacji pracy redaktorów biblioteki cyfrowej. Przykładowo może być wykorzystany wtedy gdy mamy zdefiniowany taki oto proces pracy redaktora:
- Redaktor tworzy publikację planowaną obiekt planowany wprowadzając w jej jego właściwościach: metadane, prawa użytkowników, przypisanie do kolekcji, informacje WWW.
- Redaktor skanuje analogową postać publikacji obiektu do plików wysokiej jakości (np. do plików graficznych wysokiej rozdzielczości).
- Redaktor przesyła pliki wysokiej jakości do systemu automatycznego wprowadzania publikacjiobiektu.
- System automatycznego wprowadzania publikacji obiektu konwertuje pliki wysokiej rozdzielczości do plików w formacie w którym biblioteka cyfrowa prezentuje zdigitalizowane zbiory (np. do plików w formacie PDF lub DjVu) oraz wykorzystuje opisywane w tym rozdziale narzędzie do automatycznego dodania tych plików do publikacji planowanejobiektu planowanego.
W wyniku tych operacji w bibliotece cyfrowej pojawia się normalna publikacja utworzona normalny obiekt utworzony poprzez automatyczne dodanie plików publikacjiobiektu. Dzięki temu redaktor może skupić się na wyborze publikacji obiektu do skanowania i skanowaniu odpowiednich dokumentów. Resztą (od momenu zeskanowania i przesłania plików) zajmuje się system automatyzacji pracy redaktorów.
Do uruchomienia narzędzia do dodawania plików do publikacji planowanej wymagana jest zainstalowana maszyna wirtualna Javy autorstwa firmy Sun w wersji 1.6 lub nowszej. Narzędzie to dostępne jest Narzędzie znajduje się w każdej wersji dystrybucji systemu dLibra począwszy od wersji 4.0.10. Linki do aktualnych dystrybucji poszczególnych wersji systemu dLibra znajdują się poniżej (skąd można pobrać wersję narzędzia adekwatną do posiadanej wersji systemu dLibra):
| RSS Feed | ||
|---|---|---|
|
...
,
...
w
...
Narzędzie znajduje się w dystrybucji w katalogu binaries/dlibra-client-publication-files-uploader. Katalog ten zawiera następujące elementy:
lib- katalog zawierający potrzebne biblioteki do uruchomienia narzędziaconfig.xml- plik zawierający informacje o serwerze do którego narzędzie dodawania plików ma się podłączyćusers.xml- informacje o użytkownikach w imieniu których narzędzie będzie dodawało pliki do publikacji planowanejobiektu planowanego.run.bat- skrypt uruchamiający narzędzie w środowisku systemów z rodziny Windowsrun.sh- skrypt uruchamiający narzędzie w środowisku systemów z rodziny Linux
Do uruchomienia narzędzia do dodawania plików do publikacji planowanej wymagana jest zainstalowana maszyna wirtualna Javy autorstwa firmy Sun w wersji 1.8 lub nowszej. Zazwyczaj po aktualizacji systemu dLibra nie jest potrzebne ponowne pobranie plików narzędzia (chyba że narzędzie przestanie działać).
Konfiguracja narzędzia
Plik config.xml
...
Domyślny plik wygląda następująco:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>
Configuration file for files uploader.
Properties in this file specify: server host and server port.
1. Server host
In order to specify server host place an entry which has 'server' as a key. Value specified for this key determines the server host used by the files uploader.
2. Server port
In order to speciy server port place an entry which has 'port' as a key. Value specified for this key determines the server port user by the files uploader.
</comment>
<entry key="server">localhost</entry>
<entry key="port">10051</entry>
</properties>
|
Jak widać na przykładzie narzędzie będzie podłączało się do lokalnego komputera ( localhost }) na porcie {{ 10051.
Plik users.xml
W pliku users.xml znajdują się informacje o użytkownikach w imieniu których narzędzie będzie w stanie dodawać pliki publikacjiobiektu. Jest to prosty plik XML, który definiuje właściwości gdzie kluczem jest login użytkownika a wartością hasło dostępu do jego konta. Przykładowy plik przedstawiono poniżej:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>
Configuration file for files uploader.
Properties in this file specify information about users on behalf of which this files uploader works
Each entry in this file is composed of key and value. Key indicates user login and value indicates password for this user.
</comment>
<entry key="jkowalski">mojehaslo</entry>
</properties>
|
...
Skrypty run.bat oraz run.sh mają dwa parametry. Pierwszym jest ścieżka do pliku głównego publikacjiobiektu. Drugim jest wartość true lub false oznaczająca czy po dodaniu plików nowo stworzone wydanie ma być opublikowane (true) czy nie (false).
Pierwszy parametr poza wskazaniem pliku głównego ma jeszcze dodatkowe znaczenie ponieważ poszczególne elementy ścieżki określają użytkownika w imieniu którego pliki mają być dodane oraz identyfikator publikacji planowanejobiektu planowanego. Ścieżka ta składa się z następujących elementów:
...
<PREFIX>to pierwsza część ścieżki nieistotna z punktu widzenia narzędzia<USER_ID>jest katalogiem którego nazwa jest loginem użytkownika w imieniu którego narzędzie ma dodać pliki publikacjiobiektuoutjest katalogiem zawierającym publikacje obiekty danego użytkownika<PUB_ID>jest katalogiem którego nazwa jest identyfikatorem publikacji planowanej obiektu planowanego do której którego mają zostać dodane pliki publikacjiobiektu; zawiera wszystkie pliki publikacjiobiektu<MAIN_FILE_NAME>jest nazwą pliku głównego publikacji
...
W pierwszym parametrze prefiksem jest C:\pliki, loginem użytkownika jest jkowalski, identyfikatorem publikacji planowanej obiektu planowanego jest 223 natomiast plik główny publikacji obiektu to directory.djvu.
Po wykonaniu tej komendy narzędzie doda do publikacji planowanej obiektu planowanego o identyfikatorze 223 wszystkie pliki z katalogu C:\pliki\jkowalski\out\223. Plikiem głównym publikacji obiektu będzie directory.djvu natomiast publikacja obiekt zostanie dodana dodany w imieniu użytkownika jkowalski.