Enable Workbook Users to Share Visualizations in Microsoft Teams

Administrators can set up a Microsoft Teams channel in Oracle Analytics so content authors can share their content directly to their organization’s Teams channel.

  1. Optional: If you haven't created a Microsoft Teams app on which to share analytics content, register a new app:
    1. In the Microsoft Azure Portal, go to Microsoft Entra ID and select Manage > App Registrations.
    2. Select New registration, provide the application name, complete the required details, and then click Register.

    After registration, you're redirected to the application’s Overview page. Alternatively, you can access the Teams app by signing in to the Microsoft Azure Portal and navigating to Microsoft Entra ID > App Registrations, and selecting the application.

  2. In the Microsoft Azure Portal, obtain the client ID, tenant ID, and client secret values for the Microsoft Teams app that you want to use.
    1. After you create an application in the Microsoft Azure Portal, navigate to Microsoft Entra ID, then App Registrations.
    2. Select the application.
    3. On the Overview page, copy the Application (client) ID and Directory (tenant) ID values from the Essentials area.
    4. Click Certificates & secrets, then click Client secrets, then click New client secret and copy the Value displayed.
  3. In the Microsoft Azure Portal, as an administrator, grant these permissions for delegated access:
    1. Select API Permission.
    2. Select Add Permission.
    3. Select Microsoft Graph in Microsoft APIs, then select Delegated Permissions.
    4. Added these permissions:

    • Channel.ReadBasic.All

    • ChannelMessage.Send

    • Files.ReadWrite.All

    • offline_access

    • Team.ReadBasic.All

    • User.Read

  4. Configure the Teams channel in Oracle Analytics.
    1. On your home page, click Navigator Navigator icon used to display the Navigator, then click Console.
    2. Click Content-Sharing Platforms.
    3. For Service, select Teams.
    4. Change Status to Active.
    5. For Application Name, enter the user-friendly display name of the app that you set up in Azure Portal.
    6. For Client ID, Tenant ID, and Client Secret, enter the values that you obtained in Step 1.
      Use Application (client) ID for Client ID.
      Use Directory (tenant) ID for Tenant ID.
      Use New client secret for Client Secret.
    7. Click Update.
    8. Click Copy to Clipboard to copy the Redirect URL for Oracle Analytics.
  5. In Microsoft Azure Portal, configure the redirect URL for Oracle Analytics.
    1. Under App registrations, select your app, then click Manage, then click Authentication.
    2. Click Add a platform, then click Web, and add the copied Redirect URL from Oracle Analytics to the Redirect URIs list.
  6. Verify you can share workbook content on the Teams channel.
    1. In Oracle Analytics, open a workbook.
    2. On the Visualize or Narrate canvas, click Export.
    3. Click Teams.
    4. Specify the details and click Post.
      Description of share-teams.png follows
      Description of the illustration share-teams.png

      For example, if you select "Interactive" under Format, users accessing the content on the Microsoft Teams channel can filter and rearrange the visualizations (however they can't save changes in the Microsoft Teams channel).
Workbook users can now share their content in an organization's Teams channel. See Post a Visualization or Canvas on Messaging Platforms.