--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Méthodes de connecteurs KeyValuePair # Méthodes de connecteurs KeyValuePair {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture Les méthodes de connecteur de paires de valeurs clés effectuent diverses actions sur les paires clé-valeur. 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 de valeurs clés. Pour fournir des entrées dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | Oui | | Valeur | Valeur de la clé. | Données dans | Objet | Aucun | Oui | | Ignorer les doublons | Si la valeur est True, la méthode ignore une clé en double. Sinon, si la valeur est False, la méthode renvoie un message d'erreur. | Données dans | Booléen | Aucun | 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 clé-valeur. ## ContainsKey {#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 dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | 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. Paramètres de la méthode ContainsKey] {#keyvaluepair-connector-methods__table_x4r_svx_4tb} ## Contient la valeur {#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 dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | 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 dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | Oui | [Tableau 5. Supprimer les paramètres de la méthode] {#keyvaluepair-connector-methods__table_php_txx_4tb} ## Obtenir un élément {#keyvaluepair-connector-methods__section_ush_1yx_4tb} Renvoie la valeur de la clé spécifiée. Pour fournir des entrées dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | 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} ## Obtenir des éléments {#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 le configurer, procédez comme suit. 1. Cliquez sur l'icône des paramètres de méthode (icône ![des paramètres de méthode).]() 2. Cliquez sur l'icône Ajouter des clés (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} ## Obtenir des éléments par index {#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 le configurer, procédez comme suit. 1. Cliquez sur l'icône des paramètres de méthode (icône ![des paramètres de méthode).]() 2. Cliquez sur l'icône Ajouter des index (icône ![Ajouter des clés).]() 3. Saisissez 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é. 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 dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 que la méthode analyse. | Données dans | Chaîne | Aucun | Oui | | Séparateur d'élément | Séparateur entre deux paires clé-valeur. | Données dans | Chaîne | Aucun | Oui | | KeyValueSeparator (Séparateur clé-valeur) | Séparateur entre la clé et sa valeur. | Données dans | Chaîne | Aucun | Oui | | Effacer avant d'analyser | Si la valeur est Vrai, efface toute paire de valeurs clés existante avant l'analyse. | Données dans | Booléen | Aucun | 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 l'exécution de la méthode, vous pouvez voir la sortie en exécutant la méthode GetItemsByIndex. ## SetData (en anglais seulement) {#keyvaluepair-connector-methods__section_o1v_try_4tb} Besoin d'informations. ## Définir l'élément {#keyvaluepair-connector-methods__section_a5c_vry_4tb} Met à jour la valeur d'une clé. Pour fournir des entrées dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | Oui | | Valeur | Valeur mise à jour de la clé. | Données dans | Objet | Aucun | Oui | [Tableau 10. Paramètres de méthode SetItem] {#keyvaluepair-connector-methods__table_v4f_dsy_4tb} Conseil : Testez la valeur mise à jour en exécutant la méthode GetItemsByIndex. ## Éléments définis {#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 des paramètres de méthode (icône ![des paramètres de méthode).]() 2. Cliquez sur l'icône Ajouter des clés (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 d'entrée 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 dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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 | Aucun | 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. ## Définir les éléments par index {#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 des paramètres de méthode (icône ![des paramètres de méthode).]() 2. Cliquez sur l'icône Ajouter des index (icône ![Ajouter des clés).]() 3. Saisissez 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é. 6. Cliquez sur OK. Un port d'entrée 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 clé | Index de la clé. | Données dans | Objet | Aucun | Oui | [Tableau 12. Paramètres de la 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 de valeurs clés au format JSON. ## ToText (Texte de destination) {#keyvaluepair-connector-methods__section_pnh_4vy_4tb} Affiche les paires clé-valeur au format texte. Pour fournir des entrées dans les paramètres, reportez-vous à la section [Configurer les propriétés des ports](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "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? | |-|-|-|-|-|-| | Valeurs uniquement | Si la valeur est Vrai, la méthode affiche uniquement les valeurs des clés, sinon la paire de valeurs clés est rendue. | Données dans | Booléen | Aucun | 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}