JCR - Journals API

Rejestracja

Kroki do wykonania w celu uzyskania dostępu:

1. Pierwszym etapem jest rejestracja w portalu dewelopera Clarivate https://developer.clarivate.com/, przy wykorzystaniu adresu służbowego (nakierowuje on na instytucję zgłoszoną do licencji krajowych)

2. Na etapie rejestracji aplikacji należy

• stworzyć Application ID

• stworzyć Application Name

• podać krótki opis wykorzystania API (celem w Omedze jest zbieranie danych o cytowaniach publikacji)

• w polu Client Type należy wskazać Public Clients: Single Page Applications

• pole This application will use OAuth2.0 Flows powinno pozostać odznaczone

Open

3. Po zarejestrowaniu aplikacji należy zasubskrybować Web of Science Journals API, czyli przejść do zakładki “APIs” i z listy wybrać Web of Science Journals API, a następnie na wyświetlonej stronie w obszarze “Applications” kliknąć “Subscribe”.

Open

4. Po pomyślnie zakończonej rejestracji klucz dostępu powinien przyjść w oddzielnej wiadomości mailowej.

W przypadku jakichkolwiek trudności należy kontaktować się drogą mailową z działam wsparcia Clarivate na adres WoSG.support@clarivate.com. Mail należy wysłać również do wiadomości przedstawiciela Clarivate p. Marcina Kapczyńskiego (marcin.kapczynski@clarivate.com), co przyspieszy weryfikację i potwierdzenie, że dostęp dla instytucji został wykupiony zgodnie z umową między jednostką a Clarivate.

Instalacja

Chęć instalacji integratora należy zgłosić przez Jirę. Sages instaluje najbardziej aktualną wersję integratora jaką aktualnie posiada. Należy pamiętać o kompatybilności wersji integratora i Omegi.

Konfiguracja

Dane dostępowe

Dane dostępowe (token) należy wprowadzić do modułu konfiguracji z systemami zewnętrznymi Funkcje Administracyjne → Integracja z systemami zewnętrznymi - konfiguracja:

Dane wprowadzamy do już istniejącego rekordu lub tworzymy nowy.

Pole Token (JCR) musi być uzupełnione, pozostałe pola mogą pozostać puste. Zapisujemy zmiany w rekordzie.

Dane słownikowe i algorytm punktacji

Integrator wykorzystuje słowniki systemowe:

• Identyfikator WoS,

• Impact Factor WoS,

słowniki niesystemowe:

• Kwartyl JIF,

• Wartość kwartyla JIF,

oraz algorytm punktacji:

• Kwartyl IF (jifindicatorrules.drl).

Należy upewnić się że:

• wszystkie dane słownikowe i algorytm punktacji są dostępne w systemie

• aktywowany jest przełącznik quartile.features.enabled.

Zadania cykliczne

Możliwa jest automatyczna, cykliczna aktualizacja wybranych czasopism przy pomocy zadania cyklicznego update_jcr_indicators (59 59 23 31 12 ? 2099 ).

Skrypt aktualizuje statystyki czasopism, których identyfikatory (Omegowe id) są umieszczone w pliku CSV. Poniżej przykład pliku CSV:

W zadaniu cyklicznym można nadpisać domyślnie zdefiniowane wartości parametrów:

Po zakończaniu działa skryptu można przejrzeć log z jego działania:

Integracja

Przycisk pozwalający przejść na panel integracji pojawi się po prawidłowej instalacji i konfiguracji integratora w rozwijanej liście na podglądzie listy czasopism:

Z panelu dla wybranych wcześniej czasopism można wykonać:

• import identyfikatorów WoS JCR,

• import statystyk z WoS JCR.

Import identyfikatorów WoS JCR

Import identyfikatorów WoS JCR jest obsługiwany na pierwszej zakładce w panelu integracji dla wcześniej wybranych czasopism z listy głównej:

Czasopisma są dopasowywane na podstawie pól issn, eissn i otherIssn wykonując zapytania pod endpoint /journals . Próba importu identyfikatorów dla czasopisma nastąpi tylko wtedy gdy jedno z ww. pól nie będzie puste oraz w rekordzie nie będzie już zapisanego identyfikatora WoS JCR.

Przykładowo dla czasopisma z numerami:

Integrator zbuduje zapytanie /journals?q=0898-9575 OR 2151-7290 OR 0967-5507. W rezultacie w przypadku prawidłowego dopasowania integrator otrzyma 1 lub więcej identyfikatorów z WoS (więcej np. gdy czasopismo zmieniło nazwę, ale ISSN pozostał ten sam) i zapisze pierwszy z nich w polu extid o typie Identyfikator WoS:

Po skończonym imporcie pojawi się tabela z podsumowaniem:

Dostępne statusy:

• UPDATE - system zaktualizował czasopismo o identyfikator WoS,

• NOT_FOUND - system wykonał zapytanie do WoS JCR API, jednak nie dopasowano żadnego czasopisma więc identyfikator WoS nie został zapisany,

• SKIP - system pominął dany rekord ze względu na to że pola issn, eissn, otherIssn są puste, lub czasopismo ma już wpisany identyfikator WoS,

• ERROR - błąd systemu.

Import statystyk z WoS JCR

Importu statystyk z WoS JCR jest obsługiwany na drugiej zakładce w panelu integracji dla wcześniej wybranych czasopism z listy głównej:

Import wykonywany jest tylko dla czasopism posiadających Identyfikator WoS. W pierwszej kolejności pobierane są szczegółowe dane czasopisma z wykorzystaniem endpointu /journals/{id}, następnie wykonywane są zapytania dla poszczególnych lat z wykorzystaniem endpointu /journals/{id{/reports/year/{year}. Na tej podstawie w systemie zapisywane są wskaźniki w podziale na poszczególne lata:

• impact factor 2 i 5 letni:
  
  

• kwartyl:
  
  

Przydatne linki

• https://jcr.clarivate.com,

• http://jcr.help.clarivate.com/Content/home.htm ,

• https://clarivate.com/webofsciencegroup/solutions/journal-citation-reports/