---
sourceDocument: Yokohama Erstellen oder ändern Sie Anwendungen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama Erstellen oder ändern Sie Anwendungen

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

Rollen-API -- ServiceNow Fluent
===============================

Rollen-API -- ServiceNow Fluent {#ariaid-title1}
================================================

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

Die Role-API enthält Objekte, die Rollen \[sys_user_role\] für Benutzer einer Anwendung definieren.

Rollenobjekt {#ariaid-title2}
-----------------------------

Erstellen Sie eine Rolle \[sys_user_role\], um den Zugriff auf Anwendungen und ihre Funktionen zu steuern.
{#role-object-now-ts__table_vy2_525_jq__entry__3}

|      Name       |          Typ           |                                                                                                                                                                                                                                                                                                                                                                                    Beschreibung                                                                                                                                                                                                                                                                                                                                                                                    |
|-----------------|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| $id             | Zeichenfolge oder Zahl | Erforderlich. Eine eindeutige ID für das Metadatenobjekt, die im folgenden Format bereitgestellt wird: wobei\<value\> ist eine Zeichenfolge oder Zahl. $id: Now.ID[<value>] Wenn Sie die Anwendung erstellen, wird diese ID in eine eindeutige sys_ID gehasht.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Name            | Zeichenfolge           | Ein Name für die Rolle, beginnend mit dem Anwendungsbereich im folgenden Format:\<scope\> <kbd class="ph userinput">.</kbd>\<name\> .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| assignedable_by | Zeichenfolge           | Andere Rollen, die Benutzern diese Rolle zuweisen können.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| can_delegate    | Boolean                | Kennzeichnung, die angibt, ob die Rolle an andere Anwender delegiert werden kann. Weitere Informationen finden Sie unter [Delegating roles](https://www.servicenow.com/docs/access?context=c_DelegateRoles&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Gültige Werte: * wahr: Die Rolle kann an andere Benutzer delegiert werden. * „falsch": Die Rolle kann nicht an andere Anwender delegiert werden. {#role-object-now-ts__ul_fjr_cc5_pbc} Standardwert: wahr                                                                                                                                                                                                                                                                                   |
| description     | Zeichenfolge           | Eine Beschreibung dessen, worauf die Rolle zugreifen kann.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| erhöht_privileg | Boolean                | Kennzeichnung, die angibt, ob das manuelle Übernehmen der Verantwortung für die Verwendung der Rolle erforderlich ist, bevor Sie auf die Funktionen der Rolle zugreifen können. Weitere Informationen zu erweiterten Berechtigungen finden Sie [unter Rollen mit erhöhten Berechtigungen](https://www.servicenow.com/docs/access?context=c_ElevatedPrivilege&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Gültige Werte: * wahr: Sie müssen die Verantwortung für die Verwendung der Rolle manuell übernehmen, bevor Sie auf ihre Funktionen zugreifen können. * false: Sie müssen die Verantwortung für die Verwendung der Rolle für den Zugriff auf ihre Funktionen nicht manuell übernehmen. {#role-object-now-ts__ul_ukv_qd5_pbc} Standardwert: false |
| gewährbar       | Boolean                | Kennzeichnung, die angibt, ob die Rolle unabhängig gewährt werden kann. Gültige Werte: * wahr: Die Rolle kann unabhängig gewährt werden. * „falsch": Die Rolle kann nicht unabhängig gewährt werden. {#role-object-now-ts__ul_gb2_zd5_pbc} Standardwert: wahr                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| enthält_Rollen  | Array                  | Die Variablenbezeichner anderer Rollenobjekte, die diese Rolle enthält.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| scoped_admin    | Boolean                | Kennzeichnung, die angibt, ob die Rolle ein Anwendungsadministrator ist. Allgemeine Informationen zu Anwendungsadministrationsrollen finden Sie unter [Anwendungsverwaltung](https://servicenow-prod.fluidtopics.net/ODDautJyA7nWkkyEk1xcrw "Schützen Sie vertrauliche Anwendungsdaten, indem Sie die Anwendungsverwaltung verwenden, um den Zugriff von Benutzern auf anwendungsspezifische Rollen einzuschränken."). Gültige Werte: * „wahr": Die Rolle ist ein Anwendungsadministrator. * false: Die Rolle ist kein Anwendungsadministrator. {#role-object-now-ts__ul_nxt_325_pbc} Standardwert: false                                                                                                                                                                                                                  |
[Tabelle : 1. Eigenschaften]

{#role-object-now-ts__table_vy2_525_jq}  

    import { Role } from "@servicenow/sdk/core";

    const managerRole = Role({ 
       $id: Now.ID['manager_role'], 
       name: 'x_snc_example.manager' 
    })

    const adminRole = Role({ 
       $id: Now.ID['admin_role'], 
       name: 'x_snc_example.admin', 
       contains_roles: [managerRole] 
    })