3.4. Zaawansowane zadania redaktora

Podrozdział ten opisuje typowe zaawansowane zadania redaktora biblioteki cyfrowej.

3.4.1. Tryby działania (widoki) programu redaktora

W programie redaktora możliwe są dwa tryby działania:

  • Tryb prosty

  • Tryb zaawansowany

Domyślnie włączony jest tryb prosty. Aby przełączyć się do trybu zaawansowanego należy wybrać opcję Tryb zaawansowany z menu Widok. Aby powrócić do trybu prostego należy ponownie wybrać opcję Tryb zaawansowany z menu Widok.

Różnice pomiędzy trybami działania (widokami) programu redaktora przedstawia Tabela 3.1..

Tabela 3.1. Różnice pomiędzy trybami działania programu redaktora

Właściwość \ TrybTryb prostyTryb zaawansowany
Węzeł publikacji
  • Jeżeli publikacja posiada tylko jedno wydanie to po jej otworzeniu nie jest ono widoczne - po otworzeniu publikacji widoczne są tylko wersje plików składających się na to wydanie publikacji. Wszystkie właściwości dotyczące wydania i publikacji można modyfikować na zakładkach okna właściwości po zaznaczeniu publikacji na liście elementów,

  • Jeżeli publikacja posiada więcej niż jedno wydanie to po jej otworzeniu widoczne są jej wydania (tak samo jak w trybie zaawansowanym) oraz węzeł plików publikacji. Po zaznaczeniu takiej publikacji na liście elementów, na zakładkach okna właściwości można modyfikować tylko właściwości publikacji. Aby wyświetlić/modyfikować właściwości wydań tej publikacji należy ją otworzyć, a następnie wybrać na liście elementów wydanie, którego właściwości mają być wyświetlone/modyfikowane (właściwości wydania pojawią się na zakładkach okna właściwości).

Po otworzeniu publikacji widoczne są wszystkie jej wydania. Wersje plików wchodzących w skład konkretnego wydania widoczne są po otworzeniu tego wydania. Poza wydaniami na liście znajduje się również węzeł plików publikacji (znajdują się w nim wszystkie pliki związane z publikacją).

3.4.2. Pobieranie plików wydania publikacji

Aby dokonać dalszej edycji istniejącej już publikacji, redaktor musi pobrać jej pliki na swój lokalny komputer.

Aby pobrać wydanie publikacji:

  1. Na liście elementów należy wybrać wydanie do pobrania (może to być również wydanie aktualne).

  2. Z menu kontekstowego należy wybrać funkcję Pobierz. Można także użyć przycisku na pasku narzędzi lub pozycji Pobierz z menu Publikacja.

  3. W pierwszym kroku kreatora ( Rysunek 3.30.) należy wybrać katalog na dysku lokalnym, w którym zapisane zostaną pliki publikacji.

    W tabeli Pliki od pobrania można zmienić domyślny wybór plików do pobrania. Aby wykluczyć plik z listy plików do pobrania, należy odznaczyć odpowiednią pozycję w kolumnie Pobierz. Wersję pliku do pobrania można zmienić wykorzystując listę rozwijaną w kolumnie Wersja.

    Możliwe jest pobranie publikacji w postaci archiwum zip. W tym celu należy zaznaczyć pole Pobierz spakowaną publikację.

    Aby przejść do strony pobierania pliku, należy wybrać przycisk Dalej.

    Rysunek 3.30. Kreator Pobierania - strona wyboru pliku publikacji

    Kreator Pobierania - strona wyboru pliku publikacji
  4. W kroku drugim ( Rysunek 3.31.), aby rozpocząć pobieranie wybranych plików publikacji do wskazanego w kroku pierwszym katalogu na dysku lokalnym, należy wybrać przycisk Start. Proces ten można przerywać i wznawiać, ponownie wciskając ten sam przycisk.

    Po zakończeniu pobierania należy wybrać przycisk Zakończ, aby zamknąć okno kreatora.

    Rysunek 3.31. Kreator pobierania - strona pobierania plików

    Kreator pobierania - strona pobierania plików

3.4.3. Dodawanie nowych wersji plików

