Please enable JavaScript to view this site.

Vernon CMS Help

Purpose/Function

The AU_USER_SYM_EXPLODE subroutine changes the way hierarchical authority terms display. You can expand a hierarchy so that each term starts on a new line.

For example, if you are reporting on Address Place in the Person file, you could have the address Melbourne/Victoria/Australia display in your report as:

Melbourne

Victoria

Australia

You can also include or exclude related terms a certain level away from the current term, e.g. exclude all Broader terms more than one level away from the current term. In this case, Melbourne/Victoria/Australia would become:

Melbourne

Victoria

This subroutine is useful for producing address labels in Word Merge.

Argument syntax and parameters

auth.field!auth.mv!auth.file!explode.settings

auth.field

Required

Internal field name or FMC (Field Mark Count) of field to extract authority terms from.

auth.mv

Optional

For multi-value authority fields, set to 0 to only process the first authority term, 1 to process all terms (default) or F to find first relevant data.

auth.file

Required

System ID of the authority file that controls the auth.field field.

explode.settings

Required

B$1 will display the current term and Broader terms one level away. F$1,N will display the current term, Used For terms one level away and all Narrower terms. Common codes are: B (Broader), N (Narrower), U (Use Instead), F (Used For), R (Related) and T (Translation).

Parts of the argument are delimited by an exclamation mark.

Example:

ADDRESS_PLACE!!PLACE!B$1

This will extract all Place terms from the Address Place field in the Person file. For each Place entered, it will display the current term and Broader terms one level away, e.g. Melbourne/Victoria/Australia will become:

Melbourne

Victoria

Apply the conversion [AU_CONV,PLACE*AU_SHORT_NAME_OR] to display the Short Name of the Place term, e.g. Victoria will become VIC. This relies on data being entered in the Short Name field.