Hackathon API

Ze względu na powtarzające się pytania, chciałbym wyjaśnić jedną ogólną kwestię dotycząca edycji publikacji przez API. Przede wszystkim, jak Państwo zapewne wiedzą, dane zawarte w ogólnym repozytorium (możliwe do wyszukania za pomocą wyszukiwarki dostępnej na stronie głównej PBN) są odrębne od danych oświadczonych przez poszczególne instytucje. Edycja danych w ogólnym repozytorium, jak również edycja danych w profilu jednej instytucji, w żaden sposób nie wpływa na dane w profilach pozostałych instytucji.
API PBN jest przeznaczone dla instytucji, a nie dla indywidualnych użytkowników, i ma na celu w pierwszej kolejności umożliwienie składania i edycji oświadczeń w Profilu Instytucji PBN. Z tego względu edycja publikacji przez API umożliwia pełną zmianę danych tej publikacji oświadczonych przez daną instytucję, natomiast na dzień dzisiejszy tych częściowo (w zakresie danych podstawowych publikacji, które są wersjonowane) zmienia publikację w ogólnym repozytorium. Edycja taka nie zmienia natomiast informacji o połączeniach z innymi obiektami (autorzy, czasopisma, inne publikacje itd.) widocznych w ogólnym repozytorium.
Planujemy zmienić obecny sposób edycji publikacji przez API – tak, aby edycja taka zmieniała wszystkie dane w ogólnym repozytorium, w tym także w zakresie połączeń z innymi obiektami. Nie mniej należy zauważyć, że już teraz instytucje mają pełną kontrolę nad swoimi publikacjami, ponieważ mogą w pełni edytować, także za pomocą API, dane w swoim profilu, a błędne dane wprowadzone przez inne instytucje nie mogą mieć żadnego wpływu na oświadczenia tej instytucji.
Gdyby jednak instytucja uznała za zasadne doprowadzenie do porządku danych w ogólnym repozytorium, ma już dzisiaj taką możliwość przez stronę internetową PBN. Nawet, jeśli publikacja jest zweryfikowana, może być edytowana przez każdego importera publikacji. Na stronie szczegółów publikacji dostępny jest nie tylko przycisk kierujący do strony edycji danych podstawowych, ale także przyciski umożliwiające dodanie lub zmianę poszczególnych połączeń. Oczywiście nie w tym przypadku ma gwarancji, że publikacja nie zostanie w przyszłości zmieniona przez innego importera publikacji.

Czy można uporządkować historię edycji w szczegółach publikacji? Według daty-godziny.

Mamy to w planach – niestety ze względu na napięty harmonogram, zadanie ma niski priorytet.

Czy w endpoincie /v1/search/journals można wyszukać wszystkie czasopisma? W PBN występują publikacje posiadające numer eissn lub issn której nie mogę wyszukać w tym endpoincie podając wskazane wartości.

Jeśli czasopisma nie pochodzą z listy ministerialnej – należy  w żądaniu podać flagę „mnisw”: false

Np.

{

„issn”: „string”,

„mnisw”: false

}

Jeżeli autor ma oświadczenia o dyscyplinie A w latach 2017 – 2018, a w dyscyplinie B w latach 2020-2021, to czy publikację datowaną na rok 2018 może przypisać do dyscypliny B?

W PBN można oświadczyć publikację w dowolnej z dyscyplin, w których pracownik złożył oświadczenie o dziedzinie i dyscyplinie; nie mamy cenzury czasowej.

Inna kwestia – trafiłem właśnie na sytuację gdy książka pod redakcją ma nieprawidłowego redaktora. Źródłem książki jest MS, pewnie w starym PBN był wpisany autor w książce i rozdziale ten sam. Czy mogę przesłać aktualizację opisu książki pod redakcją używając po prostu objectId i poprawić w ten sposób pełny opis publikacji według tego jak uważam, że powinien wyglądać?

W tym momencie taka edycja nie jest możliwa do dokonania poprzez API. Core aktualizowane są tylko podstawowe dane publikacji. Pełną edycje rekordu musi Pan obecnie wykonać ręcznie.

