Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introducing Virtual Room Support in CAE LearningSpace

CAE LearningSpace provides Virtual Room functionality for distance learning. This feature relies on 3rd party applications and integrates these applications’ already existing capabilities into CAE LearningSpace to be able to substitute personal meetings with virtual ones.

With CAE LearningSpace's latest integration solution, you can remotely use rooms to organize and record OSCE encounters: have your SPs host their portrayal of a scenario and allow your learners to fill out their pre- and post-encounter checklists as you would do in the physical rooms of your training center.

From now on, you can integrate and use Zoom services through CAE LearningSpace and create virtual rooms for hosting scenarios to particular learners at scheduled appointments. 

This page will explain 

  • how to set up your Zoom account
  • how to integrate Zoom into CAE LearningSpace
  • how to set up and manage virtual rooms in CAE LearningSpace

The guide will also recommend the most fitting Zoom subscription plan to choose for OSCE Teleconferencing purposes that can also be adjusted to the needs of your organization.

Before starting the setup process, make sure you have as many email addresses ready as the number of virtual rooms you would like to configure.

Info
titleRecommendation: Use Email Aliases

Ask your IT support to create email aliases—additional addresses—to your own email address with names like med.osce.virtualroom1@uni.edu, med.osce.virtualroom2@uni.edu, ect.
Set up as many email aliases as many virtual OSCE rooms you plan to configure.
Use your own email address as the primary address of your Zoom account, and then the email aliases to create users under your Zoom account.

The number of virtual rooms you can configure for OSCE  Teleconferencing purposes depends on your Zoom subscription plan. Aside from our recommendation, you can also check the subscription plans at Zoom’s Plans & Pricing page: https://zoom.us/pricing

Create Your Zoom Owner Account

Visit zoom.us and create a new owner account by signing up.

Note
titleImportant

Use the email sign-up option.

...

Info
titlePrimary Email Address

This email address will serve as the primary address of your Zoom account.
Virtual rooms will be organized under the owner account registered with this primary email address.

Anyone who has access to this email account, and consequently the Zoom owner account can:

Section
  • upgrade to a new plan (change the number of hosts)
  • see and copy the API key and secret
  • manage the type of each user in Zoom: Licensed or Basic type.

...

  1. Click Activate Account,
  2. or paste the provided URL into your browser. 

...

Invite Colleagues: We recommend to Skip this step.
By sending out this invitation, new separate primary accounts will be created which would require their own subscription plan updates. 

Tip

With our CAE LearningSpace integration solution, you can manage every virtual room your training program needs from a single Zoom account.

...

You will be redirected to your profile where you can find your account number, personal meeting ID, account information and meeting capacity.

Image Removed

Note
titleImportant

Upon registration, you will have a Basic account that you will need to upgrade in order to register your virtual rooms as users under your Zoom account.

Info

Before upgrading your Zoom account, please continue with the API Configuration part.

API Configuration

In Zoom

Before upgrading your account, you need to obtain the API key and secret from your Zoom account to have CAE LearningSpace communicate with Zoom.

Obtaining the API key and secret is made entirely user-friendly in Zoom and CAE LearningSpace likewise:

...

On the Choose your app type page, find JWT.

Info

JWT is a tool that generates the API Key & Secret you need for integrating Zoom services into CAE LearningSpace.

...

A window pops up where you need to name the new JWT application you are creating.

Info

In the example, we are simply naming the new application after CAE LearningSpace, but you can give any name to the app you prefer.
The name of the app does not affect the API configuration in any way.

Image Removed

...

You will be directed to the Information page of your new JWT application where you need to administer further details such as provide the name of your organization and the Developer Contact Information.
Image Removed

Tip

Developer Contact Information can be the same as the account owner’s information. 

...

Copy the API Key and the API Secret. Use the Copy option at API Secret if you do not want to display it.

Info

Your generated API Key and Secret are automatically saved. You can view this page any time by repeating the steps from step # 3 (selecting App Marketplace).

Only, the JWT tab will look slightly different: 

Click View here to access your API Key & Secret:

Image Removed

In CAE LearningSpace

Now that we have the app credentials, we can enable the Zoom Telemedicine module in CAE LearnigSpace.

  1. Log into CAE LearningSpace (with Administrator privilege).
  2. Go to System.
  3. Select the Security tab.
    You will find the new Telemedicine Module at the bottom of the page right under the system password.
  4. Switch on the new module to display Zoom settings.
  5. Paste the API key and API secret in the corresponding fields.
  6. Click on Save & Test Connection to connect to Zoom. 
    Image Removed
  7. CAE LearningSpace informs you about the successful or failed connection at the top of the page.

