Przejdź do treści

PBN: wysyłanie prac, kolejka i porównanie z BPP

Przewodnik dla redaktorów, którzy wysyłają prace z BPP do Polskiej Bibliografii Naukowej (PBN). Po kolei: jak zalogować się do PBN z poziomu BPP, jak wysłać jedną pracę albo wiele naraz, jak czytać kolejkę eksportu i co zrobić z komunikatem o błędzie — a na koniec, jak sprawdzić, czego brakuje po stronie BPP albo PBN.

Konfigurację integracji (adres API, aplikacja i token w PBN, konto do operacji w tle) robi administrator — opisuje ją strona Integracja z PBN API.

Zanim zaczniesz

Uprawnienia. Potrzebujesz konta z dostępem do modułu redagowania i grupy „wprowadzanie danych”. Dopiero wtedy w górnym menu widać pozycję PBN.

Menu PBN pojawia się tylko wtedy, gdy uczelnia ma włączoną integrację („Czy używać integracji z PBN?” w ustawieniach uczelni). Przyciski „Zapisz i wyślij do PBN” w formularzu pracy wymagają drugiego ustawienia — „Włącz opcjonalną aktualizację przy edycji”. Jeśli ich nie widzisz, poproś administratora.

Konto w PBN. Wysyłasz prace swoim kontem PBN — z rolą, która pozwala dodawać publikacje instytucji. Wyjątek: administrator może w Twoim koncie BPP ustawić pole „przedstawiaj w PBN jako” — wtedy prace zlecone w tle idą kontem wskazanej osoby i to ona musi być zalogowana do PBN.

Menu „PBN”: autoryzacja, import i pobieranie danych, kolejka eksportu, komparatory

Lewa kolumna menu to praca z danymi (autoryzacja, import, pobieranie, wysyłka, kolejka), prawa — narzędzia do porównywania BPP z PBN.

1. Zaloguj się do PBN („autoryzuj PBN API”)

BPP nie zna Twojego hasła do PBN. Zamiast tego raz na jakiś czas autoryzujesz BPP — PBN wydaje wtedy przepustkę (token), z którą BPP wysyła prace w Twoim imieniu.

  1. Menu PBN → autoryzuj PBN API.
  2. Zostaniesz przeniesiony na stronę logowania PBN. Zaloguj się swoim kontem PBN i potwierdź dostęp dla aplikacji BPP.
  3. PBN odeśle Cię z powrotem do BPP, na stronę, z której zaczynałeś. U góry pojawi się komunikat „Autoryzacja w PBN API przeprowadzona pomyślnie.”

Jeśli adres autoryzacji otworzysz z zakładki albo wpiszesz go ręcznie, BPP najpierw pokaże stronę pośrednią — kliknij „Przejdź do logowania w PBN”:

Strona „Za chwilę zalogujesz się w PBN” z przyciskiem „Przejdź do logowania w PBN”

Jak długo to działa? BPP uznaje autoryzację za ważną przez 24 godziny. Potem autoryzuj się ponownie. Gdy przepustka wygaśnie, a w kolejce czekają zlecone przez Ciebie prace, na każdej stronie BPP zobaczysz niebieski komunikat „W kolejce na wysłanie do PBN czeka … wyedytowanych przez Ciebie rekord(y/ów), ale nie jesteś zalogowany/a do PBN. Kliknij tutaj, aby autoryzować się w PBN.” Wystarczy kliknąć odnośnik.

Prace czekające na autoryzację ruszą same

Prace, które w kolejce czekały na Twoje zalogowanie (status „Oczekuje na autoryzacje uzytkownika”), BPP wysyła ponownie automatycznie zaraz po udanej autoryzacji.

2. Wyślij jedną pracę

Otwórz pracę w module redagowania (wydawnictwo ciągłe albo zwarte). Na dolnym pasku, obok zwykłego „Zapisz”, są dwa przyciski:

Dolny pasek formularza: „Zapisz i wyślij do PBN w tle” i „Zapisz i wyślij do PBN”

Przycisk Co się dzieje Kiedy wybrać
Zapisz i wyślij do PBN BPP zapisuje pracę i od razu wysyła ją do PBN. Czekasz na odpowiedź, wynik widzisz w komunikatach u góry formularza. Gdy chcesz od razu wiedzieć, czy się udało, i poprawić błąd na miejscu.
Zapisz i wyślij do PBN w tle BPP zapisuje pracę i dopisuje ją do kolejki eksportu. Wysyłka odbywa się na serwerze, możesz pracować dalej. Gdy PBN odpowiada wolno, gdy wysyłasz wiele prac po kolei albo gdy nie jesteś teraz zalogowany do PBN.

