Skip to content

Subject Viewer Overview

The Subject Viewer allows you to view subject data in various layouts. This data may include procedures, medications, omics data, documents, images, survey results and more, as graphs and in tables. Its accessed by clicking anywhere within the row of a subject in the Subjects tab (as shown in the clip below). The data displayed on the Subject Viewer page will depend on the layout selected.

Subject Viewer Main

Subject Viewer Header

The blue header at the top of the page (shown above) by default includes:

  • Breadcrumb path of users location in PHC: Project Name/Current Tab/Subject
  • to access and update the subject's demographics
  • to select your layout from the dropdown
  • to edit Layout
  • to access Omics Explorer

Subject Viewer Header

The header can be configured to include more information about the subject and data can be displayed or available in a dropdown format (to reduce clutter and save space). This information often comes from the subject's medical record but can come from other sources as long as it’s tagged appropriately to make them accessible.

Access Control

Adding to or editing the Header data requires (ABAC layoutAdmin) permission. To grant privileges, see Access Control.

Add Header Data

Users with the layoutAdmin ABAC access have access to and the ability to add and modify what data is displayed in the page header.

The clip below demonstrates how to add data to the header.

Subject Viewer Header edit

How to Add Header Data:

  1. Click the Header Data button (if you do not see this button, try clicking on the layout icon in the header )

    Header Data

  2. Add data fields to be displayed in the Header or Dropdown by clicking on the tab desired in the window that opens

  3. Click the + Add Field button
  4. Select the field from the dropdown
  5. Edit the label (optional)
  6. To switch the field to Header or Dropdown, click the Move Field to Header/Dropdown button
  7. Click Apply to commit changes

Header Settings

The Header Settings is where users can adjust what data is seen and located within the header/header dropdown.

To Adjust Header Fields:

  1. Click the Header Data button (if you do not see this button, try clicking on the layout icon in the header )

    Header Data

  2. Click on either the Header tab or Dropdown tab (see image below) to adjust the fields there.

    Subject Viewer Header Settings

  3. Edit Header fields (see image above):

    • Move a field up or down: Move a field up or down in the display (as shown in the image above) is done by clicking the up or down arrow beside the field.
    • Delete a Field: Clicking the "x" deletes a field.
    • Move Field to Dropdown/Header: Clicking this button will move the field you select to the other location (either dropdown or header).
    • Add a Field: Clicking + Add a Field lets you add more fields to be displayed.
  4. Click Apply to save changes.

If in masked mode (icon to toggle this on and off is found on the top right of the page, above the header), identifying data (such as DOB and name) is altered to a more vague display (such as birth year and initials).


Timeline Slider

A timeline slider is situated at the top of the Subject Viewer page. It dictates the timeline for everything in the view. A default time range can be set and is specific to the layout you are viewing. Whenever you open any subject, it will show this default timeline you've set.

The timeline slider can be adjusted by grabbing a handle and pulling it to show the time range you are seeking. If you grab the handle and drag it all the way to the left, it will show about 30% more of the subject's timeline. This can be repeated to widen your view. The clip below shows this in action as the Cancer Outcome Dates table updates as we expand the timeline.

To the right of the timeline (also shown in clip below) are two icons to return you to common views:

  • Maximize Date Range - shows everything since the subject's DOB
  • Reset to Default Date Range - returns to the preset date range

Subject Viewer Timeline

You can also adjust the time range you view by zooming in on the graph. This is done by hovering your cursor on the graph, clicking the zoom tool (which is selected by default) on the graph, then click and drag the cursor to dictate the time range you wish to zoom on as shown in the clip below.

Zooming in


Layouts

A layout is a page comprised of the header section and various modules displaying subject data. Layouts can be customized to show the data you're most interested in viewing. A project can have multiple layouts which users can select from the dropdown menu in the header. Layouts are listed alphabetically in the dropdown menu.

You can easily add common layouts from the PHC library to your project, or you can create a custom layout.

Add a Layout

How to Add a Layout to a Project:

  1. Navigate to the Manage Layouts page:

    • If this is the first layout in the project: In Subject Viewer, click Create Layout in the blue header to open the Manage Layouts page.

      Create Layout

    • For adding an additional layout to a project: Click on the Layout dropdown and click Manage Layouts .

      Manage Layouts

  2. Once in the Manage Layouts page, click to open the Add a Layout page (shown below).

    Add Layout

  3. Select from a prebuilt layout or craft a new layout:

    • Prebuilt Layout:
      1. Click on Layout Library tab.
      2. Scroll through available layouts or use the Search Library search box.
      3. In the layout row you wish to add, click on the (far right of the row).
    • Create a New Layout (this gives you a blank layout where you can add modules):

      1. Click on Create a New Layout tab.

        New Layout

      2. Give the Layout a name and description (optional), then click Create Layout.

      3. You'll return to the Manage Layouts page where you can see your new layout. On this page you can also:

        • Select which layout is default.
        • Add another layout by clicking .

        Done

      4. Click Done to return to the Subject Viewer page.

Layout Edits

You can access the Layout Edit tools by clicking the Layout icon .

Layout Edits

The tools available include:

  • - Allow subjects to view this layout - This toggle will either let subjects view this layout when they are in the PHC or prevent them from viewing it.
  • - Raw Edit: Here you can view and copy the JSON code of the current layout. This is helpful if you want to copy a complex layout you created in one project and place a copy of it in another project.

    1. Click the Raw Edit .
    2. Click the Copy to Clipboard button at the bottom of the screen with the JSON code.
    3. Click the "X" in the top right corner of the JSON code screen to leave that screen.
    4. Click to a different layout or a layout in a different project.
    5. Click the Raw Edit in this current layout.
    6. Select all the code on the screen(to delete existing layout) or add the copied layout to an existing layout by clicking the screen in the location you want to add the new layout.
    7. Paste the code onto the page using Ctrl+V (Windows) or Cmd+V (Mac).
    8. Click Save at the bottom of the screen.
    9. It will take you to the Layout Dashboard and will apply any data in the current project that applies to the newly added layout modules.
  • - Clear - This clears your entire subject viewer dashboard.

  • - Save Changes - This saves any changes you've made to the existing layout.
  • - Cancel - This cancels anything you've added since your last save and takes you out of the Edit Layout menu.

Modules

Modules are the graphs, tables, and other configurable ways of displaying a subject's information in a layout. After creating a layout, you can customize it by adding modules to quickly and easily display subject data. The PHC has some common modules available in a library for easy adding to your project, or users can create a custom module.

Visit the Modules section for more detailed information about:


Last update: 2022-05-10
Created: 2020-12-08