Typical Workflow to Use the JavaScript Embedding Framework with Oracle Analytics Content
If you're using the JavaScript embedding framework to embed Oracle Analytics content into an application or web page, then follow these tasks as a guide.
Note:
You can also embed Oracle Analytics content using the analytic content item's URL. Typically this method uses an iFrame. See Embed Oracle Analytics Content With iFrames.| Task | Description | More Information |
|---|---|---|
| Register the host application | Register development, test, and production host domains as safe domains. If the integration uses an iframe or sandbox option, enable Allow Frames. | |
| Enable Developer options and copy the embed markup | Enable the Developer option. In the workbook's Developer page, copy the <oracle-dv> markup and workbook properties that you want to embed.
|
Enable Oracle Analytics Developer Options Find the Javascript and HTML for Embedding Oracle Analytics Content |
| Create the HTML page | Create or update the host page. Include <!DOCTYPE html>, set the dir attribute as required, add appropriately sized containers for the embedded content, and reference the V2 embedding.js script.
|
|
| Select a V2 embedding mode | Use jet for an Oracle JET host application, standalone for a non-JET host application, or auto to let Oracle Analytics determine the appropriate mode.
|
|
| Initialize V2 | Wait for oracle.oa.embedding.ready(), set page-level configuration as required, and call applyBindings() after the <oracle-dv> elements are present.
|
|
| Configure authentication | Configure login prompt, 3-legged OAuth, or token authentication as required. |
Use Login Prompt Authentication With Embedded Oracle Analytics Content Use 3-Legged OAuth Authentication With Embedded Oracle Analytics Cloud Content Use Token Authentication With Embedded Oracle Analytics Cloud Content |
| Add embedded content and test | Add <oracle-dv> elements to the host page and test rendering, filters, parameters, refresh, locale, authentication, and frame configuration.
|
Pass Filters to the HTML Page for Embedded Oracle Analytics Content Pass Parameters to the HTML Page for Embedded Oracle Analytics Content Refresh Data in the HTML Page for Embedded Oracle Analytics Content |