KeyValuePair コネクタのメソッド

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

    • Keyvalue pair コネクタのメソッドは、キーと値のペアに対してさまざまなアクションを実行します。自動化フローでは、メソッドは他のメソッドやコンポーネントに接続されます。メソッドを使用するには、まずメソッドを公開する必要があります。

    追加

    キーと値のペアを追加します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 1. Add メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの名前。 データ入力 文字列 なし あり
    値 キーの値。 データ入力 オブジェクト なし あり
    IgnoreDuplicates 値が True の場合、メソッドは重複キーを無視します。値が False の場合、メソッドはエラーメッセージを返します。 データ入力 ブール なし いいえ

    クリア

    すべてのキーと値のペアをクリアします。

    ContainsKey

    指定されたキーが存在する場合は True を返し、それ以外の場合は False を返します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 2. ContainsKey メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの名前。 データ入力 文字列 なし あり
    戻る 指定されたキーが存在する場合は True を返し、それ以外の場合は False を返します。 データ出力 ブーリアン 適用外 適用外

    ContainsValue

    指定されたキー値が存在する場合は True を返し、それ以外の場合は False を返します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 3. ContainsValue メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    値 キー値の名前。 データ入力 文字列 なし あり
    戻る 指定されたキー値が存在する場合は True を返し、それ以外の場合は False を返します。 データ出力 ブーリアン 適用外 適用外

    カウント

    キーと値のペアの合計数を返します。

    表 : 4. Count メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    戻る キーと値のペアの合計数を返します。 データ出力 整数 適用外 適用外

    削除

    指定されたキーを削除します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 5. Delete メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの名前。 データ入力 文字列 なし あり

    GetItem

    指定されたキーの値を返します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 6. GetItem メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの名前。 データ入力 文字列 なし あり
    戻る キーの値を返します。 データ出力 オブジェクト 適用外 適用外

    GetItems

    複数キーの値を返します。最初にメソッドでキーを設定する必要があります。

    設定するには、次の手順を実行します。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. キーを追加アイコン (キーを追加アイコン) をクリックします。
    3. キーの名前を入力します。
    4. リストからキーデータタイプを更新します。
    5. 複数のキーの名前を設定するには、手順を繰り返します。
    6. [OK] をクリックします。

      設定したキー名ごとに、データ出力ポートが作成されます。

    表 : 7. GetItems メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの値を返します。 データ出力 オブジェクト 適用外 適用外

    GetItemsByIndex

    インデックスに基づいてキー値を返します。最初にメソッドでインデックスを設定する必要があります。

    設定するには、次の手順を実行します。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. インデックスを追加アイコン (キーを追加アイコン) をクリックします。
    3. キーインデックスを入力します。
    4. リストからキーデータタイプを更新します。
    5. 複数のキーインデックスを設定するには、手順を繰り返します。
    6. [OK] をクリックします。

      設定したキーインデックスごとに、データ出力ポートが作成されます。

    表 : 8. GetItemsByIndex メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    Key index キーの値を返します。 データ出力 オブジェクト 適用外 適用外

    ParseFromText

    指定されたテキストをキーと値のペアに解析します。これによって、複数のキーと値のペアを作成できます。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 9. ParseFromText メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    テキスト メソッドが解析するキーと値で構成されるテキスト。 データ入力 文字列 なし あり
    ItemSeparator 2 つのキーと値のペア間のセパレーター。 データ入力 文字列 なし あり
    KeyValueSeparator キーとその値の間のセパレーター。 データ入力 文字列 なし あり
    ClearBeforeParse True の場合、解析前に既存のキーと値のペアをクリアします。 データ入力 ブール なし いいえ

    リバース

    キーインデックスを反転します。
    ヒント:
    このメソッドを実行した後、GetItemsByIndex メソッドを実行すると、出力を確認できます。

    SetData

    情報が必要です。

    SetItem

    キーの値を更新します。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 10. SetItem メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの名前。 データ入力 文字列 なし あり
    値 キーの値を更新します。 データ入力 オブジェクト なし あり
    ヒント:
    GetItemsByIndex メソッドを実行して、更新された値をテストします。

    SetItems

    指定されたキーの値を更新します。最初にメソッドでキーを設定する必要があります。

    キーを設定するには、次の手順を実行します。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. キーを追加アイコン (キーを追加アイコン) をクリックします。
    3. キーの名前を入力します。
    4. リストからキーデータタイプを更新します。
    5. 複数のキーの名前を設定するには、手順を繰り返します。
    6. [OK] をクリックします。

      設定したキー名ごとに、データ入力ポートが作成されます。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 11. SetItems メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    キー キーの値を更新します。 データ入力 オブジェクト なし あり
    ヒント:
    GetItemsByIndex メソッドを実行して、更新された値をテストします。

    SetItemsByIndex

    指定されたインデックスに基づいて、キーの値を更新します。最初にメソッドでインデックスを設定する必要があります。

    インデックスを設定するには、次の手順を実行します。
    1. メソッド設定アイコン (メソッド設定アイコン) をクリックします。
    2. インデックスを追加アイコン (キーを追加アイコン) をクリックします。
    3. キーインデックスを入力します。
    4. リストからキーデータタイプを更新します。
    5. 複数のキーインデックスを設定するには、手順を繰り返します。
    6. [OK] をクリックします。

      設定したキーインデックスごとに、データ入力ポートが作成されます。

    表 : 12. SetItemsByIndex メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    Key Index キーのインデックス。 データ入力 オブジェクト なし あり
    ヒント:
    GetItemsByIndex メソッドを実行して、更新された値をテストします。

    ToJSON

    キーと値のペアを JSON 形式にレンダリングします。

    ToText

    キーと値のペアをテキスト形式にレンダリングします。

    パラメーターに入力を指定するには、「ポートのプロパティを設定する」を参照してください。

    表 : 13. ToText メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須？
    ValuesOnly True の場合、メソッドはキーの値のみをレンダリングし、それ以外の場合はキーと値のペアをレンダリングします。 データ入力 ブール なし いいえ
    戻る キーと値のペアをテキスト形式で返します。 データ出力 文字列 適用外 適用外