コネクターカードへのオプションフィールドの追加
コネクタービルダーの[Options(オプション)]ダイアログでコネクターカードのオプションを定義します。
[Options(オプション)]ダイアログを表示するには、フローを開始するConnector Actionカードまたはフローを終了するReturn Outputsカードの[Add Options(オプションの追加)]をクリックします。
ダイアログでフィールドを追加すると、該当するカードのセクションヘッダーに表示される[Edit(編集)]リンクをクリックしてダイアログを表示できるようになります。
カードにオプションのドロップダウンフィールドを追加してデフォルト値を設定し、コネクタープロジェクトをデプロイしてフローにカードを追加すると、新たに追加されたカードにはすでにデフォルトオプションが選択されて保存されており、その選択に基づいて入力フィールドと出力フィールドが表示されます。コネクタービルダーで作成したカードでは、フローへのカードの追加時にオプションフィールドは折り畳んで表示されます。オプションドロップダウンを表示して選択内容を変更するには、カードの[Options(オプション)]メニューを開く必要があります。
入力および出力フィールドを追加する方法については、「コネクターカードへの入力および出力フィールドの追加」を参照してください。
オプションフィールド
カードのオプションフィールドは、フローの作成時にユーザーが選択する設計時入力です。フィールドに渡される値は静的です。これは、各フロー実行でも同様です。たとえば、Custom API Actionカードでは、[Options(オプション)]セクションの1つのフィールドとしてRequest Type(リクエストタイプ)があります。この値は、カードを初めてフローに追加する際にエンドユーザによって選択され、カードを実行するたびに指定されたリソースに対して選択されたリクエストメソッドが実行されます。
カードにフィールドを追加するには、次の手順に従います。
-
[Action(アクション)]をクリックします。
-
Connector Actionカードの[Add Options(オプションの追加)]をクリックします。
-
ダイアログで[Add Field(フィールドの追加)]をクリックします。
フィールド | 定義 | タイプ |
---|---|---|
Group Name(グループ名) |
グループ名オプションは、カードのこのセクションに追加されるフィールドのセクションタイトルとしてデフォルトで表示されます。 オプションのグループ名は編集できません。 |
テキスト |
Label(ラベル) | カードの値の上に表示されるフィールドの表示名。ラベルには、アルファベット、数字、ハイフン、アンダースコア、スペースのみを使用できます。先行スペースや後続スペースは禁止されています。 | テキスト |
Field Type(フィールドタイプ) |
フィールドタイプは、カードユーザーに表示されるフィールドの型を説明します。オプションでは、次のデータ型がサポートされます。
|
ドロップダウン |
Data Type(データ型) |
コネクタービルダーのフローに渡されるデータの型。 オプションで利用できるデータ型はText(テキスト)のみです。 |
ドロップダウン |
必須 | セットアップ時にフィールドが必須であるかどうかを示します。デフォルトは必須です。 | ブール値 |
Dropdown values(ドロップダウンの値) |
|
ドロップダウン |
動的ドロップダウンを取り込むヘルパーフローの追加
アイテムのリストを取得するためにHTTP呼び出しが必要な場合に、作成者はヘルパーフローを使ってOptions(オプション)ドロップダウンの値を取り込むことができます。ドロップダウンのアイテムリストを返すために使用されるフローは、次の形状のオブジェクトを返す必要があります。
[
{
"value":"English",
"key":"en_us"
},
{
"value":"Chinese (Simplified)",
"key":"zh_CN"
},
{
"value":"Danish",
"key":"da"
}
]
「動的ドロップダウンフィールドの追加:HTTPの例」を参照してください。