↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Co może zrobić reguła: jedenaście poleceń

    16 min czytaniaZaktualizowano

    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”.

    Co potrafi reguła
    PolecenieCo robiCo jest potrzebne wcześniej
    Wyślij e-mailwiadomość według szablonu, który powstaje razem z poleceniemskonfigurowany serwer poczty
    Wyślij SMSSMS na telefon z dokumentu, a jeśli tam pusto — z karty kontrahentapodłączona bramka SMS, w przeciwnym razie polecenie od razu zwraca niepowodzenie
    Utwórz kontrahentanową kartę kontrahenta; bez wypełnionej nazwy nie powstaje—
    Dodaj zadaniekartę na tablicy Organizera, powiązaną z rekordem zdarzeniaco najmniej jedna włączona tablica z kolumną
    Zmień dane kontrahentazmienia kontrahenta, do którego należy rekord—
    Utwórz dokumentkopię bieżącego dokumentu w innym typie, ze wszystkimi pozycjamiw regułach polecenia trzeba koniecznie ustawić docelowy typ dokumentu
    Zmień dane dokumentuzmienia 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 organizacjizmienia firmę z kontekstu zdarzenia—
    Wykonaj żądanie HTTPpołączenie z zewnętrzną usługą z danymi rekorduadres usługi zewnętrznej
    Uruchom proces (Flow)uruchamia proces w tle z danymi zdarzeniautworzony i włączony proces
    Sekcja poleceń karty reguły z rozwiniętą listą dodawania polecenia
    1Lista 11 poleceń
    2Kolejność wykonania
    1. Rozwinięta lista zawiera jedenaście poleceń; jedna reguła może mieć ich kilka.
    2. 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.

    Pozostałe pola polecenia zapisują się zawsze, jeszcze przed zatwierdzeniem. Jedyne wyjście bez oznaczenia „wykonano” — gdy brakuje magazynu: wtedy przy następnym zdarzeniu polecenie powtórzy się i nadpisze te same pola
    NieTakTakNieTakNieNieTakZadziałało polecenie„Zmień dane dokumentu”Zapisują się wszystkie polapoleceniaoprócz pola zatwierdzeniaPolecenie ma pole zatwierdzenia?Polecenie wykonaneWartość zgadza sięz bieżącym stanem dokumentu?Typ dokumentu pracuje zmagazynem,a potrzebny magazyn nie jestwypełnionyalbo to zatwierdzenie przesunięciana ten sam magazyn?Brak zatwierdzenia. W dzienniku —„Nie wykonano!”Brak oznaczenia „wykonano” —przy następnym zdarzeniu poleceniesię powtórzyDokument jest teraz zatwierdzony?Zatwierdzenie: ruch w magazynie,stan nie jest sprawdzanyCofnięcie zatwierdzenia:ruch odwrotny w magazynie
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.

    Wszystkie cztery drogi do „Nie wykonano!” — pusty adres, token, który nie przyszedł w odpowiedzi na żądanie wstępne (wtedy główne żądanie nie jest wysyłane), adres, który nie przeszedł kontroli, i kod odpowiedzi spoza listy udanych. Kontrolę przechodzi też każdy adres przekierowania.
    nietaktaktoken przyszedłbrak tokenanienie — blockedtaktak — sprawdzany jestnowy adresnienietakPolecenie „Wykonaj żądanie HTTP”Adres żądaniawypełniony?Wypełniono „Ustawieniapobierania tokena”?Żądanie wstępne o token.Token przyszedł — trafia do żądaniaAdres przechodzikontrolę?Żądanie wysłaneOdpowiedź to przekierowaniei było ich mniej niż pięć?Kod odpowiedzi jest wśród„Kody statusu udanej odpowiedzi”?Ustawiono „Ustawienia zapisywaniadanych” —wartości z odpowiedzi trafiają do pólrekorduWiersz w „Dzienniku operacji”i w dzienniku uruchomień„Nie wykonano!” w „Dziennikuoperacji”.Następne zdarzenie spróbujeponownie
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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

    Objaw, przyczyna i co zrobić
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo