Prymitywne pole niestandardowe pozwala wybrać opcję z listy. Wartości muszą należeć do jednego z czterech podstawowych typów skalarnych: ciągu znaków, liczby, wartości logicznej lub daty.

Informacje

Opcje

Użytkownik musi wybrać wartość z listy udostępnionej przez pole niestandardowe. Lista może być statyczna lub dynamiczna.

Opcje statyczne

Opcje statyczne możesz skonfigurować w sekcji „Konfiguracja” (Configuration) funkcji pola. Konfigurujesz je w Centrum dewelopera (Developer Center) i nie ulegają zmianie.

Opcje dynamiczne

Opcje dynamiczne możesz pobierać z adresu „Remote options URL” na serwerze aplikacji. Gdy użytkownik wybierze pole, monday wyśle pod ten adres żądanie o listę opcji. Opcje z odpowiedzi zostaną wyświetlone użytkownikowi. Każda wartość powinna być unikalna.

[
  {
    title: 'Red Socks', 
    value: 'socks_1'
  },
  {
    title: 'Green Socks',
    value: 'socks_2'
  },
  {
    title: 'Pink Socks',
    value: 'socks_3'
  },
]

{
  "payload": {
    "shoes": {
      "value": "shoe1",
      "fieldTypeKey": 11369480
    },
    "pageRequestData": {},
    "credentialsValues":    { 
       "credentials-key": { 
         userCredentialsId: 12345, 
         accessToken: "abc1234" 
       } 
     },
    "dependencyData": {
      "shoes": {
        "value": "shoe1",
        "fieldTypeKey": 11369480
      }
    }
  }
}

router.post('/fields/socks', (req, res) => {
  res.status(200).send([
    {
      title: 'Red Socks',
      value: 'socks_1'
    },
    {
      title: 'Green Socks',
      value: 'socks_2'
    },
    {
      title: 'Pink Socks',
      value: 'socks_3'
    },
  ])
})

Zależności

Pola prymitywne mogą mieć wymagane i opcjonalne zależności. Zależności pola są przesyłane do adresu Remote options URL, a także dołączane do każdego ładunku zawierającego wartość tego pola.

{/*

Dane uwierzytelniające

Do tego pola możesz dodać dane uwierzytelniające OAuth. Użyj tej opcji, jeśli chcesz uwierzytelnić się w interfejsie API innej firmy, aby zwrócić zdalne opcje. Wartości danych uwierzytelniających zostaną przesłane w ładunku żądania. Dowiedz się, jak skonfigurować dane uwierzytelniające w naszym przewodniku: Zarządzanie tokenami użytkowników i danymi uwierzytelniającymi

*/}

Paginacja

Jeśli pole zwraca wiele elementów lub korzysta z paginowanego interfejsu API, możesz dodać pole isPaginated. Dowiedz się, jak to zrobić, korzystając z zaawansowanego przewodnika po paginacji zdalnych opcji.

Przykładowe żądanie

Poniższy JSON przedstawia przykładowe dane, które zostaną przekazane do aplikacji przez pola prymitywne. Zwróć uwagę, że ciągi znaków, wartości logiczne, liczby i daty mają różne formaty.

{
  "payload": {
    "blockKind": "action",
    "credentialsValues":    { 
       "credentials-key": { 
         userCredentialsId: 12345, 
         accessToken: "abc1234" 
       } 
     },
    "inboundFieldValues": {
      "customerId": "abc1234", // string
      "lastCallDate": "1993-08-27", // date field, in ISO format
      "fromContactUsPage": true, // boolean
      "dealSize": 100, // number
      "shoes": "shoe1",
      "listSocks": "socks_1"
    },
    "inputFields": {
      "customerId": "abc1234", // string
      "lastCallDate": "1993-08-27", // date field
      "fromContactUsPage": true,
      "dealSize": 100,
      "shoes": "shoe1",
      "listSocks": "socks_1"
    },
    "recipeId": 629166,
    "integrationId": 398514541
  },
  "runtimeMetadata": {
    "actionUuid": "8d496442b49bcc4f9968f154b1464cb1",
    "triggerUuid": "ced54d4ca581d948d6fdddaa0841f6ca"
  }
}