Wysyłka od razu — czytanie komunikatów

Po kliknięciu „Zapisz i wyślij do PBN” formularz otwiera się ponownie, a nad nim pojawiają się komunikaty:

Komunikaty po wysyłce: ostrzeżenia o autorach bez odpowiednika w PBN, powód odmowy wysyłki, przypomnienie o autoryzacji

  • zielony „Dane w PBN dla rekordu … zostały zaktualizowane” — sukces; obok są odnośniki „Kliknij tutaj, aby otworzyć w PBN” i „Otwórz widok wysłanych danych”,
  • żółte ostrzeżenia o autorach („… nie zostanie oświadczona w PBN, gdyż autor nie posiada odpowiednika w PBN”) — praca może zostać wysłana, ale bez oświadczenia tej osoby; popraw autora i wyślij jeszcze raz,
  • żółty „Rekord … nie zostanie wysłany do PBN: …” — praca nie poszła; po dwukropku jest powód (na obrazku: język pracy nie ma odpowiednika w PBN). Sposoby naprawy — w tabeli Komunikat → co zrobić,
  • niebieski — przypomnienie o autoryzacji (punkt 1).

Wysyłka w tle

Po „Zapisz i wyślij do PBN w tle” zobaczysz komunikat „Utworzono zlecenie wysyłki rekordu … w tle do PBN. Kliknij tutaj, aby śledzić stan.” Odnośnik prowadzi do wpisu w kolejce eksportu (punkt 4).

Komunikat „Utworzono zlecenie wysyłki rekordu … w tle do PBN” z odnośnikiem „Kliknij tutaj, aby śledzić stan”

Jeśli ta praca już czeka w kolejce, BPP nie doda jej drugi raz — pokaże „Rekord … jest już w kolejce do eksportu do PBN.”

3. Wyślij wiele prac naraz

  1. W module redagowania otwórz listę wydawnictw ciągłych albo zwartych i zawęź ją (filtr, wyszukiwanie), np. do jednego roku.
  2. Zaznacz prace w pierwszej kolumnie.
  3. Na dolnym pasku wybierz akcję „Wyślij do PBN w tle” i kliknij „Wykonaj”.

Lista wydawnictw ciągłych: zaznaczone prace, akcja „Wyślij do PBN w tle”, przycisk „Wykonaj”

BPP potwierdzi: „Zakolejkowano N rekordów do wysyłki do PBN. Proces przebiega w tle.” Prace pojawią się w kolejce eksportu po chwili.

Akcja Limit Uwagi
Wyślij do PBN w tle do 2000 prac naraz zalecana; prace już czekające w kolejce są pomijane
Wyślij do PBN do 10 prac naraz wysyła od razu, jedna po drugiej — przy większej liczbie BPP odmówi: „Możesz wysłać maksymalnie 10 rekordów naraz.”

4. Kolejka eksportu do PBN

Menu PBN → kolejka eksportu do PBN pokazuje każdą pracę wysyłaną w tle: kto ją zlecił, kiedy, ile było prób i jak się skończyło.

Kolejka eksportu do PBN: przyciski zbiorczej ponownej wysyłki i filtry statusów

Statusy

Przyciski filtrów u góry liczą wpisy w każdym stanie; ikona w kolumnie Status mówi to samo dla pojedynczej pracy.

Filtr (ikona w kolumnie Status) Znaczenie Co zrobić
Zakonczone pomyslnie (ptaszek) praca jest w PBN nic
Bledy merytoryczne (trójkąt) PBN albo BPP odrzuciły dane pracy (brak DOI, brak oświadczeń, błąd walidacji w PBN) popraw pracę i wyślij ponownie
Bledy techniczne (krzyżyk) awaria po drodze (np. błąd serwera PBN, brak uprawnień konta) wyślij ponownie; jeśli wraca — zgłoś (patrz niżej)
W trakcie/oczekujace (zegar) zlecona, wysyłana albo czeka na ponowienie poczekaj
w tym: (kłódka) czeka, aż zlecający zaloguje się do PBN autoryzuj się (punkt 1)
Wykluczone (kółko z minusem) tego rodzaju pracy BPP celowo nie wysyła (ustawienie charakteru formalnego, praca bez punktów przy wyłączonym eksporcie PK=0) to nie błąd; zmienić może tylko administrator

