3.1.4.9 CopyAclAcrossChildrenForSetting

This operation is used to clear the ACEs in a specified Setting on the descendent MetadataObjects of the specified MetadataObject, then copy the ACEs in the specified Setting on the specified MetadataObject to the descendent MetadataObjects. A given MetadataObject is a descendent of the specified MetadataObject if the MetadataObject that contains the given MetadataObject is also a descendent of the specified MetadataObject, or the MetadataObject is contained by the specified MetadataObject itself.

If the specified MetadataObject is a MetadataCatalog, the protocol server MUST NOT change the ACEs of any LobSystem and their descendent MetadataObjects if the security principal (2) in whose context the protocol client is operating is not authorized to edit the LobSystem.

The following is the WSDL port type specification of the CopyAclAcrossChildrenForSetting WSDL operation.

 <wsdl:operation name="CopyAclAcrossChildrenForSetting" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSetting" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingResponse" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingBdcExceptionStateFault" name="BdcExceptionStateFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_BdcExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingInvalidOperationExceptionFault" name="InvalidOperationExceptionFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_InvalidOperationExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/CopyAclAcrossChildrenForSettingMetadataExceptionStateFault" name="MetadataExceptionStateFault" message="tns:BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_MetadataExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends a BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_InputMessage request message, and the protocol server MUST respond with a BusinessDataCatalogSharedService_CopyAclAcrossChildrenForSetting_OutputMessage response message, unless any one of the conditions in the following table is met.

If any one of the conditions in the following table is met, the protocol server MUST instead respond  with a SOAP fault containing the corresponding error complex type, serialized as specified in Complex Types (section 2.2.4). If more than one error condition is encountered, the protocol server MUST respond with exactly one error complex type, determined in an implementation-specific manner.

Error Complex Type

Condition

AccessDeniedExceptionState (section 2.2.4.3)

The security principal (2) in whose context the protocol client is operating is not authorized to set permissions on the specified MetadataObject.

ArgumentOutOfRangeException (section 2.2.4.9)

The MetadataObjectId of the specified MetadataObject is 0.

MetadataObjectNotFoundExceptionState (section 2.2.4.43)

The specified MetadataObject does not exist.