Atomik Xport SE: Reference > Chapter 16 Automation << >>

16.2 Using a Watch Folder

Note: Watch Folders are available only in Atomik Xport Enterprise Edition.

Setting up the Watch Folder

To set up automated extraction using a Watch Folder, take the following steps:

1. First, if you have not already done so, set up your ruleset folder. All the rulesets (.rls files) that are to be used in your automated workflow should be stored in a single folder.

2. Point Atomik Xport to this folder. You can do this by choosing Atomik Xport/Preferences from the dropdown menu. In the preferences dialog, choose the path to the rulesets folder.

3. Next, set up your Watch Folder. The Watch Folder allows you to automatically extract XML from Quark documents based upon a chosen ruleset. The way that it does this is by having subfolders named after the rulesets.

So if you had three ruleset files named NewsArticle.rls, Editorial.rls and Reviews.rls in your rulesets folder, you would create a hierarchy of a root folder containing three subfolders as follows:

4. You can then set Atomik Xport to monitor the Watch Folder. Choose Atomik Xport/Watch Folder from the dropdown menu. A dialog will appear, asking you to choose the location of the folder to monitor.

5. Browse to the designated folder (e.g. “Watched_Folder” in the example above). Make sure you choose the root folder, not one of the subfolders.

Atomik Xport Enterprise Edition will now monitor the subfolders, checking them regularly for new QuarkXPress files. If it hasn’t monitored this folder before, it will automatically create “Done”, “XML” and “Proofing Logs” folders within each subfolder based on a ruleset:

The purposes of the three subfolders are given below:

Done: The QuarkXPress file is moved here when the extraction is complete.

Proofing Logs: A proofing file is generated during extraction listing any content from the QuarkXPress project which hasn’t been extracted. The listing includes the text and page number, as well as the reason for non-extraction. The proofing file is in a format that can be opened in a spreadsheet application for analysis.

XML: The extracted XML file is saved to this location, named after the original Quark project but with the .xml file extension.

Extracting XML using the Watch Folder

To automatically extract XML, you simply need to copy (or move) your Quark file to the subfolder that matches the ruleset you want to use for extraction. In the example above we would drop an album review document into the Reviews folder, triggering Atomik Xport to extract XML and save it to the XML subfolder.

Extracting web-friendly images using the Watch Folder

Web-friendly image extraction is a feature of Atomik Xport which is enabled in the Output tab of the Ruleset Editor, where all images displayed in a QuarkXPress layout are extracted in jpeg format at 72dpi (optimised for online-viewing) and saved to a subfolder of the extraction folder.

Extraction of web-friendly images is entirely compatible with the Watch Folder feature of Atomik Xport Enterprise Edition, which ensures:

• Images are given a unique name.

• If the required image folders do not exist, they are automatically generated.

• The imgName and imgPath attributes of each Image element will be updated to match the generated web-friendly image. The imgPath attribute will contain a relative path, which ensures that image links stay valid provided the images folder is moved along with the XML file.