Zmiany pomiędzy wersją 29 and wersją 30 dla DeployerGuide/Customization/ProcessAutomation

Data i czas:

01/28/11 13:11:45 (13 years temu)

Autor:

TS (IP: 213.227.67.33)

Komentarz:

--

DeployerGuide/Customization/ProcessAutomation

@@ -28 +28 @@
 '''Przekaż dokument'''
 
-Komenda służy do automatycznego przekazywania dokumentu na wybrane stanowiska za pomocą komendy oraz procedury.
+Komenda służy do automatycznego przekazywania dokumentu na wybrane stanowiska.
+
+''Parametry:''
  * to = "1" - parametr wskazujący do kogo ma zostać przekazany oryginał , jeśli parametru nie będzie, lub będzie pusty oryginał zostaje.
-
-''Parametry:''
  * dw = "2,3,4,5" - do wiadomości
  * udw = "6,7,8" - ukryte do wiadomości
 
-Każda z tych wartości to orunid (najlepiej sprawdzić w orgtree_view)
+''Przykład zastosowania:''
+to="1",dw="SQL::SELECT orunid FROM users_link_org_units WHERE usr_id ={LOGGED_USER}"
+
+Wszystkie wartości w parametrach to orunid z widoku orgtree_view.
 
 '''Sprawdź czy pole jest wypełnione'''
@@ -45 +48 @@
  * alert = "Wypełnij pole symbol" - wiadomość w przypadku pustej wartości w polu
 
-W przypadku parametru field może on obsłużyć zarówno cechy jak i inne pola.
-W przypadku cechy wpisujemy featid|id cechy z tabeli features dla której będzie wykonywana komenda. Jeśli podamy inny klucz wtedy zostanie od sprawdzony w danych formularza. Klucz wtedy powinien się nazywać tak samo jak nazwa kolumny w bazie w tabeli documents lub processes. Komenda nie pozwala na jednoczesne sprawdzanie dla kilku pól jednak jest możliwość ustawienia kilku tych samych komend z innymi parametrami dla akcji przed lub po zapisie etapu.
-
-W przypadku jeśli cena będzie wpisana etap zostanie zaznaczony jako wykonany.
+''Przykład zastosowania:''
+field="rspuid",alert="Wypełnij pole Osoba odpowiedzialna"
 
 '''Sprawdź prawdziwość warunku SQL'''
 
-Komenda służy do sprawdzania warunku SQL. Komenda może być użyta tylko dla definicji etapu. Przyjmuje 3 parametr 
-
-''Parametry:''
- * query ="SELECT cena IS NOT NULL FROM table WHERE prc_id = {PRC_ID}/doc_id = {DOC_ID}" - sql
+Komenda służy do sprawdzania warunku SQL.
+
+''Parametry:''
+ * query ="SELECT cena IS NOT NULL FROM table WHERE prc_id = {PKEYVALUE}" - zapytanie SQL
  * alert = "Wypełnij pole cena" - wiadomość w przypadku niespełnienia sql
  * success = "Pole cena wypełnione" - wiadomość w przypadku spełnienia sql
 
-W przypadku jeśli cena będzie wpisana etap zostanie zaznaczony jako wykonany.
-
-'''Utwórz zdarzenie'''
-
-Komenda służy do utworzenia zadania dla zalogowanego pracownika lub innego wpisanego w parametrze emp_id jaki usr_id. Zgodnie z #2390. komenda przyjmuje dwa parametry opis zadania oraz emp_id (zgodnie z wymogami komenda akceptuje parametr {LOGGED_USER} który wskazuje na zalogowanego pracownika)
+''Przykład zastosowania''
+query ="SELECT cena IS NOT NULL FROM table WHERE prc_id = {PKEYVALUE}", alert="Wypełnij pole cena", success="Pole cena wypełniono"
+
+'''Utwórz zdarzenie dla pracownika'''
+
+Komenda służy do utworzenia zdarzenia określonego typu (domyślnie zadanie) dla pracownika.
 
 ''Parametry:''
@@ -74 +76 @@
  * ptstid="2" - id etapu z tabeli stages_def lub (ptstid="next") dla następnego etapu (ten parametr nie jest wymagany)
 
