API

W dniu 17.11.2023 została udostępniona nowa funkcjonalność API. Za pomocą końcówki /v1/person/polon/{uid} jest obecnie możliwe wyszukiwanie metadanych osób nie tylko po UID przypisanym w systemie POL-on do pracownika, ale również po UID przypisanym w tym systemie do doktoranta.

W dniu 19.07.2023 r. zaktualizowano system PBN 2.0 do wersji 23.7.2.

Najważniejsze modyfikacje API wprowadzone we wdrożeniu to:

• rozszerzenie uprawnienia tokenów do odczytu o możliwości wyszukiwania i pobierania danych za pomocą końcówek search:
  • /v1/institutionProfile/publications/search/fees
  • /v1/institutionProfile/publications/search/incompleted-fees
  • /v1/search/conferences
  • /v1/search/institutions
  • /v1/search/journals
  • /v1/search/publications
  • /v1/search/publishers
  • /v1/search/persons

• dodanie parametrów umożliwiających pobieranie publikacji z Profilu Autora dla zdefiniowanego przedziału lat (filtrowanie dotyczące roku publikacji)

W dniu 26.06.2023 r. zaktualizowano system PBN 2.0 do wersji 23.7.1.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu to:

• wprowadzenie walidacji na format daty (wymagana liczba dodatniaa czterocyfrowa) przy dodawaniu obiektów typu publikacja oraz czasopismo,
• umożliwienie wyszukiwania przy użyciu przycisku „enter” w zakładkach w Profilu Instytucji.

Dnia 06.04.2023 r. zaktualizowano moduł PBN do wersji 23.4.1. Najważniejsze modyfikacje obejmują:

• Wyłączono trwale funkcjonalność Sugestii oświadczeń. Wyłączenie nastąpiło w porozumieniu z MEiN.
• Wprowadzono alfabetyczne sortowanie list dyscyplin na listach wyboru w komponentach filtrów.

Zmiany w API obejmują:

• W dokumentacji API (Swagger) dodano nową końcówkę do pobierania słownika dyscyplin: GET​/v2​/dictionary​/disciplines. Jednocześnie stara końcówka została wykreślona. Używanie wykreślonej z dokumentacji końcówki jest nadal możliwe, ale za jej pomocą pobierane są nieaktualne dane.
• Rozbudowano model danych słownika dyscyplin. Obecnie zwracane są następujące dane:

[
  {
    "disciplines": [
      {
        "code": "string",
        "name": "string",
        "polonCode": "string",
        "scientificFieldName": "string",
        "uuid": "string"
      }
    ],
    "uuid": "string",
    "validityDateFrom": "2023-04-11",
    "validityDateTo": "2023-04-11"
  }
]

• code – kody dyscypliny w module PBN
• name – nazwa dyscypliny
• polonCode – odpowiedni kod dyscypliny w systemie POL-on
• scientificFieldName – nazwa dziedziny, z której pochodzi dyscyplina
• uuid – alfanumeryczny kod dyscypliny (uuid)
• validityDateFrom – data początkowa obowiązywania słownika
• validityDateTo – data końcowa obowiązywania słownika

W dniu 22.11.2021 r.  zaktualizowano system do wersji 21.11.1.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu: 

• uzupełnienie brakującej punktacji dla czasopism z listy ministerialnej
• poprawa punktacji dla czasopisma Finance India
• rozszerzenie raportu xlsx z Profilu Instytucji o ISBN monografii źródłowej oraz Dane do ewaluacji

Najważniejsze modyfikacje API :

• poprawa edycji rozdziałów w książkach pod redakcją i tomów pokonferencyjnych – zniesienie obligatoryjności DOI i/lub URL
• dodanie końcówek umożliwiających pobranie danych dla tomów pokonferencyjnych – GET​/v1​/conferences​/proceedings​/page; GET​/v1​/conferences​/proceedings​/{publicationId} –  opis końcówek znajduje się na stronach pomocy PBN.

W dniu 22.10.2021 r.  zaktualizowano system do wersji 21.10.1.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu: 

• korekta niepoprawnych zapisów mniswId
• poprawa błędu logowania dla użytkowników z rolą systemową Przedstawiciel Czasopisma
• poprawa punktów dla czasopisma Folia Cardiologica (ISSN 2353-7752, e-ISSN 2353-7760)
• zdjęcie walidacji na stronę internetową serii i edycji konferencji

Najważniejsze modyfikacje API :

• poprawiono działanie wyszukiwarki /v1/search/publications – umożliwiono wyszukiwanie publikacji po więcej niż jednym autorze
• umożliwiono nadawanie podmiotom posiadającym token aplikacji odczyt/zapis dodatkowych tokenów tylko do odczytu
• zdjęto walidację na stronę internetową serii i edycji konferencji
• dodano do słownika API pozycję ’’Nieznany lub błędny kraj”

W dniu 01.10.2021 r.  zaktualizowano system do wersji 21.9.2.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu: 

