Extracts conref and conref range targets into the FISHFRAGMENTLINKS and FISHLINKS metadata fields.
Plugin Configuration
The following workset fields need to be configured:
| Field Name | Field Level |
|---|
| FISHLINKS | lng |
| FISHFRAGMENTLINKS | lng |
The following parameters can be configured:
| Parameter | Required | Default value | Allowed values | Description |
|---|
| ExtractXPath | Yes | | | XPath query syntax used to search and retrieve the information from within the supplied XML document. |
| MetadataUpperCase | No | Yes | Yes, No | Convert the retrieved value(s) into uppercase characters before storing them in the repository. |
| DocumentUpperCase | No | Yes | Yes, No | Convert the retrieved value(s) into uppercase characters and update the XML document appropriately. |
| FragmentlinkSeparator | No | # | | Fragment link separator character for conrefs. |
| ObjectRefRegExp | No | [^#]* | | Regular expression to extract object reference from the conref |
| TargetRefRegExp | No | [^#^/]*$ | | Regular expression to extract target reference from the conref |
Default plugin configuration
The following configuration updates the FISHWORDCOUNT metadata field with the word count.
<plugin name="ISHSYSFRAGMENTLINKSTOMETADATA" handler="BlobExtractDITAConrefs"
ishcondition="CurrentAction in ('Create', 'Update', 'Checkin') and (EDT='EDTXML')">
<description>Extract conref and conrefend into FISHFRAGMENTLINKS and FISHLINKS resulting in a mix of conref and conref ranges. E.g.: "LogicalIdB#Anchor1, LogicalIdA#Anchor3, LogicalIdB#Anchor1 LogicalIdB#Anchor3". Note the space as separator for a conref range.</description>
<workingset>
<ishfields>
<ishfield name="FISHLINKS" level="lng" />
<ishfield name="FISHFRAGMENTLINKS" level="lng" />
</ishfields>
</workingset>
<initialize>
<parameters>
<parameter name="MetadataUpperCase">Yes</parameter>
<parameter name="DocumentUpperCase">Yes</parameter>
<parameter name="ExtractXPath">
//*[@conref or @conrefend][not(ancestor-or-self::*[@varref])][not(ancestor::*[@conref])]
</parameter>
</parameters>
</initialize>
</plugin>
Remember: Every CD package holds the latest default plugin information in a file named \Websites\Author\EnterViaUI\Admin.XMLWriteObjPluginConfig.xml. Verify this file for the latest information.