W sytuacji kiedy autor opublikowanej już pozycji zmodyfikuje/zaktualizuje jej treść, występuje konieczność aktualizacji tej pozycji w systemie dLibra (zmodyfikowane pliki należy przesłać na serwer). Po tej operacji dokonane zmiany będą mogły być widoczne w bibliotece (np. dla czytelnika WWW po stworzeniu nowego wydania na podstawie nowo dodanych plików).

Aby przesłać nowe wersje plików na serwer:

  1. Należy przełączyć aplikację na zaawansowany tryb pracy, a następnie na liście elementów należy otworzyć publikację, do której mają być dodane nowe wersje plików i zaznaczyć element Pliki publikacji.

  2. Z menu kontekstowego należy wybrać funkcję Dodaj nowe wersje plików....

  3. W Kreatorze dodawania nowych wersji plików należy wybrać katalog na dysku lokalnym zawierający zaktualizowane pliki publikacji.

    Katalog ten musi zawierać plik główny publikacji. Pliki publikacji których brakuje na dysku oznaczane są jako .

    Kreator dodawania nowych wersji plików wybiera pliki do aktualizacji według dat modyfikacji i przechowywania. Domyślnie wybierane są pliki modyfikowane po ostatniej operacji przechowaj/dodaj. Wybór ten można zmienić przez zaznaczenie lub odznaczenie odpowiednich pozycji w kolumnie Dodaj. Możliwe jest również dodanie nowego pliku poprzez odpowiadające mu pole wyboru w kolumnie Dodaj

    Aby przejść do przesyłania plików do serwera, należy wybrać przycisk Dalej.

    Rysunek 3.32. Kreator Aktualizacji - strona katalogu zaktualizowanych plików

    Kreator Aktualizacji - strona katalogu zaktualizowanych plików
  4. Aby umieścić wybrane pliki publikacji na serwerze, należy wybrać przycisk Start . Proces można przerwać i wznowić poprzez ponowne wybranie tego przycisku.

    Po zakończeniu procesu umieszczania plików na serwerze, należy wybrać przycisk Zakończ, aby zamknąć okno kreatora.

    Rysunek 3.33. Kreator Aktualizacji - umieszczanie plików na serwerze

    Kreator Aktualizacji - umieszczanie plików na serwerze

3.4.4. Tworzenie/usuwanie wydania publikacji

Wydanie jest widzialną formą publikacji - aby publikację udostępnić czytelnikom, trzeba stworzyć i opublikować jej wydanie.

Aby stworzyć wydanie publikacji:

  1. Na liście elementów należy wybrać wydanie (np. wydanie aktualne), na którym ma się opierać nowe wydanie.

  2. Z menu kontekstowego należy wybrać funkcję Nowe wydanie.... Można też wykorzystać przycisk na pasku narzędzi lub opcję z menu rozwijanego.

  3. W Kreatorze Nowego Wydania należy wybrać wersje plików publikacji, z których ma się składać nowe wydanie.

    Kiedy nowe wydanie opiera się wydaniu aktualnym publikacji, wybierane są najnowsze wersje plików umieszczone na gałęzi. Kiedy nowe wydanie opiera się na istniejącym wydaniu publikacji, wybrane wersje plików są takie same jak w wydaniu podstawowym.

    Można dokonać zmiany wyboru wersji plików używając listy rozwijanej z kolumny Wersja w tabeli plików Wydania.

    Aby przejść do strony opisu bibliograficznego wydania, należy wybrać przycisk Dalej.

    Rysunek 3.34. Kreator Nowego Wydania - strona wyboru wersji plików

    Kreator Nowego Wydania - strona wyboru wersji plików
  4. W tym kroku należy wprowadzić opis bibliograficzny nowego wydania. Możliwy jest oczywiście import opisu zarówno z pliku w formacie MARC 21 lub RDF.

    Aby przejść do następnego kroku, należy wybrać przycisk Dalej.

    Rysunek 3.35. Kreator Nowego Wydania - strona opisu bibliograficznego wydania

    Kreator Nowego Wydania - strona opisu bibliograficznego wydania
  5. W kolejnym kroku należy wprowadzić informacje WWW dotyczące nowego wydania. Informacje te to opis wydania widoczny na liście z wynikami wyszukiwania, komentarz do wydania dostępny po wyświetleniu informacji na temat wydania oraz miniatura wydania znajdująca się na stronie z informacjami o wydaniu.

    Aby przejść do następnego kroku, należy wybrać przycisk Dalej.

    Rysunek 3.36. Kreator Nowego Wydania - strona informacji WWW

    Kreator Nowego Wydania - strona informacji WWW
  6. W polach Nazwa i Opis należy wpisać nazwę i opis nowego wydania. Aby opublikować nowe wydanie, należy zaznaczyć opcję Opublikowane. Można to również zrobić już po stworzeniu wydania.

    Aby stworzyć nowe wydanie, należy wybrać przycisk Zakończ.

    Rysunek 3.37. Kreator Nowego Wydania - strona własności wydania

    Kreator Nowego Wydania - strona własności wydania

