---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UserCriteria: Bereichsbezogen

# UserCriteria: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die UserCriteria- API bietet Methoden zum Erstellen, Ändern und Löschen von Anwenderkriteriendatensätzen mithilfe von Skripts.

Um diese Klasse in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie den Namespace-Bezeichner `sn_uc`. Das Plugin „Scoped API für Anwenderkriterien" (ID: com.glideapp.user_criteria.scoped.api) muss für den Zugriff auf diese API aktiviert sein.

## UserCriteria: UserCriteria() {#ariaid-title2}

Erstellt eine Instanz der UserCriteria-Klasse.  

    var uc = new sn_uc.UserCriteria();

## UserCriteria: UserCriteria(String sys_id) {#ariaid-title3}

Erstellt eine Instanz der UserCriteria-Klasse mit der angegebenen sys_id.
{#r_UCS-UserCriteria_S__table_dxz_fz2_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sys_id | Zeichenfolge | sys_id der Benutzerkriterien. |
[Tabelle : 1. Parameter]

{#r_UCS-UserCriteria_S__table_dxz_fz2_vz}  

    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");

## UserCriteria - create(Object columnValues, Boolean standardUpdate) {#ariaid-title4}

Erstellt Benutzerkriterien mit angegebenen Werten in der Tabelle „user_criteria". Unter „columnValues" ​​angegebene Werte überschreiben die über Festsetzungen angegebenen Werte.
{#r_UCS-create_O_B__table_ncp_prf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| columnValues | Objekt | Schlüssel- und Wertpaare für eine Spalte und ihren Wert. |
| standardUpdate | Boolean | Stellen Sie hier „true" ein, um die Ausführung von Engines und den Workflow zu aktivieren. |
[Tabelle : 2. Parameter]

{#r_UCS-create_O_B__table_ncp_prf_vz} {#r_UCS-create_O_B__table_ocp_prf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | sys_id der erstellten Benutzerkriterien. |
[Tabelle : 3. Ergebnisse]

{#r_UCS-create_O_B__table_ocp_prf_vz}  

    var uc = new sn_uc.UserCriteria(); 
    uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
    uc.setActive(true); 
    uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
    var UserCriteriaId = uc.create();
    gs.info(UserCriteriaId);

Ausgabe:

    41bea3d53790200044e0bfc8bcbe5dec

## UserCriteria -- deleteRecord() {#ariaid-title5}

Löscht die aktuellen Benutzerkriterien.
{#r_UCS-deleteRecord__table_erq_jlf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#r_UCS-deleteRecord__table_erq_jlf_vz} {#r_UCS-deleteRecord__table_frq_jlf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Bei „true" werden die Benutzerkriterien gelöscht. Bei „false" werden keine Benutzerkriterien zum Löschen gefunden. |
[Tabelle : 5. Ergebnisse]

{#r_UCS-deleteRecord__table_frq_jlf_vz}  

    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");
    uc.deleteRecord();

Ausgabe:

    true

## UserCriteria - read(Zeichenfolgenspalten) {#ariaid-title6}

Zeigt die Zuordnung für die Attribut- und Wertpaare des Katalogelements an.
{#r_UCS-read_S__table_rnk_bpf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| columns | Zeichenfolge | Array von Katalogelementattributen. |
[Tabelle : 6. Parameter]

{#r_UCS-read_S__table_rnk_bpf_vz} {#r_UCS-read_S__table_snk_bpf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Zuordnung für die Attribut- und Wertpaare des Katalogelements. |
[Tabelle : 7. Ergebnisse]

{#r_UCS-read_S__table_snk_bpf_vz}  

    var uc = new sn_uc.UserCriteria("7b8a6927ef732100438236caa5c0fb89");
    var obj = uc.read(["company","name"]);
    gs.info(JSON.stringify(obj));

Ausgabe:

    Script: {"name":"All ACME Corporation employees","company":"e7c1f3d53790200044e0bfc8bcbe5deb,227cdfb03710200044e0bfc8bcbe5d6b,86c1f3193790200044e0bfc8bcbe5d95,98c37b193790200044e0bfc8bcbe5dbe,81f95197ac1d55eb35432fd1e068385e,df7d53303710200044e0bfc8bcbe5dac,81fdf9ebac1d55eb4cb89f136a082555,4b7d13f03710200044e0bfc8bcbe5db6,81f87336ac1d55eb06002def816d139f,81fbfe03ac1d55eb286d832de58ae1fd,81fca4cbac1d55eb355b4b6db0e3c80f,187d13f03710200044e0bfc8bcbe5df2,81fd65ecac1d55eb42a426568fc87a63,31bea3d53790200044e0bfc8bcbe5dec,81f75fcaac1d55eb2b0781d6f2c3c260"}

## UserCriteria -- setActive(Boolean active) {#ariaid-title7}

Gibt an, ob die Benutzerkriterien aktiv sind.
{#r_UCS-setActive_B__table_lc1_x3f_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| active | Boolean | Bei „true" sind die Benutzerkriterien aktiv. Bei „false" sind die Benutzerkriterien inaktiv. |
[Tabelle : 8. Parameter]

{#r_UCS-setActive_B__table_lc1_x3f_vz} {#r_UCS-setActive_B__table_mc1_x3f_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 9. Ergebnisse]

{#r_UCS-setActive_B__table_mc1_x3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setActive(true); 

## UserCriteria -- setAdvanced(boolean Advanced) {#ariaid-title8}

Gibt an, ob die Benutzerkriterien ein erweitertes Skript aufweisen.
{#r_UCS-setAdvanced_B__table_eps_xff_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| advanced | Boolean | Bei „true" weisen die Benutzerkriterien ein erweitertes Skript auf. Bei „false" weisen die Benutzerkriterien kein erweitertes Skript auf. |
[Tabelle : 10. Parameter]

{#r_UCS-setAdvanced_B__table_eps_xff_vz} {#r_UCS-setAdvanced_B__table_fps_xff_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 11. Ergebnisse]

{#r_UCS-setAdvanced_B__table_fps_xff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setAdvanced(true); 

## UserCriteria -- setCompanies(Zeichenfolge „Unternehmen") {#ariaid-title9}

Legt die Eigenschaft „company" für die Benutzerkriterien fest.
{#r_UCS-setCompanies_S__table_qrr_gff_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| companies | Zeichenfolge | Kommagetrennte Liste der sys_ids von Unternehmen, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 12. Parameter]

{#r_UCS-setCompanies_S__table_qrr_gff_vz} {#r_UCS-setCompanies_S__table_rrr_gff_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#r_UCS-setCompanies_S__table_rrr_gff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria -- setDepartments(Zeichenfolge für Abteilungen) {#ariaid-title10}

Legt die Eigenschaft „department" für die Benutzerkriterien fest.
{#r_UCS-setDepartments_S__table_k24_ddf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| departments | Zeichenfolge | Kommagetrennte Liste der sys_ids von Abteilungen, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 14. Parameter]

{#r_UCS-setDepartments_S__table_k24_ddf_vz} {#r_UCS-setDepartments_S__table_l24_ddf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 15. Ergebnisse]

{#r_UCS-setDepartments_S__table_l24_ddf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setGroups(Zeichenfolgegruppen) {#ariaid-title11}

Legt die Eigenschaft „group" für die Benutzerkriterien fest.
{#r_UCS-setGroups_S__table_zzq_j3f_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| groups | Zeichenfolge | Kommagetrennte Liste der sys_ids von Gruppen, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 16. Parameter]

{#r_UCS-setGroups_S__table_zzq_j3f_vz} {#r_UCS-setGroups_S__table_a1r_j3f_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 17. Ergebnisse]

{#r_UCS-setGroups_S__table_a1r_j3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria -- setLocations(ZeichenfolgeSpeicherorte) {#ariaid-title12}

Legt die Eigenschaft „location" für die Benutzerkriterien fest.
{#r_UCS-setLocations_S__table_hrs_42f_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| locations | Zeichenfolge | Kommagetrennte Liste der sys_ids von Standorten, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 18. Parameter]

{#r_UCS-setLocations_S__table_hrs_42f_vz} {#r_UCS-setLocations_S__table_irs_42f_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 19. Ergebnisse]

{#r_UCS-setLocations_S__table_irs_42f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria -- setMatchAll(Booleanmatch_all) {#ariaid-title13}

Legt die Eigenschaft „match_all" für die Benutzerkriterien fest.
{#r_UCS-setMatchAll_B__table_wvg_gkf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine | match_all | Bei „true" müssen alle Bedingungen erfüllt sein, die als Eigenschaften für die Benutzerkriterien festgelegt sind. Bei „false" sollte mindestens eine als Eigenschaft für die Benutzerkriterien festgelegte Bedingung erfüllt sein. |
[Tabelle : 20. Parameter]

{#r_UCS-setMatchAll_B__table_wvg_gkf_vz} {#r_UCS-setMatchAll_B__table_xvg_gkf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 21. Ergebnisse]

{#r_UCS-setMatchAll_B__table_xvg_gkf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setMatchAll(true); 

## UserCriteria -- setName(String name) {#ariaid-title14}

Legt die Eigenschaft „name" für die Benutzerkriterien fest.
{#r_UCS-setName_S__table_qzy_vhf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name der Benutzerkriterien. |
[Tabelle : 22. Parameter]

{#r_UCS-setName_S__table_qzy_vhf_vz} {#r_UCS-setName_S__table_rzy_vhf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 23. Ergebnisse]

{#r_UCS-setName_S__table_rzy_vhf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setName("Property1"); 

## UserCriteria -- setRoles(String roles) {#ariaid-title15}

Legt die Eigenschaft „role" für die Benutzerkriterien fest.
{#r_UCS-setRoles_S__table_wxt_h1f_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| roles | Zeichenfolge | Kommagetrennte Liste der sys_ids von Rollen, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 24. Parameter]

{#r_UCS-setRoles_S__table_wxt_h1f_vz} {#r_UCS-setRoles_S__table_xxt_h1f_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 25. Ergebnisse]

{#r_UCS-setRoles_S__table_xxt_h1f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria -- setScript(String script) {#ariaid-title16}

Legt das Skript für die Benutzerkriterien fest.
{#r_UCS-setScript_S__table_elp_zgf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Skript | Zeichenfolge | Skript, das für die erweiterten Benutzerkriterien festgelegt werden soll. |
[Tabelle : 26. Parameter]

{#r_UCS-setScript_S__table_elp_zgf_vz} {#r_UCS-setScript_S__table_flp_zgf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 27. Ergebnisse]

{#r_UCS-setScript_S__table_flp_zgf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setScript("function scriptTest() {
      var retVal;
      if (gs.getUser().getRecord().getDisplayValue('department') == 'Product Management') {
          retVal = true;
      } else {
          retVal = false;
      }
      return retVal;
    }"); 

## UserCriteria - setUsers(Zeichenfolge users) {#ariaid-title17}

Legt die Eigenschaft „user" für die Benutzerkriterien fest.
{#r_UCS-setUsers_S__table_npm_qbf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| users | Zeichenfolge | Kommagetrennte Liste der sys_ids von Benutzern, die für die Benutzerkriterien festgelegt werden sollen. |
[Tabelle : 28. Parameter]

{#r_UCS-setUsers_S__table_npm_qbf_vz} {#r_UCS-setUsers_S__table_opm_qbf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 29. Ergebnisse]

{#r_UCS-setUsers_S__table_opm_qbf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria -- update(Object columnValues, Zeichenfolgengrund) {#ariaid-title18}

Aktualisiert das aktuelle Katalogelement mit den angegebenen Werten.
{#r_UCS-update_O_S__table_nrg_fmf_vz__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| columnValues | Objekt | Zuordnung für den Spaltennamen und die Wertpaare. |
| reason | Zeichenfolge | Grund für die Aktualisierung des Katalogelements. |
[Tabelle : 30. Parameter]

{#r_UCS-update_O_S__table_nrg_fmf_vz} {#r_UCS-update_O_S__table_org_fmf_vz__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Gibt die sys_id der erstellten Benutzerkriterien zurück. |
[Tabelle : 31. Ergebnisse]

{#r_UCS-update_O_S__table_org_fmf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name"); 

Ausgabe:

    31bea3d53790200044e0bfc8bcbe5dec