ExtendScript of the Week: Generate List of Referenced Graphics and Update Their New Paths
As part of the series ‘ExtendScript of the week’, we are providing an ExtendScript to generate a list of referenced graphics in a FrameMaker book. The list will also show the status that whether the referred graphic is resolved or not. After the list has been generated, you can modify the paths of the referenced graphics in the table and the table can be imported back to the book.This will help fixing any unresolved referenced graphic at the book level.
Download the zip file from ImportExport.
About the Script
- It contains 3 scripts, menu.jsx which loads the menu items and calls functions to handle the workflow, importExport.jsx which is used to import/export list of referenced graphics and utils.jsx that has several utility functions. It also contains a template document, BookReportTemplate, which is used for dumping report of referenced graphics.
- The script works on FM/MIF, nested books and its components as well as on the hierarchical components.
- Any XML file, dita or map which is a part of the book is left untouched.
- The import functionality traverses through the book, opens the book component file silently and extracts the referenced graphics information. File is then closed silently without saving. A book report (table) containing a list of all referenced graphics in the book is generated.
- The export functionality traverses the report document to locate a table and name of the source book. The information of each referenced graphic is extracted from the table and the information is updated in the document (in source book) if required. Any document not found in the scope of the source book is left as is. Also, the modified documents in this process will not be closed/saved but will be left open visibly in FrameMaker and user can have a look at the console window for the list of changes made.
Steps to use the Script
- Unzip the contents of the attached .zip file to the FrameMaker startup folder
- Launch FrameMaker
- For export functionality, open any book for which you want to generate list of referenced graphics report
- With focus on book, go to “File > Utilities > Export Referenced Graphics List”
- A FrameMaker document report containing the list of referenced will be generated
- For import functionality, modify the report generated from the export functionality to update any graphic paths
- With focus on the report document, go to “File > Utilities > Import Referenced Graphics List”
- An alert will come, asking for your confirmation. If you click Cancel, the operation will be aborted
- If you wish to continue by pressing OK, the script will run and update the documents (if required)
NOTE: Once you have downloaded and “installed” the script, open the file “BookReportTemplate” in FrameMaker and save it. You can also change the design of the template as you like (e.g. from portrait to landscape, default font, colors etc.) to get reports that fit to your needs.
Hope this simple automation will help to reduce your manual efforts and provide further insights into ExtendScript usage.
FrameMaker Engineering Team