3.1.4.52 GetEntityWithNameAndNamespace

  • Article

The GetEntityWithNameAndNamespace operation retrieves the active Entity with the specified name and namespace in the specified partition.

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

 <wsdl:operation name="GetEntityWithNameAndNamespace" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespace" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceResponse" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceBdcExceptionStateFault" name="BdcExceptionStateFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_BdcExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceInvalidOperationExceptionFault" name="InvalidOperationExceptionFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_InvalidOperationExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetEntityWithNameAndNamespaceMetadataExceptionStateFault" name="MetadataExceptionStateFault" message="tns:BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_MetadataExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends a BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_InputMessage request message, and the protocol server MUST respond with a BusinessDataCatalogSharedService_GetEntityWithNameAndNamespace_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

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

The specified name or the specified namespace exceeds 255 characters.

MetadataObjectNotFoundExceptionState (from namespace Microsoft.SharePoint.BusinessData)

An active Entity with the specified namespace and name does not exist in the specified partition.