+Parametry dscrpt i emp_id są wymagane
+
+''Przykład zastosowania''
+dscrpt="Utwórz kolejny punkt dokumentacji", emp_id="3", trmtyp="TODO"
+
 '''Sprawdź czy istnieje dokument'''
 
-Komenda służy do sprawdzania czy w danej sprawie występuje konkretny dokument. Zgodnie z #2082. komenda przyjmuje dwa parametry typ dokumenty (id z tabeli types_of_documents) oraz status (wartość z kolumny state_ z tabeli documents)
-
-''Parametry:''
- * dctpid="9"
- * state_="2"
-
-'''Zmień status'''
-
-Obecnie przyjmuje tylko jeden parametr jest to klucz główny tpstid z tabeli types_of_processes_states, który oznacza na jaki status zostanie zmieniony status sprawy lub dokumentu.
-
-''Parametry:''
- * tpstid="9"
-
-Czyli do kolumny params w tabeli action_commands wpisujemy np. tpstid="9" lub w interfejsie użytkownika w słownikach
+Komenda służy do sprawdzania czy w danej sprawie występuje konkretny dokument.
+
+''Parametry:''
+ * dctpid="9" - id typu dokumentu ze słownika (Ustawienia -> Panel sterowania -> Dokumenty -> Typy dokumentów -> kolumna id)
+ * state_="2" - identyfikator rodzaju dokumentu 1 - wychodzący, 2 - przychodzący 3 - wewnętrzny
+
+''Przykład zastosowania''
+dctpid="9", state_="2"
+
+'''Zmiana statusu'''
+
+Komenda zmienia status zlecenia (sprawy/dokumentu) na podany w parametrze.
+
+''Parametry:''
+ * tpstid="9" - id statusu ze słownika statusów dla odpowiedniej klasy (Ustawienia -> Panel sterowania -> Ogólne -> Statusy -> kolumna id)
 
 '''Uprawnij grupę pracowników do sprawy'''
 
-Komenda działa niezależnie od tego czy jest ustawiona dla procedury czy etapu. Uprawnia ona wpisana grupe w parametrach na określoną maskę do sprawy. Jeśli dana grupa pracowników została już wcześniej uprawniona wtedy dostajemy komunikat o tym jednak zama sprawa, komenda, etap jest zapisywana.
-
-''Parametry:''
- *  grpnam="Pracownicy" - nazwa grupy z tabeli groups
+Komenda dodaje wskazaną grupę jako uprawnioną w sprawie z zadeklarowaną maską. Jeśli grupa została dodana już wcześniej komenda jest pomijana.
+
+''Parametry:''
+ *  grpnam="Pracownicy" - nazwa grupy która zostania przydzielona do sprawy (Pracownicy -> Grupy)
  *  attrib="rwnd" - maska uprawnień według specyfikacji [wiki:Howto/ProcessPriviligesMask Integracja z systemem Subiekt]
-Oba parametry są wymagane czyli ciąg z parametrami wygląda np. grpnam="Pracownicy",attrib="rwnd"
+
+''Przykład zastosowania''
+grpnam="Pracownicy", attrib="rwnd"
 
 Znaczenie poszczególnych flag:
@@ -110 +120 @@
 '''Utwórz dokument'''
 
