3.1.4.5 BulkSwitchActiveOrValidate

  • Article

The BulkSwitchActiveOrValidate operation changes the active version of the specified set of Entities or validates the specified Entities for the purpose of changing the active versions and identifying related errors.

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

 <wsdl:operation name="BulkSwitchActiveOrValidate" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidate" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateResponse" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateBdcExceptionStateFault" name="BdcExceptionStateFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_BdcExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateInvalidOperationExceptionFault" name="InvalidOperationExceptionFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_InvalidOperationExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidateMetadataExceptionStateFault" name="MetadataExceptionStateFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_MetadataExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/BulkSwitchActiveOrValidatePackageFormatExceptionStateFault" name="PackageFormatExceptionStateFault" message="tns:BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_PackageFormatExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends a BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_InputMessage request message, and the protocol server MUST respond with a BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_OutputMessage response message, unless any faults occur.

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 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 (from namespace http://schemas.datacontract.org/2004/07/Microsoft.BusinessData.Infrastructure)

The value of the validate element is set to "false", and the security principal in whose context the protocol client is operating is not authorized to modify the specified Entities.

ArgumentException (from namespace http://schemas.datacontract.org/2004/07/System)

The partition of the specified Model is different from the partition of any of the specified Entities.

ArgumentOutOfRangeException (from namespace http://schemas.datacontract.org/2004/07/System)

The entityStructs element in the BusinessDataCatalogSharedService_BulkSwitchActiveOrValidate_InputMessage has no elements.

ConcurrentModificationExceptionState (from namespace Microsoft.SharePoint.BusinessData)

At least one of the specified Entities has been updated by a context other than the one by which it is currently being read. This happens when the specified object version is not equal to the current object version of the Entity. For example, this error can be raised when one context reads the given Entity, after which another context updates the same Entity, and then the original context tries to update the same Entity.

MetadataObjectNotFoundExceptionState (from namespace Microsoft.SharePoint.BusinessData)

One or more of the specified Entities does not exist.