Rollen-API – ServiceNow Fluent

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Die Rollen-API definiert Rollen [sys_user_role], die Anwendern einer Anwendung bestimmte Berechtigungen gewähren.

    Allgemeine Informationen zu Anwenderrollen finden Sie unter Managing roles.

    Rollenobjekt

    Erstellen Sie eine Rolle [sys_user_role], um den Zugriff auf Anwendungen und ihre Funktionen zu steuern.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    Name Zeichenfolge Ein Name für die Rolle, die mit dem Anwendungsbereich beginnt, im folgenden Format: <scope>.<name> .
    Zuweisbar nach Zeichenfolge Andere Rollen, die diese Rolle Anwendern zuweisen können.
    CanDelegate Boolean Kennzeichnung, die angibt, ob die Rolle an andere Anwender delegiert werden kann. Weitere Informationen finden Sie unter Delegating roles.
    Gültige Werte:
    • Wahr: Die Rolle kann an andere Anwender delegiert werden.
    • Falsch: Die Rolle kann nicht an andere Anwender delegiert werden.

    Standardwert: wahr
    Beschreibung Zeichenfolge Eine Beschreibung, auf was die Rolle zugreifen kann.
    ElevatedPrivilege Boolean Kennzeichnung, die angibt, ob die manuelle Übernahme 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 .
    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.
    • Falsch: Sie müssen die Verantwortung für die Verwendung der Rolle für den Zugriff auf ihre Funktionen nicht manuell übernehmen.

    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.

    Standardwert: wahr
    Umfasst Rollen Array Die Variablenbezeichner von „Sonstiges“ Rolle Objekte, die diese Rolle enthält.
    BereichsAdministrator Boolean Kennzeichnung, die angibt, ob die Rolle eine Anwendungsadministratorrolle ist. Allgemeine Informationen zu Anwendungsadministrationsrollen finden Sie unter Anwendungsverwaltung.
    Gültige Werte:
    • Wahr: Die Rolle ist ein Anwendungsadministrator.
    • Falsch: Die Rolle ist kein Anwendungsadministrator.

    Standardwert: false
    $Meta Objekt Metadaten für die Anwendungsmetadaten.
    Mit InstallMethod Eigenschaft können Sie die Anwendungsmetadaten einem Ausgabeverzeichnis zuordnen, das nur unter bestimmten Umständen geladen wird.
    $meta: {
      installMethod: 'String'
}
    Gültige Werte für InstallMethod :
    • Demo: Gibt die Anwendungsmetadaten an aus Metadaten/unload.demo Verzeichnis, das mit der Anwendung installiert werden soll, wenn Demodaten laden Option ist ausgewählt.
    • Erste Installation: Gibt die Anwendungsmetadaten an aus Metadaten/Entladen Verzeichnis, das nur bei der ersten Installation einer Anwendung auf einer Instanz installiert werden soll.
    		 
    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', 
   containsRoles: [managerRole] 
})