| 15 | | [[Image(wiki:NewBusinessAdmin/Attachments: , 250)]][[BR]] |
| | 15 | == Tworzenie nowego raportu == |
| | 16 | |
| | 17 | Dodawanie nowego raportu w module '''Raporty''' rozpoczynamy po kliknięciu ikony '''Nowy''' w '''Pasku narzędzi'''. Wypełniamy pola '''Tytuł''' oraz wybieramy wartość z listy '''[http://support.edokumenty.eu/trac/wiki/NewBusinessAdmin/Reports/Groups Grupa]'''. Opcjonalnie uzupełniamy pozostałe pola i klikamy '''Zapisz'''. [[BR]] |
| | 18 | |
| | 19 | [[Image(wiki:NewBusinessAdmin/Attachments:nowy_raport.png, 600)]][[BR]] |
| | 20 | ''Okno dodawania nowego raportu'' [[BR]] |
| | 21 | |
| | 22 | Po zapisaniu podstawowych informacji, formularz raportu zostaje poszerzony o kolejne zakładki, z których najważniejszą jest '''Definicja'''. W polu '''Kwerenda''' w tej karcie wpisujemy kwerendę '''SQL''' definiującą raport, np. '''SELECT * FROM events''', po czym klikamy '''Zapisz'''. [[BR]] |
| | 23 | |
| | 24 | __'''Uwaga'''__ [[BR]] |
| | 25 | Zapytanie musi zwracać przynajmniej 1 rekord. Użyteczne konstrukcje i funkcje językowe SQL oraz przykładowe zapytania do bazy eDokumenty można znaleźć [http://support.edokumenty.eu/trac/wiki/DeployerGuide/Custumization/AdvancedReporting/SQLExamples tutaj] [[BR]] |
| | 26 | |
| | 27 | [[Image(wiki:NewBusinessAdmin/Attachments:nowy_raport.png, 600)]][[BR]] |
| | 28 | ''nowy_raport_wszystkie zakładki.png'' [[BR]] |
| | 29 | |
| | 30 | W kwerendach możemy stosować parametry: |
| | 31 | |
| | 32 | {{{ |
| | 33 | {DATE_FROM} (string) - np. adddat::date >= '{DATE_FROM}' |
| | 34 | {DATE_TO} (string) - np. adddat:: <= '{DATE_TO}' |
| | 35 | {USR_ID} (string) - przecinkami rozdzielona lista użytkowników, do których ma dostęp zalogowany użytkownik |
| | 36 | {LOGGED_USR_ID} (int) - id zalogowanego pracownika |
| | 37 | {ENT_ID} (int) - id jednostki, na której jest wykonywany raport |
| | 38 | {SYMBOL} (string) - symbol kontrahenta z systemu zewnętrznego |
| | 39 | {EXTEID:OPTIMA}(int) - symbol kontrahenta z systemu Optima |
| | 40 | {ACORID} (int) - id jednostki rozliczeniowej |
| | 41 | {TOVCID} (int) - id rodzaju kosztów |
| | 42 | {CONTID} (int) - id kontrahenta (przy raportach wykonywanych w kartoteki) |
| | 43 | {CONTIDS} (int[]) - id kontrahentów zaznaczonych na liście w module Klienci |
| | 44 | {DOC_ID} (int) - id dokumentu (przy raportach wykonywanych z kartoteki) |
| | 45 | {DOC_IDS} (int[]) - id dokumentów zaznaczonych na liście (równoważny zapis: {DOCIDS} |
| | 46 | {PRC_ID} (int) - id sprawy (przy raportach wykonywanych w kartoteki) |
| | 47 | {PRC_IDS} (int[]) - id spraw zaznaczonych na liście (równoważny zapis: {PRCIDS} |
| | 48 | {EVNTID} (int) - id zdarzenia (przy raportach wykonywanych w kartoteki) |
| | 49 | {EVNTIDS} (int[]) - id zdarzeń zaznaczonych na liście |
| | 50 | {CAMPID} (int) - id kampanii |
| | 51 | {DEVCID} (int) - id urządzenia (przy raportach wykonywanych w kartoteki) |
| | 52 | {DEVCIDS} (int[]) - id urządzeń zaznaczonych na liście |
| | 53 | {DEPOID} (int) - id produktu |
| | 54 | {DEPOIDS} (int[]) - id produktów zaznaczonych z listy produktów |
| | 55 | {FILTER_STRING} (string) - wartość zwrócona przez filtr |
| | 56 | {ORUNID} - lista stanowisk, do których ma prawo zalogowany użytkownik (lista orunid) |
| | 57 | }}} |
| | 58 | |
| | 59 | Będą one mapowane na formularzu "Parametry raportu" i z odpowiednich pól pobierane będą wartości.[[BR]] |
| | 60 | [[BR]] |
| | 61 | Cała definicja raportu jest dodatkowo przepuszczana przez silnik parsujący (np. w workflow). Daje to dodatkowe możliwości (np. dynamiczne parametry w raportach wykonywanych na zewnętrznych źródłach danych). Przykładowe zapytanie z raportu dla dokumentu: |
| | 62 | |
| | 63 | {{{ |
| | 64 | #!sql |
| | 65 | SELECT * FROM mssql_external_documents WHERE symbol = '{SQL::SELECT ex_sym FROM documents WHERE doc_id = {DOC_ID}}' |
| | 66 | }}} |
| | 67 | |
| | 68 | W zakładce '''Kolumny''' wybieramy, jakie kolumny mają być wyświetlane. Zaznaczone na liście elementy przenosimy między oknami '''Dostępne''' a '''Aktywne na raporcie''' używając strzałek pomiędzy nimi. |
| | 69 | |
| | 70 | == Import definicji raportu == |
| | 71 | Utworzoną w zewnętrznym narzędziu definicję raportu SQL w postaci pliku '''.report''' możemy zaczytać do modułu, gdzie może być ona modyfikowana (przykładowy plik można znaleźć w załączniku). Aby tego dokonać, klikamy ikonę '''Import raportu''' w '''Pasku narzędzi'''. Następnie klikamy przycisk [[Image(wiki:NewBusinessAdmin/Attachments:raporty_import_przycisk_dodaj_z_dysku.png, 12)]] w oknie '''Import raportu''' i wybieramy plik z dysku. Po prawidłowym wczytaniu definicji raportu, jego nazwa wyświetli się w polu '''Definicja raportu'''. Klikamy przycisk '''Importuj'''.[[BR]] |
| | 72 | |
| | 73 | [[Image(wiki:NewBusinessAdmin/Attachments:raporty_import1.png, 250)]][[BR]] |
| | 74 | ''Kreator importu definicji raportu'' [[BR]] |
| | 75 | |
| | 76 | Po zaczytaniu definicji zostaje otwarte okno edycji raportu, a raport jest widoczny na liście. |
| | 77 | |