-Komenda ta tworzy dokument dla etapu procedury (nie obsługuje utworzenie dokumentu dla procedury). Przyjmuje również tylko 2 parametry i jest nim klucz główny dctpid z tabeli types_of_documents oraz opis jaki zostanie użyty w generowanym dokumencie.
-
-''Parametry:''
- * dctpid="5"  -''id typu dokumentu''
- * dctptp="Note"  -''typ dokumentu''
- * dscrpt="Wezwanie do wykonania etapy procedury"  -''opis dokumentu''
- * do="1"  -''id jednostki do której przekazać dokument(orunid)''
- * dw="2,3,4"  -''(dw = do wiadomości) jeden lub więcej id (rozdzielone znakiem interpunkcyjnym, zwanym przecinkiem) jednostki do której przekazać kopie dokumentu(orunid)''
-
-Przy standardowej instalacji taki parametr utworzy dokument typu notatka służbowa. [[BR]]
-Do kolumny params w tabeli action_commands wpisujemy np. dctpid="5",dscrpt="Wezwanie do wykonania etapy procedury" lub w interfejsie użytkownika w słownikach
-
-Póżniejsza implementacja będzie również uwzględniach parametry z formularza np nazwę etapu, procedury, lub klucz główne jak np prc_id, contid itd. Pełna funkcjonalność parametrów już niebawem ;)
-
-'''Utwórz zadanie dla następnego etapu'''
-
-Komenda tworzy zadanie dla następnego etapu procedury, o ile w kolejnym etapie jest określone stanowisko i jest na nim user. 
-Po załatwieniu zadania automatycznie odznacza się etap procedury. Po załatwieniu etapu procedury, automatycznie zaznaczane jest zadanie jako załatwione.
-
-''Parametry:'' 
- * brak możliwości określenia - mile widziane zgłoszenia w tym temacie
+Komenda ta tworzy dokument określonego typu. Komenda przyjmuje następujące parametry:
+
+''Parametry:''
+ * dctpid="5" - id typu dokumenty (Ustawienia -> Panel sterowania -> Typy dokumentów -> kolumna ID
+ * dctptp="Note" - nazwa klasy typu dokumentu (dctptp z tabeli types_of_documents) parametr zamienny z dctpid
+ * dscrpt="Wezwanie do wykonania etapy procedury" - treść dokumentu
+ * do="1" - id stanowiska na jakie zostanie przekazy dokument (orunid z tabeli organization_units)
+ * dw="2,3,4" - (dw = do wiadomości) jeden lub więcej id (rozdzielone znakiem interpunkcyjnym, zwanym przecinkiem) jednostki do której przekazać kopie dokumentu (orunid z tabeli organization_units)
   
 '''Utwórz przypomnienie'''
@@ -137 +134 @@
 
 ''Parametry:'' 
- * usr_id = dla kogo zostanie utworzone przypomnienie;
- * start_ = kiedy ma się pojawić przypomnienie;
- * dscrpt = opis przypomnienia;
-Wszystkie parametry są wymagane.
+ * usr_id="2" - dla kogo zostanie utworzone przypomnienie (Pracownicy -> Konta pracowników -> kolumna id)
+ * start_="SQL::SELECT now()" - na kiedy ma ustawić przypomnienie
+ * dscrpt="Przypomnienie o zatwierdzeniu etapu" - opis przypomnienia;
 
 '''Przekaż dokument do przełożonego'''
@@ -147 +143 @@
 
 ''Parametry:''
- * emp_id = id użytkownika którego przełożony otrzyma dokument
+ * emp_id="{LOGGED_USER}" - id użytkownika którego przełożony otrzyma dokument domyślnie id zalogowanego (usr_id z tabeli users)
 
 '''Zarejestruj dokument'''
@@ -154 +150 @@
 
 ''Parametry:''
- * reg_id = id rejestru z tabeli registers w którym zostanie zarejestrowany dokument - używany wówczas gdy z góry znamy właściwy dziennik
+ * reg_id=2 - id rejestru z tabeli registers w którym zostanie zarejestrowany dokument - używany wówczas gdy z góry znamy właściwy dziennik. Opcjonalnie można użyć innych parametrów, wówczas system obliczy właściwy dziennik (np. wtedy kiedy dokumenty mogą być rejestrowane w różnych dziennikach - np. jednostek rozliczeniowych)
+
 ''Opcjonalnie można użyć innych parametrów, wówczas system obliczy właściwy dziennik (np. wtedy kiedy dokumenty mogą być rejestrowane w różnych dziennikach - np. jednostek rozliczeniowych):''
- * orunid = id jednostki organizacyjnej po której zostanie wyszukany dziennik (tabela registers kolumna orunid), w przypadku jeśli chcemy aby wartość orunid była pobrana bezpośrednio z formularza np pole jednostka rozliczeniowa na formularzu faktury parametr ten powinien wyglądać w następujący sposób orunid="{acorid}"
- * regtyp = typ rejestru w danym orunid
- * type!__ = typ rejestru (1 = wychodzący, 2 = przychodzący, 3 = wewnętrzny)
+ * orunid="{acorid}" - id jednostki organizacyjnej po której zostanie wyszukany dziennik (tabela registers kolumna orunid), w przypadku jeśli chcemy aby wartość orunid była pobrana bezpośrednio z formularza np pole jednostka rozliczeniowa na formularzu faktury parametr ten powinien wyglądać w następujący sposób orunid="{acorid}"
+ * regtyp="RegOfVatNotes" - typ rejestru w danym orunid (kolumna regtyp z tabeli registers)
+ * type!__="1" - typ rejestru (1 = wychodzący, 2 = przychodzący, 3 = wewnętrzny)
 
 '''Utwórz załącznik z szablonu'''
@@ -165 +162 @@
 
 ''Parametry:''
- * tpl_id = id szablonu z tabeli templates, parametr jest wymagany
+ * tpl_id="23" - id szablonu z tabeli templates, parametr jest wymagany
 
 '''Wysyłanie powiadomienia do grupy'''
@@ -172 +169 @@
 
 ''Parametry:''
- * dscrpt = treść powiadomienia
- * grp_id = id grupy z tabeli groups do której zostanie wysłane powiadomienie
- * grpnam = nazwa grupy (jeśli nie podano grp_id) do której zostanie wysłane powiadomienie
+ * dscrpt="Zebranie zarządu" - treść powiadomienia
+ * grp_id="2" - id grupy, której pracownicy otrzymają powiadomienie (kolumna grp_id z tabeli groups)
+ * grpnam="Zarząd" - zamienny parametr do grp_id, nazwa grupy (kolumna grpnam z tabeli groups)
 
 ----
 ''Informacja dodatkowa''
 
-Wszystkie parametry maja możliwość pobierania wartości w następujący sposób
+Wszystkie parametry maja możliwość pobierania wartości w następujący sposób:
+
  * z cechy (nie dotyczy cech z list wyboru definiowanych przez użytkownika)
    * emp_id = "featid|81"
@@ -185 +183 @@
 
  * bezpośrednio z otwartego formularza
-   * emp_id = "{rspuid}" gdzie wartość {rspuid} zostanie zamieniona na wartość w kolumnie (polu) odpowiedniej tabeli - dla formularza dokumentu documents dla sprawy processes. W podanym przypadku jest to pole rspuid (osoba odpowiedzialna) z tabeli processes.
+   * emp_id = "{rspuid}" gdzie wartość {rspuid} zostanie zamieniona na wartość w kolumnie (polu) odpowiedniej tabeli - dla formularza dokumentu documents (plus dodatkowe tabele) dla sprawy processes. 
+
+W podanym przypadku pole rspuid (osoba odpowiedzialna w sprawie) jest wartością z kolumny rspuid z tabeli processes.
 
  * jako wynik zaptania SQL
    * emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = featid|81"
    * emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = featid::81"
-   * emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = {emp_id}"
-
-Dodatkowo obsługiwane są specjalne wartości parametrów, które można również dodawać do zapytań SQL
- * {LOGGED_USER} - id zalogowanego pracownika
- * {ENT_ID} - id jednostki
- * {PKEYVALUE} - wartość klucza głównego z tabeli documents/processes
-czyli może być
+   * emp_id = "SQL::SELECT usr_id FROM users WHERE usr_id = {rspuid}"
+
+ * predefiniowane parametry
+  * {LOGGED_USER} - id zalogowanego użytkownika
+  * {ENT_ID} - id jednostki na której pracuje użytkownik
+  * {PKEYVALUE} - wartość klucza głównego (id dokumentu/sprawy) patrz klucz główny tabeli documents/processes.
+
+Predefiniowane parametry można używać w następujący sposób
  * emp_id = "SQL::SELECT rspuid FROM processes WHERE prc_id = {PKEYVALUE}"
+ * emp_id = "{LOGGED_USER}"
 
 Dodatkowo dla dokumentów różnych typów można podawać nazwy kolumn z dodatkowych tabel np dla faktur tabela vatnote itd.