--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Méthodes de connecteur KeyValuePair # Méthodes de connecteur KeyValuePair {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture Les méthodes de connecteur de paire de valeurs clés permettent d'effectuer diverses actions sur les paires de valeurs clés. Dans un flux d'automatisation, les méthodes sont connectées à d'autres méthodes et composants. Pour utiliser les méthodes, vous devez d'abord les exposer. ## Ajouter {#keyvaluepair-connector-methods__section_gcb_ftx_4tb} Ajoute une paire keyvalue. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_l1y_t4r_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Nom de la clé. | Données dans | Chaîne | Néant | Oui | | Valeur | Valeur de la clé. | Données dans | Objet | Néant | Oui | | Ignorer les doublons | Si la valeur est Vrai, la méthode ignore les doublons. Sinon, si la valeur est False, la méthode renvoie un message d'erreur. | Données dans | Booléen | Néant | Non | [Tableau 1. Ajouter des paramètres de méthode] {#keyvaluepair-connector-methods__table_l1y_t4r_4tb} ## Effacer {#keyvaluepair-connector-methods__section_dfq_k5x_4tb} Efface toutes les paires de valeurs clés. ## Contientune clé {#keyvaluepair-connector-methods__section_ips_kvx_4tb} Renvoie la valeur Vrai si la clé spécifiée existe, sinon renvoie la valeur Faux. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_x4r_svx_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Nom de la clé. | Données dans | Chaîne | Néant | Oui | | Retour | Renvoie la valeur Vrai si la clé spécifiée existe, sinon renvoie la valeur Faux. | Sortie de données | Booléen | Non applicable | Non applicable | [Tableau 2. ContientParamètres de méthode clé] {#keyvaluepair-connector-methods__table_x4r_svx_4tb} ## ContientValeur {#keyvaluepair-connector-methods__section_h14_cwx_4tb} Renvoie la valeur Vrai si la valeur de clé spécifiée existe, sinon renvoie la valeur Faux. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_wbh_twx_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Valeur | Nom de la valeur de clé. | Données dans | Chaîne | Néant | Oui | | Retour | Renvoie la valeur Vrai si la valeur de clé spécifiée existe, sinon renvoie la valeur Faux. | Sortie de données | Booléen | Non applicable | Non applicable | [Tableau 3. Paramètres de méthode ContainsValue] {#keyvaluepair-connector-methods__table_wbh_twx_4tb} ## Nombre {#keyvaluepair-connector-methods__section_odt_xwx_4tb} Renvoie le nombre total de paires clé-valeur. {#keyvaluepair-connector-methods__table_p3f_bxx_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Retour | Renvoie le nombre total de paires clé-valeur. | Sortie de données | Entier | Non applicable | Non applicable | [Tableau 4. Paramètres de la méthode de comptage] {#keyvaluepair-connector-methods__table_p3f_bxx_4tb} ## Supprimer {#keyvaluepair-connector-methods__section_knr_qxx_4tb} Supprime la clé spécifiée. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_php_txx_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Nom de la clé. | Données dans | Chaîne | Néant | Oui | [Tableau 5. Supprimer les paramètres de méthode] {#keyvaluepair-connector-methods__table_php_txx_4tb} ## Obtenir l'élément {#keyvaluepair-connector-methods__section_ush_1yx_4tb} Renvoie la valeur de la clé spécifiée. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_rjd_2yx_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Nom de la clé. | Données dans | Chaîne | Néant | Oui | | Retour | Renvoie la valeur de la clé. | Sortie de données | Objet | Non applicable | Non applicable | [Tableau 6. Paramètres de méthode GetItem] {#keyvaluepair-connector-methods__table_rjd_2yx_4tb} ## GetItems {#keyvaluepair-connector-methods__section_nkm_4yx_4tb} Renvoie les valeurs de plusieurs clés. Vous devez d'abord configurer les clés dans la méthode. Pour configurer, procédez comme suit. 1. Cliquez sur l'icône Paramètres de méthode ( ![Icône Paramètres de méthode.]()). 2. Cliquez sur l'icône Ajouter des touches (icône ![Ajouter des clés).]() 3. Entrez le nom de la clé. 4. Mettez à jour le type de données clé à partir de la liste. 5. Répétez les étapes pour définir plusieurs noms de clés. 6. Cliquez sur OK. Un port de sortie de données est créé avec chaque nom de clé que vous définissez. {#keyvaluepair-connector-methods__ol_dsq_nzx_4tb} {#keyvaluepair-connector-methods__table_k22_21y_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Renvoie la valeur de la clé. | Sortie de données | Objet | Non applicable | Non applicable | [Tableau 7. Paramètres de méthode GetItems] {#keyvaluepair-connector-methods__table_k22_21y_4tb} ## GetItemsByIndex {#keyvaluepair-connector-methods__section_of3_41y_4tb} Renvoie les valeurs de clé en fonction de leur index. Vous devez d'abord configurer les index dans la méthode. Pour configurer, procédez comme suit. 1. Cliquez sur l'icône Paramètres de méthode ( ![Icône Paramètres de méthode.]()). 2. Cliquez sur l'icône Ajouter des index (icône ![Ajouter des clés).]() 3. Entrez l'index de clé. 4. Mettez à jour le type de données clé à partir de la liste. 5. Répétez les étapes pour définir plusieurs index de clés. 6. Cliquez sur OK. Un port de sortie de données est créé avec chaque index de clé que vous définissez. {#keyvaluepair-connector-methods__ol_e1y_bby_4tb} {#keyvaluepair-connector-methods__table_irj_mby_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Index de clé | Renvoie la valeur de la clé. | Sortie de données | Objet | Non applicable | Non applicable | [Tableau 8. Paramètres de méthode GetItemsByIndex] {#keyvaluepair-connector-methods__table_irj_mby_4tb} ## ParseFromText {#keyvaluepair-connector-methods__section_jbj_fly_4tb} Analyse le texte spécifié en paires de valeurs clés. Il peut créer plusieurs paires clé-valeur. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_vs2_xly_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Texte | Texte comprenant les clés et les valeurs analysées par la méthode. | Données dans | Chaîne | Néant | Oui | | ItemSeparator | Séparateur entre deux paires de valeurs clés. | Données dans | Chaîne | Néant | Oui | | Séparateur de valeur de clé | Séparateur entre la clé et sa valeur. | Données dans | Chaîne | Néant | Oui | | ClearBeforeParse | Si la valeur est Vrai, efface toute paire de valeurs de clé existante avant l'analyse. | Données dans | Booléen | Néant | Non | [Tableau 9. Paramètres de la méthode ParseFromText] {#keyvaluepair-connector-methods__table_vs2_xly_4tb} ## Inverser {#keyvaluepair-connector-methods__section_oyx_mny_4tb} Inverse les index clés. Conseil : Après avoir exécuté la méthode, vous pouvez voir la sortie en exécutant la méthode GetItemsByIndex. ## SetData (en anglais) {#keyvaluepair-connector-methods__section_o1v_try_4tb} Besoin d'informations. ## SetItem {#keyvaluepair-connector-methods__section_a5c_vry_4tb} Met à jour la valeur d'une clé. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_v4f_dsy_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Nom de la clé. | Données dans | Chaîne | Néant | Oui | | Valeur | Valeur mise à jour de la clé. | Données dans | Objet | Néant | Oui | [Tableau 10. Paramètres de la méthode SetItem] {#keyvaluepair-connector-methods__table_v4f_dsy_4tb} Conseil : Testez la valeur mise à jour en exécutant la méthode GetItemsByIndex. ## SetItems {#keyvaluepair-connector-methods__section_il5_jsy_4tb} Met à jour les valeurs des clés spécifiées. Vous devez d'abord configurer les clés dans la méthode. Pour configurer les clés, procédez comme suit. 1. Cliquez sur l'icône Paramètres de méthode ( ![Icône Paramètres de méthode.]()). 2. Cliquez sur l'icône Ajouter des touches (icône ![Ajouter des clés).]() 3. Entrez le nom de la clé. 4. Mettez à jour le type de données clé à partir de la liste. 5. Répétez les étapes pour définir plusieurs noms de clés. 6. Cliquez sur OK. Un port de données est créé avec chaque nom de clé que vous définissez. {#keyvaluepair-connector-methods__ol_epq_tsy_4tb} Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_ug5_zsy_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Clé | Valeur mise à jour de la clé. | Données dans | Objet | Néant | Oui | [Tableau 11. Paramètres de méthode SetItems] {#keyvaluepair-connector-methods__table_ug5_zsy_4tb} Conseil : Testez la valeur mise à jour en exécutant la méthode GetItemsByIndex. ## SetItemsByIndex {#keyvaluepair-connector-methods__section_t3c_sty_4tb} Met à jour les valeurs des clés en fonction des index spécifiés. Vous devez d'abord configurer les index dans la méthode. Pour configurer les index, procédez comme suit. 1. Cliquez sur l'icône Paramètres de méthode ( ![Icône Paramètres de méthode.]()). 2. Cliquez sur l'icône Ajouter des index (icône ![Ajouter des clés).]() 3. Entrez l'index de clé. 4. Mettez à jour le type de données clé à partir de la liste. 5. Répétez les étapes pour définir plusieurs index de clés. 6. Cliquez sur OK. Un port de données est créé avec chaque index de clé que vous définissez. {#keyvaluepair-connector-methods__ol_izp_m5y_4tb} {#keyvaluepair-connector-methods__table_emr_p5y_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | Index de clé | Index de la clé. | Données dans | Objet | Néant | Oui | [Tableau 12. Paramètres de méthode SetItemsByIndex] {#keyvaluepair-connector-methods__table_emr_p5y_4tb} Conseil : Testez la valeur mise à jour en exécutant la méthode GetItemsByIndex. ## ToJSON {#keyvaluepair-connector-methods__section_nds_gvy_4tb} Affiche les paires clé-valeur au format JSON. ## Texte cible {#keyvaluepair-connector-methods__section_pnh_4vy_4tb} Affiche les paires clé-valeur au format texte. Pour fournir des entrées aux paramètres, reportez-vous à la section [Configurer les propriétés du port](https://servicenow-prod.fluidtopics.net/6JvHcl7ZXkWp0SovDjJ3XQ "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#keyvaluepair-connector-methods__table_xsf_vvy_4tb__entry__6} | Paramètre | Description | Type de port de données | Type de données | Valeur par défaut | Obligatoire ? | |-|-|-|-|-|-| | ValeursOnly | Si la valeur est True, la méthode affiche uniquement les valeurs des clés, sinon affiche la paire keyvalue. | Données dans | Booléen | Néant | Non | | Retour | Renvoie la paire keyvalue au format texte. | Sortie de données | Chaîne | Non applicable | Non applicable | [Tableau 13. Paramètres de la méthode ToText] {#keyvaluepair-connector-methods__table_xsf_vvy_4tb}