• oddano ekspertom narzędzia umożliwiające przeprowadzenie oceny monografii
• poprawiono błędy na wykazie konferencji  (Wykazy – Oficjalna lista konferencji) – umożliwiono wyszukiwanie po nazwie skróconej oraz pełnej nazwie wraz z nazwą skróconą
• poprawiono wyszukiwanie na oficjalnych listach ministerialnych w Wykazach – umożliwiono wyszukiwanie za pomocą klawisza ENTER
• zaktualizowano linki odsyłające do aktualnych list ministerialnych – zmieniono nazwę przycisku na „Pobierz listę ze strony MEiN”
• w zakładce Wykazy zmieniono nazwę strony z Wydawca na Wydawnictwa
• zmieniono kolejność wyświetlania informacji na stronie PBN – jako pierwsze wyświetlają się obecnie Aktualności
• na Profilu Instytucji dla rozdziałów w monografiach usunięto z Danych do ewaluacji pola dotyczące monografii (dane dotyczące edycji naukowej tekstu źródłowego, źródeł finansowania edycji, informacji czy monografia stanowi tłumaczenie)

Najważniejsze modyfikacje API :

• umożliwiono dodawanie poprzez API roczników, tomów i numerów dla czasopism występujących już w PBN
• w przypadku przesłania czasopisma o roczniku, tomie i numerze występujących już w PBN dodano w komunikacie objectId objektu występującego już w bazie
• dla końcówki GET ​/v1​/conferences​/{conferenceId}​/editions dodano w wynikach wyszukiwania objectId edycji

W dniu 23.08.2021 r.  zaktualizowano system do wersji 21.8.0.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu: 

• dodanie w zestawieniu publikacji z Profilu Instytucji PBN punktów źródła dla rozdziałów
• rozszerzenie punktacji dla materiałów konferencyjnych na lata 2017-2018
• dodanie języka akadyjskiego i sumeryjskiego
• zmiana położenia i nazwy kafelka Profilu Instytucji na Profil Instytucji PBN

• korekta punktacji dla czasopisma Historyka. Studia Metodologiczne o mniswId 483942
• korekta funkcjonalności zmiany czasopism w szczegółach publikacji

Najważniejsze modyfikacje API :

• umożliwienie osobom z rolą Menadżera Aplikacji podglądu listy osób generujących tokeny użytkownika w obrębie danej instytucji
• korekta importu prac z dużą ilością autorów
• korekta wyświetlania oświadczeń w Profilu Instytucji PBN

W dniu 23.07.2021 r.  zaktualizowano system do wersji 21.7.6.

Najważniejsze modyfikacje/funkcjonalności wprowadzone we wdrożeniu: 

• rozszerzenie Sugestii dorobku do dodania na Profilu Autora – w Sugestiach pojawiają się publikacje z inną rolą niż autor (redaktor naukowy, autor przekładu, redaktor naukowy przekładu)
• naprawa błędu zdublowanych wpisów na liście autorów
• naprawa błędu braku aktualizacji publikacji na Profilu Autora w przypadku usunięcia lub dodania DOI publikacji
• naprawa błędu masowego dodawania publikacji z ORCID

Najważniejsze modyfikacje API :

• umożliwienie usunięcia daty oświadczenia  – w celu usunięcia daty oświadczenia należy w węźle „statements” w „statementDate” wpisać null lub pozostawić pusty string („”)
  1. usuwanie poprzez null –

     „statements”:[
     {
     „disciplineId”: „202”,
     „type”: „AUTHOR”,
     „personObjectId”: „5e7092ac878c28a04739a675”,
     „statementDate”: null
     }
     ]

  2. usuwanie z pustym stringiem –

     „statements”:[
     {
     „disciplineId”: „202”,
     „type”: „AUTHOR”,
     „personObjectId”: „5e7092ac878c28a04739a675”,
     „statementDate”: „”
     }
     ]

• umożliwiono dodawanie numeru DOI dla publikacji bez DOI – w pliku koniecznym jest podanie ObjectId publikacji, dla której chcemy dodać DOI; żądanie będzie realizowane wyłączenie dla ObjectId bez DOI w PBN i przy podaniu DOI niewystępującego już w PBN

Na stronach pomocy PBN zaktualizowano plik z opisem zachodzących walidacji na nadsyłanych publikacjach – https://pbn.nauka.gov.pl/centrum-pomocy/baza-wiedzy/publikacje/

W dniu dzisiejszym na środowisko produkcyjne PBN oraz na środowisko testowe PBN-Alpha wdrożone zostało rozszerzenie API o końcówki umożliwiające wyszukiwanie według kryteriów.

Dostępne jest sześć endpointów pozwalających na wyszukiwanie:

1. Konferencji
2. Instytucji
3. Czasopism
4. Osób
5. Publikacji
6. Wydawnictw

Opis poszczególnych końcówek zostanie udostępniony na stronach pomocy systemu PBN.