Readxml
(since EVL 1.3)
Parse XML <f_in>
into <evd>
.
In general not all input fields need to exist in the input XML, but if they are, then the option ‘--all-fields-exist’ will speed up the processing.
When the input XML has not the same order of fields as defined in <evd>
, then option
‘--match-fields’ has to be used.
Usually when reading XML file written by ‘Writexml’ it is good to call ‘Readxml’ with
option ‘-a’, as there are always all fields from <evd>
.
- Readxml
-
is to be used in EVS job structure definition file.
<f_out>
is either output file or flow name. - evl readxml
-
is intended for standalone usage, i.e. to be invoked from command line and and write to standard output.
EVD and EVS are EVL definition files, for details see evl-evd(5) and evl-evs(5).
Synopsis
Readxml <f_in> <f_out> (<evd>|-d <inline_evd>) [-a|--all-fields-exist] [-m|--match-fields] [--document-tag=<tag>] [--record-tag=<tag>] [--vector-element-tag=<tag>] [-y|--text-output] evl readxml (<evd>|-d <inline_evd>) [-a|--all-fields-exist] [-m|--match-fields] [--document-tag=<tag>] [--record-tag=<tag>] [--vector-element-tag=<tag>] [-y|--text-output] [-v|--verbose] evl readxml ( --help | --usage | --version )
Options
- -d, --data-definition=<inline_evd>
-
either this option or the file <evd> must be presented. Example: -d ’user_sum long’
- -a, --all-fields-exist
-
when the input contain all fields (e.g. output of evl-writexml), then using this option increase the performance
- -m, --match-fields
-
when field are not in the same order as used in evd, this option must be used
- --document-tag=<tag>
-
specify a tag name of the main tag, by default it tries to guess it. XML file should look like this:
<?xml version="1.0" encoding="UTF-8"?> <document> ... </document>
where the tag ‘document’ can be of any name.
- --record-tag=<tag>
-
specify a tag name of a record, by default it tries to guess it. XML file should look like this:
<?xml version="1.0" encoding="UTF-8"?> <document> <record> ... </record> <record> ... </record> <record> ... </record> ... </document>
where the tag ‘record’ can be of any name, but the same accross the file.
- --vector-element-tag=<tag>
-
the name of the tag for vector elements, e.g. XML file with vector ‘someVector’:
... <someVector> <elem>1</elem> <elem>2</elem> <elem>3</elem> </someVector> ...
shoul be read with option ‘--vector-element-tag=elem’.
- -y, --text-output
-
write the output as text, not binary
Standard options:
- --help
-
print this help and exit
- --usage
-
print short usage information and exit
- -v, --verbose
-
print to stderr info/debug messages of the component
- --version
-
print version and exit