Jeszcze wrócę do kwestii rozdziałów w książkach wpisanych przez inny podmiot.
Wygląda na to, że jestem w stanie wprowadzić swoje wydawnictwo przesyłając dane w węźle book, ale nie mogę zmienić np. tytułu książki. Czy mogę prosić o wykaz wartości, które mogę aktualizować w takim przypadku?
I co zrobić w przypadku, gdy wydawnictwo w takiej książce jest spoza listy a inny podmiot wpisał je nieprawidłowo, a właściwa wersja nie występuje w PBN?

Postaramy się przyjrzeć tej kwestii, Rozumiem że chodzi o rozdział i możliwość edycji tytułu wskazanej mu książki, oraz wskazanego wydawcy do tej książki.

Dlaczego nie ma reguły towarzyszącej usunięciu autora z obiektu tak aby jednocześnie usuwane było oświadczenie towarzyszące jego roli (np. redaktora).

Taka sytuacja faktycznie jest nieprawidłowa i zostanie poprawiona. Dziękujemy za zwrócenie uwagi.

Dlaczego próba wysłania aktualizacji publikacji typu BOOK kończy się błędem: „Nie możesz edytować DOI publikacji!”? DOI nie jest wskazany w minimalnych ani maksymalnych danych do wysłania, również nie jest zawarty w przesyłanych danych. Skąd taki błąd?

Jeżeli DOI już istnieje w publikacji, to przy aktualizacji trzeba je podać. Nie ma tego ujętego w minimalnych i maksymalnych  danych, ponieważ, przy dodawaniu publikacji nie trzeba podawać DOI. Na minimalne dane trzeba wziąć poprawkę, na to, jakie dane już istnieją w publikacji. Przy edycji publikacji z DOI należy zwrócić szczególną uwagę na zapis numeru DOI. Jeśli w DOI w PBN występuję spacja, np. po numerze, należy ją uwzględnić.

Zgodnie z informacją PBN dane do ewaluacji (isReviev,scientificEdition, BookProject, translation) są „zaciągane” do SEDN (SE) z Profilu Instytuacji (PI) (nie ze snapshotu SN). Po pierwsze nie zawsze (choć zwykle). Jest to prawda, np: 212326 5ec003f5ad49b31cced7a3ca (PI – SN + SE +). Po drugie, ważniejsze: jak uzyskać informacje o ww cechach publikacji, skoro z institution-profile-controller pobieramy dane pochodzące ze SN. Potrzebuję rzetelnych danych na ten temat dla ~25000 artykułów z mojej instytucji.

Rozszerzymy zatem odpowiedź która jest zwracana w końcówce /v1/institutionProfile/publications/page o dane ewaluacji, które sa przesyłąne do SEDNU.

Również raport xlsx zostanie rozszerzony w tym zakresie

Co zmienia w /v1/search/publishers podanie parametru 'official’?

W przypadku /search conferences, journals, publishers parametr official wskazuje na obiekty z listy MNISW.

zatem w przypadku official=true, mnisw=false , podanie tych parametrów wzajemnie się wyklucza

Parametry official i mnisw można stosować zamiennie.

W przypadku kryterium w /search/institutions paramaetr official wskazuje na isntytucje z POLONU

Jak wykasować zbiorczo oświadczenia (upoważnienia) przy publikacjach osób niepodlegających ewaluacji?

DELETE /v1/institutionProfile/publications
Usunięcie oświadczeń w ramach danej instytucji zalogowanego użytkownika.

DELETE /v1/institutionProfile/publications/{id} Usunięcie oświadczeń o danej publikacji w ramach instytucji zalogowanego użytkownika.

Dla DELETE /v1/institutionProfile/publications/{id}

w ciele żądania należy wpisać all:true

{

„all”: true,

„statementsOfPersons”: [

{

„personId”: „string”,

„role”: „AUTHOR”

}

]

}

all to Flaga wskazująca na to, że należy usunąć wszystkie oświadczenia w ramach danej publikacji i instytucji.

