1. Introduction

Data Viewer is a tool for viewing data that has been replicated into your system. It allows users to view, filter, and search for records in this data. The tool provides a simple way to work with data replicated through SnowMirror, without the need for complex setup or integration with other systems.

2. Overview

Data Viewer consists of two main tabs. Tables tab is used to work with data replicated to the database, while Attachments tab displays data stored in the file system.

2.1. Tables

This tab contains data stored in the database. Available workflows are Replication and Archive.

2.1.1. List

The list contains a preview of basic information of each available replication.

tables list
List

Workflow

An icon representing the type of replication. The type can be either replication or archive.

Name

The name of the replication, chosen by the user. It does not have to match the mirror database table name or the table name in ServiceNow.

Last Successful Run

The date and time when the replication last ended successfully.

Newest Entry

The date and time of the most recent entry, based on the newest sys_created_on value stored in the database table.

Total Count

The total number of rows in the database table.

Table Size

The amount of space occupied by the database table.

Display Values

Indicates whether the database table contains display values.

Attachments

Indicates whether SnowMirror has replicated related attachments for the given table.

2.1.2. Data

Lists all data stored in the selected database table. Display values are preferred if present.
The columns in the summary table are obtained from ServiceNow sys_ui_list table. Global Default View is used.
You can quickly navigate between replicated database tables using choice box in the upper right corner.

tables data

2.1.3. Detail

Shows the detail form of the stored entry from database. Display values are preferred if present.
You can choose between the Default View obtained from ServiceNow sys_ui_section table or show all replicated columns using choice box in the upper right corner.

  • If SnowMirror contains attachments related to the selected entry, they will be listed at the top of the detail form.

  • If the field with reference type can find replicated table with related entry present, it is linked together and button is displayed.

  • If sys_journal_field table with all columns is replicated and contains related data, additional comments and work notes are displayed.

If multiple replications are created for same related table, the correct replication is selected using this algorithm.

tables detail

2.2. Attachments

This tab contains data stored in the file system. Available workflows are synchronization and archive.

2.2.1. List

The list contains a preview of basic information of each available replication.

attachments list
List

Workflow

An icon representing the type of replication. The type can be either synchronization or archive.

Name

The name of the replication, chosen by the user. It does not have to match the mirror database table name or the table name in ServiceNow.

Last Successful Run

The date and time when the replication last ended successfully.

Newest Entry

The date and time of the most recent entry, based on the newest sys_created_on value stored in the metadata database table.

Total Count

The total number of rows in the metadata database table.

Folder Size

The amount of space occupied by the folder.

Table

Indicates whether SnowMirror has replicated related table for the given attachments.

2.2.2. Data

Lists all stored attachments in the selected folder.
You can quickly navigate between replicated attachments using choice box in the upper right corner.

  • If related table is present, you can navigate to it by click on object name.

If multiple replications are created for same related table, the correct replication is selected using this algorithm.

attachments data
Data

Object Name

For which entry is attachment related.

File Name

Name of the file in the file system.

Updated On

When was the attachment updated lastly.

Created On

When was the attachment created.

Size

Size of the file in the file system.

SnowMirror allows you to create multiple workflows for the same table in ServiceNow.
To determine and link related entries, the following algorithm is used:

  1. Prefer same type without a ServiceNow query:

    • A Replication workflow looks for a related table with the Replication type.

    • An Archive workflow looks for a related table with the Archive type.

  2. If the same workflow type exists but contains a ServiceNow query, use it.

  3. If the same workflow type is not available, a different workflow type can be used, preferring one without a ServiceNow query:

    • A Replication workflow looks for a related table with the Archive type.

    • An Archive workflow looks for a related table with the Replication type.

  4. If a different workflow type is present but contains a ServiceNow query, use it.

  5. If none of the above conditions are met, there is no related entry.

4. Permissions

To view and manage the data in Data Viewer, you need to have appropriate permissions.
See user roles.