Aby usunąć wydanie spełnione muszą być dwa warunki:

  • Wydanie nie może być jedynym wydaniem publikacji,

  • wydanie nie może być opublikowane.

Wydanie usuwamy wybierając opcję Usuń z menu podręcznego.

3.4.5. Porządkowanie plików publikacji

Porządkując pliki publikacji możemy wykorzystywać trzy mechanizmy. Pierwszym z nich jest usuwanie wersji pliku. Usunięcie wersji pliku możliwe jest wtedy gdy dana wersja nie jest jedyną wersją pliku oraz gdy nie należy ona do żadnego wydania. Drugim mechanizmem jest usuwanie pliku. Plik można usunąć gdy żadna z jego wersji nie należy do żadnego wydania. Trzecim mechanizmem jest automatyczne usuwanie zbędnych plików publikacji. Zbędne pliki publikacji to wersje plików oraz pliki, które można usunąć. Aby usunąć zbędne pliki publikacji należy wybrać opcję Usuń zbędne pliki... z menu kontekstowego elementu Pliki publikacji (widoczny po otworzeniu publikacji, tylko w trybie zaawansowanym).

3.4.6. Masowe ładowanie publikacji

3.4.6.1. Kreator masowego ładowania publikacji

Aby uruchomić kreator masowego ładowania publikacji należy wybrać pozycję Masowe ładowanie publikacji z menu Narzędzia.

  1. W pierwszym kroku kreatora określamy publikacje, które zostaną przesłane do serwera.

    Okno pierwszego kroku kreatora ( Rysunek 3.38.) podzielone jest na dwie części: z lewej strony umieszczone jest drzewo katalogów systemowych, z prawej lista publikacji do przesłania na serwer. Aby dodać publikacje do listy publikacji do przesłania na serwer należy:

    1. Na drzewie katalogów systemowych zaznaczyć katalog zawierający podkatalogi opisujące publikacje (informacje na temat struktury katalogu opisującego publikację znajdują się w kolejnym podrozdziale).

    2. Nacisnąć przycisk oznaczony przez . Po wykonaniu tej czynności aplikacja sprawdzi poprawność struktury katalogów opisujących publikacje. W razie błędów wyświetlone zostaną stosowne komunikaty.

    Po dodaniu conajmniej jednej publikacji do przesłania możliwe jest przejście do kolejnego kroku.

    Rysunek 3.38. Kreator masowego ładowania publikacji - wybór publikacji do przesłania

    Kreator masowego ładowania publikacji - wybór publikacji do przesłania
  2. W drugim kroku kreatora ( Rysunek 3.39.) przesyłamy publikacje na serwer. Aby przesłać publikacje na serwer należy nacisnąć przysick Start. W trakcie przesyłania wyświetlane są informacje na temat postępu przesyłania. Po przesłaniu publikacji wyświetlane jest podsumowanie. Jeżeli z jakiegoś powodu przesyłanie jednej lub więcej publikacji nie powiodło się możliwe jest sprawdzenie komunikatów o błędach na stronie z podsumowaniem naciskając przycisk Szczegóły błędów... .

    Rysunek 3.39. Kreator masowego ładowania publikacji - przesyłanie publikacji

    Kreator masowego ładowania publikacji - przesyłanie publikacji

