xdmp.setTransactionMode

xdmp.settransactionmodexdmpsettransactionmode

/apidoc/8.0/xdmp:set-transaction-mode.xml

Set the transaction mode for the current session. Calling this function has no effect on existing transactions.

The new transaction mode. Must be one of "auto", "query", "update", or "update-auto-commit".

value

String

null

The mode a transaction runs under is fixed when the transaction is created. Calling xdmp:set-transaction-mode during a query does not affect the current transaction.

The transaction mode defaults to "auto". To change the mode, you may either call xdmp:set-transaction-mode or use the xdmp:transaction-mode option.

Use the xdmp:transaction-mode option to set the transaction mode before a transaction exists. Use xdmp:set-transaction-mode to set the mode during execution.

//  this transaction runs in update mode, due to the declaration
xdmp.eval('declareUpdate({explicitCommit: true}); \n\
xdmp.setTransactionMode("query"); \n\
xdmp.documentInsert("/docs/mydoc.json", {"myData": "data"}); \n\
xdmp.commit();');

// but this new transaction runs in query mode 
xdmp.eval('var res = []; \n\
res.push(xdmp.getTransactionMode()); \n\
res.push(cts.doc("/docs/mydoc.json")); \n\
res;');

=> ["query",{"myData":"data"}]