Altova RaptorXML 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.


raptorxml 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:


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

raptorxml 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.)

raptorxml 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.)

raptorxml 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.)

raptorxml 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.




© 2018-2024 Altova GmbH