3.1.4.2 AddAssociationReferenceToAssociationGroup

This operation is used to create the specified AssociationReference in the specified AssociationGroup.

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

 <wsdl:operation name="AddAssociationReferenceToAssociationGroup" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroup" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupResponse" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupBdcExceptionStateFault" name="BdcExceptionStateFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_BdcExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupInvalidOperationExceptionFault" name="InvalidOperationExceptionFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_InvalidOperationExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/AddAssociationReferenceToAssociationGroupMetadataExceptionStateFault" name="MetadataExceptionStateFault" message="tns:BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_MetadataExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends a BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_InputMessage request message, and the protocol server MUST respond with a BusinessDataCatalogSharedService_AddAssociationReferenceToAssociationGroup_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 edit the specified AssociationGroup.

ConcurrentModificationExceptionState (section 2.2.4.27)

The specified AssociationGroup 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 AssociationGroup. For example, this error can be raised when one context reads the AssociationGroup,  another context updates the same AssociationGroup, and then the original context tries to update.

DuplicateMetadataObjectExceptionState (section 2.2.4.30)

Another AssociationReference in the specified AssociationGroup references the Association that is referenced by the specified AssociationReference.

ExceededMetadataobjectLimitExceptionState (section 2.2.4.32)

The specified AssociationGroup already contains the implementation-specific maximum number of AssociationReferences.

InvalidOperationException (section 2.2.4.38)

The operation cannot be performed because Entity containing the AssociationGroup is active.