3.4.6.2. Struktura katalogu opisującego publikację

Katalog opisujący publikację składa się z:

  • Pliku publication.properties opisującego publikację,

  • Opcjonalnego pliku RDF z opisem bibliograficznym publikacji,

  • Plików, które wchodzą w skład publikacji.

3.4.6.2.1. Plik publication.properties

Plik publication.properties jest plikiem właściwości publikacji. Składa się on z par atrybut—wartość. Atrybut oddzielony jest od wartości znakiem równości (=). Każda taka para znajduje się w oddzielnej linii.

Dozwolone atrybuty oraz ich wartości przedstawione są poniżej.

  • Atrybut publication.actorsRights.<login użytkownika lub nazwa grupy do której przydzielamy prawa>

    Prawa oddzielone przecinkiem. Lista możliwych praw (zobacz ):

    • pv – przeglądanie publikacji

    • pr – odczyt publikacji

    • pe – zarządzanie publikacją

  • Atrybut publication.collections

    Identyfikatory kolekcji, oddzielone przecinkiem, do których ma zostać przypisana publikacja.

  • Atrybut publication.destination.directoryId

    Identyfikator katalogu, w którym ma się znaleźć publikacja.

  • Atrybut publication.destination.parentPublicationId

    Identyfikator publikacji grupowej, w której ma się znaleźć publikacja.

  • Atrybut publication.mainFile

    Nazwa pliku głównego publikacji (wraz z rozszerzeniem). Plik główny musi znajdować się w katalogu opisującym publikację.

  • Atrybut publication.metadataFile

    Nazwa pliku metadanych (wraz z rozszerzeniem). Plik metadanych musi być zgodny z formatem RDF oraz znajdować się w katalogu opisującym publikację. Domyślnie nazwa pliku metadanych jest taka sama jak pliku głównego z rozszerzeniem .rdf

  • Atrybut publication.name

    Łańcuch znaków określający nazwę publikacji.

  • Atrybut publication.notes

    Łańcuch znaków określający notatki/uwagi administracyjne.

  • Atrybut publication.published

    Łańcuch znaków wskazujący na to, czy pierwsze wydanie tej publikacji ma zostać opublikowane. Jeśli wartość jest true wydanie to będzie opublikowane. W każdym innym przypadku wydanie nie będzie opublikowane. Domyślną wartością jest false.

  • Atrybut publication.secured

    Łańcuch znaków wskazujący na to, czy publikacja ma być zabezpieczona. Jeśli wartość jest true publikacja będzie zabezpieczona. W każdym innym przypadku publikacja nie będzie zabezpieczona.Domyślną wartością jest false.

  • Atrybut edition.image.content

    Nazwa pliku, który zawiera miniaturę wydania.

Przykładowy plik publication.properties:

publication.actorsRights.publicGroup=pv,pr
publication.collections=2,7,12
publication.destination.directoryId=1
publication.mainFile=index.htm
publication.metadataFile=metadata.rdf
publication.name=Przykładowa publikacja
publication.notes=Stworzone przez Jana Kowalskiego
publication.published=true                    

Powyższy przykład pliku specyfikuje publikację, do której aktor publicGroup będzie miał prawo przeglądania (pv) oraz odczytu (pr). Publikacja zostanie przypisana do kolekcji oznaczonych identyfikatorem 2, 7 oraz 12. Publikacja znajdzie się w katalogu o identyfikatorze 1. Plikiem głównym publikacji będzie index.htm, a opis metadanych znajduje się w pliku metadata.rdf. Nazwa publikacji to „Przykładowa publikacja”, a notatki administracyjne to „Stworzone przez Jana Kowalskiego”. Pierwsze wydanie nowo stworzonej publikacji będzie opublikowane, a sama publikacja nie będzie zabezpieczona.

