1. Implementing Learning
  2. Set Up the Microsoft Teams App for Oracle Learning Integration

Set Up the Microsoft Teams App for Oracle Learning Integration

For Microsoft Teams integration to work with Oracle Learning, you need to create a tenant, register an app, and configure access policies in the Microsoft Azure portal. Then configure integration, autocomplete attendance rules, and schedule background process in Oracle Learning.

Someone with Azure administration permissions should complete steps 1 – 7 using the Manage Azure Active Directory task, in Azure Active Directory. Someone with the Learning Specialist role should complete the remaining steps, 8 – 10 in Oracle Learning.
  1. As an Azure administrator, setup up a tenant using the linked information if you don't already have a Microsoft tenant. You need a Microsoft tenant ID to configure Microsoft Teams in Oracle Learning.

    You'll need to provide this information:

    • Tenant Type: Azure Active Directory
    • Organization Name: Enter the name of your organization
    • Initial Domain Name: Enter a unique domain name for your tenant

    After you set up the tenant, you need to record the Organization ID value for the tenant. You'll enter it as the Tenant ID when you configure Microsoft Teams in Oracle Learning.

  2. Register app or web API within the tenant using the linked information.

    You'll need to provide this information:

    • App Name: Enter a friendly name for your integration with Oracle Learning.
    • Supported account types: Select the account type that best matches your needs. If you need more information, please consult with Microsoft.
    • Redirect URL: You can leave this field blank for your integration with Oracle Learning.

    You need to record the application client ID generated after you finish registering the app, to use when you configure application access to online meetings in step 7. You'll also enter it when you configure Microsoft Teams in Oracle Learning.

  3. Add a client secret using the linked information. You need to record the provided client secret value because you'll enter it when you configure Microsoft Teams in Oracle Learning.
  4. Grant application permission to Microsoft Graph using the linked information.

    You'll need to provide your registered app with these permissions, which are required for your Microsoft Teams integration with Oracle Learning to work:

    • OnlineMeetings.ReadWrite.All
    • User.Read.All
    • OnlineMeetingArtifact.Read.All
    Caution: Make sure that the required API permissions are application type, not delegate type.
  5. Grant admin consent to the configured app permissions using the linked information.
  6. Configure application access to online meetings using the linked information.

    Before you start, you should have a user in the tenant that will call the Microsoft Graph APIs from Oracle Learning. We strongly recommend that this user is a generic account, not a personal account.

    You need to create an app access policy and grant it to a user. This authorizes the app configured in the policy to create an online meeting on behalf of that user. You'll need to provide this information:

    • The application client ID generated when you registered the app.
    • The user (object) ID from the Azure user management portal. Identify the user (object) ID of the user you're using or plan to use while configuring Microsoft Teams in Oracle Learning. This user will be the organizer of all Microsoft Teams meetings created through the integration.

    For more help with this configuration, see these topics:

    • To create an application access policy containing an application client ID: New-CsApplicationAccessPolicy
    • To grant the policy to the integration user, to allow the app client IDs contained in the policy to access online meetings on behalf of the granted user: Grant-CsApplicationAccessPolicy

    • To verify the access policy for the integration user: Get-CsApplicationAccessPolicy

      1. Run Windows PowerShell ISE as an administrator.
      2. Run Connect-MicrosoftTeams to launch the Microsoft sign in page. Sign in using integration user's account.
      3. Get application access policy information for the logged in integration user. The output should return the policy details.
  7. As a learning specialist, in Oracle Learning, configure the external provider.

    Before you continue, get this information from your Azure administrator:

    • Tenant ID
    • Client ID
    • Client Secret
    • Integration user name (Needs to be the same user you assigned the app access policy in the previous step. You'll enter it as the Administrator user name in Oracle Learning.)

    Complete these steps using the Configure External Providers task on the My Client Groups > Learning page:

    1. On the Configure External Providers page, in the row for the appropriate virtual classroom provider, click Configure.
    2. On the Configure External Provider page, click Create.

    3. Complete the configuration parameters using the information given to you by your Azure administrator.

      Field Description
      Account Name Display name for the Microsoft Teams provider in Oracle Learning drop-down lists, such as on the Create Instructor Provider Account page.
      Status

      Make the Microsoft Teams provider available or unavailable to instructors and for virtual instructor-led activities (VILT).

      When you change the status from Active to Inactive, you also need to remove the provider from any VILT offerings that currently use it.
      Secret You need to get the relevant information from your Azure administrator.
      Tenant ID
      Client ID
      Administrator user name

      You need to get this information from your Azure administrator.

      Make sure the Microsoft Teams user account with the email address meets these conditions:

      • It's part of the same tenant ID that you're using.
      • It has the required application access policy to call Microsoft Teams APIs. Your Azure administrator should already have set the up.
      • It's a generic account, not a personal account.
    4. To validate that the configuration parameters are correct, click Validate.
    5. Click Save and Close.
  8. To automatically update learner attendance to completed, set up attendance defaults for virtual instructor-led training activities.
  9. To keep the session details and assigned learners in sync, schedule the Sync Instructor-Led Trainings for Learning process to run once hourly. You only need to schedule the process after you set up the first virtual classroom provider. The process automatically includes any providers that you set up later.
    Caution: Alerts and .ics files won't include meeting links until the Virtual Classroom External Provider Synchronization process runs.

Related Topics