Add and update study users in bulk

Download and use the User Upload template to add new and update existing study users in bulk.

Before using this template, consider the following:
  • This template is only to manage study users within a given study. For more information, see About the User Upload template.
  • If the account for a new user included in the template doesn't exist, this template also creates the Oracle Life Sciences Single Sign-On (SSO) account for the user in Oracle Life Sciences Identity and Access Management Service (IAMS).

    Caution:

    It is important that you closely review the user account details entered in the template. If you mistype an email or user name for an existing account, it may result in the creation of a new account.
  • For more information to fill in the template, see Guidelines for updating the User Upload template.
The User Upload Error report generates automatically after every import completed with errors, and includes details about the errors occurred during the upload. This report uses the same format as the User Upload template.

Tip:

You can fix errors directly in the User Upload Error report and re-upload that report, instead of filling a new User Upload template to upload it.
  1. On the Home page, open the study's settings.
  2. Navigate to the Users tab.
    If you are using an User Upload Error report instead of a new template file, skip to step number 9.
  3. Click Download Template and select either one of the following options to download the template that you need:
    • Create Users: this option downloads a template with an empty users table.
    • Update Users: this option downloads a template populated with all current study users.

    Tip:

    In both cases, the template is populated with the current active study roles available in the study. You should always download a new template to pick up any changes applied to your study.
  4. Open the template.
  5. In the Clinical One Users tab, enter details for each user:
    • In the template generated to Create Users, enter the details for new users to be added.
    • In the template generated to Update Users, locate the existing user you want to update, and edit the necessary details.

    Note:

    Both templates support the functionality to add and update study users, as well as to create SSO accounts when they don't exist.

    For instance, you can add rows with updated details for existing users in the template generated to Create Users, or add rows with details for new users in the template generated to Update Users. In both cases your updates will get properly applied.

  6. Click Validate and then click OK in the confirmation dialog.
    After you click Validate, macros run to ensure required data is present and adheres to the required format. To do this, make sure macros are enabled on the file.Enable Macros
  7. If applicable, address any issues identified by the macros. Cells with errors get highlighted after the validation.
  8. Save and close the file.
  9. In Oracle Clinical One Platform, return to the Users tab in your study's settings, and click Create/Assign User.
  10. In the Create/Assign Users dialog, click Upload File for one of the following options:
    • Upload Clinical One SSO users
    • Upload federated SSO users
  11. When prompted, select the file (user upload template or user upload error report) previously saved, and click Open.
    A screen to Map Roles opens in the Upload Users dialog. The roles in the import file are automatically mapped to the roles available in the study. However, you can manually map roles differently using the drop-downs on this screen.
  12. Review the role mappings and click Next.
  13. In the preview window, review the user details to be uploaded and do the following:
  14. Click Upload.
An information message displays in the Users tab summarizing the amount of users being uploaded. When the upload completes, a confirmation email is sent with the subject Bulk User Upload notifications.
Check the notification for any users with errors. If there are any errors, download the User Upload Error report to review and address any import issues. You can fix errors directly in the report and upload it (following these same steps) for a successful import.