Onyx
latest
  • Introduction

Administrator Guide

  • Introduction
  • Key concepts related to the way Onyx works
    • User Roles
    • User Status
    • Data Export
    • Data Purge
    • Participant Data
    • Experimental Conditions Data
    • Instrument Data
  • Installation
  • Server Configuration
  • Workstation Configuration
  • Procedures (in the Onyx user interface) that can only be done by system administrators

User Guide

  • Introduction
  • Getting Started
  • Viewing Participants
  • Participant Managers
  • Managing an Interview

Developer Guide

  • Introduction
  • Onyx Customization & Configuration Guide
Onyx
  • Docs »
  • Key concepts related to the way Onyx works
  • Edit on GitHub

Key concepts related to the way Onyx works¶

key User Roles¶

These are the roles that are possible for Onyx users: * Data collector - has basic permissions * Participant manager - has data collector permissions plus a few more * System administrator - has permissions of participant manager plus a few more

For details about what each user role can do, see Who Uses Onyx.

key User Status¶

Onyx users have one of these statuses: * Active: The user can log in. By default, when a user is created, their status is active. * Inactive: The user will not be able to log in. For example, you may want to deactivate a user who is away on leave.

The word that appears in the Status column in the User administration page is the user’s current status. Only system administrators can change the status of an Onyx user. See Activating and Deactivating Onyx Users.

key Data Export¶

Exporting data from Onyx means reading data from the Onyx database and writing it to one or more export destinations. Here are some points worth noting about the Onyx export function:

  • Exporting does not delete any data from the Onyx database. Deleting data from the database is done by the purge function. See Data Purge (page 139).
  • An export destination is a compressed zip file. The name given to an export destination may indicate the location into which the data will be imported—for example, a data repository like Opal.
  • Participant data and experimental conditions data can be exported. See Participant Data and Experimental Condition Data.
  • Configuration of data export is done entirely in configuration files, not through the Onyx user interface. Some things that can be configured:
    • Which data is selected for export
    • Directory to which export files are written
    • How many export destinations are defined

For detailed information about how the export function is configured, see the OBiBa Wiki Onyx+1.6.0+Upgrade. Only system administrators can execute a data export from the Onyx user interface. See Exporting data.

key Data Purge¶

In Onyx, purging data means deleting data from the Onyx database. Only participant data can be purged—not experimental conditions data. Configuration of data purging is done entirely in configuration files, not through the Onyx user interface. For detailed information about how the purge function is configured, see the OBiBa Wiki Onyx+1.6.0+Upgrade. Only system administrators can execute a purge from the Onyx user interface. See Purging data.

key Participant Data¶

Participant data includes personal information (such as the participant’s name and address), as well the data from all stages of the interview (consent, questionnaires, physical measurements, and information about the biospecimens collected). Participant data can be exported (see Exporting Data) and purged (see Purging Data).

key Experimental Conditions Data¶

Each study can define experimental conditions that it would like to track on a regular basis. This information is stored in one or more experimental condition logs. The Workstation page of the Onyx user interface allows users to make entries in these logs. As a system administrator, you will export this data, so you should be familiar with the experimental condition logs that were defined for the study. The user interface for experimental condition logs is in the lower half of the Workstation page. Instrument data is a special case of experimental conditions data. See Instrument Data. Experimental conditions data can be exported (see Data Export), but it cannot be purged (see Data Purge). This data is not purged because it is needed for the log history, and because no privacy issues are involved with this kind of data.

key Instrument Data¶

Instruments are part of the experimental setup, so data about instruments is a special case of experimental conditions data. As a system administrator, you will export this instrument data, so you should be familiar with the instrument calibrations that are done for the study. The user interface for instrument calibration is in the the top half of the Workstation page. Like other experimental condition data, instrument data can be exported but not purged.

Next Previous

© Copyright 2019, OBiBa Revision dd6f71a4.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: latest
Versions
latest
Downloads
pdf
html
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.