1. Create a document approval process in Oracle Sales Cloud
  2. Embed the Oracle Content Management Web User Interface in Other Applications as an iFrame

Embed the Oracle Content Management Web User Interface in Other Applications as an iFrame

You can embed the Oracle Content Management web user interface in an HTML inline frame (iframe tag). The embedded interface removes the default branding and resizes the content to fit the enclosing frame, letting you to integrate Oracle Content Management into your own web applications.

To do this, add /embed to any member or public folder link immediately after the /documents element in the URL that’s used to populate the inline frame.

For example, the following URL calls the standard user interface and shows the home folder for the current user:

https://www.example.com/documents/home/nameasc

To display the home folder in the embedded user interface, use the following form of the URL:

https://www.example.com/documents/embed/home/nameasc

To open a folder in the embedded interface, use the folder element in the URL and specify the globally unique identifier (GUID) of the folder: 

https://www.example.com/documents/embed/folder/1713A5712BE73C37891915A0127B594F/nameasc

Note:

The embedded user interface adjusts the content to fit within windows as small as 320 pixels wide. Windows smaller than 320 pixels begin to hide content on the right edge of the window.

You can also embed member links and public links to folders, and use configuration parameters that control some aspects of the browser display.

Embed Content in Other Domains

You can display content from Oracle Content Management in other domains. For example, you might embed the Oracle Content Management web user interface in your own web applications to access folder and document management features inside your application.

To allow users to embed content, enable embedded content and add domains:

  1. After you sign in to the Oracle Content Management web application as an administrator, click System in the Administration area of the navigation menu.

  2. In the Administration menu, click Security.

  3. Under Embedded Content , select Enabled.

  4. In the Allowed domains box, enter a list of permitted domains, separated by commas. Domains must be in the form www.example.com.

    • To restrict the domain to a particular port, include the port in the specification. For example, www.example.com:12345.

    • If you want to allow a domain that has multiple sub-domains, you can use the * wildcard character. For example, www.example.* includes the domains www.example.com, www.example.co.uk, and so on.

Embed an Application as a Subtab in an Oracle Sales Object

After you embed an application as a subtab, the new subtab appears as part of a details page for an specific object in Oracle Sales. The application is embedded in an iFrame on the subtab.

To do this, you use the Oracle Sales Application Composer toolkit. This example uses the Sales application container and the Account object.

  1. Activate a sandbox.
  2. On the Oracle Sales Navigator menu, under the Tools category, click Application Composer.
  3. Expand Objects, and then expand Standard Objects.
  4. Expand the Account object and click Pages.
    The panel on the right side will refresh to display the editing interface.
  5. Select the Simplified Pages tab if it’s not already selected.
  6. Under Details Page Layout, click the Standard Layout to select it, and then click the Duplicate icon in the toolbar.
  7. Click the link to the copy you created (for example, Default custom layout).
    The Default custom layout editing interface appears. You also see a set of icons stacked vertically that represent the subtabs that appear in the Details Page Layout for the selected object.
  8. At the bottom of the icon stack, click the Add icon.
    The Details Layout: Default custom layout: Create Subtab editing interface appears.
  9. Click Web content, and then click Next.
    The Details Layout: Default Layout: Create Subtab has two areas:

    • Basic Information, for subtab display details.

    • URL Definition, which includes a Palette where system values can be selected for use in Groovy scripts, and a Groovy scripting interface for constructing a valid URL.

  10. In Basic Information, enter the display label. If you want, enter a description and change the default display icon.
  11. In the URL Definition area of the Edit Script window, enter a well-formed application URL. For example, the Groovy expression: return "http//{YOUR-APP-URL}", and then click Save and Close.
    The interface shows the subtabs associated with the object, including the new subtab.
  12. If you want, move the location of the new subtab by clicking on the two-arrow icon at the top of the subtab icon stack.
  13. Click Done.
  14. If you want, you can test your subtab. Click Accounts in the Navigator menu, and create a new account. You’ll see the new subtab for the application that you just embedded.

Troubleshoot iFrame Embedding Issues with Oracle Sales

Some of the common issues around embedding an IFrame in Oracle Sales occur establishing a secure connection with the HTTPS protocol.

For example, if you see a blank iFrame when you embed the application:

  • Make sure that the URL of the application is correct. Use your browser developer tools to check whether the URL generated uses the correct hostname, and is otherwise correct.
  • If you’re using an Oracle Java Cloud Service servlet to embed the iFrame, check whether you are accessing the servlet using HTTPS. For security reasons, most browsers do not allow you to mix HTTP and HTTPS content in the same browser page.
  • If your servlet writes an error log, you can examine the application debug logs. If you encounter errors when you execute the application and no visible errors appear in the browser, try checking the error log on your applications server.