Please enable JavaScript to view this site.

Vernon CMS Help

Purpose/Function

The AU_USER_SYM_HIERARCHY subroutine is for reporting on hierarchical authorities at a particular level, e.g. to report on Place at Nation level or to report on Classification at Species level. If no term is found at the specified level, the subroutine will continue up the hierarchy until a term is found. You set the limit for when it should stop looking.

Argument syntax and parameters

auth.fmc!auth.mv!auth.file!level.codes

auth.fmc

Required

FMC (Field Mark Count) of the 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.fmc field.

 

level.codes

Required

Go up the hierarchy until a term has one of these hierarchical levels. System IDs of hierarchical levels should be separated by '~', e.g. ID1~ID2~ID3. Leave blank to indicate only Top Terms are to be returned.

 

limit

Optional

Stop looking at this level, i.e. do not display terms at this level or above. Enter the system ID of the hierarchical level.

 

display.field

Optional

Conversion field, e.g. show AU_ASCENDING for the term found.

 

auth.conv.file

Optional

Additional default authority conversion, e.g. display.field may be AU_TAXONOMIC_LEVEL. Set auth.conv.file to CLASSIFICATION_TAX to convert the level to a name (CLASSIFICATION_TAX is the system ID of the Classification Level authority file).

 

level.count

Optional

Go up the hierarchy a maximum number of levels, e.g. 1 will just show the current term and its next higher term.

 

display.fld2

Optional

The second display field will be shown in brackets beside the first. If the field is authority controlled, then specify the conversion in display.fld2.conv.

Use this if you have a field in a foreign language for which you would like the translation to display in brackets next to the term, e.g. a product name in French with the English translation in brackets.

 

display.fld2.conv

Optional

Conversion for the second display field.

 

display.fld2.mv

Optional

If the second display field is multi-valued, set to 0 to only include the first term from display.fld2.

 

Parts of the argument are delimited by an exclamation mark.

Example:

56!!CLASSIFICATION!LIN.SPE~LIN.GEN~LIN.FAM!LIN.ORD

The above argument has been configured for the Classification field in the Object file. When reporting on natural science specimens, it will display the classification at Species level. If no species is entered, it will display the genus instead. If no Genus level term is entered, it will display the family. Terms at Order level and above will be ignored, i.e. if no species, genus or family is found, the symbolic result will be null.