Opisywane narzędzie służy do dodawania plików do publikacji planowanej. Pliki jakie mają zostać dodane, użytkownika w imieniu którego pliki będą dodawane oraz publikację do której 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:
W wyniku tych operacji w bibliotece cyfrowej pojawia się normalna publikacja utworzona poprzez automatyczne dodanie plików publikacji. Dzięki temu redaktor może skupić się na wyborze publikacji 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 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):
Proszę pamiętać, że opisywane narzędzie dostępne jest dla systemu dLibra w wersji 4.0.10 lub nowszej. |
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 planowanej.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 Linuxconfig.xml
Plik config.xml
jest plikiem XML w którym zapisane są informacje wskazujące na serwer dLibra do którego narzędzie ma zostać podłączone. W pliku można zdefiniować dwie właściwości:
server
)port
)Domyślny plik wygląda następująco:
<?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
.
users.xml
W pliku users.xml
znajdują się informacje o użytkownikach w imieniu których narzędzie będzie w stanie dodawać pliki publikacji. 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:
<?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> |
W pliku zdefiniowano dane dostępowe dla jednego użytkownika - login jkowalski
oraz jego hasło mojehaslo
.
Skrypty run.bat
oraz run.sh
mają dwa parametry. Pierwszym jest ścieżka do pliku głównego publikacji. 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 planowanej. Ścieżka ta składa się z następujących elementów:
<PREFIX>
/<USER_ID>
/out
/<PUB_ID>
/<MAIN_FILE_NAME>
I tak:
<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 publikacjiout
jest katalogiem zawierającym publikacje danego użytkownika<PUB_ID>
jest katalogiem którego nazwa jest identyfikatorem publikacji planowanej do której mają zostać dodane pliki publikacji; zawiera wszystkie pliki publikacji<MAIN_FILE_NAME>
jest nazwą pliku głównego publikacjiPrzykładowe wykonanie skryptu wygląda następująco:
run C:\pliki\jkowalski\out\223\directory.djvu true |
W pierwszym parametrze prefiksem jest C:\pliki
, loginem użytkownika jest jkowalski
, identyfikatorem publikacji planowanej jest 223
natomiast plik główny publikacji to directory.djvu
.
Po wykonaniu tej komendy narzędzie doda do publikacji planowanej o identyfikatorze 223
wszystkie pliki z katalogu C:\pliki\jkowalski\out\223
. Plikiem głównym publikacji będzie directory.djvu
natomiast publikacja zostanie dodana w imieniu użytkownika jkowalski
.