Aby możliwe było stworzenie publikacji wymagany jest minimalny zbiór informacji. Jeśli nie jest możliwe uzyskanie choćby jednej z informacji, nie jest możliwe stworzenie publikacji. Minimalny zbiór informacji:

  • Umiejscowienie publikacji w drzewie katalogów systemu dLibra. Możliwe są dwa przypadki: specyfikacja katalogu docelowego (atrybut publication.destination.directoryId ) i specyfikacja docelowej publikacji grupowej (atrybut publication.destination.parentPublicationId ) lub specyfikacja jedynie katalogu docelowego.

  • Plik główny publikacji. Specyfikuje go atrybut publication.mainFile i jest on wymagany.

  • Nazwa publikacji. Specyfikacja nazwy publikacji możliwa jest na dwa sposoby. Pierwszy sposób to specyfikacja atrybutu publication.name. Jeżeli atrybut ten nie jest wyspecyfikowany, zostanie sprawdzony plik metadanych w celu skomponowania nazwy publikacji tak jak w przypadku kroku 4 kreatora nowej publikacji. Zatem plik metadanych jest drugim sposobem.

3.4.6.2.2. Dziedziczenie plików publication.properties

Mechanizm dziedziczenia został wprowadzony w celu ułatwienia grupowego przypisywania wartości atrybutów z plików publication.properties

Mechanizm dziedziczenia działa w następujący sposób: Dla każdego pliku publication.properties, który ma zostać wczytany (nazwijmy go „dzieckiem”) sprawdzane jest czy istnieje plik publication.properties w katalogu nadrzędnym (nazwijmy go „rodzicem”). Jeżeli plik „rodzica” istnieje, wczytywana jest jego zawartość, a następnie wczytywana jest zawartość pliku „dziecka”. W trakcie wczytywania przyjęta jest taka zasada, że wartości atrybutów są nadpisywane. Oznacza to, że jeżeli zarówno plik „rodzica” jak i „dziecka” specyfikuje ten sam atrybut, brana pod uwagę jest wartość atrybutu dziecka (następuje nadpisanie wartości wyspecyfikowanych w pliku „rodzica” wartościami z pliku „dziecka”).

Zauważmy, że mechanizm ten działa rekursywnie. Oznacza to, że zanim zostanie wczytany plik „rodzica” wczytywany jest najpierw jego „rodzic” (jeśli taki istnieje).

3.4.6.2.3. Dziedziczenie plików metadanych

Mechanizm ten działa tak samo jak w przypadku dziedziczenia plików publication.properties z tym wyjątkiem, że plik „rodzica” nazywać się powinien publication.rdf.

Zatem jeśli wyspecyfikujemy w pliku publication.properties atrybut publication.metadataFile, zostanie sprawdzone czy istnieje jego „rodzic” (publication.rdf), itd.

3.4.6.2.4. Przykładowy plik właściwości

Używając Zapisz plik właściwości z menu Narzędzia możliwe jest zapisanie informacji opisujących publikację wybraną na liście elementów do pliku (plik taki może służyć jako wzór pliku jaki powinien znaleźć się w katalogu opisującym publikację dla masowego ładowania publikacji).

3.4.7. Konfiguracja programu redaktora

Po wybraniu opcji Konfiguracja z menu Program pojawi się okno konfiguracji programu ( Rysunek 3.40.).

Rysunek 3.40. Okno konfiguracji programu

Okno konfiguracji programu

W oknie konfiguracji znajdują się zakładki odpowiadające za konfigurację różnych cech programu. W kolejnych podrozdziałach omówione są wszystkie zakładki. Wartości domyślne poszczególnych parametrów znajdują się w załączniku konfiguracja domyślna.

3.4.7.1. Ustawienia programu

Na zakładce Ustawienia programu możliwe jest dostosowanie widoku programu redaktora. Konfiguracja w tym miejscu jest ściśle połączona z trybami pracy programu redaktora. Jeżeli opcja Zawsze pokazuj wydania publikacji nie jest zaznaczona to program redaktora pracuje w trybie prostym. Jeśli sytuacja jest odwrotna to program pracuje w trybie zaawansowanym. Przełączając tryby z zaawansowanego na prosty i odwrotnie ustawiamy odpowiednio opisaną wyżej opcję. Znaczenie opcji opisane jest w Tabela 3.1..

