Gdy zdarzenie zaszło, a rekord spełnił warunek, Elbuz wykonuje polecenia reguły po kolei: wysyła e-mail lub SMS, tworzy dokument, zmienia pola, łączy się z usługą zewnętrzną.
Kiedy to się przyda:
- Klient potrzebuje powiadomienia — e-mail lub SMS wychodzi przez Twoją skrzynkę pocztową i bramkę SMS.
- Z zamówienia potrzebny jest dokument WZ — „Utwórz dokument” kopiuje je do innego typu ze wszystkimi pozycjami i może od razu zatwierdzić.
- Dane trzeba przekazać do innego systemu — „Wykonaj żądanie HTTP” wysyła pola rekordu na Twój adres.
- Menedżer potrzebuje przypomnienia — „Dodaj zadanie” umieszcza kartę na tablicy Organizera.
Od czego zacząć: karta reguły → trzecia sekcja → „Dodaj polecenie”.
Co potrafią polecenia
- Jedenaście poleceń — e-mail, SMS, zadanie, tworzenie i zmiana kontrahenta, dokumentu, organizacji, żądanie HTTP, proces.
- Wartości pól — stała wartość albo formuła, którą program oblicza dla każdego rekordu.
- Zatwierdzenie — reguła zatwierdza dokument lub cofa zatwierdzenie, a magazyn zmienia się tak jak przy zatwierdzeniu ręcznym.
- Żądanie HTTP — dane rekordu w treści żądania przez makra, token, Basic Auth, rozkładanie odpowiedzi na pola.
- Uruchomienie procesu — przebieg w tle z ochroną przed nieskończoną pętlą.
- E-mail i SMS — wychodzą przez Twoje połączenia; niepowodzenie widać w dzienniku.
Co robi każde z jedenastu poleceń
Polecenia dodaje się w trzeciej sekcji karty reguły przyciskiem z podpowiedzią „Dodaj polecenie”. Jedna reguła może mieć kilka poleceń; kolejność ustala kolumna „Kolejność wykonania”.
| Polecenie | Co robi | Co jest potrzebne wcześniej |
|---|---|---|
| Wyślij e-mail | wiadomość według szablonu, który powstaje razem z poleceniem | skonfigurowany serwer poczty |
| Wyślij SMS | SMS na telefon z dokumentu, a jeśli tam pusto — z karty kontrahenta | podłączona bramka SMS, w przeciwnym razie polecenie od razu zwraca niepowodzenie |
| Utwórz kontrahenta | nową kartę kontrahenta; bez wypełnionej nazwy nie powstaje | — |
| Dodaj zadanie | kartę na tablicy Organizera, powiązaną z rekordem zdarzenia | co najmniej jedna włączona tablica z kolumną |
| Zmień dane kontrahenta | zmienia kontrahenta, do którego należy rekord | — |
| Utwórz dokument | kopię bieżącego dokumentu w innym typie, ze wszystkimi pozycjami | w regułach polecenia trzeba koniecznie ustawić docelowy typ dokumentu |
| Zmień dane dokumentu | zmienia dokument zdarzenia | — |
| Utwórz organizację | nową organizację, a jeśli taka już jest (z tym samym zewnętrznym , a gdy go nie podano — z tą samą nazwą), bierze istniejącą; w dokumencie zdarzenia wpisuje ją w pole „Firma odbiorcy”; bez nazwy nie powstaje | — |
| Zmień dane organizacji | zmienia firmę z kontekstu zdarzenia | — |
| Wykonaj żądanie HTTP | połączenie z zewnętrzną usługą z danymi rekordu | adres usługi zewnętrznej |
| Uruchom proces (Flow) | uruchamia proces w tle z danymi zdarzenia | utworzony i włączony proces |
1
Lista 11 poleceń2
Kolejność wykonania- Rozwinięta lista zawiera jedenaście poleceń; jedna reguła może mieć ich kilka.
- Kolumna „Kolejność wykonania” ustala, w jakim porządku polecenia się wykonują.
Jak ustawia się wartości pól
Polecenia, które coś zmieniają lub tworzą, ustawia się tym samym kreatorem co warunek, ale czyta się go inaczej: po lewej pole, po prawej wartość, którą trzeba zapisać. Operator pośrodku w tym trybie w ogóle nie jest używany — program bierze tylko parę „pole — wartość”.
Wartość może być formułą: wszystko, co zaczyna się od znaku @, jest obliczane — @if, @calc, @concat, @json, @field. Składnia, źródła danych i gotowe formuły — w artykule formuły w wyzwalaczach.
Dwa pola zachowują się inaczej niż wszystkie. W poleceniach „Zmień dane dokumentu” i „Utwórz dokument” reguła z polem zatwierdzenia nie zapisuje wartości, tylko naprawdę zatwierdza dokument (o zatwierdzeniu). A w poleceniu „Utwórz dokument” reguła z polem typu dokumentu określa, do jakiego typu kopiować; bez niej nic nie powstaje.
Jak reguła zatwierdza dokument
W poleceniu „Zmień dane dokumentu” program najpierw zapisuje wszystkie pozostałe pola polecenia, a dopiero potem zatwierdza dokument lub cofa zatwierdzenie. Zatwierdzenie idzie tym samym mechanizmem co ręczne i w chwili wykonania polecenia — czyli wewnątrz zapisu, który wywołał zdarzenie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Co dzieje się ze stanami
Co stanie się ze stanami, zależy od typu dokumentu. W standardowym zestawie typów:
- „Dokument PZ (przyjęcie zewnętrzne)” dodaje ilość na magazyn odbiorcy;
- „Dokument WZ (wydanie zewnętrzne)”, „Zwrot do dostawcy” i „Rozchód wewnętrzny (RW)” zdejmują z magazynu nadawcy;
- „Przesunięcie międzymagazynowe” zdejmuje z jednego magazynu i dodaje na inny;
- „Zamówienie klienta” nie zmienia stanu magazynu, ale zatwierdzone zamówienie rezerwuje towar — jeśli w „Schemacie pracy” dokumentów zaznaczono „Własny magazyn” lub „Dostawca / hurt”.
Dostępność przed zdjęciem ze stanu nie jest sprawdzana: jeśli towaru w magazynie nie ma, stan schodzi poniżej zera. Jeśli typ dokumentu pracuje z magazynem, a potrzebny magazyn w dokumencie nie jest wypełniony, zatwierdzenie nie nastąpi i polecenie dostanie „Nie wykonano!”. Jeśli dokument jest już w docelowym stanie — już zatwierdzony lub już niezatwierdzony — nic się nie dzieje.
Dokument WZ utworzony na podstawie zamówienia przy zatwierdzeniu dopisuje wydaną ilość do pozycji tego zamówienia — jeśli w „Schemacie pracy” zaznaczono „Dostawca / hurt”.
Zatwierdzenie można cofnąć ręcznie i regułą — wartością 0 w polu zatwierdzenia polecenia „Zmień dane dokumentu”. Obie drogi wykonują ruch odwrotny: przyjęcie znika z magazynu, zdjęte i przesunięte wraca, rezerwacja zamówienia jest przeliczana, a w zamówieniu bazowym wydana ilość maleje (rezerwacja i wydanie — przy tych samych warunkach „Schematu pracy”).
Zatwierdzenie i cofnięcie zostawiają wpis w historii dokumentu. Jeden wyjątek: jeśli włączona jest ewidencja partii, cofnięcie rozchodu nie przywraca rozchodowanych partii.
Jeśli magazyn nie jest wypełniony (albo to przesunięcie na ten sam magazyn), pozostałe pola polecenia są w tym momencie już zapisane. Oznaczenia „wykonano” reguła w takim przypadku nie stawia, więc przy następnym zdarzeniu na tym dokumencie polecenie spróbuje ponownie i znów nadpisze te same pola.
Zatwierdzenie z reguły nie wywołuje zdarzenia „Dokument: zatwierdzenie (podpis)”: reguły, które czekają właśnie na nie, po takim zatwierdzeniu nie zadziałają.
W poleceniu „Utwórz dokument” wartość „Tak” w polu zatwierdzenia zatwierdza nowy dokument — po jego utworzeniu i zapisaniu pól polecenia. Wyniku tego zatwierdzenia nie widać w dzienniku: jeśli nowego dokumentu nie udało się zatwierdzić (na przykład nie ma w nim magazynu), zostanie niezatwierdzony, a wiersz w dzienniku będzie taki sam jak po udanym zatwierdzeniu — z numerem utworzonego dokumentu.
Polecenie i tak uznaje się za wykonane — dokument powstał, a następne zdarzenie nie utworzy go drugi raz. Dlatego to, czy nowy dokument jest zatwierdzony, sprawdzaj w samym dokumencie; niezatwierdzony zatwierdź ręcznie. „Nie” w tym poleceniu zatwierdzenia nie rusza.
Jak przekazać dane do innej usługi: żądanie HTTP
Formularz jest podzielony na pięć bloków. Pierwszy to „Ustawienia pobierania tokena” — jest zwinięty i większości niepotrzebny: to osobne żądanie wstępne, po którym {token} w parametrach i nagłówkach jest zastępowany otrzymaną wartością.
Samo żądanie ustawia się w drugim bloku, „Ustawienia wysyłania danych”: typ żądania GET, POST, PUT, PATCH lub DELETE; adres; treść FORM, lub TEXT; parametry; nagłówki. Dalej — „Autoryzacja HTTP (Basic Auth)” z loginem i hasłem, „Ustawienia zapisywania danych” (rozłożenie odpowiedzi na pola dokumentu lub kontrahenta) i „Dodatkowe”, gdzie są „Kody statusu udanej odpowiedzi” — domyślnie 200.
Dane samego rekordu wstawia się makrami — to dla nich zwykle robi się żądanie. W polu RAW wystarczy wpisać otwierający nawias klamrowy, a program pokaże listę pól dokumentów, kontrahentów i firm w zwykłej postaci: {Dokument: Nr dokumentu}, {Kontrahent: Telefon}.
Krótka forma tych samych makr — {{d.pole}} dla dokumentu zdarzenia, {{pc.pole}} dla jego kontrahenta i {{cn.pole}} dla firmy. Działają w treści żądania i w wartościach parametrów; w nagłówkach makr nie ma — tam zastępowany jest tylko {token}.
Treść i parametry wykluczają się: jeśli pole RAW jest wypełnione, parametry w ogóle nie są wysyłane.
Adres jest sprawdzany przed każdym żądaniem. Dozwolone są tylko http i https; zabronione są localhost, domeny .local, adresy wewnętrzne i usługowe sieci, a także nazwy, których nie udało się przetłumaczyć na adres.
Przekierowania program obsługuje sam, nie więcej niż pięć z rzędu, i każdy kolejny adres sprawdza tak samo.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jak uruchomić proces (Flow)
Jedyne polecenie, które nie wykonuje się na miejscu: reguła tworzy przebieg w tle i idzie dalej. Wyłączony proces nie uruchamia się od zdarzenia. Jest też ochrona przed nieskończoną pętlą: ten sam proces nie uruchomi się od zdarzenia dla tego samego dokumentu lub kontrahenta częściej niż 3 razy w ciągu 10 minut — czwarta próba jest odrzucana i zostawia wiersz w dzienniku.
Skąd wychodzą e-mail i SMS i kto za nie płaci
Same polecenia niczego nie pobierają z salda Elbuz: e-mail i SMS wychodzą przez Twoje własne połączenia, a płacisz według cennika usługi pocztowej lub bramki SMS.
- E-mail jest wysyłany ze skrzynki wybranej w szablonie wiadomości. Jeśli w szablonie nie ma skrzynki, program bierze włączoną skrzynkę domyślną, a jeśli i takiej nie ma — pierwszą włączoną z wypełnionym serwerem, loginem, hasłem i adresem nadawcy. Gdy żadnej nie ma albo puste są odbiorca, temat lub treść, e-mail nie wychodzi, w dzienniku pojawia się „Wiadomość nie została wysłana: nie skonfigurowano skrzynki pocztowej lub nie wypełniono wymaganych pól” z listą braków, a polecenie dostaje „Nie wykonano!”.
- SMS jest wysyłany w imieniu Twojego konta w bramce SMS — z loginem i hasłem podanymi w ustawieniach bramki. Telefon pochodzi z dokumentu: najpierw główny, potem telefon płatnika, potem telefon odbiorcy. Jeśli w dokumencie wszystkie trzy są puste — z karty kontrahenta, kolejno pierwszy, drugi i trzeci telefon.
- Język wiadomości program wybiera sam: najpierw język odbiorcy, potem język sklepu, a jeśli szablon wypełniono tylko w jednym języku — ten.
Ile wydano, widać w panelu usługi pocztowej lub bramki SMS. W Elbuz nie ma osobnego licznika kosztów, liczbę wysyłek liczy się wierszami „Dziennika operacji”.
Polecenie uznaje się za wykonane tylko wtedy, gdy usługa SMS przyjęła wiadomość. Usługa odmówiła (skończyły się środki, błędny numer, zablokowany nadawca) — w „Dzienniku operacji” polecenie ma oznaczenie „Nie wykonano!” i przyczynę od usługi. To samo oznaczenie, gdy nie wybrano usługi SMS, tekst szablonu jest pusty albo nie znaleziono żadnego telefonu. Wszystkie wysyłki i błędy widać też w dzienniku okna „Wysyłka SMS”.
Co zrobić, gdy polecenie się nie wykonało
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Polecenie „Wyślij SMS” za każdym razem ma w dzienniku oznaczenie „Nie wykonano!” | Usługa SMS nie jest wybrana albo odmówiła — przyczyna stoi w dzienniku obok oznaczenia | „Usługi zewnętrzne i integracje” → „Wysyłka SMS”: wybrać usługę, wpisać klucz i kliknąć „Wyślij test”. Więcej: jak wysyłać SMS do klientów |
| Żądanie HTTP nie wychodzi, w odpowiedzi „blocked” | Adres nie przeszedł kontroli: niewłaściwy protokół, wewnętrzny adres sieci albo nazwa, której nie udało się przetłumaczyć na adres | Podać adres zewnętrzny przez http lub https (o żądaniu HTTP) |
| Proces z polecenia „Uruchom proces (Flow)” nie wystartował | Ten sam proces był już uruchamiany od zdarzenia dla tego rekordu 3 razy w ciągu 10 minut — zadziałała ochrona przed pętlą | Przerwać łańcuch: usunąć polecenie, które znów wywołuje to samo zdarzenie (o uruchomieniu procesu) |
Najczęstsze pytania
Czy w jednej regule można i wysłać e-mail, i zmienić status?
Tak. Reguła może mieć kilka poleceń, wykonują się po kolei według kolumny „Kolejność wykonania”.
Czy dane rekordu są wstawiane do nagłówków żądania HTTP?
Nie. Makra działają w treści żądania i w wartościach parametrów, a w nagłówkach zastępowany jest tylko token otrzymany z żądania wstępnego (o żądaniu HTTP).
Czy reguły zadziałają na dokument utworzony przez inną regułę?
Nie. Dokument utworzony przez polecenie nie wywołuje własnych zdarzeń, więc reguły na „Dokument: dodanie” na niego nie zadziałają.
Czy można utworzyć dokument przy zdarzeniu kontrahenta?
Nie. „Utwórz dokument” kopiuje dokument zdarzenia, a w zdarzeniu kontrahenta nie ma czego kopiować.
Czy „Utwórz kontrahenta” utworzy duplikat, jeśli klient już istnieje?
Nie. Polecenie szuka karty z tym samym adresem e-mail, a bez e-maila — z tą samą nazwą. Jeśli znajdzie, nowej karty nie będzie, a polecenie uznaje się za wykonane.
Gdzie to jest i kto ma dostęp
- Polecenia reguły
- karta reguły → trzecia sekcja „Polecenie” → „Dodaj polecenie”
- Ustawienia polecenia
- ołówek w wierszu polecenia
- Uprawnienia
- okno „Reguły automatyczne” (wszystkie wejścia)
- Przygotuj
- skrzynkę pocztową, bramkę SMS, tablicę Organizera lub proces — zależnie od polecenia
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu, — jak działają reguły automatyczne.
- Jeśli wartość pola trzeba obliczyć z kwoty lub skleić z pól, — formuły w wyzwalaczach.
- Jeśli polecenie ma w dzienniku oznaczenie „Nie wykonano!”, — jak sprawdzić regułę.
- Jeśli bramka SMS nie jest jeszcze podłączona, — jak wysyłać SMS do klientów.
