Important: This Cloud Connector/Component will be decommissioned  after March 31st 2017. Please review the App Replacement Cheatsheet for instructions

 

Box Cloud App

 

This article will describe the individual pieces of the Box Cloud App, how to have it enabled for your Eloqua instance, and configure it for display on your E10 landing page. This document assumes that the reader is an E10 user, and is familiar with using landing pages.

 

With the Box Cloud App, you can now share files stored in your Box account on an E10 landing page.  You can choose to either display a link to your file, embed an image, or display the Box file previewer right on your page.

 

In order to use the Box  App, you will need to have a valid Box account, and must be registered at cloudconnectors.eloqua.com.

 

What is the difference between Appcloud.eloqua.com and Cloudconnectors.eloqua.com?

 

Box Cloud App Components

 

The Box Cloud App consists of the following Cloud Component:

  • Box File Share - allows you to embed an image, document link, or document previewer into an E10 landing page.

 

ARTICLE – What is the difference between an App, a Connector, a Component and a Feeder

 

How to Install the Cloud App

 

The Box Cloud App is already available for use in E10, but may need to be enabled.

 

See here for more information.

 

Using the Component on a Landing Page

 

     A Cloud Component is inserted into a landing page via drag and drop within the landing page editor.

 

     From the editor toolbar, select the "Cloud Components" button.  A select box containing all of the available Cloud Components will then display.

CCButton.PNG

 

Drag and Drop the Box File Share component onto the landing page:

CCDrop.PNG

 

Next, save the page, then double-click the icon that you just dropped onto the page.  The following screen will appear:

CC_Login.png

 

Enter your cloudconnectors.eloqua.com credentials and log in.  The configuration screen for the Box File Share will then be displayed:

BoxConfig1.PNG

 

In order to access your Box files, you will need to grant the component access to your account.  To do this, click "Authorize Account".

BoxConfigAuthorize.PNG

The following screen will then appear:

BoxConfig2.PNG

Enter your Box credentials and click "Log In".

(NOTE: If you are using a Single Sign On (SSO) service such as Okta, enter only your Email and leave the password blank)

 

Once successful, a window will display saying "Thank you. Close this window to continue".  Close the window, you've now granted access to your files!

AuthConfirm.png

     Next, select the file you would like to share on the page.  Click on the Select File button.

     BoxConfigSelectFile.PNG

     The app will search your Box account and display the results.

     BoxConfigSelectFileList.PNG

     Your Box account contents will be displayed as a set of folders and files.  Click on a folder to see the files within it, or click on a file to select it.  You can also page through results by clicking on the numbers below the file list.

 

     Once you've selected your file, the app will check your Box account to see if the file is currently shared.  If the file is not yet shared, you will be shown the following:

     DocShareError.png

Since the app required you to share the file before displaying in on the landing page, you have a couple options.  You can choose to go to your Box account and create the share there, or the app can create it for you.  If you choose to do this through your Box  account, you simply create the share manually, then come back to the app and click Save Settings again.  The warning will then disappear.  If you choose to have the app create it for you, simply select a share type (Open, Company, or Collaborators) and click  Share.  If the share is created successfully, you will see the following:

     DocShareSuccess.png

     Your file is now shared.  The shared file will show in the File to Share field.

     BoxConfigFileSelected.PNG

    You're now ready to select your Share Type.

     BoxConfigOptionList.PNG

     You will be presented with three options for sharing.  These include:

    • Previewer - Embed the Box previewer directly in your page.
    • Image Embed - Display an image from your Box account on your page.
    • Link to File - Provide a link to a file in your page.

 

     To embed an image from your Box account, choose Image Embed.

     BoxImageEmbed.PNG

     Click on Save Settings and close the Configuration screen.

 

     Now, render the landing page, and you will see your Image Embed on the page where you placed it.

BoxImageRendered1.PNG

     If you would like to embed a link to a file in your landing page, select Link to File.

     BoxConfigFileLinkDefault.PNG

 

     For a "Link to File", you can use either the default icon, or a custom icon of your choosing.

 

     To select a custom icon, select "Custom" from the "Image to display as link" dropdown, and enter the URL to the image.

     BoxConfigFileLinkCustom.PNG

     Now, render the landing page, and you will see your file link on the page where you placed it.

BoxImageRendered2.PNG

     The third option is embedding the file previewer on your page.  Select Previewer from the option list.  The following additional settings will appear.

     BoxConfigPreviewer.PNG

     In the Previewer Settings area, you can use the following to customize the previewer for display on your page.

 

    • Permissions - Choose to either show or hide the Download, Share, or Print buttons.
    • Dimensions - Set the size of the previewer (Note: make sure that the component on the landing page is at least the dimensions that you set here to allow all of your content to display).

 

     When you have the settings the way you wish, render the landing page.  You will see the previewer displayed on the page.

     PreviewRendered.PNG