--- sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu: Integrationen mit Anwendungen erstellen ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # KeyValuePair-Connector-Methoden # KeyValuePair-Connector-Methoden {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Die Connector-Methoden für Schlüsselwertpaare führen verschiedene Aktionen für Schlüsselwertpaare aus. In einem Automatisierungs-Flow werden die Methoden mit anderen Methoden und Komponenten verbunden. Um die -Methoden verwenden zu können, müssen Sie sie zuerst verfügbar machen. ## Hinzufügen {#keyvaluepair-connector-methods__section_gcb_ftx_4tb} Fügt ein KeyValue-Paar hinzu. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_l1y_t4r_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Wert | Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | | Duplikate ignorieren | Wenn der Wert true ist, ignoriert die Methode einen doppelten Schlüssel. Andernfalls gibt die Methode eine Fehlermeldung zurück, wenn der Wert False ist. | Daten in | Boolean | Keine | Nein | [Tabelle : 1. Fügen Sie Methodenparameter hinzu] {#keyvaluepair-connector-methods__table_l1y_t4r_4tb} ## Löschen {#keyvaluepair-connector-methods__section_dfq_k5x_4tb} Löscht alle Schlüssel-Wert-Paare. ## EnthältSchlüssel {#keyvaluepair-connector-methods__section_ips_kvx_4tb} Gibt „Wahr" zurück, wenn der angegebene Schlüssel vorhanden ist. Andernfalls wird „Falsch" zurückgegeben. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_x4r_svx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | 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} ## EnthältWert {#keyvaluepair-connector-methods__section_h14_cwx_4tb} Gibt „Wahr" zurück, wenn der angegebene Schlüsselwert vorhanden ist, andernfalls wird „Falsch" zurückgegeben. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#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 KeyValue-Paare zurück. {#keyvaluepair-connector-methods__table_p3f_bxx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Zurück | Gibt die Gesamtanzahl der KeyValue-Paare zurück. | Daten aus | Ganzzahl | Nicht zutreffend | Nicht zutreffend | [Tabelle : 4. Parameter der Zählungsmethode] {#keyvaluepair-connector-methods__table_p3f_bxx_4tb} ## Löschen {#keyvaluepair-connector-methods__section_knr_qxx_4tb} Entfernt den angegebenen Schlüssel. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_php_txx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | [Tabelle : 5. Löschen Sie die Methodenparameter] {#keyvaluepair-connector-methods__table_php_txx_4tb} ## GetItem {#keyvaluepair-connector-methods__section_ush_1yx_4tb} Gibt den Wert des angegebenen Schlüssels zurück. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_rjd_2yx_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | 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 ![Methodeneinstellungen (Symbol für Methodeneinstellungen]()). 2. Klicken Sie auf das Symbol zum Hinzufügen von Schlüsseln (Symbol zum Hinzufügen von ![Schlüsseln.]()). 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 Datenausgangsport erstellt. {#keyvaluepair-connector-methods__ol_dsq_nzx_4tb} {#keyvaluepair-connector-methods__table_k22_21y_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | Gibt den Wert des Schlüssels zurück. | Daten aus | Objekt | Nicht zutreffend | Nicht zutreffend | [Tabelle : 7. Parameter der GetItems-Methode] {#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 ![Methodeneinstellungen (Symbol für Methodeneinstellungen]()). 2. Klicken Sie auf das Symbol zum Hinzufügen von Indizes (Symbol zum ![Hinzufügen von Schlüsseln.]()). 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 Datenausgangsport 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. Parameter der GetItemsByIndex-Methode] {#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üssel-Wert-Paare erstellt werden. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_vs2_xly_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Text | Text mit den Schlüsseln und Werten, die von der Methode analysiert werden. | Daten in | Zeichenfolge | Keine | Ja | | ItemSeparator | Trennzeichen zwischen zwei KeyValue-Paaren. | Daten in | Zeichenfolge | Keine | Ja | | KeyValueTrennzeichen | Trennzeichen zwischen dem Schlüssel und seinem Wert. | Daten in | Zeichenfolge | Keine | Ja | | ClearBeforeParse | Bei „Wahr" werden vorhandene Schlüssel-Wert-Paare 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 Ausführung der Methode können Sie die Ausgabe anzeigen, indem Sie die Methode GetItemsByIndex ausführen. ## Daten festlegen {#keyvaluepair-connector-methods__section_o1v_try_4tb} Informationen erforderlich. ## Element festlegen {#keyvaluepair-connector-methods__section_a5c_vry_4tb} Aktualisiert den Wert eines Schlüssels. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_v4f_dsy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | Name des Schlüssels. | Daten in | Zeichenfolge | Keine | Ja | | Wert | Aktualisierter Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | [Tabelle : 10. Parameter der SetItem-Methode] {#keyvaluepair-connector-methods__table_v4f_dsy_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die GetItemsByIndex-Methode ausführen. ## Elemente festlegen {#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 ![Methodeneinstellungen (Symbol für Methodeneinstellungen]()). 2. Klicken Sie auf das Symbol zum Hinzufügen von Schlüsseln (Symbol zum Hinzufügen von ![Schlüsseln.]()). 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 werden Daten im Port erstellt. {#keyvaluepair-connector-methods__ol_epq_tsy_4tb} Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_ug5_zsy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | Key | Aktualisierter Wert des Schlüssels. | Daten in | Objekt | Keine | Ja | [Tabelle : 11. Parameter der SetItems-Methode] {#keyvaluepair-connector-methods__table_ug5_zsy_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die GetItemsByIndex-Methode ausführen. ## Elemente nach Index festlegen {#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 Verzeichnisse zu konfigurieren. 1. Klicken Sie auf das Symbol für ![Methodeneinstellungen (Symbol für Methodeneinstellungen]()). 2. Klicken Sie auf das Symbol zum Hinzufügen von Indizes (Symbol zum ![Hinzufügen von Schlüsseln.]()). 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 werden Daten im Port 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. Parameter der Methode „SetItemsByIndex"] {#keyvaluepair-connector-methods__table_emr_p5y_4tb} Tipp: Testen Sie den aktualisierten Wert, indem Sie die GetItemsByIndex-Methode ausführen. ## ToJSON {#keyvaluepair-connector-methods__section_nds_gvy_4tb} Rendert die KeyValue-Paare im JSON-Format. ## ToText {#keyvaluepair-connector-methods__section_pnh_4vy_4tb} Rendert die Schlüsselwertpaare im Textformat. Informationen zur Eingabe von Parametern finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#keyvaluepair-connector-methods__table_xsf_vvy_4tb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Obligatorisch? | |-|-|-|-|-|-| | ValuesOnly | Bei „Wahr" rendert die Methode nur die Werte der Schlüssel, andernfalls wird das Schlüssel-Wert-Paar gerendert. | Daten in | Boolean | Keine | Nein | | Zurück | Gibt das Schlüsselwertpaar an das Textformat zurück. | Daten aus | Zeichenfolge | Nicht zutreffend | Nicht zutreffend | [Tabelle : 13. ToText-Methodenparameter] {#keyvaluepair-connector-methods__table_xsf_vvy_4tb}