{"id":24431,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/box-integration-setup-1\/"},"modified":"2025-02-18T15:30:23","modified_gmt":"2025-02-18T23:30:23","slug":"box-integration-setup-1","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/","title":{"rendered":"Box Integration Setup"},"content":{"rendered":"

The setup of the Box integration consists of the following steps. These steps can all be performed on the server where the ExtraView web application is installed, although the generation of the auth token step can be performed on any computer with Java installed. The installation and configuration steps need to be performed only once for an ExtraView application.<\/p>\n

\n\tCreate Box Application<\/h3>\n

A Box application is required for the integration to be able to connect to the Box account from ExtraView.<\/p>\n

Go to the Box developers site<\/a> and click on the Get API Key<\/b> link to login with your Box account credentials. Enter a value in the Application name<\/b> field and click the Create App<\/b> button to create a new Box application. The new application will have an Api Key<\/b> assigned, which you will need to use in the steps below.<\/p>\n

\n\tDownload Integration Software<\/h3>\n

Download the following files from the ExtraView download site. If you are not familiar with the download site, please contact the ExtraView support group.<\/p>\n

GetBoxAuthToken.zip
\n\tBoxIntegration.class <\/span><\/p>\n

\n\tInstall Java<\/h3>\n

If you don’t already have Java installed, download the latest Java runtime<\/a> and install it according to the installer and instructions provided on the Java website.<\/p>\n

\n\tGenerate the Box Auth Token<\/h3>\n

You must give the new Box app access to your Box account. Extract the GetBoxAuthToken.zip<\/span> file into a new directory, which will contain the following files:<\/p>\n

NEW_DIRECTORY\/
\n\t   GetBoxAuthToken.jar
\n\t   lib\/ <\/span><\/p>\n

The lib<\/span> directory contains additional files necessary for the integration.<\/p>\n

\n\tNote:<\/b> You must perform these steps within 10 minutes as the URL generated is only valid for a limited amount of time.<\/div>\n

Open a Command Prompt window on your local computer and execute the following commands, replacing the uppercase strings with appropriate values for your computer:<\/p>\n

cd <NEW_DIRECTORY>
\n\tJAVA_HOME\/bin\/java -jar GetBoxAuthToken.jar <API_KEY> <\/span><\/p>\n

where <NEW_DIRECTORY> <\/span>is the newly created directory with the contents of the GetBoxAuthToken.zip file, JAVA_HOME<\/span> is the path to your Java installation directory, <API_KEY> <\/span>is the Api Key assigned to the new Box application you created above.<\/p>\n

Information similar to the following will display in the Command Prompt window:<\/p>\n

1. Go to: https:\/\/www.box.com\/api\/1.0\/auth\/fadsa3124lkj098erwopiu980 <\/span>
\n\t2. Enter your Box credentials.
\n\t3. Press ENTER. <\/span><\/p>\n

Load the URL listed above in Step 1 within a web browser and follow the prompts to allow access to the Box app – this is Step 2. Once you login to the Box website, then go back to the Command Prompt window and press the Enter key as Step 3 indicates. Information similar to the following will display in the Command Prompt window:<\/p>\n

Auth Token: vxcz8fasd9sdfa3iuore8 <\/span><\/p>\n

Save the Auth Token value for the next step in the integration setup.<\/p>\n

\n\tNote:<\/b> If you encounter an error while running the commands above in the Command Prompt, or the Auth Token is not displayed, then verify that you have performed the steps exactly as instructed and have used the appropriate Box app Api Key value. If you still receive an error, then contact ExtraView Support for assistance.<\/div>\n

\n\tConfigure ExtraView<\/h3>\n

The following settings need to be added to ExtraView’s Configuration.properties<\/span> file with the api and auth codes used and generated in the previous section. This file is situated in the directory WEB-INF\/configuration\/<\/span>:<\/p>\n

BOX_API_KEY = <API_KEY>
\n\tBOX_AUTH_TOKEN = <AUTH TOKEN><\/span><\/p>\n

Log into the ExtraView web application with an account that has administrative privileges and set the following Behavior Setting to the value indicated:<\/p>\n

USER_CUSTOM_CLASSNAME = com.extraview.usercustom.BoxIntegration <\/span><\/p>\n

Decide where all the files (attachments, document and image fields) uploaded to ExtraView are to be stored. The ATTACHMENT_REPOSITORY_OPT behavior setting controls this behavior. If all files are to be stored in the Box account instead of the ExtraView database or on the filesystem, then set the behavior setting to the following value:<\/p>\n

ATTACHMENT_REPOSITORY_OPT = REPOSITORY <\/span><\/p>\n

\n\tInstall Custom Code<\/h3>\n

Install the BoxIntegration.class<\/span> custom code file by copying it to the following location in your ExtraView installation:<\/p>\n

<evj>\/WEB-INF\/classes\/com\/extraview\/usercustom\/ <\/span><\/p>\n

where <evj><\/span> is the directory where the ExtraView application is installed. (Note: You will need to create the directory tree if it doesn’t exist.) If you already have a custom code file for your installation, the source files must be merged and compiled. Contact ExtraView support for help with this step.<\/p>\n

Next, install the following files extracted from GetBoxAuthToken.zip<\/span> (into NEW_DIRECTORY\/lib above), to the <evj>\/WEB-INF\/lib\/<\/span> directory of your ExtraView installation.<\/p>\n

\tcommons-logging-1.1.1.jar
\n\thttpclient-4.1.3.jar
\n\thttpcore-4.1.4.jar <\/span><\/p>\n

Lastly re-start the ExtraView web application in order for the integration to take effect.<\/p>\n","protected":false},"excerpt":{"rendered":"

The setup of the Box integration consists of the following steps. These steps can all be performed on the server where the ExtraView web application is installed, although the generation of the auth token step can be performed on any computer with Java installed. The installation and configuration steps need to be performed only once…<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24430,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24431","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nBox Integration Setup - Product Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Box Integration Setup - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"The setup of the Box integration consists of the following steps. These steps can all be performed on the server where the ExtraView web application is installed, although the generation of the auth token step can be performed on any computer with Java installed. The installation and configuration steps need to be performed only once...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-18T23:30:23+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/\",\"name\":\"Box Integration Setup - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-02-18T23:30:23+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Integration Guides\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Box Integration Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Box Integration Setup\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Box Integration Setup - Product Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/","og_locale":"en_US","og_type":"article","og_title":"Box Integration Setup - Product Documentation","og_description":"The setup of the Box integration consists of the following steps. These steps can all be performed on the server where the ExtraView web application is installed, although the generation of the auth token step can be performed on any computer with Java installed. The installation and configuration steps need to be performed only once...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/","og_site_name":"Product Documentation","article_modified_time":"2025-02-18T23:30:23+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/","name":"Box Integration Setup - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-02-18T23:30:23+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/box-integration-setup-1\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Integration Guides","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/"},{"@type":"ListItem","position":4,"name":"Box Integration Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/box-integration-guide-1\/"},{"@type":"ListItem","position":5,"name":"Box Integration Setup"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24431"}],"version-history":[{"count":0,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24431\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24430"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}