Skip to main content

Sposoby odwołań do danych

Aplikacja nie musi przy uruchamianiu otwierać się na pierwszej stronie. Oprócz ustawienia wewnętrznego parametru powodującego uruchomienie aplikacji z widokiem konkretnego miejsca i w konkretnej skali, możliwe jest również odwoływanie się do konkretnego miejsca podając te parametry w URL.

Aby uniezależnić odwołania do ksiąg i stron od wbudowanego odwoływania się poprzez współrzędne, możliwe jest odwoływanie się za pomocą oddzielnej usługi typu proxy (indxr/p.php)

Parametry których można użyć to: app: której aplikacji użyć, dopuszczalne wartości to: indxr i indxr-viewer. Można też nie podawać tego parametru. book: nazwa księgi taka jak w adresie IDXRa (i w tabeli indxr2.config). Musi wystąpić. page: karta, co do zasady powinna się zgadzać z nazwą pliku ze skanem tej karty, ale bez zer i bez podkreśleń, na przykład 13v dla 0013_v.JPG albo 0013v.jpg albo 013v.JPG zoom: tylko w połączeniu z app=indxr, oznacza stopień powiększenia obrazu record: tylko w połączeniu z app=indxr-viewer, powoduje przejście do strony z podanym hasłem i podświetlenie go x: współrzędna x w widoku księgi w INDXR, y: współrzędna y w widoku księgi w INDXR. Współrzędne x,y muszą wystąpić razem, inaczej nie zadziałają, jeżeli zostaną podane jednocześnie z nr strony (page) to nr strony nie będzie brany pod uwagę. Współrzędne działają tylko dla edytora INDXR. To czy użyć przekierowania do indxr czy indxr-viewer każdy może zdecydować sam. Natomiast jeżeli ktoś nie chce sam o tym decydować może nie podawać tego parametru. Decyzja zostanie podjęta automatycznie. Hipotetycznie możliwa jest sytuacja że bez modyfikacji wywołania URL, to co dzisiaj przekierowuje do INDXR Edytora, jutro będzie automatycznie przekierowywało do INDXR Viewer’a Algorytm przekształcania nr strony w lokalizację na skanie zakłada zasadę 4-cyfrowej numeracji skanów z suffixem recto-verso w postaci _r lub _v. W tej chwili automatyzm dopuszcza wyjątki typu 3-cyfrowa numeracja lub brak suffixu, lub suffix tylko jednego rodzaju. Ale ma to swoje granice… Oczywiście cały czas mowa o wymaganiach co do nazw skanów do których ma zostać przekształcony nr strony. W tej chwili automatyzm kieruje się ogólną zasadą, że dopóki nie zostaną podane współrzędne ani nie zostanie explicite podany edytor, to następuje przekierowanie do viewera.

Przykłady:

strona 13r w określonej skali

strona 256r

strona 126 w aplikacji typu „przeglądarka”

wskazane miejsce na strona 13r, w określonej skali

element o identyfikatorze 121

strona 13r w aplikacji INDXR

wskazane miejsce na strona 13r, w określonej skali, bez korzystania z proxy

INDXR jest częścią infrastruktury Dariah.lab stworzonej w ramach projektu DARIAH-PL