admin.forestSetEnabled

admin.forestSetEnabled(
   config as element(configuration),
   forest-id as (Number|String),
   value as Boolean
) as element(configuration)

Summary

This function sets the enabled state for a forest configuration.

Parameters
config	A configuration specification, typically as returned from one of the Admin module functions.
forest-id	The ID of the forest. For example, `xdmp:forest("myForest")` specifies the ID for a forest named "myForest".
value	The new state of the forest, for example `fn:true()` for enabled, `fn:false()` for disabled.

Required Privileges

This operation requires at least one of the following privileges:

http://marklogic.com/xdmp/privileges/admin/database

http://marklogic.com/xdmp/privileges/admin/database/{id}

http://marklogic.com/xdmp/privileges/admin/forest

http://marklogic.com/xdmp/privileges/admin/forest/{id}

Example

  
  const admin = require('/MarkLogic/admin.xqy');
  var config = admin.getConfiguration()
  admin.forestSetEnabled(config, admin.forestGetId(config, "Documents"),
      fn.false())
  => sets the forest named "Documents" to the disabled state.
     Use admin.saveConfiguration to save the changes to the configuration
     or pass the configuration to other Admin API functions to make other changes.