...
Info | ||
---|---|---|
| ||
Analizator bazy danych można pobrać tutaj. Przed uruchomieniem prosimy o zapoznanie się z dokumentacją programu, która znajduje się poniżej. Dokumentacja dotyczy zawsze najbardziej aktualnej wersji analizatora. Historia wersji dostępna jest tutaj. |
Informacje ogólne
Uruchamianie
Do uruchomienia programu, poza archiwum JAR z tym programem, niezbędna jest maszyna wirtualna Java (JRE) w wersji 5.0 oraz archiwum JAR ze sterownikiem JDBC. Uruchomienie programu następuje poprzez wykonanie następującego polecenia (w jednej linijce):
No Format |
---|
java -cp dl-db-analyzer-current.jar:<ścieżka do archiwum JAR ze sterownikiem JDBC>:<dodatkowe zależności dla konkretnego raportu> pl.psnc.dlibra.server.util.databaseanalyser.Main <ścieżka do pliku konfiguracyjnego> <ścieżka do katalogu przeznaczonego na wygenerowany raport> |
...
Parametry konfiguracyjne można podzielić na parametry ogólne (dotyczące wszystkich rodzajów raportów) oraz parametry związane z konkretnym rodzajem raportu. Aktualnie wyróżnia się parametry opisane poniżej.
Ogólne parametry konfiguracyjne
...
Parametry połączenia z bazą danych
...
No Format |
---|
hibernate.connection.driver_class hibernate.connection.url hibernate.connection.username hibernate.connection.password |
...
Note | ||
---|---|---|
| ||
Analizator bazy danych będzie pracował na bazie danych Państwa biblioteki cyfrowej. Nie dokonuje on zmian w tej bazie, jednak jego działanie może w znacznym stopniu tę bazę obciążyć. Dlatego też zaleca się generowanie raportów w godzinach mniejszego obciążenia biblioteki cyfrowej żądaniami czytelników lub też pracę na kopii bazy danych biblioteki. |
...
Inne parametry ogólne
...
No Format |
---|
libraryAddress |
Wartość tego parametru zawiera adres WWW stron biblioteki cyfrowej, dla której generowany jest raport. Wartość ta wykorzystywana jest do generowania hiperłączy w raporcie i powinna kończyć się znakiem /
. Przykładowe poprawne wartości to http://www.wbc.poznan.pl/
czy http://dlibra.psnc.pl/biblioteka/
.
No Format |
---|
className |
Nazwa klasy odpowiadająca typowi generowanego raportu. Nazwa ta zmienia się w zależności od raportu - szczegółowe informacje znajdują się poniżej, przy informacjach dotyczących konkretnych raportów.
Dostępne raporty
Raport na temat wydań opublikowanych przez określonych użytkowników w określonych zakresie czasu
Raport pozwalający na wygenerowanie zestawienia opublikowanych wydań dodanych przez określonych użytkowników (jeden lub wielu) w podanym zakresie czasu (z dokładnością do miesiąca). Raport zawiera również liczbę wyświetleń każdej publikacji do momentu wygenerowania raportu. W raporcie będę uwzględnione te publikacje, które zostały dodane w podanym okresie czasu, są opublikowane i ostatnią modyfikację przeprowadził na nich któryś z wybranych użytkowników.
Przykładowy raport dla Biblioteki Cyfrowej Projektu dLibra można obejrzeć pobrać tutaj.
W celu wygenerowania tego raportu należy podać następującą wartość parametru className
:
No Format |
---|
className=pl.psnc.dlibra.server.util.databaseanalyser.editorstats.EditorStatsGenerator |
...
Dodatkowe zależności raportu
...
Raport ten wymaga pobrania i dołączenia do parametru cp
dwóch dodatkowych plików:
...
Parametry konfiguracyjne raportu
...
No Format |
---|
esg.startMonth=2005.01 esg.endMonth=2007.12 |
Pierwszy Powyższe dwa parametry określają pierwszy i ostatni miesiąc zakresu, dla którego ma zostać wygenerowany raport. Format daty to <rok - 4 cyfry>.<miesiąc - 2 cyfry>. Powyższe wartości spowodują wygenerowanie raportu za okres od stycznia 2005 do grudnia 2007 włącznie.
No Format |
---|
esg.users=red1,red2 |
...
esg.group=12345
|
Powyższe dwa parametry pozwalają na określenie dla jakich użytkowników zostanie wygenerowany raport i powinny być używane zamiennie. Ich znaczenie jest następujące:
- Użycie pierwszego parametru pozwala na podanie wprost listy loginów użytkowników (redaktorów), dla których ma być wygenerowany raport
...
- . Można podać jednego użytkownika lub kilku, przy czym poszczególne loginy należy rozdzielać znakiem przecinka.
- Użycie drugiego parametru spowoduje, że do raportu wybrani zostaną wszyscy redaktorzy należący do grupy o podanym identyfikatorze.
- Brak któregokolwiek z tych dwóch parametrów spowoduje, że do raportu wybrani zostaną wszyscy redaktorzy.
No Format |
---|
esg.separatedseparatedTime=false esg.separatedUsers=false |
Powyższe dwa parametry pozwalają na określenie w jaki sposób raport ma być podzielony na poszczególne pliki HTML.
- Wartość
...
- pierwszego parametru określa, czy raport z całego okresu będzie wygenerowany do pojedynczego pliku (wartość
false
) czy też dane z poszczególnych miesięcy będą zawarte w osobnych plikach (wartośćtrue
). - Wartość drugiego parametru określa, czy raport dla wszystkich użytkowników będzie wygenerowany w postaci pojedynczej tabeli (wartość
false
) czy też dane na temat poszczególnych redaktorów będą zawarte w osobnych plikach (wartośćtrue
).