Kapitel 2. Allgemeines zu Annotationen

Annotations spezifische Berechtigungen werden mit der Klasse IndividualAnnotationPermission definiert:

Setzen einer Berechtigung via API:

Annotation a = <<Annotation-Instanz>>
// Setzen der Berechtigung 'Änderung verweigern'
a.getPermissions().getPermissions()
    .add(IndividualAnnotationPermission.DENY.CHANGE);

Als Standardeinstellung sind alle Berechtigungen erlaubt.

Beim Laden kann bereits eine Berechtigungsvergabe an die einzelnen Annotationsobjekte vorgenommen werden, hierzu wird eine Implementation des Interface AnnotationCustomizer benötigt, die beim Ladevorgang den entsprechenden Annotation-ReaderSettings gesetzt wird.

final DefaultReaderControls controls = new DefaultReaderControls();

// AnnotationCustomizer-Implementation, wird fürs setzen der Berechtigung benutzt
final AnnotationCustomizer annotationCustomizer = new AnnotationCustomizer() {
    @Override
    public void customize(Annotation a) {
    // Hier gewünschte Berechtigungen setzen
    //	a.getPermissions().getPermissions()
    //		.add(IndividualAnnotationPermission.DENY.CHANGE);
    //	a.getPermissions().getPermissions()
    //		.add(IndividualAnnotationPermission.DENY.REMOVE);
    //	a.getPermissions().getPermissions()
    //		.add(IndividualAnnotationPermission.DENY.SHOW);
    }
};

// Implementation den ReaderSettings übergeben (hier z.B. für FileNet P8),
// die Controls dann fürs Laden benutzen
controls.getSettings(FNP8AnnotationReaderSettings.class)
	.getAnnotationCustomizers().add(annotationCustomizer);

Es existiert noch ein weiteres Berechtigungkonzept, welches das Anlegen, Verändern, Löschen von Annotationen via GUI-Komponenten steuert, diese Berechtigungen müssen an der jadice Document Instanz registriert werden und werden mit der Klasse DocumentAnnotationPermission abgebildet.

Die Dokument gebundene Berechtigungen haben Vorrang gegenüber den Annotationsberechtigungen

Setzen der Berechtigung an einer Dokumentinstanz:

Document document = <<Document-Instanz>>
// Berechtigung setzen, Anlegen von Annotationen nicht möglich
document.getPermissions().getPermissions().add(DocumentAnnotationPermission.DENY.ADD);