Pola niestandardowe dają większą kontrolę nad tym, jak użytkownicy konfigurują bloki. Można ich używać wielokrotnie, dzięki czemu wystarczy utworzyć jedno pole i wykorzystać je w wielu wyzwalaczach oraz akcjach.

Adres URL zdalnych opcji

Wiele pól niestandardowych może dynamicznie udostępniać opcje. Na przykład lista projektów może pobierać najnowsze projekty zalogowanego użytkownika.

Adres URL zdalnych opcji to punkt końcowy w aplikacji, który zwraca opcje lub konfigurację pola. Zostanie wywołany, gdy użytkownik po raz pierwszy doda przepis i go skonfiguruje.

Zależności

Możesz też skonfigurować zależności pól, aby wymagać od użytkownika wcześniejszego skonfigurowania innego pola. Na przykład integracja do zarządzania projektami może wymagać wybrania projektu przed wyborem zadania w tym projekcie.

W infrastrukturze zdań zależności nie mogą przyjmować wartości null.

Jeśli użyjesz zależności, jej zawartość zostanie dołączona do ładunku wysyłanego do adresu URL zdalnych opcji:

{ 
    "payload": {
        "boardId": 12345678, 
        "automationId": 123456, 
        "dependencyData": {
             "boardId": 12345678 // dependency field configured by user
         },
        "recipeId": 123456,
        "integrationId": 123456 
    }
}

W powyższym przykładzie ładunek wysyłany do adresu URL zależnego pola niestandardowego będzie zawierać identyfikator pola, od którego ono zależy. Oznacza to, że żądanie POST do adresu URL zdalnych opcji, które pobiera listę elementów, będzie zawierać identyfikator tablicy, na której znajdują się te elementy.

Typy pól niestandardowych

Tekst

Typ Tekst pozwala utworzyć pole z predefiniowanym kluczem, którego można używać wielokrotnie.

Na przykład: jeśli wszystkie Twoje bloki korzystają z klucza „projectId”, możesz używać go we wszystkich pozostałych blokach wyzwalaczy i akcji, zamiast konfigurować go za każdym razem od nowa.

W polach tekstowych możesz określić, czy niestandardowe pole tekstowe ma przyjmować wyłącznie liczby. Dzięki temu użytkownicy będą mogli wpisywać tylko znaki numeryczne.

Lista

Typ Lista pozwala wygenerować tablicę opcji do wyboru, na przykład listę repozytoriów GitHub. Możesz dynamicznie zwracać opcje, ustawić inne pole jako zależność i stronicować duże zbiory danych.

Więcej informacji znajdziesz w dokumentacji pola listy.

Mapowanie dynamiczne

Typ Mapowanie dynamiczne pozwala zdefiniować niestandardowy obiekt zawierający zestaw pól podrzędnych, które można mapować na element w monday. Możesz na przykład mapować dane z zadania w Jira na tablicę w monday.com.

Twoja aplikacja zwróci zestaw pól obsługiwanych przez obiekt, a monday określi odpowiednią logikę mapowania. Możesz zwrócić statyczną listę pól lub generować je dynamicznie na podstawie zależności.

Więcej informacji o tym typie pola znajdziesz w artykule o mapowaniu dynamicznym.

Dane logowania

Typ Dane logowania pozwala przechowywać i zarządzać zestawem profili w przepisie integracji. Twoja aplikacja zwróci listę danych logowania, z której użytkownik będzie mógł wybrać odpowiednie dane, a także wdroży mechanizm dodawania i usuwania profili.

Więcej informacji znajdziesz w artykule o polu danych logowania.

Pola wejściowe i wyjściowe

Pola wejściowe i wyjściowe przekazują dane między blokami oraz umożliwiają użytkownikom ich konfigurację.

Pola wyzwalacza

Podczas tworzenia niestandardowych wyzwalaczy możesz samodzielnie skonfigurować pola wejściowe i wyjściowe.

Pola wejściowe wyzwalacza mogą pochodzić z kontekstu przepisu integracji lub z treści przepisu, czyli z tego, co użytkownik wybiera podczas korzystania z integracji. Pola wyjściowe wyzwalacza to dane, które zostaną zmapowane na pola wejściowe akcji.

Jeśli korzystasz z wbudowanego wyzwalacza, możesz sprawdzić więcej informacji o jego polach wyjściowych, najeżdżając kursorem na ikonę informacji. W przypadku niestandardowych wyzwalaczy możesz samodzielnie skonfigurować pola wyjściowe. Powinny one zawierać dane potrzebne w bloku akcji.

Na przykład: załóżmy, że chcesz utworzyć element w monday.com za każdym razem, gdy otrzymasz zgłoszenie w Zendesk. Pola wyjściowe wyzwalacza muszą zawierać identyfikator tablicy monday.com, na której znajduje się przepis, aby nowy element można było utworzyć na właściwej tablicy.

Pola akcji

W bloku akcji możesz dostosować tylko pola wejściowe, ponieważ wynikiem tego bloku jest sama akcja. Pola wejściowe wyzwalacza muszą zawierać wszystkie dane potrzebne do wykonania akcji.

Jeśli planujesz używać mapowania dynamicznego na element w monday.com, pole wejściowe mapowanego elementu musi być polem wyjściowym bloku wyzwalacza, a nie utworzonym przez Ciebie obiektem niestandardowym. Dzieje się tak, ponieważ mapowaniem zajmuje się framework aplikacji monday!

Więcej informacji znajdziesz w artykule o niestandardowych akcjach.

📘 Dołącz do społeczności deweloperów!

Utworzyliśmy społeczność dla naszych deweloperów. Możesz w niej wyszukiwać wcześniejsze tematy, by znaleźć rozwiązania, zadawać pytania, poznawać nowe funkcje i aktualizacje oraz uczyć się wskazówek i trików od innych deweloperów. Dołącz do nas! 😎