Administration guide for Assay

    There are three main user roles in Chemaxon Assay. Administrators (admins) have access to the entire system, including its configurations. Users have access only to parts of the functionalities and special users are the external users (e.g. CRO staff) restricted to data upload only.

    This page summarizes the tools collected in the Admin Area tab. This is only visible to users with admin rights (managed in Synergy).

    Automatic Upload

    Automatic file upload is available via a file sharing service. Currently Google Drive and Egnyte services are implemented.

    Google Drive Settings: You have to sign in with a Google account, and copy the target folder's URL to theFolder URL field (please note that it is not the sharing link of the folder). The folder icon next to the URL field opens the Drive folder in a new browser tab. If the folder is valid, you can quick-view the contents by clicking the Google Drive Folder Content dropdown button.

    Egnyte Settings: You have to sign in with an Egnyte account, and enter the folder path of the shared Egnyte folder. The folder icon next to the path field opens the Egnyte folder in a new browser tab. If the folder is valid, you can quick-view the contents by clicking the Egnyte Folder Content dropdown button.

    OneDrive Settings: You have to sign in with a OneDrive account and enter the folder path of the shared OneDrive folder. The folder icon next to the path field opens the OneDrive folder in a new browser tab. If the folder is valid, you can quick-view the contents by clicking the OneDrive Folder Content dropdown button. Azure Active Directory Setup These screenshots will guide you through the setup process of Active Directory to register the app. Click the pictures to enlarge.

    1. Open Azure Active Directory admin center, App registrations page. Click the New registration button, fill in the fields. Redirect URI is the location where your Assay instance is running (ending in /onedriveoauth), see attached example.
    images/download/thumbnails/1805206/oneDriveSetup1.jpg
    1. Open the newly registered application details (click its name in the applications list). On the Overview page select and copy the Application (client) ID and send it to the Assay support team.
    images/download/attachments/1805206/oneDriveSetup2.jpg
    1. Go to the Authentication page, and change the settings as shown on this screenshot:
    images/download/attachments/1805206/oneDriveSetup3.jpg
    1. Go to Certificates & secrets page, click New client secret. This secret string has to be copied and sent to the Assay support team. You should save it securely for later else you won't be able to access it again. images/download/attachments/1805206/oneDriveSetup4.jpg
    2. Open API permissions page and set the following permissions: Files.Read, User.Read, offline_access. Make sure that the Azure admin grants the permissions, and statuses are marked with a green tick.
    images/download/attachments/1805206/oneDriveSetup5.jpg

    Scheduling: you may set the periodical checkup of the folder to see if there are any new files added. The software then automatically uploads the new files. Set the starting date and time in the corresponding fields, and define a time period when the folder check should occur. Click the Start button to start the scheduling. If you set a date already passed, the scheduling will start immediately. To pause the scheduled file upload, click the Stop button.

    Audit Log

    Every modification done in Assay is logged in the audit log table. An audit log entry contains the following fields:

    • timestamp of the logged action
    • resource name (name of the result type or task)
    • resource type (TASK, RESULT_TYPE, PROTOCOL etc.)
    • action (depends on the resource. ex: CREATE, MODIFY, CONFIRM)
    • user (the initiator of the action)
    • other resource specific metadata

    Assay Audit Log

    Main features of the audit log table:

    • sort the table by clicking on the column header (sorted by timestamp, newest first by default)
    • click on the row to open a detailed view of the record
    • there is a link Assay Audit Log to the resource in the last column
    • use the Assay Audit Log in the top toolbar to filter the table (searches in Name, Type, Action and User)
    • refresh the table any time by clicking on  Assay Audit Log

    Assay Audit Log Details

    Data Synchronization

    Data may be sent (downstreamed) to other applications, so connected databases are always synchronized. This happens periodically, but if needed, a manual synchronization can be started.

    Adapter status : the current state of the Assay adapter is displayed here. The normal case is a green sign reading UP and Ready. If this is not the case, please contact your system administrator for support.

    On-demand synchronization: after the first synchronization a colored bar displays the time stamp of the last synch and if it was succesful. To initiate the data synchronization right away, press the Start synchronization button.

    Available columns in downstream: this list shows you which columns are downstreamed.

    Access Control

    You can assign various roles to groups of users as defined in Synergy administration. The groups are automatically retrieved from Synergy, and offered in the dropdown list.

    The assignment of users to groups is handled in the Synergy Administration. See details in the Synergy documentation.

    Roles Overview

    We collected all privileges in a table so you'll have a reference of who is allowed to do what.

    Power User Functions

    Regenerate indexes: click the button to regenerate indexes for the database.

    Feature on demand: Clear database

    {info} Recommended only for trial periods of evaluting Assay!

    With this function you may permanently delete the database (wipe clear of all user-set parameter types, procedures, tasks, history).

    There are three options of database cleaning:

    • Delete tasks and processed data only: Tasks and Processed Data tabs will be emptied, but the Parameter Types, Procedures and settings in the Admin Area will remain.

    • Keep settings, delete all data: Parameter Types, Procedures, Tasks and Processed Data tabs will be emptied, but settings in the Admin Area will remain.

    • Delete settings and all data: all tabs will be emptied and Admin Area settings will be set back to the default values.