--- sourceDocument: Yokohama データと自動化 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama データと自動化 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # KeyValuePair コネクタのメソッド # KeyValuePair コネクタのメソッド {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 Keyvalue pair コネクタのメソッドは、キーと値のペアに対してさまざまなアクションを実行します。自動化フローでは、メソッドは他のメソッドやコンポーネントに接続されます。メソッドを使用するには、まずメソッドを公開する必要があります。 ## 追加 {#keyvaluepair-connector-methods__section_gcb_ftx_4tb} キーと値のペアを追加します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_l1y_t4r_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの名前。 | データ入力 | 文字列 | なし | はい | | 値 | キーの値。 | データ入力 | オブジェクト | なし | はい | | IgnoreDuplicates | 値が True の場合、メソッドは重複キーを無視します。値が False の場合、メソッドはエラーメッセージを返します。 | データ入力 | ブール | なし | いいえ | [表 : 1. Add メソッドのパラメーター] {#keyvaluepair-connector-methods__table_l1y_t4r_4tb} ## クリア {#keyvaluepair-connector-methods__section_dfq_k5x_4tb} すべてのキーと値のペアをクリアします。 ## ContainsKey {#keyvaluepair-connector-methods__section_ips_kvx_4tb} 指定されたキーが存在する場合は True を返し、それ以外の場合は False を返します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_x4r_svx_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの名前。 | データ入力 | 文字列 | なし | はい | | 戻る | 指定されたキーが存在する場合は True を返し、それ以外の場合は False を返します。 | データ出力 | ブール | 該当なし | 該当なし | [表 : 2. ContainsKey メソッドのパラメーター] {#keyvaluepair-connector-methods__table_x4r_svx_4tb} ## ContainsValue {#keyvaluepair-connector-methods__section_h14_cwx_4tb} 指定されたキー値が存在する場合は True を返し、それ以外の場合は False を返します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_wbh_twx_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | 値 | キー値の名前。 | データ入力 | 文字列 | なし | はい | | 戻る | 指定されたキー値が存在する場合は True を返し、それ以外の場合は False を返します。 | データ出力 | ブール | 該当なし | 該当なし | [表 : 3. ContainsValue メソッドのパラメーター] {#keyvaluepair-connector-methods__table_wbh_twx_4tb} ## カウント {#keyvaluepair-connector-methods__section_odt_xwx_4tb} キーと値のペアの合計数を返します。 {#keyvaluepair-connector-methods__table_p3f_bxx_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | 戻る | キーと値のペアの合計数を返します。 | データ出力 | 整数 | 該当なし | 該当なし | [表 : 4. Count メソッドのパラメーター] {#keyvaluepair-connector-methods__table_p3f_bxx_4tb} ## 削除 {#keyvaluepair-connector-methods__section_knr_qxx_4tb} 指定されたキーを削除します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_php_txx_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの名前。 | データ入力 | 文字列 | なし | はい | [表 : 5. Delete メソッドのパラメーター] {#keyvaluepair-connector-methods__table_php_txx_4tb} ## GetItem {#keyvaluepair-connector-methods__section_ush_1yx_4tb} 指定されたキーの値を返します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_rjd_2yx_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの名前。 | データ入力 | 文字列 | なし | はい | | 戻る | キーの値を返します。 | データ出力 | オブジェクト | 該当なし | 該当なし | [表 : 6. GetItem メソッドのパラメーター] {#keyvaluepair-connector-methods__table_rjd_2yx_4tb} ## GetItems {#keyvaluepair-connector-methods__section_nkm_4yx_4tb} 複数キーの値を返します。最初にメソッドでキーを設定する必要があります。 設定するには、次の手順を実行します。 1. メソッド設定アイコン (![メソッド設定アイコン]()) をクリックします。 2. キーを追加アイコン (![キーを追加アイコン]()) をクリックします。 3. キーの名前を入力します。 4. リストからキーデータタイプを更新します。 5. 複数のキーの名前を設定するには、手順を繰り返します。 6. \[OK\] をクリックします。 設定したキー名ごとに、データ出力ポートが作成されます。 {#keyvaluepair-connector-methods__ol_dsq_nzx_4tb} {#keyvaluepair-connector-methods__table_k22_21y_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの値を返します。 | データ出力 | オブジェクト | 該当なし | 該当なし | [表 : 7. GetItems メソッドのパラメーター] {#keyvaluepair-connector-methods__table_k22_21y_4tb} ## GetItemsByIndex {#keyvaluepair-connector-methods__section_of3_41y_4tb} インデックスに基づいてキー値を返します。最初にメソッドでインデックスを設定する必要があります。 設定するには、次の手順を実行します。 1. メソッド設定アイコン (![メソッド設定アイコン]()) をクリックします。 2. インデックスを追加アイコン (![キーを追加アイコン]()) をクリックします。 3. キーインデックスを入力します。 4. リストからキーデータタイプを更新します。 5. 複数のキーインデックスを設定するには、手順を繰り返します。 6. \[OK\] をクリックします。 設定したキーインデックスごとに、データ出力ポートが作成されます。 {#keyvaluepair-connector-methods__ol_e1y_bby_4tb} {#keyvaluepair-connector-methods__table_irj_mby_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | Key index | キーの値を返します。 | データ出力 | オブジェクト | 該当なし | 該当なし | [表 : 8. GetItemsByIndex メソッドのパラメーター] {#keyvaluepair-connector-methods__table_irj_mby_4tb} ## ParseFromText {#keyvaluepair-connector-methods__section_jbj_fly_4tb} 指定されたテキストをキーと値のペアに解析します。これによって、複数のキーと値のペアを作成できます。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_vs2_xly_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | テキスト | メソッドが解析するキーと値で構成されるテキスト。 | データ入力 | 文字列 | なし | はい | | ItemSeparator | 2 つのキーと値のペア間のセパレーター。 | データ入力 | 文字列 | なし | はい | | KeyValueSeparator | キーとその値の間のセパレーター。 | データ入力 | 文字列 | なし | はい | | ClearBeforeParse | True の場合、解析前に既存のキーと値のペアをクリアします。 | データ入力 | ブール | なし | いいえ | [表 : 9. ParseFromText メソッドのパラメーター] {#keyvaluepair-connector-methods__table_vs2_xly_4tb} ## リバース {#keyvaluepair-connector-methods__section_oyx_mny_4tb} キーインデックスを反転します。 ヒント: このメソッドを実行した後、GetItemsByIndex メソッドを実行すると、出力を確認できます。 ## SetData {#keyvaluepair-connector-methods__section_o1v_try_4tb} 情報が必要です。 ## SetItem {#keyvaluepair-connector-methods__section_a5c_vry_4tb} キーの値を更新します。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_v4f_dsy_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの名前。 | データ入力 | 文字列 | なし | はい | | 値 | キーの値を更新します。 | データ入力 | オブジェクト | なし | はい | [表 : 10. SetItem メソッドのパラメーター] {#keyvaluepair-connector-methods__table_v4f_dsy_4tb} ヒント: GetItemsByIndex メソッドを実行して、更新された値をテストします。 ## SetItems {#keyvaluepair-connector-methods__section_il5_jsy_4tb} 指定されたキーの値を更新します。最初にメソッドでキーを設定する必要があります。 キーを設定するには、次の手順を実行します。 1. メソッド設定アイコン (![メソッド設定アイコン]()) をクリックします。 2. キーを追加アイコン (![キーを追加アイコン]()) をクリックします。 3. キーの名前を入力します。 4. リストからキーデータタイプを更新します。 5. 複数のキーの名前を設定するには、手順を繰り返します。 6. \[OK\] をクリックします。 設定したキー名ごとに、データ入力ポートが作成されます。 {#keyvaluepair-connector-methods__ol_epq_tsy_4tb} パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_ug5_zsy_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | キー | キーの値を更新します。 | データ入力 | オブジェクト | なし | はい | [表 : 11. SetItems メソッドのパラメーター] {#keyvaluepair-connector-methods__table_ug5_zsy_4tb} ヒント: GetItemsByIndex メソッドを実行して、更新された値をテストします。 ## SetItemsByIndex {#keyvaluepair-connector-methods__section_t3c_sty_4tb} 指定されたインデックスに基づいて、キーの値を更新します。最初にメソッドでインデックスを設定する必要があります。 インデックスを設定するには、次の手順を実行します。 1. メソッド設定アイコン (![メソッド設定アイコン]()) をクリックします。 2. インデックスを追加アイコン (![キーを追加アイコン]()) をクリックします。 3. キーインデックスを入力します。 4. リストからキーデータタイプを更新します。 5. 複数のキーインデックスを設定するには、手順を繰り返します。 6. \[OK\] をクリックします。 設定したキーインデックスごとに、データ入力ポートが作成されます。 {#keyvaluepair-connector-methods__ol_izp_m5y_4tb} {#keyvaluepair-connector-methods__table_emr_p5y_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | Key Index | キーのインデックス。 | データ入力 | オブジェクト | なし | はい | [表 : 12. SetItemsByIndex メソッドのパラメーター] {#keyvaluepair-connector-methods__table_emr_p5y_4tb} ヒント: GetItemsByIndex メソッドを実行して、更新された値をテストします。 ## ToJSON {#keyvaluepair-connector-methods__section_nds_gvy_4tb} キーと値のペアを JSON 形式にレンダリングします。 ## ToText {#keyvaluepair-connector-methods__section_pnh_4vy_4tb} キーと値のペアをテキスト形式にレンダリングします。 パラメーターに入力を指定するには、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#keyvaluepair-connector-methods__table_xsf_vvy_4tb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須ですか？ | |-|-|-|-|-|-| | ValuesOnly | True の場合、メソッドはキーの値のみをレンダリングし、それ以外の場合はキーと値のペアをレンダリングします。 | データ入力 | ブール | なし | いいえ | | 戻る | キーと値のペアをテキスト形式で返します。 | データ出力 | 文字列 | 該当なし | 該当なし | [表 : 13. ToText メソッドのパラメーター] {#keyvaluepair-connector-methods__table_xsf_vvy_4tb}