DSpace (eksport)

Założenia wstępne

Integracja Omegi z systemem DSpace wymaga modułu obsługującego protokół SWORD w wersji 2. Modularność systemu DSpace pozwala na niezależne doinstalowanie niezbędnego modułu integracyjnego. Z drugiej strony Omega do komunikacji z DSpace używa dodatkowej aplikacji, tj. pośredniczącego mikroserwisu.

Kolekcje w systemie DSpace nie są bezpośrednio powiązane z encjami dostępnymi w Omedze, dlatego należy przygotować plik reguł mapujących jednostkę w Omedze oraz typ rekordu na kolekcję. Interfejs Omegi umożliwia wgranie i zastosowanie odpowiednich mapowań.

Na ten moment do Dspace eksportowane są kompletne rekordy publikacji zaklasyfikowane jako:

artykuły,
książki,
doktoraty,
materiały nieopublikowane.

Eksport do DSpace zachodzi automatycznie pod warunkiem akcji zapisania rekordu z wymaganymi właściwościami.

Rekordy zdeponowane w DSpace przez Omegę nigdy nie powinny być modyfikowane po stronie interfejsu DSpace. Aktualizacja rekordu w Omedze spowoduje nadpisanie ręcznie wprowadzonych zmian w Dspace.

Wymagane i opcjonalne właściwości rekordów

Aby rekord podlegał eksportowi muszą zostać spełnione następujące warunki:

Rekord jest w statusie kompletny i należy do typu artykuł, książka doktorat lub materiał nieopublikowany.
Rekord zawiera załączony przynajmniej jeden plik zawierający pełny tekst o publicznym dostępie.
Data utworzenia rekordu jest nie mniejsza niż ustalony dzień rozpoczęcia synchronizacji z systemem DSpace.
Przynajmniej jeden autor rekordu (publikacji) należy do afiliacji dla których reguły mapowania na kolekcje DSpace zostały zdefiniowane (opisane poniżej).

Przed wysłaniem rekordu do DSpace należy zadbać o uzupełnienie wymaganych i opcjonalnych właściwości przedstawionych w tabelach poniżej.

Plik z regułami mapowań jednostek na kolekcje DSpace

Plik reguł jest plikiem CSV, gdzie każda kolejna komórka wiersza oddzielona jest przecinkiem.

Plik jest utworzony jednorazowo i może funkcjonować bez zmian do czasu modyfikacji struktury organizacyjnej i struktury zapisanej w DSpace.

Błędna struktura pliku będzie skutkować niepoprawnym działaniem lub brakiem synchronizacji rekordów.

Przykładowa postać pliku (obowiązująca przy obecnej strukturze i kolekcjach w DSpace):

1600000000,ARTICLE,10593/3286
1600000000,CHAPTER,10593/3288
1600000000,BOOK,10593/3288
1600000000,PHD,10593/3287
1600000000,REPORT,10593/3291
200000000,ARTICLE,10593/56
200000000,CHAPTER,10593/549
200000000,BOOK,10593/549
200000000,PHD,10593/763
200000000,REPORT,10593/973
300000000,ARTICLE,10593/60
300000000,CHAPTER,10593/550
300000000,BOOK,10593/550
300000000,PHD,10593/765
300000000,REPORT,10593/974
400000000,ARTICLE,10593/36
400000000,CHAPTER,10593/518
400000000,BOOK,10593/518
400000000,PHD,10593/767
400000000,REPORT,10593/975
500000000,ARTICLE,10593/63
500000000,CHAPTER,10593/551
500000000,BOOK,10593/551
500000000,PHD,10593/768
500000000,REPORT,10593/976

W pierwszej kolumnie zapisane jest ID jednostki w Omedze (w powyższym przykładzie jest to wydział), w drugiej kolumnie typ rekordu z Omegi, który ma być przesyłany do kolekcji DSpace o ID określonym w trzeciej kolumnie.

Plik w formie tekstowej należy aktualizować wraz ze zmianami wprowadzanymi w zakresie jednostek uczelni, zwłaszcza przy pojawieniu się nowych jednostek.

Aby rozpocząć procedurę importu należy w panelu administracyjnym wybrać ostatnią opcję z listy funkcji administracyjnych - Parametry systemowe. Funkcja jest dostępna tylko dla osób z uprawnieniami ADMIN Na pokazanej liście powinien pojawić się parametr o nazwie DSpace collection data, który zawiera reguły w formie CSV. Rekord wystarczy zmodyfikować (trzeba podać datę we właściwym formacie) i zapisać aby nowe reguły zaczęły obowiązywać - restart systemu nie jest wymagany.

Data początkowa startu synchronizacji z DSpace

W systemie Omega istnieje możliwość zdefiniowany daty początkowej obowiązywania synchronizacji rekordów z systemem DSpace. Podanie wartości jest wymagane, aby integracja pomiędzy systemami mogła zachodzić.

Wartość daty w formie YYYY-MM-DD ustawia się w parametrze systemowym o nazwie DSpace deposit lower date limit. Jedynie rekordy utworzone w Omedze po tej dacie będą mogły być eksportowane do DSpace.

Powiązanie rekordu Omegi i DSpace

Rekordy wysłane do DSpace mają tam nadawane id oraz tworzony jest do nich link typu handle zapisywany jako identyfikator zewnętrzny rekordu w Omedze. Po drugiej stronie w DSpace zapisywany jest link pod którym można przejść do systemu Omega. Dzięki temu w prosty sposób użytkownicy systemów mogą przechodzić pomiędzy oboma systemami.

Aktualizacja wyeksportowanego rekordu

Rekordy zdeponowane w DSpace mogą być aktualizowane poprzez Omegę. Przy pomocy ikony przy rekordzie znajdującym się na liście wyszukiwanych rekordów w Omedze można zauważyć które podlegają synchronizacji z DSpace.

Każdorazowe wprowadzenie zmian i zapisanie rekordzie w Omedze spowoduje aktualizację rekordu w DSpace.

Scenariusz testowy

Przykładowy scenariusz testowy opisujący dokładne kroki jak przetestować eksport rekordu do DSpace jest dostępny na stronie: Scenariusz testowy