Section:

Setting user annotation permissions in viewer

WebViewer supports client side user permissions for annotations to control which users can modify which annotations. By default users can only modify annotations that they have created but there are a number of ways that this can be customized if you wish.

Default behavior

When WebViewer is instantiated it sets the current user name to Guest. You can set the initial user using the annotationUser option in the WebViewer constructor. After WebViewer has been instantiated you can also programmatically set the current user name using the setCurrentUser function on the AnnotationManager.

When the user creates a new annotation, the annotation's Author property will be set to the current user name. The user will be able to modify or delete any annotations that have an Author value equal to their user name and these annotations will have a blue border when selected. The user will also be able to update the text on the note associated with the annotation.

Apryse Docs Image

Any annotations that have a different Author value will be displayed with a red border when selected and the user will not be able to modify or delete them. They will also not be able to modify the note text but they will be able to add replies.

Apryse Docs Image

Admin users

WebViewer has an isAdminUser boolean option that can be passed to the WebViewer constructor. When set to true the user is considered to be an administrator and is able to modify and delete any annotation or message regardless of the user that created it. You can programmatically toggle this property for the current user by calling setIsAdminUser.

Readonly mode

There is also an isReadOnly boolean option that puts WebViewer into readonly mode. When in readonly mode annotations cannot be created, modified or deleted and no replies can be added to any annotation messages. You can programmatically toggle this mode by calling setReadOnly.

Annotation properties

There are several properties that individual annotations can have that affect whether an annotation can be edited or not.

  • ReadOnly: Neither the annotation nor the annotation's note can be deleted or modified.
  • Locked: The annotation cannot be deleted or modified but the annotation's note can be changed.
  • LockedContents: The annotation can be deleted or modified but the annotation's note cannot be changed.

Custom permissions

You can define your own logic for whether an annotation can be modified or not using the setPermissionCheckCallback function on AnnotationManager.

This function takes a callback function that you define that should return true if the current user should have permission to modify the annotation and false otherwise. For example:

1WebViewer(...)
2  .then(instance => {
3    const { annotationManager } = instance.Core;
4
5    annotationManager.setPermissionCheckCallback((author, annotation) => {
6      const currentUserIsAuthor = annotation.Author === annotManager.getCurrentUser();
7
8      // any annotation with 50% opacity will also be editable regardless of the author
9      const customPermission = annotation.Opacity === 0.5;
10
11      return currentUserIsAuthor || customPermission;
12    });
13  });

Related Links

Next steps

Learn how to change how users are displayed for clarity and customization.

Did you find this helpful?

Trial setup questions?

Ask experts on Discord

Need other help?

Contact Support

Pricing or product questions?

Contact Sales