Use case: Unresolve an annotation

Before you start

Before you unresolve an annotation, ensure you have completed the following prerequisites:

  1. Verify Permissions: Check that you have the necessary permissions to modify the status of annotations. This typically requires being the annotation creator, assigned reviewer, or having appropriate administrator privileges.
  2. Locate the Annotation: Identify the specific resolved annotation you want to change back to an unresolved state. You'll need its unique identifier to perform this action.
  3. Understand Status Implications: Be aware that unresolving an annotation typically indicates that the discussion or issue raised in the annotation requires further attention. This status change may:
    • Reactivate notifications for team members
    • Return the annotation to active status in filters and views
    • Signal that additional work or discussion is needed
  4. Consider Workflow Impact: Evaluate how changing the status will affect your team's workflow and communication processes. Unresolving should be used when genuine follow-up is required.
  5. Set Up SDK Environment: Ensure your Unity environment is properly configured with the Collaboration SDK to interact with the annotation system.

How do I...?

Unresolve a single annotation

To change an annotation from resolved back to unresolved, follow these steps:

  1. Prepare the Project Identifier: Ensure you have the correct project identifier (GUID) for the project you want to search for.
  2. Obtain the Annotation ID: Identify the unique identifier of the resolved annotation you want to unresolve.
  3. Call the Unresolve Method: Use the SDK to change the annotation's status from resolved to unresolved.
  4. Handle Response: Verify that the status change was successful and handle any errors appropriately.
  5. Update UI: If your application has a user interface displaying annotations, refresh it to reflect the updated unresolved status.

Example:

await annotationManagement.UnresolveAnnotationAsync(
   projectId: projectId,
   annotationId: annotationId,
   cancellationToken: cancellationToken);
Note

The ability to unresolve annotations gives teams flexibility in their workflow. It supports scenarios where issues previously considered addressed need to be revisited, or when a resolution was marked prematurely.

For more information on overall annotation management, see the documentation on resolving an annotation and updating an annotation.