BPP sam ponawia wysyłkę, gdy przyczyna jest przejściowa: po zablokowaniu pracy w PBN — po kilku minutach, przy pracach serwisowych PBN — po kilku godzinach. Błędów merytorycznych nie ponawia — czekają na Ciebie.

Przyciski zbiorcze

Nad filtrami (widać tylko te, które mają coś do zrobienia):

  • Obudz wysylke (N) — wysyła wpisy, których nikt jeszcze nie podjął,
  • Wyslij ponownie bledy techniczne (N) — ponawia wszystkie błędy techniczne,
  • Wyslij oczekujace (N) — ponawia wpisy czekające na autoryzację (najpierw się zaloguj),
  • pod filtrami Wyslij widoczne rekordy — ponawia to, co jest akurat na liście (do 100 wpisów); najpierw zawęź listę filtrem, rokiem albo wyszukiwaniem w tytule.

Odswiezaj co 5 sekund odświeża tabelę bez przeładowania strony.

Czytanie błędu

Pod każdą pracą zakończoną błędem lista pokazuje skrót powodu:

Lista błędów w kolejce: wykluczenie, błąd HTTP 500, brak oświadczeń, brak DOI/WWW, zduplikowany ISBN, błąd walidacji PBN

Kliknij wiersz (albo Szczegoly), aby otworzyć pełny opis:

Szczegóły wpisu kolejki: powód błędu, „Edytuj w admin”, „Wyslij do PBN”

  1. Przeczytaj powód. Przy błędzie od PBN widać „Blad po stronie PBN -- kod …” i Szczegoly bledu — nazwę pola i komunikat PBN (na obrazku: brak daty udostępnienia w otwartym dostępie).
  2. Popraw pracę — Edytuj w admin otwiera jej formularz.
  3. Wyślij ponownie — przycisk Wyslij do PBN na stronie szczegółów (albo „Zapisz i wyślij do PBN w tle” w formularzu pracy).

Niżej na stronie szczegółów:

  • Wyslane dane JSON — dokładnie to, co poszło do PBN; przyciski „JSON wyslanych danych” (kopiuje) i „Pobierz plik JSON”,
  • Zgloszenie do helpdesku PBN — kopiuje do schowka gotową treść zgłoszenia z opisem błędu i wysłanymi danymi; wklej ją w e-mail do pomocy technicznej PBN, gdy błąd leży po ich stronie,
  • Prompt dla AI — kopiuje opis problemu do wklejenia w czat AI,
  • Historia komunikatow — wszystkie próby wysyłki po kolei,
  • Usun z kolejki — usuwa wpis (pracy nie usuwa, ani w BPP, ani w PBN).

5. Import, pobieranie danych i komparatory

Te narzędzia działają w drugą stronę — z PBN do BPP — i łatwo je pomylić.

Import z PBN Pobieranie danych z PBN
Co robi tworzy w BPP rekordy na podstawie PBN: prace, autorów, źródła, wydawców, oświadczenia odświeża lokalną kopię danych PBN przechowywaną w BPP (publikacje i oświadczenia instytucji, osoby, źródła)
Czy zmienia rekordy BPP dodaje tylko te prace, których w BPP jeszcze nie ma (bez powiązanego odpowiednika w PBN); istniejących nie nadpisuje nie — zmienia tylko kopię danych PBN
Jak często jednorazowo (np. przy wdrożeniu BPP) albo „Aktualizacja” — rzadko, świadomie regularnie, przed każdym porównaniem; strona ostrzega, gdy dane mają ponad 7 dni
Wymaga autoryzacji w PBN tak tak

Import z PBN

PBN → Import z PBN. Do wyboru są trzy gotowe zestawy: Wszystko, Aktualizacja (autorzy, publikacje, oświadczenia i opłaty) i Tylko źródła (źródła i ich punktacja). Bez aktywnej autoryzacji strona pokazuje „Brak aktywnej sesji PBN” z przyciskiem Zaloguj się do PBN. Postęp i wynik widać w Historii importów.

Import z PBN: ostrzeżenie „Brak aktywnej sesji PBN” i zestawy „Wszystko”, „Aktualizacja”, „Tylko źródła”

Import tworzy nowe rekordy

Praca z PBN, której BPP nie powiązał z istniejącym rekordem, zostanie dodana jako nowa — to może dać duplikat pracy wprowadzonej wcześniej ręcznie. Na bieżącej bazie częściej potrzebujesz pobierania danych i komparatorów, a importu — po uzgodnieniu z administratorem.

