...
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<login użytkownika lub nazwa grupy do której przydzielamy
prawa>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>
. 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.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
publication.id
Identyfikator publikacji (obiektu) do aktualizacji (zob.update.mode
poniżej).edition.id
Identyfikator wydania (wersji obiektu) do aktualizacji (zob.update.mode
poniżej).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ą.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
Przykładowy plik publication.properties
:
Code Block | ||||
---|---|---|---|---|
| ||||
publication.actorsRights.publicGroup=prU\u017Cytkownicy\ publiczni=pv 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 |
...
Tworzona publikacja może być publikacją planowaną. Aby tak było, w katalogu z publikacją mogą być tylko 2 pliki: publication
.properties
i description
.rdf
. Dodatkowo w pliku publication
.properties
można umieścić klucz publication
.publishingDate
, którego wartością powinna być planowana data opublikowania. Dozwolony format daty to yyyy-MM-dd
, gdzie yyyy
oznacza rok, MM
miesiąc a dd
dzień. W przypadku późniejszego uzupełniania publikacji planowanej o treść, należy pamiętać o uzupełnieniu wartości publication.name,
ponieważ jej wartość posłuży jako nazwa wydania.
Definiowanie umiejscowienia publikacji
...