> For the complete documentation index, see [llms.txt](https://docs.guardianservice.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardianservice.app/technical-information/complex-iterative-review-and-approval-workflows/demo-using-ui.md).

# Demo using UI

## 1. Document reviews <a href="#id-1.-document-reviews" id="id-1.-document-reviews"></a>

### 1.1 Overview <a href="#id-1.1-overview" id="id-1.1-overview"></a>

To enable document reviews within a policy, a corresponding button must be made available in the grid. (This button is combined with the document view function.)

<figure><img src="/files/IJxdBuwY4f5SLAJSoJBC" alt=""><figcaption></figcaption></figure>

This button will appear in the grid for documents, showing a number of existing comments for each of them.

<figure><img src="/files/G4T4sQYJwgWd4lOU9DnJ" alt=""><figcaption></figcaption></figure>

### 1.2 Discussions <a href="#id-1.2-discussions" id="id-1.2-discussions"></a>

When opening a comments section a list of discussions is displayed. To create a comment, users must either select an existing discussion or create a new one.

<figure><img src="/files/skr1t8zjFPixizm6aUnK" alt=""><figcaption></figcaption></figure>

### **1.2.1 Creating a Discussion**

To create a discussion several fields must be filled out:

**Discussion name** - arbitrary human readable name (usually used for indicating the topic of the discussion).

**Relationships** – references to other documents related to the current one.

<figure><img src="/files/FAERx9IyYFiQkQZOpJhd" alt=""><figcaption></figcaption></figure>

Selecting document in the ‘relationships’ will cause the discussion to be shown when viewing them as well.

<figure><img src="/files/17Cz7wsC8480sGvOLpwz" alt=""><figcaption></figcaption></figure>

You can also link a discussion to a specific field in the document by adding a field reference.

<figure><img src="/files/w77zpxIHLIq9GCEyKBlU" alt=""><figcaption></figcaption></figure>

1. **Visibility Scope** The visibility scope determines who can see a given discussion.

a. **Public** – all users who have access to the document

<figure><img src="/files/m066XlKnMq209xTpJvP4" alt=""><figcaption></figcaption></figure>

b. **Roles** – users with specific roles (and the creator of the discussion)

<figure><img src="/files/HbC6vnLZd4U9rdre0GnJ" alt=""><figcaption></figcaption></figure>

c. **Users** – only specified users (and the creator of the discussion)

<figure><img src="/files/pzn6GfWsZ2Yf1lohePKp" alt=""><figcaption></figcaption></figure>

#### **1.2.2 Viewing**

You can search for the desired discussion using a **search** function.

<figure><img src="/files/VpVBVJd2HOlu4K6BEN5u" alt=""><figcaption></figcaption></figure>

Also it is possible to search (filter) discussions based on their field links

<figure><img src="/files/mE3aQD5AjBG4FcpbBECL" alt=""><figcaption></figcaption></figure>

The list of discussion participants can be viewed inside each discussion.

<figure><img src="/files/7t5tGfIvEAmUFXOutXXF" alt=""><figcaption></figcaption></figure>

### 1.3 Messages <a href="#id-1.3-messages" id="id-1.3-messages"></a>

#### **1.3.1 User mentions**

Users can be mentioned in messages using @username notation.

<figure><img src="/files/1v1573gDXaDXKTjZHsHH" alt=""><figcaption></figcaption></figure>

#### **1.3.2 Field References**

Fields in a document can be referenced in messages using #fieldname notation.

<figure><img src="/files/bIWLqHgx7LGOBO12XtjL" alt=""><figcaption></figcaption></figure>

Fields in a document can be referenced in messages also using the link button. 

<figure><img src="/files/28YfgWWUeLd2OzOMO9C0" alt=""><figcaption></figcaption></figure>

#### **1.3.3 Attachments**

Files can be attached to messages.

<figure><img src="/files/DGWeAggWajH2oejeoUt6" alt=""><figcaption></figcaption></figure>

Files, as well as messages, are encrypted and stored in IPFS.

Hedera Topics contain messages with meta-information and links to the corresponding document and attached files.

<figure><img src="/files/ZjxrUVor9mHVgc4pncHc" alt=""><figcaption></figcaption></figure>

## 2. Document Revisions <a href="#id-2.-document-revisions" id="id-2.-document-revisions"></a>

### 2.1 Configuration <a href="#id-2.1-configuration" id="id-2.1-configuration"></a>

To allow document revision, a corresponding button (requestVcDocumentBlock) must be added. To configure requestVcDocumentBlock to enable editing, the operation type must be set to Edit.

<figure><img src="/files/BGUWfFEdQAAuEZrWWP8C" alt=""><figcaption></figcaption></figure>

### 2.2 Events <a href="#id-2.2-events" id="id-2.2-events"></a>

As with creating a new document, editing a document revision triggers a standard event that saves a new version of the document.

<figure><img src="/files/oIY4BfIBcJXHPdumXLmP" alt=""><figcaption></figcaption></figure>

The old revision of the document is automatically marked as outdated. To hide ‘outdated’ revisions of the documents from the grid, enable “Hide previous versions.”  

<figure><img src="/files/am6xACySkD3syRoUwP2J" alt=""><figcaption></figcaption></figure>

## 3. Access control <a href="#id-3.-access-control" id="id-3.-access-control"></a>

Since discussions are published encrypted, keys are required to access (e.g. for audits) their content - comments and attached documents.

### 3.1 Guardian user Permissions <a href="#id-3.1-guardian-user-permissions" id="id-3.1-guardian-user-permissions"></a>

To enable access to all policy artifacts, audit permission in the policy configuration must be assigned to the corresponding user/role.

<figure><img src="/files/400yXL5itMypEoBD6lEk" alt=""><figcaption></figcaption></figure>

### 3.2 Documents <a href="#id-3.2-documents" id="id-3.2-documents"></a>

Audit permission allows access to all documents within the policy.

<figure><img src="/files/cil9OtaMjksFrBhqgMiP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jySMOZlaPgZvMS2icCLc" alt=""><figcaption></figcaption></figure>

#### **3.3 Encryption keys**

Audit permission grants access to discussion encryption keys. These keys make it possible to decrypt messages within discussions for verification purposes.

<figure><img src="/files/75TfjjeHwd7fK8gNEd5x" alt=""><figcaption></figcaption></figure>

## 4. Indexer view <a href="#id-4.-indexer-view" id="id-4.-indexer-view"></a>

Because discussion content is published encrypted, to view their content Indexer users need to provide the corresponding encryption keys.

<figure><img src="/files/MW7RAQTX624hnzVqXPVM" alt=""><figcaption></figcaption></figure>

When provided, keys are never stored. They are used solely within the current user session to decrypt messages encrypted with the corresponding key, which are automatically identified by the Indexer. 

<figure><img src="/files/MC5NoJEvKdkBXpCYsbdI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IZc4YiI90kA3HHgQqZl8" alt=""><figcaption></figcaption></figure>
