Installing and Configuring Help Locally or on a Web Server

  To install and configure Smart View help locally or on a web server:

1. Obtain the help zip file for this release from My Oracle Support.

2. Extract the contents of the help zip file to either a local folder on the computer where Smart View is installed or to a folder accessible by your users on an HTTP web server in your organization.

   For example:

   • Extract the contents locally to:

     C:\Oracle\SmartView\

     The extraction adds an additional folder named smartview_help. The result is:

     C:\Oracle\SmartView\smartview_help

   • Extract the contents to a web server:

     http://webServerHost:webServerPort/pathToHelpFiles

     The extractions adds smartview_help after pathToHelpFiles. The result is:

     http://webServerHost:webServerPort/pathToHelpFiles/smartview_help

   Under the smartview_help folder, there are 28 language folders; for example:

   C:\Oracle\SmartView
                  \smartview_help
                       \ar
                       \cs
                       \da
                       \de
                       \el
                       \en
                       \es
                       \fi
                       \fr
                       \fr_CA
                       \he
                       \hu
                       \it
                       \ja
                       \ko
                       \nl
                       \no
                       \pl
                       \pt
                       \pt_BR
                       \ro
                       \ru
                       \sk
                       \sv
                       \th
                       \tr
                       \zh_CN
                       \zh_TW
   
   

   The following language folders contain translated versions of the Smart View help:

                       \de
                       \es
                       \fr
                       \it
                       \ja
                       \ko
                       \nl
                       \pt_BR
                       \zh_CN
                       \zh_TW
   
   

   The remaining language folders contain the English version of the help. When you run Smart View in one of those languages (for example, Swedish) and you click a button for Help, the English help is displayed.

   Additionally, the English folder contains a copy of the help in PDF format, smartview_user.pdf.

3. Modify the helpurlcontext property in the Smart Viewproperties.xml file:

   1. In your Smart View installation, navigate to the SmartView\cfg folder.

   2. Make a backup copy of the original properties.xml file.

   3. Open properties.xml for editing.

   4. Modify the helpurlcontext property, providing the path to the folder that is parent to the language folders using the following syntax:

      • If installing locally, provide the path to the folder that is parent to the language folders using the following syntax:

        <helpurlcontext>file:///parent_language_folder_path/</helpurlcontext>

        Tip:	Use forward slashes in the syntax and ensure that you enter a final forward slash (/) after the parent language folder path that you provide.

        Using the example from step 2, after extracting the zip contents to C:\Oracle\SmartView, the smartview_help folder is the parent folder of the language folders. Thus, you would modify the parent_language_folder_path placeholder as follows:

        <helpurlcontext>file:///C:/Oracle/SmartView/smartview_help/</helpurlcontext>

      • If installing on a web server, provide the path to the folder that is parent to the language folders using the following syntax:

        <helpurlcontext>http://webServerHost:webServerPort/pathToHelpFiles/smartview_help/</helpurlcontext>

        Tip:	Use forward slashes in the syntax and ensure that you enter a final forward slash (/) after the parent language folder path that you provide.

        Using the example from step 2 and substituting user_documentation for pathToHelpFiles, after extracting the zip contents to http://abcxyzco.com:12345/user_documentation, the smartview_help folder is the parent folder of the language folders. For example:

        <helpurlcontext>http://abcxyzco.com:12345/user_documentation/smartview_help/</helpurlcontext>

4. Restart your Microsoft Office applications and access the help from the Smart View ribbon.

5. Repeat this procedure for each computer that requires Smart View local help.