Kolejna opcja konfiguracyjna to pole wyboru Automatycznie dodaj format pliku głównego do zaimportowanych metadanych. Jeżeli pole to jest zaznaczone to po każdym imporcie metadanych zostaną one wzbogacone o wartość formatu pliku głównego publikacji. Jeśli opcja ta nie jest zaznaczona to metadane nie są modyfikowane.

Pozostałe parametry konfiguracyjne mogą być pobierane z pliku konfiguracyjnego. Aby zmienić plik konfiguracyjny aplikacji wybierz przycisk Plik konfiguracyjny... i wskaż w otwartym oknie plik lub URL do pliku konfiguracyjnego. Należy pamiętać o zaznaczeniu pola Używaj konfiguracji z podanego źródła. Plik konfiguracyjny aplikacji zawiera zaawansowane parametry konfiguracyjne aplikacji. Jest to plik właściwości, gdzie klucze oddzielone są od wartości znakiem równości. Znajdują się w nim następujące parametry konfiguracyjne:

  • gui.lookandfeel - wartość to nazwa klasy języka programowania Java, która odpowiada za sposób wyświetlania/zachowania elementów interfejsu graficznego użytkownika. Jeśli brak tej wartości przyjmowany jest domyślny wygląd odpowiedni dla systemu operacyjnego na którym uruchomiono aplikację.

  • tags.refresh.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinna być odświeżana (aktualizowana z serwera) lista tagów w aplikacji. Domyślna wartość to 600000 czyli 10 minut.

  • tags.message.period - wartość to czas podawany w milisekundach, który mówi o tym co ile milisekund powinien być wyświetlany monit użytkownikowi w przypadku gdy ma on tagi, które powinny być poddane moderacji. Domyślna wartość to 1800000 czyli 30 minut.

  • newPublication.title.template - wartość określa szablon tytułu tworzonego elementu (np. publikacji). Szablon ten jest szablonem velocity. W szablonie w miejscu odpowiednio nazwanych zmiennych wprowadzane są wartości atrybutów. Zmienne powinny mieć nazwę odpowiadającą nazwie RDF atrybutu. Domyślna wartość tego parametru to $!{Creator}#if ( ($Date || $Title) && $Creator ), #end$!Date#if ( $Title && $Date ), #end$!Title. Przykładowo w miejscu $Creator zostanie wprowadzona wartość z atrybutu, którego nazwa RDF to Creator.

  • searchDuplicates.roles.url - wartość to adres URL pod którym znajduje się lista ról Dublin Core atrybutów, które mają być wykorzystywane w mechaniźmie wyszukiwania duplikatów. Domyślna wartość to http://fbc.pionier.net.pl/owoc/ajax.xml?id=GetDCRolesForDups.

  • searchDuplicates.results.url - wartość to początek adresu URL, do którego zostaną dodane parametry wyszukiwawcze w procesie wyszukiwania duplikatów. Domyślna wartość to http://fbc.pionier.net.pl/owoc/ajax.xml?id=GetDups.

  • sortTokens - wartość to lista ciągów znaków oddzielonych symbolem |. Są to ciągi znaków, które nie są brane pod uwagę na początku nazwy elementów podczas sortowania publikacji na liście elementów i drzewie katalogów. Domyślna wartość to "|(|[...]|[|the |the.

Przykładowy plik konfiguracji mógłby wyglądać następująco (jeśli w pliku nie ma jakiegoś klucza to przyjmowana jest wartość domyślna):

tags.refresh.period=60000
tags.message.period=3600000
sortTokens=[|]|/

3.4.7.2. Konfiguracja rozszerzeń

Zakładka Konfiguracja rozszerzeń umożliwia dostosowanie ustawień poszczególnych rozszerzeń. Na panelu ( Rysunek 3.41.) znajduje się lista rozszerzeń, które można konfigurować. Aby zmieniń ustawienia konkretnego rozszerzenia należy zaznaczyć je na liście i wybrać przycisk Konfiguruj.... Domyślnie w aplikacji znajdują się następujące rozszerzenia:

Rysunek 3.41. Konfiguracja - zakładka Konfiguracja rozszerzeń

Konfiguracja - zakładka Konfiguracja rozszerzeń