HLPF0010 - Maintain System Help Control Details

Purpose

To create and maintain the Base URL addresses for the Online User documentation

Subsystem Help
Normally Run By Systems Specialist
Anticipated Frequency

As required

Structure Block System Help Control

 

The online User Manual is displayed as 'Web' pages viewed using a web browser. A web page equates to a file that may be located on the user's desktop computer, on a networked file server, or on a web server. The User Manual consists of thousands of these files. Each file has a unique physical location, known as its URL (Uniform Resource Locator). This form, together with the Maintain Online Help URL Details form (HLPF0020), is used to record the URLs that are accessed when buttons are selected in the Field Help form. This is explained in the Online User Documentation Facility - Introduction.

Some URLs are divided into two parts: a Base URL and a Detail URL. This is done to facilitate the portability of the online manual. The Detail URL specifies the location of a file within the manual's filing system. The Base URL specifies a common directory pathway to which all the Detail URLs are linked. The Maintain System Help Control Details form is used to maintain Base URL's. Detail URLs are maintained using the Maintain Online Help URL Details form - (HLPF0020).

For example, the location of this page of the User Manual when mounted on a user's desktop computer might be: c:/ausis/help/html/hlpf0010.htm. All the files comprising the User Manual reside in the sub-directory help/, therefore c:/ausis/ will be common to all the files and can be defined as the Base URL. If the files comprising the User Manual were to be transferred onto a fileserver at Callista University, the directory help/ and its entire contents could be moved to a directory on the file server such as servername.its.callista.edu.au/directory1/…/directoryn/. This path could then be specified as the Base URL and this page would have a URL of servername.its.callista.edu.au/directory1/…/directoryn/help/html/hlpf0010.htm. Changing the Base URL will have made all of the files of the User Manual accessible from the System's Help form.

 

The System Help Control block contains:

  • Base URL
  • Oracle Web Server Enabled check box
  • TOC URL
  • Index URL
  • Link #1 Button Label
  • Base URL
  • Link #2 Button Label
  • Base URL
  • Link #3 Button Label
  • Base URL

Rules/Notes:

 

To set up the Base URL data for the Field Help form buttons using the Maintain System Help Control Details form:
  • Determine the content of the Base URL. (In most cases this will be a directory path specifying the location of the help/ directory.)
  • Enter the Base URL for context sensitive manual entries in the Base URL field.
  • Enter the full directory/file path for the Table of Contents 'page' in the TOC URL field. (This is currently "Base URL/help/html/tocframe.htm")
  • Enter the full directory/file path for the Index 'page' in the Index URL field. (This is currently "Base URL/help/html/indframe.htm")
  • Enter the text to be displayed as the label of the fourth user-defined button of the Field Help form, in the Link #1 Button Label field. (optional.)
  • Enter the Base URL for any institution-specific web files to be accessed via the fourth button, in the Base URL field directly below the button label field. (optional.)
  • Where required, repeat steps 5. and 6. for the fifth and sixth buttons. (optional.)
  • Save.

Rules/Notes:

All of the files comprising the AUSIS User Manual are located in the subdirectory help/. When relocating the User Manual, help/ and all its contents should be relocated.

The first three buttons in the Field Help form have been allocated for specific purposes (context, Index and TOC). Buttons 4 to 6 can be used to invoke other types of files accessed via a web browser (eg. institution-defined policies, procedures etc.).

Navigation buttons not defined in this form will not be displayed in the Field Help form.

To delete Base URL data for a Field Help form button using the Maintain System Help Control Details form:
  • Select the data to be deleted.
  • Delete record.
  • Save.

Rules/Notes:

Deleting the Base URL of a button will cause that button to become inoperative in the Field Help form displayed for all fields within the system.

To modify a Base URL for a Field Help form button using the Maintain System Help Control Details form:

  • Select the data to be modified.
  • Modify the data as required.
  • Save.

 

 

 

Last Modified on 12 January, 2004