Dokumentation
IPS_GetRole
array IPS_GetRole (string $Rolle)
Parameterliste
| Rolle | Name der Rolle |
Rückgabewert
Folgende Informationen stehen als key => value Paare zur Verfügung:
| Index | Typ | Beschreibung |
|---|---|---|
| RoleName | string | Name der Rolle |
| Permissions | array | Liste der Berechtigungen der Rolle (siehe Berechtigungstabelle) |
Berechtigungstabelle
| Index | Typ | Beschreibung |
|---|---|---|
| ObjectID | integer | ID des Objekts, für das die Berechtigung gilt |
| Operation | string | Name der Operation, z.B. VISUALIZATION |
| Recursive | boolean | Die Berechtigung gilt auch für alle Objekte unterhalb von ObjectID |
Beschreibung
Die Funktion liefert den Namen und die Berechtigungen der Rolle mit dem Namen Rolle. Existiert die Rolle nicht, schlägt die Funktion mit "Role with name '…' does not exist" fehl.
Die Rolle @admin enthält keine Einträge in Permissions, gewährt aber trotzdem alle Berechtigungen. Ob eine Rolle eine bestimmte Berechtigung hat, prüft IPS_RoleHasPermission. Die Funktion setzt weder Administratorrechte noch das RBAC-Feature der Lizenz voraus.
Beispiel
print_r(IPS_GetRole('Bewohner'));
/* liefert z.B.:
Array
(
[Permissions] => Array
(
[0] => Array
(
[ObjectID] => 12345
[Operation] => VISUALIZATION
[Recursive] =>
)
)
[RoleName] => Bewohner
)
*/