11 Installing and Configuring Help Locally

After installing Oracle Smart View for Office, the online help is retrieved from a URL hosted on the Oracle.com web site. This is the default behavior for Smart View, and no changes are required by users to launch help.

However, you may require that the help be installed locally for Section 508 accessibility purposes. To accommodate this, help must be downloaded from My Oracle Support and placed on a local drive, and the Smart View properties.xml file must be modified..

To install and configure Smart View help locally:

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

  2. Extract the contents of the patch zip file to a local folder on the computer where Smart View is installed.

    For example, extract the contents locally to:

    C:\Oracle\SmartView\

    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 View properties.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, providing 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 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>

  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.