The following chapter is available only in English.
Program ESA_XML
It is executable from another program, that is capable of using XML file to modify ESA project data and obtain outputs in various formats.
It is a command line program and is able to perform the following tasks.
- open the existing ESA project
- read the given XML format and use its data to override the project
- perform the given type of calculation
- regenerate the existing document in the ESA project and export it into the selected format (HTML,TXT,PDF,RTF,ESA). In case of several documents, one can specify the name of the document, otherwise the current document is used.
- regenerate the existing output XML format and use it to generate XML file. If there are more then one output formats in the project, it is possible to select the format by name.
Command line parameters:
1. calculation type (LIN, NEL, etc.)
If text CMD is input, it is possible to perform arbitrary number of actions within one run of the program.
The second parameter is the name of text file, where each line has the same syntax as the whole program and leads to opening of one file (sub-levels are not allowed in CMD).
2. input ESA project (file name including path)
3. input XML file (file name including path) – optional parameter
Switches – starting with ‘/’ or ‘-‘ character
| /t | output file type: TXT, HTML, PDF, RTF |
| if not stated, the output file type is set to ESA | |
| /l | log file name |
| /o | output file name, the extension must be specified by used according to the selected output file type |
| if not stated, no output is performed | |
| /x | name of output XML file |
| if not stated, no output is performed | |
| /d | name of document from which the output is performed, if not stated, the current document is used |
| /m | name of output XML format, if not stated, the current one is used |
Example
ESA_XML LIN E:\mydir\test.esa E:\mydir\test.xml /tHTML /oD:\listr\test.htm /xD:\listr\test.xml
Multiple output
If we want to make several outputs for one calculation, we have to use the following syntax for switches (o, x, d, m).
The first character after the switch sign must be ‘#’, which is followed by several correct texts separated by ‘,’ (comma) or ‘;’ (semicolon).
If sign ‘#’ is used, it must be present at both switches for output from document (o, d), or at both switches for output into XML (n, m).
Example: two XML outputs
ESA_XML LIN E:\mydir\test.esa E:\mydir\test.xml /x#D:\listr\test1.xml, D:\listr\test2.xml /m#F1,F2