--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # SCIM2ClientUtil - Dans le champ d'application # SCIM2ClientUtil - Dans le champ d'application {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture L'API SCIM2ClientUtil fournit des méthodes utilitaires permettant d'obtenir les identificateurs uniques des systèmes des fournisseurs externes, puis d'utiliser ces informations lors de l'appel de l'API SCIM2Client . Cette API s'exécute dans l'espace de noms `sn_auth` et nécessite l'installation du module d'extension SCIM v2 - ServiceNow Cross-domain Identity Management Client (com.snc.integration.scim2.client) pour accéder à l'API. Pour plus d'informations sur SCIM, consultez [System for Cross-domain Identity Management (SCIM).](https://www.servicenow.com/docs/access?context=scim&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) ## SCIM2ClientUtil : getProviderIdByFilter(String provider, String resourceName, String filter) {#ariaid-title2} Renvoie l'identificateur unique d'une ressource spécifiée à partir d'un système de fournisseur externe spécifié pour un ID de ressource unique dans une ServiceNow instance à l'aide d'une expression de filtre pour décrire la ressource souhaitée. Cette API est utile lors du mappage ServiceNow des champs avec des champs SCIM où l'identificateur de ressource dans le système du fournisseur externe est nécessaire. Avant d'appeler cette méthode, un champ unique doit être défini pour la ressource dans la carte d'attributs système, située dans la table Mappage des ressources du fournisseur SCIM \[sys_scim_provider_resource_mapping \]. Pour en savoir plus sur le mappage des ressources des fournisseurs, reportez-vous à la section [Create a SCIM Provider Resource Mapping](https://www.servicenow.com/docs/access?context=scim-provider-resource-mapping&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). {#S2CUtil-getProviderIdByFilter_S_S_S__table_j21_ks5_ctb__entry__3} | Nom | Type | Description | |-|-|-| | fournisseur | Chaîne | Nom du fournisseur de service SCIM configuré. Table : dans le champ Nom de la table Fournisseur SCIM \[sys_scim_provider\]. | | resourceName | Chaîne | Nom du type de ressource, par exemple Utilisateur ou Groupe. Table : dans le champ resource_name de la table Mappage des ressources du fournisseur SCIM \[sys_scim_provider_resource_mapping\]. | | filtre | Chaîne | Expression de filtre à appliquer aux résultats renvoyés. Pour plus d'informations sur les paramètres de filtre disponibles et leur format associé, reportez-vous à la section suivante du document Internet Engineering Task Force : System for Cross-domain Identity Management : Protocol | [Tableau 1. Paramètres] {#S2CUtil-getProviderIdByFilter_S_S_S__table_j21_ks5_ctb} {#S2CUtil-getProviderIdByFilter_S_S_S__table_k21_ks5_ctb__entry__2} | Type | Description | |-|-| | Chaîne | Identificateur de ressource unique utilisé par le fournisseur de service externe. Lève une exception en cas de problème lors de l'extraction des informations. | [Tableau 2. Renvoie] {#S2CUtil-getProviderIdByFilter_S_S_S__table_k21_ks5_ctb} L'exemple suivant montre comment obtenir l'identificateur de ressource de l'utilisateur à `l'aide du filtre 'username eq << abel.tuter"`'. var response = sn_auth.SCIM2ClientUtil.getProviderIdByFilter('SNOW Provider','User','username eq "abel.tuter"'); gs.info('response: ' + response); Sortie : "005d500b536073005e0addeeff7b12f4 ``` ``` L'exemple suivant montre comment utiliser un script pour obtenir l'identificateur de ressource du gestionnaire à `l'aide du filtre 'userName eq << ' + manager + '"'`. (function getValue(resourceGR) { try { var manager = resourceGR.manager.user_name; return sn_auth.SCIM2ClientUtil.getProviderIdByFilter('SCIM Provider Demo', 'User', 'userName eq "' + manager + '"'); } catch (e) { gs.error('Unable to get attribute value using script' + e); // Handle failure scenario here } })(resourceGR); Sortie : "125d500b535973005e0addeeff8c12a2" ## SCIM2ClientUtil : getProviderIdByResourceId(String provider, String resourceName, String resourceId) {#ariaid-title3} Renvoie l'identificateur unique d'une ressource spécifiée à partir d'un système de fournisseur externe spécifié pour un ID de ressource unique dans une ServiceNow instance. Cette API est utile lors du mappage ServiceNow des champs avec des champs SCIM où l'identificateur de ressource dans le système du fournisseur externe est nécessaire. Avant d'appeler cette méthode, un champ unique doit être défini pour la ressource dans la carte d'attributs système, située dans la table Mappage des ressources du fournisseur SCIM \[sys_scim_provider_resource_mapping\]. Pour plus d'informations sur le mappage des ressources du fournisseur, consultez [Créer un mappage des ressources du fournisseur SCIM](https://www.servicenow.com/docs/access?context=scim-provider-resource-mapping&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). {#S2CUtil-getProviderIdByResId_S_S_S__table_rks_rd5_ctb__entry__3} | Nom | Type | Description | |-|-|-| | fournisseur | Chaîne | Nom du fournisseur de service SCIM configuré. Table : dans le champ Nom de la table Fournisseur SCIM \[sys_scim_provider\]. | | resourceName | Chaîne | Nom du type de ressource, par exemple Utilisateur ou Groupe. Table : dans le champ resource_name de la table Mappage des ressources du fournisseur SCIM \[sys_scim_provider_resource_mapping\]. | | resourceId | Chaîne | Sys_id de la ressource enregistrée dans l'instance ServiceNow (le client). Table : dans le champ primary_table de la table Mappage des ressources du fournisseur SCIM \[sys_scim_provider_resource_mapping\]. | [Tableau 3. Paramètres] {#S2CUtil-getProviderIdByResId_S_S_S__table_rks_rd5_ctb} {#S2CUtil-getProviderIdByResId_S_S_S__table_sks_rd5_ctb__entry__2} | Type | Description | |-|-| | Chaîne | Identificateur de ressource unique utilisé par le fournisseur de service externe. Lève une exception en cas de problème lors de l'extraction des informations. | [Tableau 4. Renvoie] {#S2CUtil-getProviderIdByResId_S_S_S__table_sks_rd5_ctb} L'exemple suivant montre comment obtenir l'identificateur de ressource de l'utilisateur avec le sys_id f282abf03710200044e0bfc8bcbe5d12. var response = sn_auth.SCIM2ClientUtil.getProviderIdByResourceId('SNOW Provider','User','f282abf03710200044e0bfc8bcbe5d12'); gs.info('response: ' + response); Sortie : "005d500b536073005e0addeeff7b12f4"