Methoden zum Ermitteln und Bearbeiten von Instanzberechtigungen
Die Instanzberechtigungen auf ein Objekt können über die Methoden „GetPermissions“ und „SetPermissions“ in der IHlObject-Schnittstelle abgefragt bzw. gesetzt werden. Zum Setzen der Berechtigungen über „SetPermissions“muss das zuvor von „GetPermissions“ erhaltene Objekt „IHlObjectPermissions“ angegeben werden. „SetPermissions“ kann also nur in Verbindung mit „GetPermissions“ verwendet werden.
Die einzelnen Berechtigungen können über die Schnittstelle „IHlGroupPerms“ ermittelt und gesetzt werden.
Das folgende Beispiel zeigt die Verwendung der Methoden im Zusammenhang:Syntaxbeispiel:
Über das folgende Skript wird für die Gruppe der helpLine Administratoren die Berechtigung „Ändern“ für ein Objekt ein- bzw. ausgeschaltet:
' Abfrage der gesamten Instanzberechtigungen
Dim permissions
Set permissions=hlObj.GetPermissions
' Abfrage der gesamten Berechtigungen für die Gruppe der helpLine Administratoren
Dim grouppermissions
Set grouppermissions=permissions.GetGroupPermissions("Administratoren")
' Einschalten der Ändern-Berechtigung
grouppermissions.AllowModify = True
' Damit die Änderungen wirksam werden, müssen die Berechtigungen auf dem Objekt noch gesetzt werden!
hlObj.SetPermissions(permissions)
GetGroupPermissions
Diese Methode ermittelt die Instanzberechtigungen der angegebenen Gruppe auf dieses Objekt.
| Syntax | GetGroupPermissions(groupname) |
| Parameter | groupname: Name der Gruppe als Zeichenkette |
| Rückgabewert | Instanzberechtigungen der angegebenen Gruppe auf dieses Objekt als Objekt (IHlGroupPerms) |
| Beispiel |
Die Instanzberechtigungen der Gruppe „Administratoren“ sollen ermittelt werden: Set grouppermissions=permissions.GetGroupPermissions("Administratoren") Siehe auch oben stehendes Syntaxbeispiel. |
GetGroupPermissionsByID
Diese Methode ermittelt die Instanzberechtigungen der über ihre ID angegebenen Gruppe auf dieses Objekt, sodass wieder die typspezifischen Systemberechtigungen gelten.
| Syntax | GetGroupPermissions(groupid) |
| Parameter | groupname: ID der Gruppe als ganze Zahl |
| Rückgabewert | Instanzberechtigungen der angegebenen Gruppe auf dieses Objekt als Objekt (IHlGroupPerms) |
| Beispiel |
Die Instanzberechtigungen der Gruppe „1234“ sollen ermittelt werden: Set grouppermissions=permissions.GetGroupPermissions("1234”) |
GetPermissions
Diese Methode ermittelt die gesamten Instanzberechtigungen auf dieses helpLine Objekt.
| Syntax | GetPermissions() |
| Rückgabewert | Instanzberechtigungen auf dieses Objekt als Objekt (IHlObjectPermissions) |
| Beispiel | Siehe oben stehendes Syntaxbeispiel. |
RemoveGroupPermissions
Diese Methode entfernt die Instanzberechtigungen der angegebenen Gruppe auf dieses Objekt.
| Syntax | RemoveGroupPermissions(groupname) |
| Parameter | groupname: Name der Gruppe als Zeichenkette |
RemoveGroupPermissionsByID
Diese Methode entfernt die Instanzberechtigungen der über ihre ID angegebenen Gruppe auf dieses Objekt.
| Syntax | RemoveGroupPermissionsByID(groupid) |
| Parameter | groupid: ID der Gruppe als ganze Zahl |
SetPermissions
Diese Methode setzt die Instanzberechtigungen aus dem über die Methode „GetPermissions“ ermittelten Objekt „IHlObjectPermissions“ auf dieses Objekt.
| Syntax | SetPermissions(IHlObjectPermissions) |
| Parameter | IHlObjectPermissions: Instanzberechtigungen auf dieses Objekt, die über die Methode „GetPermissions“ ermittelt wurden |
| Beispiel | Siehe oben stehendes Syntaxbeispiel. |