API

W dniach 30.09.2024 r. oraz 04.10.2024 r. zostały przeprowadzone dwie aktualizacje systemu PBN.

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

• uzupełnienie identyfikatora ministerialnego (MNISW ID) wydawnictwa w rekordzie rozdziału w publikacjach w Profilu Instytucji,
• dodanie języka ugaryckiego oraz języka syryjskiego w interfejsie użytkownika w formularzu dodawania publikacji,
• usuwanie zbędnych spacji w tytułach publikacji na listach publikacji w Profilu Instytucji,
• uzupełnienie punktacji konferencji w 2024 roku,
• zmiana walidacji umożliwiająca usuwanie z repozytorium publikacji, która uprzednio została usunięta z Profilu Instytucji,
• usunięcie wyświetlania zdublowanych obiektów połączonych z publikacją w sekcji Połączenia w repozytorium.

Najważniejsze modyfikacje API:

• wdrożenie końcówki umożliwiającej pobranie strony z publikacjami z Profilu Instytucji (/v2/institution-profile/publications),
• wdrożenie końcówki umożliwiającej usunięcie publikacji, wskazanych identyfikatorami objectId, z Profilu Instytucji w ramach instytucji zalogowanego użytkownika (/v2/institution-profile/publications/id),
• wdrożenie końcówki umożliwiającej usunięcie publikacji, wskazanych identyfikatorami uuid, z Profilu Instytucji w ramach instytucji zalogowanego użytkownika (/v2/institution-profile/publications/uuid).

W dniu 26.06.2024 r. zaktualizowano system PBN 2.0

Najważniejsza modyfikacja wprowadzona we wdrożeniu:

• aktualizacja punktacji i dyscyplin przypisanych do czasopism zgodnie z komunikatem Ministra Nauki z dnia 5 stycznia 2024 r. w sprawie wykazu czasopism naukowych i recenzowanych materiałów z konferencji międzynarodowych czasopism z dnia 5 stycznia 2024 r.

Najważniejsze modyfikacje API:

• wdrożenie końcówki umożliwiającej dodanie publikacji do Repozytorium bez jednoczesnego dodawania publikacji do Profilu Instytucji (/v1/repositorium/publications),
• wdrożenie końcówki umożliwiającej eksport publikacji z Repozytorium bez dołączania oświadczenia do zakładki Publikacje w Profilu Instytucji (/v1/repositorium/export/institution-profile).

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/