↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak dodać przycisk w tabeli: webhook, link, okno lub scenariusz

    4 min czytaniaZaktualizowano

    Elbuz dodaje do tabeli kolumnę z przyciskiem: z wiersza zamówienia lub produktu otwiera on link, wysyła dane na Twój serwer lub do API przewoźnika, otwiera okno albo uruchamia scenariusz Flow.

    Kiedy to się przyda:

    • Trzeba śledzić paczkę po numerze listu przewozowego — przycisk otwiera stronę przewoźnika z numerem z wiersza.
    • Dane zamówienia mają trafić na Twój serwer — webhook wysyła je jednym kliknięciem.
    • List przewozowy trzeba utworzyć bez programowania — żądanie idzie do API przewoźnika, a numer z odpowiedzi zapisuje się w polu zamówienia.
    • Przycisk nie jest potrzebny we wszystkich wierszach — warunek go ukrywa lub dezaktywuje.

    Od czego zacząć: lista dokumentów → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → „Przycisk”.

    Co potrafi przycisk w tabeli

    Jak dodać przycisk do tabeli

    Dla tabeli zamówień: lista dokumentów → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → typ „Przycisk” → „Nazwa przycisku”. Zaraz po utworzeniu otwiera się okno „Akcja przycisku”; później otwiera je ikona koła zębatego „Ustaw działanie przycisku” w wierszu tego pola, w tym samym oknie ustawień tabeli.

    Jak ustawić działanie przycisku

    Okno ma pięć kroków:

    1. „Co robi przycisk” — „Otwórz link”, „Wyślij żądanie HTTP (webhook)”, „Otwórz okno Elbuz” lub „Uruchom scenariusz Flow”.
    2. „Parametry akcji”. Dla webhooka — „Adres (URL)”, „Metoda”, „Typ treści”, „Treść żądania”, „Nagłówki” (po jednym w wierszu, „Nazwa: wartość”) i „Połączenie z danymi dostępowymi”: login, hasło i token pochodzą ze słownika połączeń zewnętrznych, w przycisku nie są przechowywane. Dane wiersza wstawia się makrami i do adresu, i do treści: wybierz pole z listy „Pola wiersza” i kliknij „+” przy właściwym polu wprowadzania. W wartości są escapowane automatycznie.
    3. „Wygląd przycisku” — napis (też z makrami), ikona, kolor.
    4. „Kiedy przycisk jest aktywny” — warunek dla wiersza: pusty — przycisk jest aktywny zawsze; w pozostałych wierszach można go pokazać jako nieaktywny lub ukryć.
    5. „Potwierdzenie i odpowiedź” — „Pytaj o potwierdzenie” z treścią pytania, a także „Ścieżka do wartości w odpowiedzi” (np. data.tracking_url) i „Zapisz w polu”: wartość z odpowiedzi Twojego serwera zapisze się w polu tego rekordu.
    Okno „Akcja przycisku” pola „Send to server”: kafelek webhooka i parametry żądania
    1Wyślij żądanie HTTP (webhook)
    2Adres (URL)
    3Treść żądania
    4Pola wiersza
    1. Wybrana akcja: po kliknięciu program wysyła żądanie na podany adres.
    2. Adres, który odbiera żądanie.
    3. Treść żądania: makra w nawiasach klamrowych są zastępowane wartościami klikniętego wiersza.
    4. Lista pól wiersza: wybierz pole, aby wstawić jego makro tam, gdzie był kursor, albo użyj „+” obok nazwy pola.

    Dokąd można wysłać żądanie i ile razy

    • Adres. Żądanie wychodzi z serwera Elbuz, a nie z przeglądarki, więc adres musi zaczynać się od http:// lub https:// i prowadzić do internetu. localhost, adresy sieci lokalnej i nazwę, której nie udało się znaleźć, program odrzuca z komunikatem „Odrzucono adres żądania:”.
    • Limit. Jeden użytkownik może kliknąć przyciski wysyłające żądania najwyżej 30 razy na minutę — potem pojawia się „Zbyt wiele kliknięć z rzędu, odczekaj minutę”.
    • Dziennik. Kliknięcia webhooka i scenariusza Flow zapisują się w „Dzienniku operacji” (Panel klienta → Dziennik operacji), a nie w historii karty dokumentu. Nie zapisują się „Otwórz link”, „Otwórz okno” ani kliknięcia, które program odrzucił z powodu limitu, uprawnień lub warunku przycisku.

    Jak sprawdzić przycisk, niczego nie psując

    Przycisk „Sprawdź” najpierw zapisuje ustawienia, a potem wysyła prawdziwe żądanie — z danymi najnowszego rekordu tabeli, który spełnia warunek przycisku.

    Twój serwer otrzyma je jako zwykłe, kliknięcie zapisze się w dzienniku i wliczy do limitu 30 na minutę, a jeśli ustawiono „Zapisz w polu”, wartość z odpowiedzi zapisze się w tym prawdziwym rekordzie. Sprawdzaj na adresie testowym albo wtedy, gdy takie żądanie niczego nie zepsuje.

    W jakich tabelach działa webhook i Flow

    Webhook i Flow są dostępne w tabelach produktów katalogu, produktów z cenników, kontrahentów, dokumentów, pozycji dokumentów, kategorii, producentów i artykułów. W innych tabelach okno pokaże „W tej tabeli dostępne są tylko akcje wykonywane przez przeglądarkę: otwarcie linku i otwarcie okna”.

    Jeśli dane mają być wysyłane same, bez kliknięcia — to reguła automatyczna z poleceniem żądania HTTP.

    Scenariusze

    Przycisk śledzenia paczki po numerze listu przewozowego

    Co zrobić. W tabeli zamówień dodaj pole typu „Przycisk” o nazwie „Śledzenie”. W „Co robi przycisk” wybierz „Otwórz link”. W „Adres (URL)” wklej adres strony śledzenia Twojego przewoźnika, a w miejsce numeru — makro pola z numerem listu przewozowego: wybierz pole z listy „Pola wiersza” i kliknij „+”.

    Efekt. Wartość zostanie wstawiona z wiersza, w którym kliknięto przycisk, i automatycznie zakodowana dla adresu. Aby przycisk był widoczny tylko tam, gdzie numer listu przewozowego jest wypełniony, ustaw warunek w kroku „Kiedy przycisk jest aktywny”.

    Wysłać zamówienie na własny serwer

    Co zrobić. W oknie „Akcja przycisku” wybierz „Wyślij żądanie HTTP (webhook)”, podaj „Adres (URL)”, metodę i w „Treść żądania” wstaw makra potrzebnych pól zamówienia z listy „Pola wiersza”. Kliknij „Zapisz”.

    Efekt. Przycisk pojawi się jako kolumna w tabeli zamówień i będzie wysyłać dane wiersza, w którym go kliknięto. Kliknięcie zapisuje się w „Dzienniku operacji”.

    Utworzyć list przewozowy w API przewoźnika i zapisać numer

    Typowy przykład — integracja z przewoźnikiem bez programowania: przycisk w tabeli zamówień wysyła dane zamówienia do API InPost lub innego przewoźnika, żeby utworzyć list przewozowy, a numer listu lub link do śledzenia z odpowiedzi zapisuje w polu zamówienia.

    Format treści żądania ustalasz sam według dokumentacji przewoźnika — automatyzacja jest tu całkowicie w Twoich rękach, gotowych szablonów dla przewoźników w oknie nie ma.

    Co zrobić. Wybierz „Wyślij żądanie HTTP (webhook)”, podaj adres API przewoźnika, „Metoda” i „Treść żądania” z makrami pól zamówienia. Klucz dostępu wybierz w „Połączenie z danymi dostępowymi”. W kroku „Potwierdzenie i odpowiedź” wpisz „Ścieżka do wartości w odpowiedzi”, np. data.tracking_url, a w „Zapisz w polu” — pole zamówienia.

    Efekt. Po kliknięciu wartość z odpowiedzi zapisze się w tym rekordzie. Numer listu przewozowego zapisuje się tak samo: ścieżka do niego w odpowiedzi i osobne pole zamówienia na numer listu.

    Co zrobić, gdy przycisk nie zadziałał

    Co widziszDlaczego tak jestCo zrobić
    „Odrzucono adres żądania:”adres prowadzi do localhost, do sieci lokalnej albo nazwy nie znalezionopodać adres serwera w internecie z http:// lub https:// (ograniczenia)
    „Zbyt wiele kliknięć z rzędu, odczekaj minutę”ponad 30 kliknięć przycisków wysyłających żądania w ciągu minutyodczekać do minuty i kliknąć ponownie
    „W tej tabeli dostępne są tylko akcje wykonywane przez przeglądarkę: otwarcie linku i otwarcie okna”webhook i Flow nie działają we wszystkich tabelachsprawdzić listę tabel lub wysyłać żądanie regułą automatyczną
    Przycisk w wierszu jest nieaktywny lub go nie mawiersz nie spełnia warunku z kroku „Kiedy przycisk jest aktywny”zmienić warunek lub wypełnić potrzebne pole w wierszu

    Najczęstsze pytania

    Przycisk z webhookiem pokazuje „Zbyt wiele kliknięć z rzędu, odczekaj minutę”. Jaki jest limit?

    30 kliknięć przycisków z webhookiem i scenariuszami Flow na minutę na użytkownika, łącznie ze „Sprawdź”. Licznik zeruje się z kolejną minutą. „Otwórz link” i „Otwórz okno Elbuz” nie są wliczane do limitu.

    Czy można wysyłać dane na serwer bez klikania przycisku?

    Tak, ale to już nie przycisk, tylko reguła automatyczna z poleceniem żądania HTTP: uruchamia się sama po zdarzeniu.

    Gdzie widać, kto i kiedy kliknął przycisk?

    W „Dzienniku operacji” (Panel klienta → Dziennik operacji) — dla webhooków i scenariuszy Flow. Do historii karty dokumentu kliknięcia nie są zapisywane.

    Czy przycisk przechowuje hasło lub token do API?

    Nie. Login, hasło i token pochodzą ze słownika połączeń zewnętrznych przez „Połączenie z danymi dostępowymi”, w samym przycisku nie są przechowywane.

    Czy są gotowe ustawienia dla InPost lub innych przewoźników?

    Nie, gotowych szablonów dla przewoźników w oknie nie ma. Format treści żądania ustalasz sam według dokumentacji przewoźnika.

    Gdzie to jest i kto ma dostęp

    Dodać przycisk
    tabela → menu ≡ → „Skonfiguruj tabelę” → „Dodaj nowe pole” → „Przycisk”
    Zmienić działanie
    ikona koła zębatego „Ustaw działanie przycisku” w wierszu pola
    Przygotować
    dla webhooka — adres i format żądania Twojego serwera lub przewoźnika

    Przycisk dodaje się nie w „Ustawieniach tabel”, tylko w samej tabeli, w której jest potrzebny. Podobnie jak „Pasek postępu”, to pole wirtualne: nie tworzy kolumny w bazie, nie można według niego filtrować, sortować ani go eksportować.

    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