--- sourceDocument: Zürich-Daten und Automatisierung sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/integrate-applications Release : - zurich ft:locale : - de-DE ft:publication_title : - Zürich-Daten und Automatisierung ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # KeyValuePair-Connector-Methoden # KeyValuePair-Connector-Methoden {#ariaid-title1} * Freigeben Version: Zurich * * Aktualisiert 31. Juli 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Die KeyValue-Paar-Connector-Methoden führen verschiedene Aktionen für Schlüssel-Wert-Paare aus. In einem Automatisierungs-Flow sind die Methoden mit anderen Methoden und Komponenten verbunden. Um die Methoden zu verwenden, müssen Sie sie zuerst verfügbar machen. ## Hinzufügen {#keyvaluepair-connector-methods__section_gcb_ftx_4tb} Fügt ein Schlüsselwertpaar hinzu. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_l1y_t4r_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Wert | Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | | IgnoreDuplikate | Wenn der Wert „wahr" ist, ignoriert die Methode einen doppelten Schlüssel. Andernfalls gibt die Methode eine Fehlermeldung zurück, wenn der Wert „falsch" ist. | Daten in | Boolean | Keine | Nein | [Tabelle : 1. Fügen Sie Methodenparameter hinzu] {#keyvaluepair-connector-methods__table_l1y_t4r_4tb} ## Leeren {#keyvaluepair-connector-methods__section_dfq_k5x_4tb} Löscht alle Schlüsselwertpaare. ## ContainsKey {#keyvaluepair-connector-methods__section_ips_kvx_4tb} Gibt „wahr" zurück, wenn der angegebene Schlüssel vorhanden ist, andernfalls wird „falsch" zurückgegeben. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_x4r_svx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Zurück | Gibt „wahr" zurück, wenn der angegebene Schlüssel vorhanden ist, andernfalls wird „falsch" zurückgegeben. | Daten aus | Boolean | Nicht zutreffend | Nicht zutreffend | [Tabelle : 2. ContainsKey-Methodenparameter] {#keyvaluepair-connector-methods__table_x4r_svx_4tb} ## ContainsValue {#keyvaluepair-connector-methods__section_h14_cwx_4tb} Gibt „wahr" zurück, wenn der angegebene Schlüsselwert vorhanden ist, andernfalls wird „falsch" zurückgegeben. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_wbh_twx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Wert | Name des Schlüsselwerts. | Daten in | Zeichenfolge | Keine | Ja | | Zurück | Gibt „wahr" zurück, wenn der angegebene Schlüsselwert vorhanden ist, andernfalls wird „falsch" zurückgegeben. | Daten aus | Boolean | Nicht zutreffend | Nicht zutreffend | [Tabelle : 3. ContainsValue-Methodenparameter] {#keyvaluepair-connector-methods__table_wbh_twx_4tb} ## Anzahl {#keyvaluepair-connector-methods__section_odt_xwx_4tb} Gibt die Gesamtanzahl der Schlüsselwertpaare zurück. {#keyvaluepair-connector-methods__table_p3f_bxx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt die Gesamtanzahl der Schlüsselwertpaare zurück. | Daten aus | Ganzzahl | Nicht zutreffend | Nicht zutreffend | [Tabelle : 4. Parameter der Zählmethode] {#keyvaluepair-connector-methods__table_p3f_bxx_4tb} ## Löschen {#keyvaluepair-connector-methods__section_knr_qxx_4tb} Entfernt den angegebenen Schlüssel. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_php_txx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | [Tabelle : 5. Löschen Sie Methodenparameter] {#keyvaluepair-connector-methods__table_php_txx_4tb} ## Element abrufen {#keyvaluepair-connector-methods__section_ush_1yx_4tb} Gibt den Wert des angegebenen Schlüssels zurück. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_rjd_2yx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Zurück | Gibt den Wert des Schlüssels zurück. | Daten aus | Objekt | Nicht zutreffend | Nicht zutreffend | [Tabelle : 6. Parameter der GetItem-Methode] {#keyvaluepair-connector-methods__table_rjd_2yx_4tb} ## GetItems {#keyvaluepair-connector-methods__section_nkm_4yx_4tb} Gibt die Werte mehrerer Schlüssel zurück. Sie müssen zuerst die Schlüssel in der Methode konfigurieren. Führen Sie zum Konfigurieren die folgenden Schritte aus. 1. Klicken Sie auf das Symbol für die Methodeneinstellungen ( ![Symbol für Methodeneinstellungen.]()). 2. Klicken Sie auf das Symbol Schlüssel hinzufügen ( ![Symbol „Schlüssel hinzufügen“.]()). 3. Geben Sie den Schlüsselnamen ein. 4. Aktualisieren Sie den Schlüsseldatentyp aus der Liste. 5. Wiederholen Sie die Schritte, um mehrere Schlüsselnamen festzulegen. 6. Klicken Sie auf OK. Mit jedem von Ihnen festgelegten Schlüsselnamen wird ein Datenausgang-Port erstellt. {#keyvaluepair-connector-methods__ol_dsq_nzx_4tb} {#keyvaluepair-connector-methods__table_k22_21y_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Gibt den Wert des Schlüssels zurück. | Daten aus | Objekt | Nicht zutreffend | Nicht zutreffend | [Tabelle : 7. GetItems-Methodenparameter] {#keyvaluepair-connector-methods__table_k22_21y_4tb} ## GetItemsByIndex {#keyvaluepair-connector-methods__section_of3_41y_4tb} Gibt die Schlüsselwerte basierend auf ihrem Index zurück. Sie müssen zuerst die Indizes in der Methode konfigurieren. Führen Sie zum Konfigurieren die folgenden Schritte aus. 1. Klicken Sie auf das Symbol für die Methodeneinstellungen ( ![Symbol für Methodeneinstellungen.]()). 2. Klicken Sie auf das Symbol Indizes hinzufügen ( ![Symbol „Schlüssel hinzufügen“.]()). 3. Geben Sie den Schlüsselindex ein. 4. Aktualisieren Sie den Schlüsseldatentyp aus der Liste. 5. Wiederholen Sie die Schritte, um mehrere Schlüsselindizes festzulegen. 6. Klicken Sie auf OK. Mit jedem von Ihnen festgelegten Schlüsselindex wird ein Datenausgang-Port erstellt. {#keyvaluepair-connector-methods__ol_e1y_bby_4tb} {#keyvaluepair-connector-methods__table_irj_mby_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüsselindex | Gibt den Wert des Schlüssels zurück. | Daten aus | Objekt | Nicht zutreffend | Nicht zutreffend | [Tabelle : 8. GetItemsByIndex-Methodenparameter] {#keyvaluepair-connector-methods__table_irj_mby_4tb} ## ParseFromText {#keyvaluepair-connector-methods__section_jbj_fly_4tb} Analysiert den angegebenen Text in Schlüssel-Wert-Paare. Es können mehrere Schlüsselwertpaare erstellt werden. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_vs2_xly_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Text | Text, der die Schlüssel und Werte enthält, die die Methode analysiert. | Daten in | Zeichenfolge | Keine | Ja | | Elementtrennzeichen | Trennzeichen zwischen zwei Schlüsselwertpaaren. | Daten in | Zeichenfolge | Keine | Ja | | KeyValueSeparator | Trennzeichen zwischen dem Schlüssel und seinem Wert. | Daten in | Zeichenfolge | Keine | Ja | | ClearBeforeAnalysieren | Bei „wahr" werden alle vorhandenen Schlüsselwertpaare vor der Analyse gelöscht. | Daten in | Boolean | Keine | Nein | [Tabelle : 9. Parameter der ParseFromText-Methode] {#keyvaluepair-connector-methods__table_vs2_xly_4tb} ## Umkehren {#keyvaluepair-connector-methods__section_oyx_mny_4tb} Kehrt die Schlüsselindizes um. Tipp: Nach der Ausführung der Methode können Sie die Ausgabe anzeigen, indem Sie die Methode GetItemsByIndex ausführen. ## SetData {#keyvaluepair-connector-methods__section_o1v_try_4tb} Informationen erforderlich. ## SetItem {#keyvaluepair-connector-methods__section_a5c_vry_4tb} Aktualisiert den Wert eines Schlüssels. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_v4f_dsy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Wert | Aktualisierter Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | [Tabelle : 10. SetItem-Methodenparameter] {#keyvaluepair-connector-methods__table_v4f_dsy_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die Methode GetItemsByIndex ausführen. ## SetItems {#keyvaluepair-connector-methods__section_il5_jsy_4tb} Aktualisiert die Werte der angegebenen Schlüssel. Sie müssen zuerst die Schlüssel in der Methode konfigurieren. Führen Sie die folgenden Schritte aus, um die Schlüssel zu konfigurieren. 1. Klicken Sie auf das Symbol für die Methodeneinstellungen ( ![Symbol für Methodeneinstellungen.]()). 2. Klicken Sie auf das Symbol Schlüssel hinzufügen ( ![Symbol „Schlüssel hinzufügen“.]()). 3. Geben Sie den Schlüsselnamen ein. 4. Aktualisieren Sie den Schlüsseldatentyp aus der Liste. 5. Wiederholen Sie die Schritte, um mehrere Schlüsselnamen festzulegen. 6. Klicken Sie auf OK. Mit jedem von Ihnen festgelegten Schlüsselnamen wird ein Datenport erstellt. {#keyvaluepair-connector-methods__ol_epq_tsy_4tb} Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_ug5_zsy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüssel | Aktualisierter Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | [Tabelle : 11. SetItems-Methodenparameter] {#keyvaluepair-connector-methods__table_ug5_zsy_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die Methode GetItemsByIndex ausführen. ## SetItemsByIndex {#keyvaluepair-connector-methods__section_t3c_sty_4tb} Aktualisiert die Werte der Schlüssel basierend auf den angegebenen Indizes. Sie müssen zuerst die Indizes in der Methode konfigurieren. Führen Sie die folgenden Schritte aus, um die Indizes zu konfigurieren. 1. Klicken Sie auf das Symbol für die Methodeneinstellungen ( ![Symbol für Methodeneinstellungen.]()). 2. Klicken Sie auf das Symbol Indizes hinzufügen ( ![Symbol „Schlüssel hinzufügen“.]()). 3. Geben Sie den Schlüsselindex ein. 4. Aktualisieren Sie den Schlüsseldatentyp aus der Liste. 5. Wiederholen Sie die Schritte, um mehrere Schlüsselindizes festzulegen. 6. Klicken Sie auf OK. Mit jedem von Ihnen festgelegten Schlüsselindex wird ein Datenport erstellt. {#keyvaluepair-connector-methods__ol_izp_m5y_4tb} {#keyvaluepair-connector-methods__table_emr_p5y_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Schlüsselindex | Index des Schlüssels. | Daten in | Objekt | Keine | Ja | [Tabelle : 12. SetItemsByIndex-Methodenparameter] {#keyvaluepair-connector-methods__table_emr_p5y_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die Methode GetItemsByIndex ausführen. ## Zu JSON {#keyvaluepair-connector-methods__section_nds_gvy_4tb} Rendert die Schlüsselwertpaare im JSON-Format. ## Zu Text {#keyvaluepair-connector-methods__section_pnh_4vy_4tb} Rendert die Schlüsselwertpaare im Textformat. Informationen zum Bereitstellen von Eingaben für die Parameter finden Sie unter [Konfigurieren Sie Porteigenschaften](https://www.servicenow.com/docs/o3w08UFDdlbO02ahKr0j3A "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in übergeben werden RPA Desktop Design Studio."). {#keyvaluepair-connector-methods__table_xsf_vvy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | WertOnly | Bei „wahr" rendert die Methode nur die Werte der Schlüssel, andernfalls rendert das Schlüsselwertpaar. | Daten in | Boolean | Keine | Nein | | Zurück | Gibt das Schlüsselwertpaar im Textformat zurück. | Daten aus | Zeichenfolge | Nicht zutreffend | Nicht zutreffend | [Tabelle : 13. ToText-Methodenparameter] {#keyvaluepair-connector-methods__table_xsf_vvy_4tb}