---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SCIM2ClientUtil -- Umfang

# SCIM2ClientUtil -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die SCIM2ClientUtil Die API stellt Dienstprogrammmethoden bereit, um die eindeutigen Bezeichner externer Anbietersysteme abzurufen und diese Informationen dann beim Aufrufen von zu verwenden SCIM2Client API.

Diese API wird in ausgeführt `sn_auth `Namespace und erfordert die Installation des Plugins SCIM v2 -- domänenübergreifender ServiceNow-Identitätsverwaltungsclient (com.snc.integration.scim2.client), um auf die API zuzugreifen.

Weitere Informationen zu SCIM finden Sie unter [System für domänenübergreifendes Identitätsmanagement (SCIM)](https://www.servicenow.com/docs/access?context=scim&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

## SCIM2ClientUtil -- getProviderIdByFilter(Zeichenfolgenanbieter, Zeichenfolgenressourcenname, Zeichenfolgenfilter) {#ariaid-title2}

Gibt den eindeutigen Bezeichner einer angegebenen Ressource aus einem angegebenen externen Anbietersystem für eine eindeutige Ressourcen-ID in zurück ServiceNowInstanz, die einen Filterausdruck verwendet, um die gewünschte Ressource zu beschreiben.
Diese API ist bei der Zuordnung nützlich ServiceNowFelder zu SCIM-Feldern, in denen der Ressourcenbezeichner im externen Anbietersystem erforderlich ist. Vor dem Aufrufen dieser Methode muss ein eindeutiges Feld für die Ressource in der Systemattributzuordnung definiert werden, die sich in der Tabelle „SCIM-Anbieterressourcenzuordnung" \[sys_scim_provider_resource_mapping\] befindet.

Weitere Informationen zur Zuordnung von Anbieterressourcen finden Sie unter [Create a SCIM Provider Resource Mapping](https://www.servicenow.com/docs/access?context=scim-provider-resource-mapping&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
{#S2CUtil-getProviderIdByFilter_S_S_S__table_j21_ks5_ctb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anbieter | Zeichenfolge | Name des konfigurierten SCIM-Service Providers. Tabelle: Im Namensfeld der Tabelle „SCIM-Anbieter" \[sys_scim_Provider\]. |
| resourceName | Zeichenfolge | Name des Ressourcentyps, z. B. Anwender oder Gruppe. Tabelle: Im Feld resource_Name der Tabelle „SCIM-Anbieterressourcenzuordnung \[sys_scim_provider_resource_mapping\]". |
| Filter | Zeichenfolge | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Weitere Informationen zu den verfügbaren Filterparametern und dem zugehörigen Format finden Sie im folgenden Abschnitt im Dokument der Task Force „Internet Engineering": System für domänenübergreifende Identitätsverwaltung: Protokoll <https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2.2> |
[Tabelle : 1. Parameter]

{#S2CUtil-getProviderIdByFilter_S_S_S__table_j21_ks5_ctb} {#S2CUtil-getProviderIdByFilter_S_S_S__table_k21_ks5_ctb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eindeutiger Ressourcenbezeichner, der vom externen Service Provider verwendet wird. Löst eine Ausnahme aus, wenn beim Abrufen der Informationen ein Problem auftritt. |
[Tabelle : 2. Rückgaben]

{#S2CUtil-getProviderIdByFilter_S_S_S__table_k21_ks5_ctb}  
Das folgende Beispiel zeigt, wie der Ressourcenbezeichner des Anwenders mithilfe des Filters abgerufen wird `„Anwendername eq „abel.tuter"" `.

    var response = sn_auth.SCIM2ClientUtil.getProviderIdByFilter('SNOW Provider','User','username eq "abel.tuter"'); 
    gs.info('response: ' + response);

Ausgabe:


     "005d500b536073005e0addeeff7b12f4"

Das folgende Beispiel zeigt, wie ein Skript verwendet wird, um den Ressourcenbezeichner des Managers mithilfe des Filters abzurufen `„Anwendername 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);

Ausgabe:


      "125d500b535973005e0addeeff8c12a2"

## SCIM2ClientUtil -- getProviderIdByResourceId(Zeichenfolgenanbieter, Zeichenfolge ResourceName, Zeichenfolge resourceId) {#ariaid-title3}

Gibt den eindeutigen Bezeichner einer angegebenen Ressource aus einem angegebenen externen Anbietersystem für eine eindeutige Ressourcen-ID in zurück ServiceNowInstanz.
Diese API ist bei der Zuordnung nützlich ServiceNowFelder zu SCIM-Feldern, in denen der Ressourcenbezeichner im externen Anbietersystem erforderlich ist. Vor dem Aufrufen dieser Methode muss ein eindeutiges Feld für die Ressource in der Systemattributzuordnung definiert werden, die sich in der Tabelle „SCIM-Anbieterressourcenzuordnung" \[sys_scim_provider_resource_mapping\] befindet.

Weitere Informationen zur Zuordnung von Anbieterressourcen finden Sie unter [Create a SCIM Provider Resource Mapping](https://www.servicenow.com/docs/access?context=scim-provider-resource-mapping&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).
{#S2CUtil-getProviderIdByResId_S_S_S__table_rks_rd5_ctb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anbieter | Zeichenfolge | Name des konfigurierten SCIM-Service Providers. Tabelle: Im Namensfeld der Tabelle „SCIM-Anbieter" \[sys_scim_Provider\]. |
| resourceName | Zeichenfolge | Name des Ressourcentyps, z. B. Anwender oder Gruppe. Tabelle: Im Feld resource_Name der Tabelle „SCIM-Anbieterressourcenzuordnung \[sys_scim_provider_resource_mapping\]". |
| resourceId | Zeichenfolge | SYS_ID der in gespeicherten Ressource ServiceNowInstanz (der Client). Tabelle: Im Feld „primary_table" der Tabelle „SCIM-Anbieterressourcenzuordnung \[sys_scim_provider_resource_mapping\]". |
[Tabelle : 3. Parameter]

{#S2CUtil-getProviderIdByResId_S_S_S__table_rks_rd5_ctb} {#S2CUtil-getProviderIdByResId_S_S_S__table_sks_rd5_ctb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eindeutiger Ressourcenbezeichner, der vom externen Service Provider verwendet wird. Löst eine Ausnahme aus, wenn beim Abrufen der Informationen ein Problem auftritt. |
[Tabelle : 4. Rückgaben]

{#S2CUtil-getProviderIdByResId_S_S_S__table_sks_rd5_ctb}  
Das folgende Beispiel zeigt, wie der Ressourcenbezeichner des Anwenders mit der sys_ID f282abf0371020004e0bfc8bcbe5d12 abgerufen wird.

    var response = sn_auth.SCIM2ClientUtil.getProviderIdByResourceId('SNOW Provider','User','f282abf03710200044e0bfc8bcbe5d12'); 
    gs.info('response: ' + response);

Ausgabe:


      "005d500b536073005e0addeeff7b12f4"


