Die [DESCENDANTS] Die Funktion dient dazu, ein Attribut für alle Objekte innerhalb einer bestimmten Ebene einer Organisationshierarchie abzurufen, einschließlich aller darunterliegenden Ebenen.
Diese Funktion ist dynamisch; werden der Hierarchie Untereinheiten hinzugefügt oder aus ihr entfernt, wird die von der Regel zurückgegebene Benutzerliste automatisch aktualisiert, um der Änderung Rechnung zu tragen. Dies ist nützlich für Aufgaben wie die Gewährung von Zugriffsrechten für alle Benutzer, die einem bestimmten Geschäftsbereich und den dazugehörigen Abteilungen angehören.
Syntax
Die Syntax lautet:
[DESCENDANTS:RootObjectId:AttributeToReturn1:AttributeToReturn2:...]
-
RootObjectId: Die interne ID der obersten Organisationseinheit, in der die Suche beginnt.
-
AttributeToReturn: Der Name des Feldes, dessen Wert von der Funktion zurückgegeben werden soll. Sie können mehrere Attribute durch Doppelpunkte getrennt auflisten.
Beispielsweise der Ausdruck [DESCENDANTS:228714:OrgUnitnr:SourceId:ParentDepartmentNumber] gibt die Abteilungsnummern für die Einheit zurück 228714 sowie alle darunter liegenden Einheiten.
Hinweis: Dieser Ausdruck kann zwar manuell geschrieben werden, der Regel-Assistent in eADM kann ihn jedoch mit wenigen Klicks für Sie erstellen.
Beispielregel
Diese Regel ermittelt alle Benutzer, die eine Position in der „Abteilung für Wirtschaft und Stadtentwicklung“ innehaben (ID 228714) oder einer ihrer Untereinheiten, unabhängig davon, ob es sich dabei um deren Hauptfunktion handelt.
