10 | | 1. Eksport - Przygotowanie paczki z modułem |
11 | | 2. Import paczki do lokalnego repozytorium marketu |
12 | | 3. Instalacja paczki z marketu |
13 | | |
14 | | W systemie eDokumenty od wersji 4.10 został udostępniony eDokumenty Market dzięki, któremu możemy przenosić gotowe moduły między systemami. |
15 | | |
16 | | eDokumenty Market jest dostępny w Ustawienia > Panel sterowania w sekcja Narzędzia administracyjne (wymagane jest prawo bswfms.tools.market). |
17 | | |
18 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market01.jpg, 400)]][[BR]] |
19 | | eDokumenty Market został podzielony na trzy sekcje: |
20 | | * Zainstalowane - modułu dostępne w naszym systemie |
21 | | * Dostępne - moduły w bazie lokalnej marketu do zainstalowania |
22 | | * Market - moduły stworzone oraz udostępnione przez innych twórców modułów |
23 | | |
24 | | == Eksport - Przygotowanie paczki z modułem == |
25 | | |
26 | | Wybieramy moduł, który chcemy przenieść do innego systemu. Po kliknięciu w przycisk Eksportuj zostanie uruchomiony skrypt Migration Custom Modules dzięki któremu krok po krok przejdziemy przez proces przygotowania paczki instalacyjnej. |
27 | | |
28 | | Krok 1. Exporter Custom Modules[[BR]] |
29 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market02.jpg, 400)]][[BR]] |
30 | | |
31 | | Krok 2. Własności Custom Module[[BR]] |
32 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market03.jpg, 400)]][[BR]] |
33 | | |
34 | | Przedstawienie zawartości modułu, z którego przygotowujemy paczkę instalacyjną - zakładki utworzone w module, podłączone raporty oraz przyciski zadeklarowane w pliku !CustomModules.xml. |
35 | | |
36 | | Krok 3. Rejestry[[BR]] |
37 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market04.jpg, 400)]][[BR]] |
38 | | |
39 | | Wybieramy rejestry na których został oparty nasz moduł. Jeśli moduł nie wymaga rejestru pozostawiamy to pole niezmienione. |
40 | | |
41 | | Krok 4. !CustomWidget[[BR]] |
42 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market05.jpg, 400)]][[BR]] |
43 | | |
44 | | Przedstawia listę przycisków dodanych przez mechanizm !CustomWidget wraz z definicją. Przyciski, które zostały wykorzystane w module. |
45 | | |
46 | | Krok 5. Skrypty [[BR]] |
47 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market06.jpg, 400)]][[BR]] |
48 | | |
49 | | Lista skryptów wykorzystanych w module, jeśli moduł wykorzystuje skrypty napisane przez nas należy je dodać do paczki. Nie należy dodawać skryptów domyślnie dostępnych w systemie. |
50 | | |
51 | | Krok 6. Komendy [[BR]] |
52 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market07.jpg, 400)]][[BR]] |
53 | | |
54 | | Lista Komend wykorzystanych w module, jeśli moduł wykorzystuje komendy napisane przez nas należy je dodać do paczki. Nie należy dodawać komend domyślnie dostępnych w systemie. |
55 | | |
56 | | Krok 7. Informacje o module [[BR]] |
57 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market08.jpg, 400)]][[BR]] |
58 | | W przedostatnim kroku eksportu modułu uzupełniamy opis samego modułu. Możemy umieścić takie informację dla osób na co zwrócić uwagę podczas instalacji modułu z przygotowanej przez nas paczki. |
59 | | |
60 | | Krok 8. Zakończenie [[BR]] |
61 | | [[Image(wiki:NewBusinessAdmin/Attachments:edokumenty_market09.jpg, 400)]][[BR]] |
62 | | |
63 | | Ostatnie krok to eksport przygotowanej paczki do pliku *.zip. Eksport zostanie wykonany w chwili kliknięcia w ikonę paczki. |
64 | | |
65 | | == Import paczki do lokalnego repozytorium marketu == |
66 | | |
67 | | Przygotowaną wcześniej paczkę przed instalacją musimy zaimportować do lokalnego repozytorium marketu z którego potem moduł zostanie zainstalowany.[[BR]] |
68 | | 1. Uruchamiamy eDokumenty Market z poziomu systemu - Ustawienia > Panel sterowania w sekcja Narzędzia administracyjne. |
69 | | 2. Następnie klikamy na dodaj aplikację, po pojawieniu się nowego okna wskazujemy lokalizację z wcześniej wyeksportowaną paczką modułu i potwierdzamy. |
70 | | 3. W module eMarketu klikamy na Aktualizuj. Zaimportowana paczka pojawi się w naszym lokalnym markecie w części Dostępne. |
71 | | |
72 | | == Instalacja paczki z marketu == |
73 | | |
74 | | '''Uwaga''' |
75 | | |
76 | | W systemie linux, aby był możliwy import ikonek używanych przez !CustomModule należy przydzielić uprawnienia dla www-data, poniżej znajduje się przykładowy skrypt. |
77 | | |
78 | | {{{ |
79 | | #!/bin/bash |
80 | | |
81 | | cd ../../.. |
82 | | chmod o+w commands |
83 | | chmod o+w var/tpl |
84 | | chmod o+w scripts |
85 | | chmod o+w ../../framework/img/toolbarIcons/24x24/ |
86 | | chmod o+w ../../framework/img/toolbarIcons/small/ |
87 | | chmod o+w ../../framework/img/PageToolBar |
88 | | |
89 | | }}} |
90 | | |
91 | | Paczki z modułami już znajdujące się w markecie oraz te które dodajemy do lokalnego marketu musimy zainstalować w systemie eDokumenty. |
92 | | 1. Uruchamiamy eDokumenty Market z poziomu systemu - Ustawienia > Panel sterowania w sekcja Narzędzia administracyjne. |
93 | | 2. Wybieramy paczkę z modułem, którą chcemy zainstalować |
94 | | 3. Klikamy Zainstaluj. |
95 | | |
96 | | Zainstalowany moduł będzie dostępny po przelogowaniu się w systemie. Ostatnim krokiem jest dostosowanie modułu do instancji na której został zainstalowany, ID statusów, teczek, a także utworzenie definicji uprawnień. |
97 | | |
98 | | |
99 | | |
100 | | |
| 3 | Dokumentacja modułu eMarket znajduje się pod poniższym adresem [http://dokumentacja.edokumenty.eu/index.php/tutoriale/edokumenty-market/ link] |