Zugriffsberechtigungen

Existiert ein Objekt

var exists = await dms.AccessRights.ObjectExists(id);

Hiermit kann überprüft werden, ob ein Objekt zu der angegebenen Id existiert. Die Funktion liefert aber nur dann true, wenn der Anwender auch mindestens Leseberechtigung auf das Objekt besitzt.

Die Methode kann auch mit einer Liste von Objekt-Ids aufgerufen werden. true bedeutet, dass alle angefragten Objekte existieren und auch eine Leseberechtigung vorhanden ist.

Berechtigungen abfragen

var aclInfos = await dms.AccessRights.GetAccessRightsInfo(ids);

Die Liste, welche von dieser Methode zurückgegeben wird enthält einen Eintrag für jedes Objekt, welches existiert und der Anwender mindestens Leseberechtigung besitzt. Eine AclInfo (ObjectAccessRightsInfo) enthält die Objekt-Id und eine Liste mit gesetzten Berechtigungen.

Berechtigungen setzen

Berechtigungen werden an den angegebenen Objekten auf einen gewünschten Stand gesetzt. Dieser muss grundsätzlich vollständig angegeben werden. Es ist nicht möglich Berechtigungen, ungeachtet der existierenden Situation, hinzuzufügen, zu ändern oder zu entfernen. Dabei ist zu Beachten, dass mindestens ein Benutzer oder eine Gruppe Vollzugriff auf ein Objekt erhalten muss. Fehlt ein Eintrag mit Vollzugriff, wird ein Fehler geworfen.

var setAcl = new SetObjectAccessRightsInfo();
setAcl.ObjectGuid = documentId; // hier sind auch Akten-/Ordner-Ids erlaubt
var acl = new List<SetAccessRightInfo>();
acl.Add(
    new SetAccessRightInfo() {
        UserGroupXid = xidOfGroupAll,
        AccessRight = AccessRight.Full
    });

var result = await dms.AccessRights.SetAccessRightsInfo(setAcl);

In diesem Beispiel erhält das Dokument für alle DMS-Benutzer Vollzugriff.