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 also possible to use XLSX (SAF format http://dev.aef.guide/ ) file to make the modification. The XLSX file must be created by exporting the modified ESA project, meaning it has the corresponding IDs to the ESA project.
For detailed documentation, see the output when you run "esa_xml.exe" in command line.
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 a) Document; b) Engineering Report 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
| /sd | Engineering Report is used for export of output instead of old Document |
| /t |
output file type
Engineering Report HTML = Engineering report output file format HTML RTF = Engineering report output file format RTF TST = Engineering report output file format TST PDF = Engineering report output file format PDF DDS = Engineering report output file format DDS XLSX = Engineering report output file format XLSX REGEN = Regenerate Engineering report(s), saves project with regenerated ER, output file format ESA
Old document HTML = document output file format HTML RTF = document output file format RTF TXT = document output file format TXT TST = document output file format TST PDF = document output file format PDF
output file type (XML I/O): XML 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 or Engineering Reportfrom which the output is performed |
| without /sd switch: if not stated, the current Document is used | |
| with /sd switch: must be stated so that program knows which Engineering Report should be exported | |
| /m | name of output XML format, if not stated, the current one is used |
Example for single output
ESA_XML LIN E:\mydir\test.esa E:\mydir\test.xml /tHTML /oD:\listr\test.htm /xD:\listr\test.xml
ESA_XML LIN E:\mydir\test.esa E:\mydir\test.xml -sd /tTST /oE:\mydir\ESAOUT_er.TXT /lE:\mydir\log_er.txt
ESA_XML NON E:\mydir\test.esa E:\mydir\test.xml -tXML -oE:\mydir\ESAOUT_XML.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
ESA_XML LIN E:\mydir\test.esa E:\mydir\test.xml -sd /tPDF /o#E:\mydir\ESAOUT_batch_er1.PDF,E:\mydir\ESAOUT_batch_er2.PDF,E:\mydir\ESAOUT_batch_er3.PDF /d#Report_1,Report_2,Report_3 /lE:\mydir\log_er.txt