Maintain Online Help URL Details - HLPF0020

Purpose To allow the creation and maintenance of the detail part of URL addresses for the on-line user documentation
Facility Help
Structure Two Blocks System Form

System Block

Image


System Form

Explanation
On-line user documentation is able to be accessed directly from the System. This is explained in the On-line User Documentation Facility - Introduction. The on-line user manual is displayed as individual 'Web' pages with each page equating to a file of information. The user manual consists of thousands of these files. Each file has a unique physical location, known as its URL (Uniform Resource Locator). .Some URLs are divided into two parts, a base URL and a detail URL. This is fully explained under Maintain System Help Control Details.

This form is used to maintain the detail URL part of each file's location. This facility provides the capability to target user documentation "in context". (ie. documentation relevant to the part of the System being used can be accessed automatically) This capability is maintained by linking the URL of the context documentation to the System form to which it relates. This can be further refined by linking the context URL to a block within a form. If both a form and block URL are specified, the block URL will take precedence.

All user manual context URLs are pre-defined as part of the on-line user manual facility. Provision is made for institutions to define context URLs for the three remaining configurable Field Help form navigation buttons (Link 1, Link 2 & Link 3). These can be used to access other web based user documentation.

Example
This form (HLPF0020) consists of two blocks (System Form and System Block). In this case, it is sufficient when using the form in the System, to have one set of explanatory documentation to describe the use of both the form and the individual blocks. In some forms (such as the Record Enrolments form (ENRF3000) which is displayed over many blocks and many screens), explanation is sufficiently involved to make the use of a separate "page" for each block a more efficient way to present user information. Use this form (HLPF0020) to query the URL details for System Form ENRF3000. The name of each block in ENRF3000 will be displayed. Select each block in turn to view the context URL for the block. Note that block URLs will override the displayed form URL.


To set up URL detail data for the Field Help form navigation buttons using the Maintain Online Help URL Details form:
  1. Determine whether context sensitivity should apply at the block or form level.
  2. Determine the content of the detail URL. (In most cases this will be a directory/file path specifying the location of an html file but with the base URL omitted)
  3. For context sensitivity at the form level:
    1. Enter the detail URL for context sensitive user manual entries in the Context URL field of the System Form block.
  4. For context sensitivity at the block level:
    1. Select the block for which the detail URL is to be recorded.
    2. Enter the detail URL for context sensitive user manual entries in the Context URL field of the System Block block.
  5. Carry out steps 3. and/or 4. for the Link 1, 2and/or 3 fields where applicable. (optional)
  6. Save.
Rules:
  • URL detail data is specific to, and must be recorded for, each System form.
  • Context URL refers to the URL accessed via the first navigation button of each Field Help form.
  • Link 1, Link 2 and Link 3 URL refer to the fourth, fifth and sixth navigation buttons of each Field Help form.
  • Navigation buttons not defined in this form will not be displayed in the Field Help form.
To delete detail URL data for a Field Help form navigation button using the Maintain Online Help URL Details form:
  1. Select the data to be deleted.
  2. Delete record.
  3. Save.
Rules:
  • Deleting the detail URL of a navigation button will cause that navigation button to become inoperative in the Field Help form displayed for all fields within the specified form or block.
To modify a detail URL for a Field Help form navigation button using the Maintain Online Help URL Details form:
  1. Select the data to be modified.
  2. Modify the data as required.
  3. Save.