コネクターカードにオプションフィールドを追加する

コネクタービルダーのコネクタービルダーダイアログでコネクターカードのオプションを定義します。

オプション（Options）ダイアログを表示するには、フローを開始するコネクターアクションカード、またはフローを終了する返答出力（Return Outputs）カードのオプションの追加（Add Options）をクリックします。

フィールド追加後に再度ダイアログを表示には、カードのセクションヘッダーに表示されるリンクの編集（Edit）をクリックします。

注意:

デフォルト値があるカードにオプションのドロップダウンフィールドを追加すると、カードはそれらの選択されたデフォルトオプションを保存します。コネクタープロジェクトをデプロイし、フローにカードを追加すると、カードはその選択に基づいて入力および出力のフィールドを表示します。

コネクタービルダーで作成したカードでは、フローへのカードの追加時にオプションフィールドは折りたたんで表示されます。オプションのドロップダウンメニューを表示して選択内容を変更するには、カードのオプション（Options）メニューを開く必要があります。

入力および出力フィールドを追加する方法については、コネクターカードに入力と出力のフィールドを追加するを参照してください。

オプションフィールド
動的ドロップダウンを取り込むヘルパーフローを追加する

オプションフィールド

カードのオプションフィールドは、フローの作成時にユーザーが選択する設計時入力です。フィールドに渡される値は静的です。つまり、各フロー実行でも同様です。たとえば、Custom API Actionカードでは、オプション（Options）（Custom API Action）セクションの1つのフィールドとしてリクエストタイプ（Request Type）があります。エンドユーザーは、カードを初めてフローに追加する際に値を選択します。カードが実行されるたびに、指定されたリソースに対して選択したリクエストメソッドが実行されます。

カードにフィールドを追加するには、次の手順に従います。

アクション（Action）をクリックします。
コネクターアクションカードのオプションの追加（Add Options）をクリックします。
ダイアログでフィールドの追加（Add Field）をクリックします。

フィールド	定義	タイプ
グループ名（Group Name）	オプション（Options）のグループ名は、カードのこのセクションに追加されるフィールドのセクションタイトルとしてデフォルトで表示されます。オプション（Options）のグループ名を編集することはできません。	テキスト
ラベル（Label）	カードの値の上に表示されるフィールドの表示名。ラベルには、アルファベット、数字、ハイフン、アンダースコア、スペースのみを使用できます。先行スペースや後続スペースは禁止されています。	テキスト
フィールドタイプ（Field Type）	フィールドタイプは、カードユーザーに表示されるフィールドの型を説明します。オプションのフィールドは、次のデータ型をサポートしています。テキストフィールド（Text Field）：任意の文字列値。 Dropdown（ドロップダウン）：カードユーザーが選択するアイテムのリスト。	ドロップダウン
データ型（Data Type）	コネクタービルダーのフローに渡されるデータ型。オプションで利用できるデータ型は`Text`のみです。	ドロップダウン
必須（Required）	セットアップ時にフィールドが必須であるかどうかを示します。デフォルトは`True`です。	True/False
ドロップダウンの値（Dropdown values）	`Static Values`：このオプションでは、表示（Display）および値（Value）のフィールドに手動で入力することで、カードユーザーにドロップダウンメニューを作成できます。カスタムAPIアクション（Custom API Action）カードのように表示と値のフィールドが同じ場合がありますが、異なる場合もあります。値（Value）は、フローに渡される値です。 `Helper Flow`：このオプションでは、ドロップダウンの値を返すフローを選択できます。サービスからリストを収集する必要があり、アカウントによってリストが異なる可能性がある場合にこのオプションを使用します。	ドロップダウン

動的ドロップダウンを取り込むヘルパーフローを追加する

アイテムのリストを取得するためにHTTP呼び出しが必要な場合に、作成者はヘルパーフローを使ってオプション（Options）ドロップダウンの値を取り込むことができます。ドロップダウンのアイテムリストを返すフローは、次の例のようなオブジェクトを返す必要があります。

[
   {
      "value":"English",
      "key":"en_us"
   },
   {
      "value":"Chinese (Simplified)",
      "key":"zh_CN"
   },
   {
      "value":"Danish",
      "key":"da"
   }
]

動的ドロップダウンフィールドを追加する：HTTPの例を参照してください。