Create a collection for a study

This guide is intended for W2H implementation leads.

If you are not an implementation lead and need access to an existing Lens collection, submit a help ticket at http://support.waytohealth.org. Please include your full name, email address, program/study name, and your role on the project (e.g. project manager, clinical lead).

Turn on ETLs for your study/program

In order to make study-specific data tables available in Lens, they need to be turned on. In the W2H admin portal (http://app.waytohealth.org ), navigate to Study Settings > Advanced Settings > Analytics.

Open

There are standard datasets such as Enrollment and Incidents. There are also study specific sources which include any surveys, text conversations, devices, etc.

After toggling on, standard datasets will run overnight. After enabling daily or weekly, study specific sources will run overnight (daily) or overnight on Sundays (weekly). This means you will need to wait at least a day to view the tables in the Lens Analytics portal.

The data sets that you’ve turned on in the W2H admin portal will become a table object in the Lens Analytics Portal. To see these sets, go to ‘Browse Data’ icon, select Analytics Main and use keyboard shortcut ‘Ctrl+F’ searching on study name to find the objects associated with your study. These table objects by themselves cannot be added to a collection, you must convert them to a question in metabase. You can accomplish this by accessing the object table and clicking ‘Save’. You can also “Ask a Simple Question (See: Creating and publishing questions).

Create a collection

Navigate to the Lens Analytics portal at https://lens.waytohealth.org/collection/root and click the folder icon in the top right corner to add a new collection. Save under Our Analytics if it is a new study, or under the existing study’s collection if it is a subfolder.

Giving users access to a collection

Research and care team users only require access to the Lens Analytics Portal if they would like to curate or edit questions. Otherwise, it is recommended that the implementation lead create a dashboard and embed it within the W2H portal. See Setting up embedded analytics in W2H.

Create a group

From the gear icon, navigate to the Admin section.

Open

Click “People” and then “Groups”. Click “Create a group.”

Name the group the study name for consistency. This should also match the collection name. Click “Add”.

Create a Lens user account

Click “People” in the left hand navigation. You can click “Invite someone” for new Lens users, or add existing users to the Group by clicking the arrow within the user’s row under the Group column.

If you are going to give the users the rights to curate or modify questions themselves, you will need to set permissions.

Set collection permissions to curate

From the Admin section, select “Permissions”. Under Collection permissions, select the Collection from the left hand side. Then find the Group you just added. Update Collection access to be “Curate”.