> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnilinker.pl/llms.txt
> Use this file to discover all available pages before exploring further.
# Własne wyzwalacze
> Skonfiguruj przyciski, skróty klawiszowe i kody kreskowe, które uruchamiają automatyzacje, gdy zdecyduje człowiek, i naciskaj je na zamówieniu.
Własny wyzwalacz uruchamia automatyzacje, gdy zdecyduje człowiek: ktoś naciska jego przycisk na karcie zamówienia,
zaznacza zamówienia na liście i naciska go tam, używa jego skrótu klawiszowego albo skanuje jego kod kreskowy w trybie
stanowiska. Mogą go też nacisnąć Twoje własne systemy, przez API.
Własny wyzwalacz sam niczego nie robi. Uruchamia automatyzacje, które się od niego zaczynają, więc po jego
skonfigurowaniu dodaj co najmniej jedną automatyzację.
## Skonfiguruj własny wyzwalacz
Potrzebujesz uprawnień **Konfiguracja przycisków, skrótów i kodów kreskowych** oraz **Przeglądanie automatyzacji**.
Aby dodać automatyzacje, które uruchamia, potrzebujesz też **Tworzenie i zmiana automatyzacji**.
Otwórz **Automatyzacje** > **Własne wyzwalacze**. Twoje wyzwalacze są po lewej, każdy z informacją, jak się go
uruchamia i ile automatyzacji uruchamia. Kliknij **Nowy**.
W sekcji **Jak wygląda** wpisz **Nazwę widoczną dla ludzi**, np. „Spakowane — drukuj etykietę”, i wybierz
**Ikonę** oraz **Kolor**. **Podgląd** pokazuje przycisk w miejscach **Karta zamówienia**, **Tryb stanowiska** (czyli
tryb stanowiska) i **Lista zamówień, z zaznaczonymi zamówieniami**.
W sekcji **Jak się go uruchamia** wybierz, gdzie widać przycisk, nadaj skrót i zdecyduj, czy mogą go naciskać Twoje
systemy. Zobacz [Jak się go uruchamia](#jak-się-go-uruchamia).
W sekcji **Kto go widzi i kiedy** ogranicz go do stanowisk, ról i statusów zamówienia oraz ustaw, kiedy naciśnięcie
na wielu zamówieniach najpierw pyta. Zobacz [Kto go widzi i kiedy](#kto-go-widzi-i-kiedy).
Kliknij **Utwórz**. Wyzwalacz dostaje swój kod kreskowy.
W sekcji **Co uruchamia** kliknij **Dodaj automatyzację dla tego wyzwalacza**. Edytor otworzy się z wybranym
wyzwalaczem; dodaj warunki i kroki i włącz automatyzację. Zobacz
[Tworzenie i edycja automatyzacji](/pl/automations/create-and-edit).
Aby zmienić własny wyzwalacz, kliknij go na liście, zmień, co trzeba, i kliknij **Zapisz zmiany**. **Anuluj** przywraca
zapisaną wersję.
### Jak się go uruchamia
| Sposób | Co ustawić |
| - | - |
| **Przycisk** | Gdzie widać przycisk: **Na karcie rekordu**, **Na liście, dla kilku naraz** i **W trybie stanowiska**. Nowy wyzwalacz ma zaznaczone wszystkie trzy. Przycisk jest widoczny „dla osób i rekordów wybranych niżej”. |
| **Skrót klawiszowy** | Kliknij **Wybierz klawisze** i naciśnij klawisze. Zobacz [Zasady skrótów](#zasady-skrótów). |
| **Kod kreskowy** | Każdy własny wyzwalacz ma swój kod, np. `OL-T-7K3M`, narysowany na tej stronie. „Zeskanowanie go przy zamówieniu naciska ten wyzwalacz, na tych samych zasadach co przycisk.” Zobacz [Kod kreskowy](#kod-kreskowy). |
| **Twoje systemy** | Zaznacz, aby integracja mogła naciskać wyzwalacz kluczem API z uprawnieniem **Używanie przycisków, skrótów i kodów kreskowych**. Zobacz [Naciskanie przez API](#naciskanie-przez-api). |
Pod nimi strona mówi, czy ten wyzwalacz naciskają inne automatyzacje, krokiem **Uruchom własny wyzwalacz** albo
w bloku **Jeśli krok się nie powiedzie**.
### Zasady skrótów
Skrót to **Ctrl** albo **Alt** z literą lub cyfrą, z **Shift** albo bez, albo klawisz funkcyjny, od **F1** do **F12**.
Pojedyncza litera ani cyfra nie może być skrótem: skaner kodów kreskowych wpisuje pojedyncze klawisze i nacisnąłby
wyzwalacz w trakcie skanowania.
Omnilinker odczytuje klawisz z jego miejsca na klawiaturze, więc **Alt+P** to **Alt+P** także na polskiej klawiaturze.
Niektórych klawiszy nie można użyć: „… odpada: zajmuje go przeglądarka albo AltGr wpisuje nim literę.”
* klawisze przeglądarki: **Ctrl+W**, **Ctrl+T**, **Ctrl+N**, **Ctrl+Shift+N**, **Ctrl+Shift+T**, **Ctrl+Shift+W**,
**Ctrl+Shift+Q**, **Ctrl+F4** i **Alt+F4**;
* **Ctrl+Alt** z literą albo cyfrą: w Windows AltGr to Ctrl+Alt, więc takie skróty wpisują litery, np. „ą”.
Dwa własne wyzwalacze nie mogą mieć tego samego skrótu: strona mówi „Zajęty: „…” już używa tych klawiszy.” Wolny skrót
ma komunikat „Wolny. Pojedynczych liter nie można użyć: wpisuje je skaner.” Aby go zmienić, kliknij **Zmień**, a aby
usunąć, **Usuń**.
### Kod kreskowy
Wyzwalacz dostaje kod kreskowy, gdy go utworzysz. Zeskanowanie go w trybie stanowiska, przy otwartym zamówieniu, naciska
wyzwalacz na tym zamówieniu. Kod kreskowy naciska wyzwalacz tylko tam, gdzie jego przycisk może być widoczny **W trybie
stanowiska**, i tylko dla osób, stanowisk i statusów wybranych niżej.
Aby nadać wyzwalaczowi nowy kod, kliknij **Nowy kod** i potwierdź: „Nadać nowy kod? Wydrukowane karty z obecnym kodem
przestaną działać.” Nowy kod nigdy nie jest kodem innego wyzwalacza.
Omnilinker nie drukuje jeszcze arkusza z kodami wyzwalaczy. Strona konfiguracji pokazuje kod każdego wyzwalacza.
### Kto go widzi i kiedy
Sekcja czyta się jak zdanie: **Pokazuj go na** każdym stanowisku **osobom z rolą** dowolną **gdy zamówienie ma status**
dowolny. Wybierz wartości, aby to zawęzić:
* **Stanowiska**: przycisk jest widoczny, a wyzwalacz można nacisnąć tylko na komputerze, który drukuje na jednym z tych
stanowisk. Zobacz [Wybór stanowiska](/pl/devices/choose-station).
* **Role**: widzą go i mogą go naciskać tylko osoby z jedną z tych ról. Wyzwalacz zapamiętuje rolę po nazwie: po zmianie
nazwy roli wybierz ją tu ponownie.
* **Statusy**: statusy zamówienia, w których wyzwalacz działa.
Stanowisk i ról nie da się obejść. Ze statusem jest inaczej: „Naciśnięty na rekordzie w innym statusie nie zawodzi po
cichu: mówi, w jakim statusie działa, a osoba z uprawnieniem może go mimo to uruchomić.” Zobacz
[Zamówienie w innym statusie](#zamówienie-w-innym-statusie).
Skrót i kod kreskowy działają na tych samych zasadach co przycisk.
**Na wielu rekordach naraz najpierw zapytaj, gdy jest ich więcej niż** określona liczba zamówień, domyślnie 10, od 1 do
500\. „Każdy rekord dostaje własny wynik; jeden błąd nie zatrzymuje pozostałych.”
### Co uruchamia
**Co uruchamia** pokazuje automatyzacje, które zaczynają się od tego wyzwalacza, w kolejności, w jakiej działają, każdą
z jej warunkiem (albo **zawsze**), liczbą kroków i stanem, jeśli nie jest **Włączona**.
„Każde naciśnięcie przechodzi przez wszystkie, w tej kolejności. Ich warunki decydują, które zadziałają, więc jeden
przycisk obsłuży każdy przypadek.” Na przykład jeden przycisk **Spakowane** może uruchamiać jedną automatyzację dla
zamówień do paczkomatu, a inną dla zamówień kurierskich.
Etykieta pokazuje, jak poszły naciśnięcia w zeszłym tygodniu: „W zeszłym tygodniu każde naciśnięcie pasowało do
dokładnie jednej” albo ile naciśnięć nie pasowało do żadnej, a ile do więcej niż jednej.
### Usuń własny wyzwalacz
Kliknij **Usuń** i potwierdź: „Usunąć „…”? Jego przyciski, skrót i kod kreskowy przestaną działać.”
Nie możesz usunąć własnego wyzwalacza, dopóki zaczynają się od niego automatyzacje albo naciskają go krokiem **Uruchom
własny wyzwalacz** lub w bloku **Jeśli krok się nie powiedzie**. Komunikat je wymienia; najpierw przenieś lub usuń te
automatyzacje albo usuń krok.
## Naciśnij własny wyzwalacz
Potrzebujesz uprawnienia **Używanie przycisków, skrótów i kodów kreskowych**. Widzisz tylko wyzwalacze przeznaczone dla
Ciebie: umieszczone tam, gdzie jesteś, na Twoim stanowisku i dla Twojej roli.
### Na karcie zamówienia
Przyciski są w nagłówku karty zamówienia, każdy ze swoim skrótem. Kliknij przycisk albo naciśnij jego skrót w dowolnym
miejscu strony, z wyjątkiem pisania w polu.
Komunikat mówi „„…” uruchomiono na 1 rekordzie.” Sekcja **Automatyzacje** na karcie pokazuje, co się uruchomiło; zobacz
[Sekcja Automatyzacje na karcie zamówienia](/pl/automations/runs-and-activity#sekcja-automatyzacje-na-karcie-zamówienia).
### Na liście zamówień
Zaznacz zamówienia na stronie **Sprzedaż** > **Zamówienia**. Przyciski pojawią się na pasku nad listą, a ich skróty
działają, dopóki zamówienia są zaznaczone.
Gdy zaznaczysz więcej zamówień, niż wynosi próg wyzwalacza, Omnilinker pokaże, co zrobi naciśnięcie, zanim cokolwiek
się stanie: „Uruchomić „…” na N rekordach?”
* na ilu zamówieniach zadziała każda automatyzacja i do ilu żadna nie pasuje („żadna automatyzacja nie pasuje: nic się
nie stanie”);
* każde zamówienie, które się nie uruchomi, z powodem, np. dlatego, że jest wstrzymane;
* „Uruchomią się po kolei, w kolejności tej listy.”
Kliknij **Uruchom na N rekordach** albo **Anuluj**. „Pracuj dalej: karta każdego rekordu pokaże, co się uruchomiło, gdy
skończy.”
Jedno naciśnięcie działa na najwyżej 500 zamówieniach. Naciśnięcie z listy pomija zamówienia, na których automatyzacje są
wstrzymane, nawet gdy zaznaczysz tylko jedno.
### Zamówienie w innym statusie
Przycisk dla statusów innych niż status zamówienia jest wyszarzony, a jego podpowiedź mówi „Działa w innych statusach:
naciśnij, by zobaczyć w jakich”. Naciśnięcie mówi, dlaczego się nie uruchomił, np. „Działa tylko w statusach: Pakowanie;
ten ma status Nowe.”
Z uprawnieniem **Uruchamianie przycisku na zamówieniu w niedozwolonym statusie** pojawia się pytanie „… Uruchomić mimo
to?” i możesz go uruchomić.
### Zamówienie wstrzymane
Na karcie zamówienia i w trybie stanowiska własny wyzwalacz naciśnięty na wstrzymanym zamówieniu nadal działa: patrzysz
na zamówienie i to Ty decydujesz o naciśnięciu. Automatyzacje, które jego kroki uruchamiają same, nadal czekają na
zwolnienie wstrzymania. Zobacz [Wstrzymanie automatyzacji na zamówieniu](/pl/automations/overview#wstrzymanie-automatyzacji-na-zamówieniu).
## Automatyzacja, która naciska własny wyzwalacz
Automatyzacja też może nacisnąć własny wyzwalacz:
* jako krok, **Uruchom własny wyzwalacz**;
* gdy ostatecznie się nie powiedzie, w bloku **Jeśli krok się nie powiedzie**, przez **i naciśnij**.
Automatyzacje uruchamiane przez wyzwalacz działają jak po naciśnięciu przez człowieka, w tym samym łańcuchu, więc liczy
je [ochrona przed pętlą](/pl/automations/overview#ochrona-przed-pętlą). Automatyzacja może nacisnąć własny wyzwalacz
tylko na swoim rodzaju rekordu.
Częsty sposób użycia to wyzwalacz „Potrzebny człowiek”, którego automatyzacja daje znać zespołowi, wstrzymuje zamówienie
i ustawia status. Każda automatyzacja, która może się nie udać, naciska go w bloku **Jeśli krok się nie powiedzie**. Cel
**Przekaż człowiekowi** to konfiguruje.
## Naciskanie przez API
Zaznacz **Twoje systemy** przy wyzwalaczu. Potem wywołaj go kluczem API z uprawnieniem **Używanie przycisków, skrótów
i kodów kreskowych**; zobacz [Klucze API](/pl/administration/api-keys).
```http theme={null}
POST /api/automation/custom-trigger/{id}/run
Content-Type: application/json
{
"subjectIds": [""]
}
```
`{id}` to identyfikator własnego wyzwalacza. Odpowiedź wymienia każde zamówienie z `accepted`, a gdy się nie
uruchomiło, z `reason`. Naciśnięcie kluczem API jest widoczne na karcie zamówienia jako **przez API**.
Ograniczenia stanowisk i ról dotyczą też API: wyzwalacz ograniczony do stanowisk lub ról może nacisnąć tylko klucz,
który je spełnia. Wyzwalacz bez **Twoje systemy** odpowiada „Przycisk „…” nie jest dostępny dla kluczy API.”
Naciśnięcie kluczem API pomija zamówienia, na których automatyzacje są wstrzymane, tak jak naciśnięcie z listy: nikt na
nie nie patrzył.
Każde wywołanie to nowe naciśnięcie: wywołanie, które przekroczyło czas, mogło już nacisnąć. Zanim wywołasz ponownie,
sprawdź sekcję **Automatyzacje** zamówienia albo `pressedAt` w odpowiedzi, zamiast ponawiać na ślepo.
Klucz, który może nacisnąć wyzwalacz, uruchamia go na dowolnym zamówieniu Twojej organizacji: działają automatyzacje
wyzwalacza, niezależnie od tego, co jeszcze klucz może robić. Zaznacz **Twoje systemy** tylko przy wyzwalaczach, które
ma uruchamiać integracja.
## Co dalej
Pakowacze skanują zamówienie, a potem naciskają kafelek albo skanują kod wyzwalacza.
Zobacz, co uruchomiło każde naciśnięcie.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.