Altova RaptorXML+XBRL Server 2024

The xqueryupdate command takes an XQuery or XQuery Update file as its single argument and executes it. If an optional input XML file is specified, then this XML file is processed with the XQuery Update commands submitted in the XQuery(Update)-File. In this case, the updates can be applied directly to the input file or the updated XML data can be written to an output XML file. The input and output files are specified as options. If the XQuery(Update)-File contains only XQuery instructions and no XQuery Update instructions, then the command carries out a straightforward XQuery execution.


raptorxmlxbrl xqueryupdate [options] XQuery(Update)-File


The argument XQuery(Update)-File is the path and name of the XQuery file (.xq) or XQuery Update (.xqu) file to be executed. If the file contains XQuery Update instructions, then these are executed on the input XML file. Otherwise, the command works as an XQuery execution command.

You can specify whether XQuery Update 1.0 or 3.0 should be used. By default XQuery Update 3.0 is used.



Examples of the xqueryupdate command:


raptorxmlxbrl xqueryupdate --output=c:\Output.xml c:\TestQuery.xq (Writes the output of the XQuery file to the output file.)

raptorxmlxbrl xqueryupdate --input=c:\Input.xml --output=c:\Output.xml --updated-xml=asmainresult c:\UpdateFile.xqu (Updates Input.xml using the update instructions in UpdateFile.xqu, and writes the update to Output.xml.)

raptorxmlxbrl xqueryupdate --input=c:\Input.xml --output=c:\Output.xml --updated-xml=writeback c:\UpdateFile.xq (Updates Input.xml using the update instructions in UpdateFile.xq.  The file Output.xml is not created.)

raptorxmlxbrl xqueryupdate --input=c:\Input.xml --output=c:\Output.xml --updated-xml=discard c:\TestQuery.xqu (Updates are discarded. The input file is not modified. The file Output.xml will be created, but will not contain any updated XML.)

raptorxmlxbrl xqueryupdate --input=c:\Input.xml --output=c:\Output.xml c:\TestQuery.xqu (Updates are discarded as in the previous example. This is because the default value of the --updated-xml option is discard.)




Options are listed in short form (if available) and long form. You can use one or two dashes for both short and long forms. An option may or may not take a value. If it takes a value, it is written like this: --option=value. Values can be specified without quotes except in two cases: (i) when the value string contains spaces, or (ii) when explicitly stated in the description of the option that quotes are required. If an option takes a Boolean value and no value is specified, then the option's default value is TRUE. Use the --h, --help option to display information about the command.




© 2017-2023 Altova GmbH