A w jaki sposób mogę zaktualizować oświadczenia o dyscyplinach? Pobrałem publikacje z profilu instytucji w PBN, porównałem oświadczenia z tymi które są u Nas w bazie i otrzymałem różnice, których nie mogę się pozbyć wysyłając aktualizacje publikacji. Tak wysyłałem rekord publikacji jeszcze raz. Jeśli liczba osób w oświadczeniu się zgadzała publikacja była aktualizowana. Jednak co w przypadku gdy autor zrezygnował z oświadczenia danej publikacji do dyscypliny? Czyli w PBN jest np. 7 oświadczeń dyscyplin, a chciałbym tak zaktualizować żeby było ich np.5

W celu zmiany dyscyplinę dla osoby z A na B należy dokonać edycji publikacji,  wpisując dla osoby właściwą dyscyplinę w której chcą Państwo oświadczyć publikację.

Należy skorzystać z końcówek delete

DELETE /v1/institutionProfile/publications
Usunięcie oświadczeń w ramach danej instytucji zalogowanego użytkownika.

DELETE /v1/institutionProfile/publications/{id} Usunięcie oświadczeń o danej publikacji w ramach instytucji zalogowanego użytkownika.

Zakładając, że zmiana z projektu rozporządzenia w zakresie 'kosztów publikacji’ wejdzie w życie, jak zostanie zrealizowana w PBN? Zapis rozporządzenia jest ogólny, czasu będzie bardzo mało (czyli pewnie już Państwo o tym myśleli).
Projekt mówi o koszcie i źródle finansowania (wymienia trzy możliwości) – czy do wypełnienia będą pary danych – źródło1 – kwota, źródło2 – kwota, źródło3 – kwota?

Jeśli przepis wejdzie w życie dane o kosztach będą wprowadzane na Profilu Instytucji, koszt będą wprowadzać Państwo jeden, łączny nawet jeśli wskażą Państwo więcej niż jedno źródło finansowania. Kwestie waluty zostaną ustalone z Ministerstwem.

W jaki sposób formatować m.in. indeksy górne/dolne w tytułach? tagami html (<sup>, <sub>), innymi modyfikatorami?

Nie przewidzieliśmy zapisu formatowania w naszej bazie danych. Przyjęty sposób formatowania musiałby być stosowany nie tylko przez PBN, ale także przez inne systemy, do którego przekazywane dane. Z tego względu nie zalecamy dodawania żadnych znaków specjalnych, które miałyby określać formatowanie – znaki takie zostaną potraktowane jako część tekstu.

Czy nadal są wymagane powiązania pomiędzy ORCID a PBN? (są alerty w SEDN). Czy w takim razie można ten proces zautomatyzować? Jest możliwość powiązania poprzez API? Co z osobami, które nie umieściły prac na koncie ORCID, gdyż odeszły z pracy w 2018 roku, a w kilku przypadkach przeszły już do wieczności bez wiązania profili?

Aktualnie obowiązujące przepisy w dalszym ciągu przewidują taki obowiązek. Trwają prace nad zmianą rozporządzenia znoszącą taki wymóg, jednakże zmiana taka jeszcze nie została wprowadzona. Odnośnie automatyzacji – aktualnie jest możliwość zawarcia w API oświadczenia, iż publikacja jest powiązana z ORCID danego autora. Oczywiście jest to jedynie oświadczenie któremu nie towarzyszy faktyczne dodanie publikacji do ORCID autora – taka operacja musiała by zostać wykonana przez samego autora lub z użyciem jego osobistego tokena umożliwiającego edycję danych w ORCID. Informacja o poświadczeniu, że publikacja jest w ORCID jest umieszczana w węźle statements jako flaga „orcid” (wartość true poświadcza obecność publikacji na koncie ORCID).

Pytanie o byłych lub zmarłych pracowników nie powinno być skierowane do nas, lecz do Ministerstwa. Wymóg jest określony w rozporządzeniu, które my jesteśmy obowiązani respektować, natomiast nie jesteśmy jego autorami.