Dokumentacja dla programistów

Dodawanie pól do bloku

Aktualizacja 2026-01-07

Ten przewodnik wyjaśnia, jak tworzyć niestandardowe pola tekstowe, daty i obiektowe, których później użyjesz do konfigurowania bloków automatyzacji.

Implementacja

Na początek dodajmy nową funkcję aplikacji Pole dla bloku automatyzacji (Field for automation block).

Kliknij swoje zdjęcie profilowe w prawym górnym rogu.
Wybierz Deweloperzy (Developers). Centrum deweloperów (Developer Center) otworzy się w nowej karcie.
Wybierz aplikację, w której chcesz utworzyć pola, albo utwórz nową.
Przejdź do karty Funkcje (Features).
Kliknij Utwórz funkcję (Create feature) > Pole dla bloku automatyzacji (Field for automation block) > Utwórz (Create).

Po dodaniu funkcji aplikacji możesz skonfigurować pole:

Dodaj nazwę, opis i klucz pola.

Nazwa pola (Field name): Wpisz opisową nazwę, którą użytkownicy zobaczą w kreatorze przepływu pracy.
Opis pola (Field description): Wpisz krótki opis wyjaśniający, do czego służy pole. Będzie on widoczny tylko w Centrum deweloperów i nie będzie wyświetlany użytkownikom.
Domyślny klucz pola (Default field key): Wpisz unikatowy identyfikator pola. Może zawierać tylko cyfry, litery i znaki podkreślenia. Musi zaczynać się od litery.

Określ typ i schemat pola (jeśli ma zastosowanie).

Typ schematu (Schema type): Wybierz, czy pole ma być ciągiem znaków, liczbą, wartością logiczną, danymi uwierzytelniającymi czy obiektem.
Konfiguracja schematu (Schema configuration): Jeśli wybierzesz typ schematu Obiekt (Object), możesz podać statyczny schemat lub adres URL schematu. Więcej informacji o konfigurowaniu adresu URL schematu znajdziesz w dokumentacji pól obiektowych.

Dodaj zdalne opcje do niestandardowego pola. Jeśli ich nie skonfigurujesz, użytkownik wpisze wartość samodzielnie.

Adres URL zdalnych opcji (Remote options URL): Wpisz punkt końcowy, z którego będą pobierane opcje pola. Powinien on zwracać tablicę opcji, z których każda zawiera pola title i value.
Opcje statyczne (Static options):
Etykieta (Label): Nazwa opcji.
Wartość (Value): Wartość opcji.

Każdy typ pola obsługuje zdalne opcje inaczej. Więcej informacji znajdziesz w dokumentacji pól prymitywnych, obiektowych i danych uwierzytelniających.

Ustaw wymagane i opcjonalne zależności, które muszą zostać spełnione przed wywołaniem punktu końcowego skonfigurowanego w kroku 3.

Wymagane zależności (Mandatory dependencies)
Typ pola (Field type): Wybierz typ pola.
Klucz docelowego pola (Target field key): Wpisz unikatowy identyfikator docelowego pola.
Opcjonalne zależności (Optional dependencies)
Typ pola (Field type): Wybierz typ pola.
Klucz docelowego pola (Target field key): Wpisz unikatowy identyfikator docelowego pola.

Powtórz te czynności, aby utworzyć dowolną liczbę pól. Aby dowiedzieć się, jak dodawać je do bloków, skorzystaj z przewodnika Tworzenie bloków!