Include Children PATCH Method Enhancement

This feature provides merge PATCH support for both parent and child objects in the same request.  Previously, a single PATCH request would not support updating both parent and child objects, a separate request for the parent and child objects were required.

The query parameter - includeChildren - will allow you to have your single PATCH requests include both the child resources and parent resources.  The includeChildren query parameter options are true or false.

In addition, the property - glog.fusion.cil.restapi.config.includeChildren - has been provided as a fallback for the PATCH method requests. Assuming that the request does not include the includeChildren query parameter, the current behavior will be retained, i.e., your PATCH operation will not affect child resources. When the property is set to true, the PATCH operation will be carried out on both parent and child resources in a single request.

This feature simplifies and reduces the number of patch requests required when updating both parent and child objects.

Steps to Enable

You will want to set the property - glog.fusion.cil.restapi.config.includeChildren - to true, to have your PATCH operations carried out on both parent and child resources in a single request. Navigate to Configuration and Administration > Property Management > Property Sets, to set the property. 

NOTE: Only the DBA.ADMIN user can access and use the Property Sets page.

Tips And Considerations

With the property - glog.fusion.cil.restapi.config.includeChildren - set to true, so that the PATCH method operates against both the parent and child objects in a single request, the query parameter - includeChildren - can be used for exception cases, where - for whatever reason, you do not want to have the PATCH method updating both the parent and child objects in a single requests.