Pobieranie danych z PBN

PBN → pobieranie danych z PBN („PBN Downloader”). Trzy niezależne przyciski: Pobierz publikacje z PBN, Pobierz osoby z PBN, Pobierz zrodla z PBN. Każde pobieranie może potrwać kilka minut; status (data, użytkownik, ewentualny błąd) widać pod przyciskiem.

PBN Downloader: przycisk „Pobierz publikacje z PBN” i status pobierania

Komparatory — czego brakuje po której stronie

Komparatory porównują BPP z lokalną kopią PBN — najpierw pobierz świeże dane, inaczej wyniki będą nieaktualne (strony same o tym ostrzegają).

Narzędzie (menu PBN) Na co odpowiada
komparator PBN przegląd za okres ewaluacji 2022–2025: ile prac nigdy nie wysłano do PBN, prace w PBN nieistniejące w BPP, prace i autorzy skasowani w PBN, a nadal powiązani w BPP, źródła skasowane w PBN, liczba rozbieżności dyscyplin; każdy kafelek ma przycisk „Pokaż w module redagowania” z gotową listą
komparator publikacji PBN prace powiązane z PBN, których dane się różnią (tytuł, rok, DOI, ISBN, ISSN, WWW, liczba autorów; dodatkowe pola do wyboru); tabela „Wartość w BPP / Wartość w PBN”, eksport do XLSX
komparator źródeł PBN czasopisma z inną punktacją albo dyscyplinami niż w PBN; „Ustaw punkty wg PBN” przepisuje punkty z PBN
komparator udziałów PBN („Problemy PBN”) rozbieżności dyscyplin autorów w pracach między BPP a oświadczeniami w PBN oraz oświadczenia z PBN, którym w BPP brakuje autora, powiązania autora z pracą albo samej pracy
źródła skasowane w PBN źródła usunięte w PBN, do przemapowania na aktualne

Komparator PBN: sekcja „Publikacje - rozbieżności między PBN a BPP”

Komparator publikacji przegląda do 100 prac każdego typu naraz — przy dużej bazie zawęź lata albo wyszukaj po tytule, DOI lub ISBN. Komparatory źródeł i udziałów mają przycisk Przebuduj — przelicza rozbieżności po pobraniu nowych danych.

Komunikat → co zrobić

Najczęstsze komunikaty z formularza pracy i z kolejki eksportu (w kolejce ten sam powód bywa poprzedzony nazwą błędu, np. DOIorWWWMissing:).

