コネクターカードへのオプションフィールドの追加

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

[Options(オプション)]ダイアログを表示するには、フローを開始するConnector Actionカードまたはフローを終了するReturn Outputsカードの[Add Options(オプションの追加)]をクリックします。

ダイアログでフィールドを追加すると、該当するカードのセクションヘッダーに表示される[Edit(編集)]リンクをクリックしてダイアログを表示できるようになります。

カードにオプションのドロップダウンフィールドを追加してデフォルト値を設定し、コネクタープロジェクトをデプロイしてフローにカードを追加すると、新たに追加されたカードにはすでにデフォルトオプションが選択されて保存されており、その選択に基づいて入力フィールドと出力フィールドが表示されます。コネクタービルダーで作成したカードでは、フローへのカードの追加時にオプションフィールドは折り畳んで表示されます。オプションドロップダウンを表示して選択内容を変更するには、カードの[Options(オプション)]メニューを開く必要があります。

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

オプションフィールド

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

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

  1. [Action(アクション)]をクリックします。

  2. Connector Actionカードの[Add Options(オプションの追加)]をクリックします。

  3. ダイアログで[Add Field(フィールドの追加)]をクリックします。

フィールド 定義 タイプ
Group Name(グループ名)

グループ名オプションは、カードのこのセクションに追加されるフィールドのセクションタイトルとしてデフォルトで表示されます。

オプションのグループ名は編集できません。

テキスト
Label(ラベル) カードの値の上に表示されるフィールドの表示名。ラベルには、アルファベット、数字、ハイフン、アンダースコア、スペースのみを使用できます。先行スペースや後続スペースは禁止されています。 テキスト
Field Type(フィールドタイプ) フィールドタイプは、カードユーザーに表示されるフィールドの型を説明します。オプションでは、次のデータ型がサポートされます。
  • Text Field(テキストフィールド):任意の文字列値。

  • Dropdown(ドロップダウン):カードユーザーが選択するアイテムのリスト。

ドロップダウン
Data Type(データ型)

コネクタービルダーのフローに渡されるデータの型。

オプションで利用できるデータ型はText(テキスト)のみです。

ドロップダウン
必須 セットアップ時にフィールドが必須であるかどうかを示します。デフォルトは必須です。 ブール値
Dropdown values(ドロップダウンの値)
  • Static Values(静的な値):このオプションでは、DisplayおよびValueフィールドに手動で入力することで、カードユーザーに表示されるドロップダウンを作成できます。Custom API ActionカードのようにDisplayとValueが同じ場合がありますが、異なる場合もあります。Valueは、フローに渡される値です。

  • Helper Flow(ヘルパーフロー):このオプションでは、ドロップダウンの値を返すフローを選択できます。このオプションは、アカウントに応じてリストが異なる可能性があるサービスからリストを収集する必要がある場合に使用する必要があります。

ドロップダウン

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

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

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

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

関連項目

ドロップダウンオプションフィールドの静的な値の追加

動的ドロップダウンフィールドの追加:HTTPの例

コネクターカードへの入力および出力フィールドの追加

httpHelperフローの構築