DITA-FMx User Guide

LoadReferences

Updates the references in the specified or current file.

Use this function to update all references (xrefs, links, conrefs, and image references) in the specified file. Call this function using the “LoadReferences” parameter to update the active document, or pass the docIdOrName value (as a string) after this parameter to update a specific document.

Syntax

F_ApiCallClient("ditafmx", "LoadReferences[|docIdOrName]");
docIdOrName
The id or path and file name of the document to process. The document must be open. You must use double backslashes as the directory delimiter when specifying the document file name. Optional; if not provided the “active” document is used.
Note: This DITA-FMx API function is only available when the “FMx-Auto” addon is installed. For information on this DITA-FMx addon, please contact Leximation.

Return Value

0
Failure. Unable to update the specified document. It is also possible that DITA-FMx is not available for calls. Verify that DITA-FMx is registered in the maker.ini file using the client name of “ditafmx”.
-1
Failure. Invalid docIdOrName.
-2
Failure. document is not a DITA file.
>0
Successfully updated the specified document (this is the value of the docId processed).