Date: Thu, 28 Mar 2024 12:37:17 +0100 (CET) Message-ID: <443576025.4777.1711625837846@gazella.mgmt.psnc> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_4776_818797444.1711625837846" ------=_Part_4776_818797444.1711625837846 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Opisywane narz=C4=99dzie s=C5=82u=C5=BCy do dodawania plik=C3=B3w do obi= ektu planowanego. Pliki jakie maj=C4=85 zosta=C4=87 dodane, u=C5=BCytkownik= a w imieniu kt=C3=B3rego pliki b=C4=99d=C4=85 dodawane oraz obiekt do kt=C3= =B3rego pliki zostan=C4=85 dodane wskazywane s=C4=85 w parametrach konfigur= acyjnych tego narz=C4=99dzia. Narz=C4=99dzie to uruchamiane jest z linii po= lece=C5=84 i jest dedykowane do wykorzystania w mechanizmach automatyzacji = pracy redaktor=C3=B3w biblioteki cyfrowej. Przyk=C5=82adowo mo=C5=BCe by=C4= =87 wykorzystany wtedy gdy mamy zdefiniowany taki oto proces pracy redaktor= a:
W wyniku tych operacji w bibliotece cyfrowej pojawia si=C4=99 normalny o= biekt utworzony poprzez automatyczne dodanie plik=C3=B3w obiektu. Dzi=C4=99= ki temu redaktor mo=C5=BCe skupi=C4=87 si=C4=99 na wyborze obiektu do skano= wania i skanowaniu odpowiednich dokument=C3=B3w. Reszt=C4=85 (od momenu zes= kanowania i przes=C5=82ania plik=C3=B3w) zajmuje si=C4=99 system automatyza= cji pracy redaktor=C3=B3w.
Narz=C4=99dzie znajduje si=C4=99 w ka=C5=BCdej wersji dystrybucji system=
u dLibra, w katalogu binaries/dlibra-client-publication-files-uploade=
r
. Katalog ten zawiera nast=C4=99puj=C4=85ce elementy:
lib
- katalog zawieraj=C4=85cy potrzebne biblioteki do uru=
chomienia narz=C4=99dziaconfig.xml
- plik zawieraj=C4=85cy informacje o serwerze d=
o kt=C3=B3rego narz=C4=99dzie dodawania plik=C3=B3w ma si=C4=99 pod=C5=82=
=C4=85czy=C4=87users.xml
- informacje o u=C5=BCytkownikach w imieniu kt=
=C3=B3rych narz=C4=99dzie b=C4=99dzie dodawa=C5=82o pliki do obiektu planow=
anego.run.bat
- skrypt uruchamiaj=C4=85cy narz=C4=99dzie w =C5=
=9Brodowisku system=C3=B3w z rodziny Windowsrun.sh
- skrypt uruchamiaj=C4=85cy narz=C4=99dzie w =C5=9B=
rodowisku system=C3=B3w z rodziny LinuxDo uruchomienia narz=C4=99dzia do dodawania plik=C3=B3w do publikacji pl= anowanej 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=C3=B3w narz=C4=99dzia (chyba =C5=BCe = narz=C4=99dzie przestanie dzia=C5=82a=C4=87).
config.xml
Plik config.xml
jest plikiem XML w kt=C3=B3rym zapisane s=
=C4=85 informacje wskazuj=C4=85ce na serwer dLibra do kt=C3=B3rego narz=C4=
=99dzie ma zosta=C4=87 pod=C5=82=C4=85czone. W pliku mo=C5=BCna zdefiniowa=
=C4=87 dwie w=C5=82a=C5=9Bciwo=C5=9Bci:
server
)port
)Domy=C5=9Blny plik wygl=C4=85da nast=C4=99puj=C4=85co:
<?xml= version=3D"1.0" encoding=3D"UTF-8"?> <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <comment> Configuration file for files uploader.=20 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. Va= lue specified for this key determines the server port user by the files upl= oader. </comment> <entry key=3D"server">localhost</entry> <entry key=3D"port">10051</entry> </properties>
Jak wida=C4=87 na przyk=C5=82adzie narz=C4=99dzie b=C4=99dzie pod=C5=82=
=C4=85cza=C5=82o si=C4=99 do lokalnego komputera localhost
na =
porcie 10051
.
users.xml
W pliku users.xml
znajduj=C4=85 si=C4=99 informacje o u=C5=
=BCytkownikach w imieniu kt=C3=B3rych narz=C4=99dzie b=C4=99dzie w stanie d=
odawa=C4=87 pliki obiektu. Jest to prosty plik XML, kt=C3=B3ry definiuje w=
=C5=82a=C5=9Bciwo=C5=9Bci gdzie kluczem jest login u=C5=BCytkownika a warto=
=C5=9Bci=C4=85 has=C5=82o dost=C4=99pu do jego konta. Przyk=C5=82adowy plik=
przedstawiono poni=C5=BCej:
<?xml= version=3D"1.0" encoding=3D"UTF-8"?> <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <comment> Configuration file for files uploader.=20 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 lo= gin and value indicates password for this user. </comment> <entry key=3D"jkowalski">mojehaslo</entry> </properties>
W pliku zdefiniowano dane dost=C4=99powe dla jednego u=C5=BCytkownika - =
login jkowalski
oraz jego has=C5=82o mojehaslo
.=
p>
Skrypty run.bat
oraz run.sh
maj=C4=85 dwa para=
metry. Pierwszym jest =C5=9Bcie=C5=BCka do pliku g=C5=82=C3=B3wnego obiektu=
. Drugim jest warto=C5=9B=C4=87 true
lub false
oz=
naczaj=C4=85ca czy po dodaniu plik=C3=B3w nowo stworzone wydanie ma by=C4=
=87 opublikowane (true
) czy nie (false
).
Pierwszy parametr poza wskazaniem pliku g=C5=82=C3=B3wnego ma jeszcze doda=
tkowe znaczenie poniewa=C5=BC poszczeg=C3=B3lne elementy =C5=9Bcie=C5=BCki =
okre=C5=9Blaj=C4=85 u=C5=BCytkownika w imieniu kt=C3=B3rego pliki maj=C4=85=
by=C4=87 dodane oraz identyfikator obiektu planowanego. =C5=9Acie=C5=BCka =
ta sk=C5=82ada si=C4=99 z nast=C4=99puj=C4=85cych element=C3=B3w:
<PREFIX>
/<USER_ID>
/out
/<PUB_ID>
/<MAIN_FILE_NAME>
I tak:
<PREFIX>
to pierwsza cz=C4=99=C5=9B=C4=87 =C5=9Bcie=
=C5=BCki nieistotna z punktu widzenia narz=C4=99dzia<USER_ID>
jest katalogiem kt=C3=B3rego nazwa jest lo=
ginem u=C5=BCytkownika w imieniu kt=C3=B3rego narz=C4=99dzie ma doda=C4=87 =
pliki obiektuout
jest katalogiem zawieraj=C4=85cym obiekty danego u=C5=
=BCytkownika<PUB_ID>
jest katalogiem kt=C3=B3rego nazwa jest ide=
ntyfikatorem obiektu planowanego do kt=C3=B3rego maj=C4=85 zosta=C4=87 doda=
ne pliki obiektu; zawiera wszystkie pliki obiektu<MAIN_FILE_NAME>
jest nazw=C4=85 pliku g=C5=82=C3=B3=
wnego publikacjiPrzyk=C5=82adowe wykonanie skryptu wygl=C4=85da nast=C4=99puj=C4=85co:= p>
run C:\= pliki\jkowalski\out\223\directory.djvu true
W pierwszym parametrze prefiksem jest C:\pliki
, loginem u=
=C5=BCytkownika jest jkowalski
, identyfikatorem obiektu planow=
anego jest 223
natomiast plik g=C5=82=C3=B3wny obiektu to
Po wykonaniu tej komendy narz=C4=99dzie doda do obiektu planowanego o iden=
tyfikatorze 223
wszystkie pliki z katalogu C:\pliki\jkow=
alski\out\223
. Plikiem g=C5=82=C3=B3wnym obiektu b=C4=99dzie d=
irectory.djvu
natomiast obiekt zostanie dodany w imieniu u=C5=BCytko=
wnika jkowalski
.