3.1.4.65 GetLobSystemInstanceById

  • Article

The GetLobSystemInstanceById operation retrieves the LobSystemInstance with the specified MetadataObjectId.

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

 <wsdl:operation name="GetLobSystemInstanceById" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceById" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdResponse" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdBdcExceptionStateFault" name="BdcExceptionStateFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_BdcExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdInvalidOperationExceptionFault" name="InvalidOperationExceptionFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_InvalidOperationExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://www.microsoft.com/Office/2009/BusinessDataCatalog/BusinessDataCatalogSharedService/GetLobSystemInstanceByIdMetadataExceptionStateFault" name="MetadataExceptionStateFault" message="tns:BusinessDataCatalogSharedService_GetLobSystemInstanceById_MetadataExceptionStateFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends a BusinessDataCatalogSharedService_GetLobSystemInstanceById_InputMessage request message, and the protocol server MUST respond with a BusinessDataCatalogSharedService_GetLobSystemInstanceById_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 security principal in whose context the protocol client is operating is not authorized to modify the LobSystemInstance with the specified MetadataObjectId, and the CameThroughRemoteAdminService header specified in section 3.1 is present in the SOAP request.

AccessDeniedExceptionState (from namespace

http://schemas.datacontract.org/2004/07/Microsoft.BusinessData.Infrastructure)

The specified LobSystemInstance does not exist , and the CameThroughRemoteAdminService header specified in section 3.1 is present in the SOAP request, and the performErrorCheck element  in the request is set to "False".

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

The specified MetadataObjectId is set to zero ("0").

MetadataObjectNotFoundExceptionState (from namespace Microsoft.SharePoint.BusinessData)

A LobSystemInstance with the specified MetadataObjectId does not exist in the partition of the protocol client, and the value of the performErrorCheck element is set to "true".