Komunikat (fragment) Przyczyna Co zrobić
„Najpierw wykonaj autoryzację w PBN API …” nie jesteś zalogowany do PBN PBN → autoryzuj PBN API (w komunikacie stoi „operacje → autoryzuj w PBN” — to stara nazwa menu)
„Brak dostępu z powodu nieprawidłowego tokena -- wymagana autoryzacja w PBN” / w kolejce „Użytkownik bez autoryzacji w PBN, spróbuję po zalogowaniu do PBN.” autoryzacja wygasła autoryzuj się ponownie; wpisy z kolejki ruszą same
„Brak dostępu -- najprawdopodobniej użytkownik nie posiada odpowiednich uprawnień po stronie PBN/POLON” / w kolejce „Brak uprawnień …” Twoje konto PBN nie ma uprawnień do publikacji instytucji poproś osobę zarządzającą kontami PBN w uczelni o nadanie roli
„Musi być DOI lub adres WWW” praca nie ma DOI ani adresu WWW uzupełnij DOI albo WWW
„Język rekordu "…" nie ma określonego odpowiednika w PBN” język nie jest powiązany ze słownikiem PBN zgłoś administratorowi (słownik języków) albo, jeśli język jest błędny, popraw go w pracy
„Nie wyślę rekordu artykułu lub rozdziału bez zadeklarowanych oświadczeń autorów (dyscyplin).” żaden autor nie ma w tej pracy dyscypliny uzupełnij dyscypliny autorów w pracy; wysyłkę prac bez oświadczeń może włączyć administrator
„Autor … ma w tej pracy przypiętą dyscyplinę i afiluje, ale nie zostanie oświadczona w PBN, gdyż autor nie posiada odpowiednika w PBN.” autor nie jest powiązany z osobą w PBN w formularzu autora wybierz Odpowiednik w PBN (pomoże importer autorów PBN) i wyślij pracę ponownie
„Wygląda na to, że wydawnictwo nadrzędne tego rekordu nie posiada odpowiednika w PBN …” rozdział, którego książka nie jest jeszcze w PBN najpierw wyślij książkę (albo ustaw jej Odpowiednik w PBN), potem rozdział
„Rekord … został odrzucony przez PBN z powodu błędów walidacji danych: …” / w kolejce „Blad po stronie PBN -- kod 400” PBN nie przyjął danych; lista pod spodem mówi, które pole popraw wskazane pole, np. openAccess.releaseDate „Data udostępnienia w otwartym dostępie jest wymagana!” — uzupełnij dane otwartego dostępu
NOT_UNIQUE_PUBLICATION_ISBN_ISMN „Publikacja o identycznym ISBN już istnieje!” ta książka już jest w PBN nie wysyłaj jej drugi raz — powiąż pracę z istniejącą w PBN (pole Odpowiednik w PBN)
„… obiekt po stronie serwera PBN jest zablokowany. Spróbuj ponownie za jakiś czas.” / w kolejce „Zasób zablokowany w PBN (HTTP 423), ponawiam wysyłkę za kilka minut...” ktoś (albo inny proces) właśnie zmienia tę pracę w PBN poczekaj; kolejka ponowi sama
„Po stronie PBN trwają prace serwisowe …” / „Prace serwisowe w PBN, spróbuję za kilka godzin” przerwa techniczna PBN poczekaj; kolejka ponowi sama
„Identyczne dane rekordu … zostały wgrane do PBN w dniu … Nie aktualizuję w PBN API.” od ostatniej wysyłki nic się nie zmieniło nic — praca jest aktualna; aby mimo to wysłać, zmień coś w pracy albo poproś administratora o usunięcie wpisu o wysłanych danych
„Eksport prac z PK=0 jest wyłączony w konfiguracji.” / „Wykluczone: Eksport prac bez punktów PK wyłączony w konfiguracji.” artykuł lub rozdział bez punktów, a uczelnia nie wysyła takich prac uzupełnij punkty, jeśli praca je ma; inaczej to zamierzone
„Rekord … nie będzie eksportowany do PBN zgodnie z ustawieniem dla charakteru formalnego.” / „Wykluczone: Charakter formalny tego rekordu nie jest ustawiony jako wysyłany do PBN …” ten charakter formalny nie jest wysyłany do PBN sprawdź, czy charakter formalny pracy jest właściwy; zmiana ustawienia — administrator
„Wystąpił błąd HTTP z PBN, załączam traceback” (np. HTTP 500) awaria po stronie PBN Wyslij ponownie bledy techniczne; jeśli błąd wraca — Zgloszenie do helpdesku PBN
„Rekord … jest już w kolejce do eksportu do PBN.” praca czeka już w kolejce sprawdź jej stan w kolejce
„Możesz wysłać maksymalnie 10 rekordów naraz.” za dużo zaznaczonych prac dla wysyłki od razu użyj akcji „Wyślij do PBN w tle” (do 2000)

Co może pójść nie tak

  • Nie ma menu „PBN” — konto nie jest w grupie „wprowadzanie danych” albo uczelnia nie ma włączonej integracji z PBN.
  • Nie ma przycisków „Zapisz i wyślij do PBN” — wyłączone „Włącz opcjonalną aktualizację przy edycji” w ustawieniach uczelni.
  • Po autoryzacji: „Nie można zakończyć autoryzacji w PBN API - nie znaleziono aktualnej autoryzacji rozpoczętej w tej sesji …” — logowanie w PBN trwało dłużej niż 10 minut albo zaczęto je w innym oknie. Kliknij ponownie „autoryzuj PBN API”.
  • „Bez możliwości autoryzacji - błąd odpowiedzi z serwera autoryzacyjnego …” albo **„Nie można autoryzować zalogowania do PBN
  • …”** — problem z konfiguracją aplikacji w PBN; zgłoś administratorowi.
  • Praca zlecona w tle długo „W trakcie/oczekujace” — sprawdź, czy nie ma kłódki (autoryzacja); jeśli nie, kliknij Obudz wysylke.
  • Komparator pokazuje „Dane PBN nieaktualne” — uruchom pobieranie danych z PBN i odczekaj, aż się skończy.

Zobacz też

  • Integracja z PBN API — konfiguracja po stronie administratora,
  • Wydawnictwa — m.in. dlaczego nie można usunąć pracy z wpisanym „Odpowiednikiem w PBN”,
  • Autorzy — identyfikatory autora, w tym ORCID.