Monday, August 10, 2015

Embedding Oracle Documents Cloud Service UI In Custom Web Pages

Introduction

With Oracle Documents Cloud Service we have the possibility to embed the user interface of Documents Cloud Service in other web pages by simply using an HTML iframe tag. This is the simplest way to integrate with Oracle Documents Cloud Service and to do this you have to follow few simple steps. Note that this integration removes the default branding from interface and dimension parameters of the interface are dictated by the attributes of the iframe.


Enable the embedded content

In the Administration interface of Oracle Documents Cloud Service go to Embedded Content section. A switch allows you to enable or disable content from Oracle Documents within other domains. Also you have to specify the domain and port and if you enable CAPTCHA and Safe Mode. We will come back to these features a little later. 

Oracle Documents Cloud Service Administration Interface


For this simple tutorial I used wildcards for the domain name and port and this is not safe. Please use your actual domain name and actual port for your web application.


Define the IFRAME URL

Next step is to identify the URL for the iframe src attribute. If your URL for the service is: 

http://<tennant-info>.oraclecloud.com/documents/home/nameasc 

the URL for embedded UI will be: 

http://<tennant-info>.oraclecloud.com/embed/documents/home/nameasc. 

Replace the <tenant-information> with corresponding section form the URLyou’re your Oracle Documents Cloud subscription. Notice that we added “embed” before “documents” in the URL. You can also start with a specific folder but for this you will have to specify the GUID of the folder. In this case the URL will look like:

http://<tennant-information>.oraclecloud.com/embed/folder/<GUID>

Integrate IFRAME in WebPage

I wrote a very simple HTML page (test1.html) that displays the Oracle Documents web interface:

<!DOCTYPE html>
<html>
  <head></head>
  <body>
   <iframe src="http://<tenantinfo>.oraclecloud.com/embed/documents/home/nameasc" 
           width="800" height="600"/>
  </body>
</html>


The page was deployed to a web server and final step, testing. Be sure that you disabled pop-up blocker for your page first because a pop-up will be used for authentication.



and here are your files:



Now you can start dragging and dropping files in your folders.

Finally, notice the difference between the embedded interface and standard interface. In the right corner of the embedded interface we have the "Open in Oracle Documents" button (see above image) . This button allows you to switch between the embedded interface and standard web interface of the service. 


A final word about enabling CAPTHCA and Safe Mode. 

You can enable CAPTCHA to allow only users and restrict access of scripts to your Oracle Documents Cloud Service content. You do this  An embedded page with CAPTCHA enabled looks like:





Safe Mode prevents users for performing dangerous actions like copying or moving content in public folders, changing the status of public links (share/unshared content) and deleting permanently files of folders. A user can move a folder or file in trash folder.


1 comment:

Mary Gooven said...

Virtual cloud services give a possibility to store data on the virtual servers. And one type of such clouds is virtual data rooms, such as Ideals. In general, it is the same cloud, but it has better protection and permit to implement deals within the room.