Understanding Stakeholder Roles in Structured Documents

Introduction

Lab Summary Report Authors, Regulatory Affairs professionals, and Technical Authors in the biopharma industry use the Structured Content Editor app, available with the Structured Document Manager (XDO-OC) role, to collaboratively author CMC (Chemistry, Manufacturing, and Controls) documents and other technical publications through a rich, web-based authoring experience. 

Unlike traditional documents, structured documents are composed of individual parts, making content easier to reuse, extract, analyze and compare. Refer to this blog which explains a generic process of authoring a technical document using this role.

In this blog, we’ll explore how to assign and manage stakeholder roles in a structured document and understand the value each role brings to the authoring process.

 

Understanding Stakeholder Roles & Their Responsibilities

The Structured Document Editor app uses Repositories to store content such as document maps, topics, and data tables. Technical Authors often create dedicated Repositories to manage content for a specific project or product.

Assigning specific responsibilities ensures that the right stakeholders are involved in the right activities throughout the authoring process. These responsibilities are assigned at the Repository level and can be defined in two ways:

  • During repository creation

  • Using the “Add Members” command in the repository

The following table provides an overview of the five levels of available Responsibilities and their associated Capabilities: 

Responsibility

Capabilities

Viewer

Allows you to read any document in the repository.

Reviewer

Includes all Viewer capabilities. You can also add review comments in a dedicated comments panel.

Author

Includes all Reviewer capabilities. You can also create, edit and delete limited content. 

Coordinator

Includes all Author capabilities. You can also create, edit and delete any object.

Leader

Includes all Coordinator capabilities. You can also manage the repository, move and unlock objects.

 

The table below lists specific permissions associated with each responsibility: 

Capability

Objects

Viewer

Reviewer

Author

Coordinator

Leader

Managing Maturity

Data Collection, Data Collection Template, Document Map, Document Map Template, Images, Topic, Topic Template

❌

❌

❌

✅

✅

Commenting

Document Map, Document Map Template, Topic, Topic Template

❌

✅

✅

✅

✅

Creating, Editing, or Deleting Objects (01)

Data Collection, Data Collection Template, Image, Published PDF

❌

❌

✅

✅

✅

Creating, Editing, or Deleting Objects (02)

Document Map

Document Map Template, Parameter Definition, Publishing Theme, Topic, Topic Template

❌

❌

❌

✅

✅

Data Verification

Data Collection, Data Collection Template

❌

❌

❌

✅

✅

Duplication, New Revisions

Data Collection, Data Collection Template, Document Map, Document Map Template, Images, Topic, Topic Template

❌

❌

❌

✅

✅

Moving

Data Collection, Data Collection Template, Document Map, Document Map Template, Images, Topic, Topic Template

❌

❌

❌

❌

✅

Viewing

Data Collection, Data Collection Template, Document Map, Document Map Template, Images, Topic, Topic Template

✅

✅

✅

✅

✅

Publishing PDF's

Document Map, Document Map Template

❌

❌

✅

✅

✅

Managing Repositories

Repository

❌

❌

❌

❌

✅

Please refer to the following demo video to learn how to assign responsibilities to stakeholders and how they can leverage them to perform specific operations.

Comments 0