Embed Oracle Analytics Content With iFrames

This section explains how to use iFrames to embed Oracle Analytics content into applications and web pages.

Topics:

• Considerations for Embedding Oracle Analytics Content With iFrame

• Use iFrame to Embed Analytics Content into an Application or Web Page

Considerations for Embedding Oracle Analytics Content With iFrame

This topic describes issues that you might encounter when you use iFrame to embed Oracle Analytics content into applications and web pages.

Typically when users open embedded analytics content from an application, they'll be prompted to log into Oracle Analytics. To avoid this issue, set up single sign-on or user federation between Oracle Analytics and the application hosting the embedded analytics content.

If you're using the Safari browser and the embedded analytics content doesn't display as expected, try disabling Safari's Prevent cross-site tracking preference.

Use iFrame to Embed Analytics Content into an Application or Web Page

You can embed your analytics content into an application or web page by adding the target analytics content's URL into an application or portal's iFrame. For example, you can use this method to embed analytics content into Microsoft Teams.

Note:

If you need an integrated way to embed analytics content, then use the JavaScript embedding framework. This method provides greater flexibility than the iFrame embedding method. See Typical Workflow to Use the JavaScript Embedding Framework with Oracle Analytics Content.

Before you perform this task, confirm that you've registered the domain that you want to embed your analytics content into as a safe domain. See Register an Application as a Safe Domain.

If you need to manually build the URL, for example to create a URL that includes parameters, be sure to properly escape any characters. All special characters in the URL need to be URL-encoded. For example, use %2C to encode commas and %20 to encode spaces.

1. On the Home page, click Navigator, and then click Catalog.
2. Locate the item that you want to embed and click Actions. Click Open.
3. Go to the browser's address bar and copy the item's URL. These are examples of URLs:

   • Report - http://example.com/analytics/saw.dll?PortalGo&path=%2Fshared%2FRevenuehttp://example.com/analytics/saw.dll?PortalGo&Action=prompt&path=%2Fshared%2FSaled%2FSales%20by%20Brand

   • Dashboard - http://example.com/analytics/saw.dll?Dashboard&PortalPath=%2Fshared%2FSales%2F_portal%2FQuickStart&page=Top%20Products

   • Workbook - http://example.com/ui/dv/home.jsp?pageid=visualAnalyzer&reportmode=full&reportpath=%2Fshared%2FMySalesWorkbook

   • Canvas - https://example.com:8080/ui/dv/?pageid=visualAnalyzer&reportmode=full&reportpath=%2F%40Catalog%2Fusers%2Fadmin%2FOAC%20Demo%20Samples%2FCost%20Management%20Analytics%20copy&canvasname=canvas!2. See Share a Workbook URL with a Specific Canvas Selected.

4. Alternatively, manually build and then copy the URL to insert into an iFrame.
   This is an example of how to construct a URL containing parameters:
   https://example.com/ui/dv/ui/project.jsp?pageid=visualAnalyzer&reportmode=full&reportpath=%2F%40Catalog%2Fshared&p1n=pCustomerSegment&p1v=Corporate&p2n=pCity&p2v=Bristol%2CCardiff%2CAustin
5. Open the target application or portal, locate an iFrame, and paste the analytics content's URL into it.