This is candidate release 2.4.0.6 of the Personal Rendering Engine, or simply "the Renderer". To use this release you should be familiar with using Command Prompts and zip files.
The personal renderer must be invoked from a Command Prompt (or a .bat file); it will not operate by simply double clicking on the ReportBuilderRenderer.exe.
The renderer produces HTML and other files identical to the corresponding version of the rendering engine as installed at the SEC's EDGAR web site and Interactive Data previewer (https://datapreview.sec.gov/previewer/). Therefore, you can use it on your own machine to fine-tune your rendered output, without relying on the SEC interactive data previewer.
The files produced include:
Note that the renderer is not a validator and does not test for EDGAR Filer Manual, nor for XBRL 2.1 Validity. Input files that are not valid with respect to the EDGAR Filer Manual may fail or produce poor results. It is highly recommended that before any "live" submission that you validate your XBRL files. You can validate your XBRL files here: (https://www.edgarfiling.sec.gov).
This section gives step by step instructions on how to install and run the Renderer. Since it is impossible to encompass all scenarios we have made the following assumptions in our example:
From the start menu, Run a Command Prompt (Start > Run > cmd.exe).
Execute the following commands:
OR
Hint: In the command prompt, type the first few characters of a long name followed by the "tab" key to complete the rest.
After running either set of the commands above, a new folder with the results will be created at the following location: "C:\myXBRL\Reports". You may view the files in a browser by the following Command Prompt commands (for example the R1.htm file):
Alternatively you can launch a browser and open the file, or double click on the filename in Windows Explorer.
You use the renderer interactively at a command prompt. If you run the program without any arguments:
ReportBuilderRenderer.exe
You will see the following message with details of other ways to use the program:
The syntax of this command is:
ReportBuilderRenderer.exe /Instance="[drive:][path]instance.xml" [/Instance="[drive:][path]i
nstance.xml"] [...]
- or -
ReportBuilderRenderer.exe /Instance="[drive:][path]package.zip" [/Instance="[drive:][path]pa
ckage.zip"] [...]
Optional parameters:
Set the base output path:
/ReportsFolder=[drive:][path\to\]folder
Set the report output format(s):
/ReportFormat=(Xml|Html|HtmlAndXml)
If format contains Html, set the html format:
/HtmlReportFormat=(Complete|Fragment)
Set the caching policy of remote files:
Value descriptions can be found at 'http://msdn.microsoft.com/en-us/library/system.net.cache.request
cachelevel.aspx'
/RemoteFileCachePolicy=(Default|BypassCache|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoC
acheNoStore)
Set quiet mode, the application will not interact with the user:
/Quiet
Set the output format for all filings in this session:
/SaveAs=(Xml|Zip)
Example: assuming that the XBRL instance you want to render is in folder C:\myXBRL and the filename is my-20111231.xml. In the Command Prompt (with the Renderer as the current folder) the command
ReportBuilderRenderer /Instance="C:\myXBRL\my-20111231.xml"
will create a C:\myXBRL\Reports folder with the rendered result.
The folder "Examples" contains ten examples, each in its own sub folder. It is recommended that you run/view these files before processing your own XBRL files in the renderer in order to become comfortable with the renderer and to view the new features of the rendering engine. Additionally they illustrate some of the new features of this new release including the information, warning and error messages.
There is a ".bat" file for each folder that illustrates how the renderer is invoked from the command line prompt. To view these examples do the following:
or
Note that if there are already files in the destination "Reports" folder, the renderer will ask you whether you want to overwrite them. Answer "y" to the prompt. To run without such interruptions, delete the "Reports" folder before rendering.
The examples should help you become comfortable with the renderer. For example:
The examples also illustrate new features of the rendering engine:
Finally, the examples illustrate some of the information, warning and error messages that may appear in the <Logs> portion of output file FilingSummary.xml, but not displayed to end users:
Instead of passing many arguments on the command line, edit the file
ReportBuilderRenderer.exe.config
to set the argument defaults. Note that the config file MUST be in the same folder as where you extracted the renderer.
The file TaxonomyAddonManager.xml and the folder Taxonomy do not contain a full copy of all EDGAR taxonomies, only their "documentation" and "reference" files; these files are referenced by the pop-ups in the output HTML.
The "Xml" format of the output appears on the EDGAR web site for older filings but will be phased out in favor of the HTML output produced by the renderer.
The source code of the renderer is available from the same web site where this was posted.
For additional information contact EDGAR Filer Support by phone or Contact RiskFin form.
The message "Error Parsing the Taxonomy" often means that the renderer is unable to get a file it needs from the Internet. There may be nothing wrong with your filing. Try typing the URL of the file it cannot find into your browser's address bar. If, for example, you cannot reach
http://www.xbrl.org/dtr/type/numeric-2009-12-16.xsd
from your browser, then the renderer cannot reach it either.
Many rendering issues can arise because the input files are not compliant with the EDGAR Filer Manual. If you run into rendering problems and have trouble interpreting the Log messages, try validating the input first and correcting any errors before trying again.
The date format of the output and thousands separators are determined by Windows locale settings on the machine where the renderer runs. The SEC previewer and EDGAR Viewer use the US locale. Your machine must be set to the US locale to produce correct results.
Avoid including images among the input having names such as "barchart1.jpg", "BarChart2.jpg" or variations thereof.
If you notice other discrepancies between your renderer and the SEC previewer, be sure to check that the version numbers agree. The version number appears at the top of every FilingSummary.xml file. You can also see the version of your renderer without needing to run a test file, by right-clicking on ReportBuilderRenderer.exe and looking for the details tab. There is no personal renderer for versions prior to 2.3.0.11.