Chains are a great way in 12d Model to automate and speed-up repetitive tasks and can also be used to standardise processes. I’ve espoused some of their many benefits in my previous post, Introduction to Chains, so please read that if you’re not aware of what they are or how much they can improve your efficiency in 12d.
However, with greater use of and complexity in chains, users often would like a way to view all the information about a chain. There is no current inbuilt way to produce a report for chains with such information, so I’ve created one.
Since the newer chains- from V10 onwards, with the .chain extension- are XML-based and all information of the chain is contained in that XML, it is possible to write an XSLT and extract and transform the information from that into a report for chains.
So, enough with the preamble, you just want to get your hands on it and run it, don’t you? 🙂
Here’s how you can download and use this report for chains:
- Download the XSLTs (both or either) at the bottom of this post.
- Save them to one of the standard 12d search locations. I’d recommend either the User Library or Customer Library locations.
- To produce a report, from within 12d Model, go to
A screenshot showing a blank panel of the XML Translate option in 12d Model (Report→Utilities→Xml Translate).
. - For the Xml file field, you’ll need to Browse for the chain, since the field defaults to listing .xml files and not .chain files (you can also type *.chain in the field and hit enter to get a list of files in the current working directory).
- For the Translation file field, select either of the XSLTs you downloaded in Step 1.
- For the Report type field, I’d recommend choosing htm for the HTML report template and csv for the CSV report template (seems logical enough).
- For the Output file field, type in any new file name you’d like for your chain report.
- Once all that’s done, click the Report button and wait until it’s finished.
An example of a filled-out Xml Translate panel for reporting of chains. - The default program for the HTML and CSV report types (e.g. web browser and MS Excel, respectively) should open the file automatically, once completed.
Screenshot showing an example report for chains in CSV format viewed in Microsoft Excel. Screenshot showing an example report for chains in HTML format viewed in a web browser.
That’s all there is to it. A few points to mention about these:
- Not all information from the chain is reported, just the most important fields.
- There are some settings that you can change to alter the appearance of these reports. Open up the XSLT files in a text editor and read through the comments.
- This doesn’t do any recursion (i.e. processing chains called from chains). It also doesn’t work on parameter files (PVFs) (though, you could easily create a similar template for those, too).
You can also generate the report for chains from the command line or batch file by passing the required parameters directly to the XmlTransform.exe shipped with 12d Model. I won’t discuss how to do so here, but if you’re interested, let me know in the comments and I’ll give you more info.