Upgrade Your Zoom Account

When you sign up for free with your primary email address, you only have access to the Basic features of Zoom.

You can check your subscription status at the User Type field on your profile:

Image Removed

A Basic subscription does not

  • support Zoom service integration into other applications
  • contain cloud recording
  • and restricts the duration of meetings to 40 minutes if there are more than three total participants at the meeting.
Note

In order to use Zoom services within CAE LearningSpace after completing the API setup as described in the previous part, you need to upgrade your account and include as many hosts in your subscription plan as many virtual rooms you would like to configure in CAE LearningSpace.

  • Upgrade your account to Pro if you plan to configure 9 virtual rooms or less;
  • Upgrade your account to Business if you want to configure 10 or more virtual rooms.
Info

Virtual room configuration in CAE LearningSpace will be explained in the next section.

To upgrade your Zoom account:

...

  1. Select Pro if you plan to configure 9 virtual rooms or less;
  2. Select Business if you want to configure 10 or more virtual rooms.

Select the number of hosts you want to purchase.

Info

Zoom automatically calculates the monthly and annual fees afterwards.

Image Removed

Info
titleOptional Cloud Storage Purchase

Zoom offers 1 GB/host cloud storage starting from Pro accounts, but in our setting, it is only used as temporary storage.

OSCE teleconference meetings can be moved/downloaded to the Video Review module in CAE LearningSpace once a meeting is processed.

However, if you would like to add some extra storage because you find 1 GB insufficient, scroll down to the Available Add-ons and open Cloud Recording. 
We recommend purchasing the extra 100 GB/month solution:

Image Removed

Page Tree
rootVirtual Rooms for OSCE Teleconferencing
startDepth2

Image Added

Monitoring Page

...

Billing Contact information

Info

Beside basic details, the total employee count of your organization is required to continue.

...

Virtual Room Configuration

(=CAE LearningSpace handles Zoom User Management when setting up a new room.)

Create virtual rooms in CAE LearnigSpace after you have successfully connected to Zoom after setting the API key and secret in the Security tab.

By creating virtual rooms in CAE LearningSpace, your Zoom owner account will automatically send activation emails to each email address to verify the email address of each virtual room and to add them as users to your primary Zoom account.

After verifying the virtual rooms, the room’s status in CAE LearningSpace will change to “Verified”, meanwhile in Zoom, you can set the virtual rooms up as Licensed users. If all these settings are complete, your room can be added as a station for an event created with Advanced Scheduling. You can schedule your learners and add SPs as would do using a physical room.

You can organize virtual OSCE sessions; your SPs will be allowed to start hosting the scenario they are portraying and allow scheduled learners to access the virtual scenario according to their timeslot assignments.

Enter System from the Dashboard, and go to Rooms.

Click Add New Room. Enter the name and description of the new room which are required to continue.

Check the new Virtual Room checkbox included under the required fields.

Click Add.
Instead of the usual setting options, only a few fields will appear:

New Registration email field: The email alias of your virtual room goes here.

Zoom will send an activation email here to add the virtual room as a user under your primary Zoom account. Then the virtual room can be Licensed to enable hosting from the user/virtual room registered with this email alias.

This setup is necessary to enable SPs to host and learners to join a meeting through CAE LearningSpace.

New Status fields: Shows the status of the room whether the activation email was verified or not that was sent by Zoom to the email alias Once the Zoom activation email that was sent to the email  was verified  

The Location drop-down will also appear as an optional setting in case you would like to categorize your virtual room e.g. by campuses.

After providing the Registration email address, click Save.
Zoom will automatically send a user activation email to the email alias of the room.  

Check for the activation email in the mailbox of the provided email alias.

Click Activate Account.
You will be redirected to Zoom to provide the name and password of the new user/virtual room added under your primary account.

The Room Settings popup will warn you if the Telemedicine module is currently switched off in CAE LearningSpace.
Every virtual room that has been previously verified will appear as not verified if the Telemedicine Module is switched off.

When switching back the Telemedicine Module on the Security page, the API key and secret will auto-populate in each field. Without changing anything, click Save & Test set up the connection to Zoom Services again.

Click Add New Room.
The Room Settings popup will contain extra fields:

Registration email: email alias that needs to be provided so that Zoom can activate the virtual room as a user in its system.

Status: Not verified until the activation email of the room is not verified by the Zoom account owner.

...