...
Plik publication.properties
jest plikiem właściwości publikacji. Składa się on z par klucz-wartość. Klucz, czyli nazwa właściwości, oddzielony jest od wartości znakiem równości (=). Każda taka para znajduje się w oddzielnej linii. Plik powinien być zapisany w kodowaniu UTF-8.
Dozwolone właściwości kluczy oraz ich wartości przedstawione są poniżej.
- Klucz
publication.actorsRights.<login użytkownika lub nazwa grupy do której przydzielamy prawa>
.
Prawa oddzielone przecinkiem. Uwaga: jeśli login zawiera spacje, muszą one zostać poprzedzone znakiem '\'.
Lista możliwych praw (szczegółowe informacje o prawach można znaleźć tutaj):pv
- dostęp tylko do opublikowanych wydań publikacjipr
- dostęp do wszystkich wydań publikacjipe
- zarządzanie publikacją
- Klucz
publication.collections
Identyfikatory kolekcji, oddzielone przecinkiem, do których ma zostać przypisana publikacja. - Klucz
publication.destination.directoryId
Identyfikator katalogu, w którym ma się znaleźć publikacja. - Klucz
publication.destination.parentPublicationId
Identyfikator publikacji grupowej, w której ma się znaleźć publikacja. - Klucz
publication.mainFile
Nazwa pliku głównego publikacji (wraz z rozszerzeniem). Plik główny musi znajdować się w katalogu opisującym publikację. W przypadku publikacji wielofromatowej, zamiast tego klucza powinny być zdefiniowane wartościpublication.mainFormat
oraz przynajmniej jednej wartościpublication.mainFile.<format>
. - Klucz
publication.mainFile.<format>
Nazwa/ścieżka pliku głównego w wybranym formacie. Wszystkie pliki danego formatu powinny znajdować się w podkatalogu o nazwie takiej jak format, np. PDF. Wartość klucza również musi zawierać nazwę katalogu. - Klucz
publication.mainFormat
Nazwa formatu, który ma być uznawany za główny (wyświetlany domyślnie jako pierwszy). - Klucz
publication.metadataFile
Nazwa pliku metadanych (wraz z rozszerzeniem). Plik metadanych musi znajdować się w katalogu opisującym publikację oraz być zgodny z jednym z formatów obsługiwanych przez aktualnie zainstalowane rozszerzenia do importu metadanych (zwykle jest to RDF, MARC lub Bibtex - zobacz rozdział Import i eksport metadanych). Jeśli wartość dla tego klucza nie jest zdefiniowana, domyślnie wyszukiwane są pliki o nazwie takiej samej jak nazwa pliku głównego, z rozszerzeniami domyślnymi dla każdego obsługiwanego formatu (np..rdf
,.mrc
,.bib
). - Klucz
publication.name
Łańcuch znaków określający nazwę publikacji. Jeśli wartość dla tego klucza nie zostanie zdefiniowana, aplikacja spróbuje wygenerować nazwę na podstawie wartości atrybutów (w taki sam sposób, jak w drugim kroku kreatora nowej publikacji).
Uwaga: Wartość ta określa również nazwę wydania. Przy dodawaniu treści do publikacji planowanej należy również uzupełnić tę wartość. - Klucz
publication.notes
Łańcuch znaków określający notatki/uwagi administracyjne. - Klucz
publication.published
Łańcuch znaków wskazujący na to, czy pierwsze wydanie tej publikacji ma zostać opublikowane. Jeśli wartość jesttrue
wydanie to będzie opublikowane. W każdym innym przypadku wydanie nie będzie opublikowane. Domyślną wartością jestfalse
. - Klucz
publication.secured
Łańcuch znaków wskazujący na to, czy publikacja ma być zabezpieczona. Jeśli wartość jesttrue
publikacja będzie zabezpieczona. W każdym innym przypadku publikacja nie będzie zabezpieczona.Domyślną wartością jestfalse
. - Klucz
image.content
Nazwa pliku, który zawiera miniaturę wydania. - Klucz
publication
.publishingDate
Planowana data udostępnienia publikacji, np.2020-02-29
- Klucz
publication.id
Identyfikator publikacji (obiektu) do aktualizacji (zob.update.mode
poniżej). - Klucz
edition.id
Identyfikator wydania (wersji obiektu) do aktualizacji (zob.update.mode
poniżej). - Klucz
edition.externalId
Zewnętrzny identyfikator powiązany z wydaniem (wersją obiektu). Wartość ta nie jest używana przez system dLibra, ale jest przechowywana w bazie danych, więc może być wykorzystana przez zewnętrzne narzędzia operujące na bazie. Identyfikator ten może też służyć do wskazania wydania (wersji obiektu) do aktualizacji (zob.update.mode
poniżej).. publication.registerDOI
Łańcuch znaków wskazujący na to, czy przy tworzeniu publikacji ma nastąpić automatyczna rejestracja numeru DOI. Jeśli wartość jesttrue
, nastąpi próba rejestracji numeru DOI. W każdym innym przypadku nie zostanie wywołana żadna dodatkowa akcja. Domyślą wartością jest false.publication.forceDOI
Istniejący numer DOI powiązany z publikacją.- Klucz
update.mode
Pozwala zdefiniować tryb aktualizacji istniejącego obiektu. Wartość powinna zawierać wybrane opcje rozdzielane przecinkiem, np.replaceContent,addMetadata
. Jednocześnie z tym kluczem musi być wskazany identyfikator istniejącego obiektu docelowego, przy pomocy jednego z kluczy:publication.id
,edition.id
, lubedition.externalId
. Możliwe opcje aktualizacji to:addMetadata
- dodaje do opisu obiektu metadane załadowane z pliku wskazanego przezpublication.metadataFile
, bez usuwania wcześniej przypisanych wartości. Nie może być użyte jednocześnie zreplaceMetadata
.replaceMetadata
- zastępuje opis obiektu metadanymi załadowanymi z pliku wskazanego przezpublication.metadataFile
. Nie może być użyte jednocześnie zaddMetadata
.addContent
- dodaje do obiektu pliki treści z aktualnego katalogu, bez usuwania wcześniej istniejących plików (starsze pliki zostaną nadpisane, jeśli mają takie same nazwy jak nowe pliki). Jako plik główny publikacji ustawia zawsze plik wskazany przezpublication.mainFile
. Opcja nie może być użyta jednocześnie zreplaceContent
.replaceContent
- zastępuje wszystkie pliki z treścią w obiekcie plikami z aktualnego katalogu. Nie może być użyte jednocześnie zaddContent
.addRights
- dodaje do zbioru praw przypisanych do obiektu prawa zdefiniowane przez kluczepublication.actorsRights.*
. Nie może być użyte jednocześnie zreplaceRights
.replaceRights
- przypisuje do obiektu prawa zdefiniowane przez kluczepublication.actorsRights.*
, usuwając prawa przypisane wcześniej. Nie może być użyte jednocześnie zaddRights
.addCollections
- dodaje obiekt do kolekcji wskazanych przezpublication.collections
, bez usuwania z kolekcji przypisanych wcześniej. Nie może być użyte jednocześnie zreplaceCollections
.replaceCollections
- dodaje obiekt do kolekcji wskazanych przezpublication.collections
oraz usuwa wcześniej istniejące przypisania do kolekcji. Nie może być użyte jednocześnie zaddCollections
.image
- zastępuje miniaturę obiektu obrazkiem wskazanym przezimage.content
.adminData
- zastępuje dane administracyjne obiektu (wartości wskazane w kluczachpublication.name
,publication.notes
,publication.secured
,publication.published, publication.publishingDate
,edition.externalId).
full
- specjalna opcja służąca do pełnego zastąpienia treści i właściwości obiektu, jednoznaczna z użyciemreplaceMetadata,replaceContent,replaceRights,replaceCollections,image,adminData
...
Mechanizm ten działa podobnie jak w przypadku dziedziczenia plików publication.properties
z tym wyjątkiem, że plik metadanych w katalogu nadrzędnym nazywać się powinien publication.rdf
. Zatem, jeśli w katalogu zawierającym katalogi z opisami publikacji zostanie znaleziony plik publication.rdf
, zawarte w nim metadane zostaną przypisane wszystkim tworzonym publikacjom. Dziedziczenie to działa tylko na pierwszym poziomie katalogów — nie dotyczy publikacji zgrupowanych w nowo tworzonych publikacjach. Dziedziczenie metadanych z publikacji grupowych jest obsługiwane przez mechanizm grupowania publikacji.
...