コンテンツにスキップ

リストから選択 (Select From List)

ドロップダウンインターフェースを使用して文字列リストからアイテムを選択します。

説明 (Description)

Select From List ノードを使用すると、ドロップダウンメニューから文字列リストの単一アイテムを対話的に選択できます。入力リストが変更されると選択肢が自動的に更新され、可能な限り現在の選択状態が保持されます。

パラメータ一覧 (Parameters)

入力パラメータ

パラメータ名 型 説明 デフォルト値
list list 選択対象となるアイテムのリスト []

出力パラメータ

パラメータ名 型 説明
selected_item string 現在選択されているアイテム

主な機能 (Features)

  • 動的ドロップダウン: 入力リストの内容からドロップダウンの選択肢を自動生成
  • 選択状態の維持: リスト更新時にも、同じアイテムが存在していれば現在の選択を維持
  • 文字列変換: 一貫した比較処理のため、リストのすべてのアイテムを自動的に文字列に変換
  • リアルタイム更新: 入力リストの変更に応じて即座に選択肢を更新
  • 安全な例外処理: 空のリストや無効な入力に対しても安全に対応

使用例 (Examples)

基本的なリスト選択

# 入力リスト: ["Apple", "Banana", "Cherry", "Date"]
# ユーザー選択: "Banana"
# 出力: "Banana"

ステータス選択

# 入力リスト: ["In Progress", "Not Started", "Waiting", "Completed", "Blocked"]
# ユーザー選択: "Completed"
# 出力: "Completed"

動的リストの更新時の挙動

# 初回リスト: ["Option A", "Option B", "Option C"]
# ユーザー選択: "Option B"
# リストが次に更新: ["Option A", "Option B", "Option D", "Option E"]
# 選択の保持: "Option B"（新しいリストにも存在するため維持）

# リストが全く別の内容に更新: ["Option X", "Option Y", "Option Z"]
# 選択のリセット: "Option X"（新しいリストの先頭アイテムに再設定）

ユースケース (Use Cases)

  • ステータス選択: 事前定義されたステータス値からの選択（例: "In Progress", "Completed"）
  • カテゴリ選択: カテゴリやタイプのリストからの選択
  • 設定オプションの指定: 利用可能な設定項目からの選択
  • ユーザーインターフェース: ワークフロー内に対話的なドロップダウン選択を提供
  • データフィルタリング: 生成されたリストから特定のアイテムを抽出

ワークフロー例 (Workflow Examples)

ステータス管理ワークフロー

Create Text List → Select From List → Process Selected Status
     ↓                    ↓
["In Progress",      "Completed"    → タスクステータスを更新
 "Not Started", 
 "Waiting", 
 "Completed", 
 "Blocked"]

動的オプション選択

API Response → Extract Options → Select From List → Use Selection
     ↓              ↓                ↓
JSON data    → ["Option 1",    → "Option 2"    → 選択した処理を実行
              "Option 2", 
              "Option 3"]

動作仕様 (Behavior)

選択ロジック

  1. 初回読み込み: リストの最初のアイテムがデフォルトで選択されます
  2. リスト更新時:
    • 現在の選択アイテムが新しいリストにも存在する場合 → 現在の選択を維持
    • 現在の選択アイテムが新しいリストに存在しない場合 → 新しいリストの先頭アイテムを選択
  3. 空のリスト: 選択がクリアされます（空文字列）
  4. 無効な入力: 選択がクリアされます（空文字列）

文字列変換

一貫した比較を行うため、リスト内のすべてのアイテムは自動的に文字列型に変換されます：

  • 数値: 123 → "123"
  • 真偽値: True → "True"
  • オブジェクト: {"key": "value"} → "{'key': 'value'}"