3.2.4.1 GetRepositoryElements

The GetRepositoryElements operation is used to query the scan repository for its configuration and/or status.

 <wsdl:operation name="GetRepositoryElements">
    <wsdl:input message="dsc:GetRepositoryElementsRequestMsg" 
       wsa:Action="http://schemas.microsoft.com/windows/2008/12/wdp/distributedscan/
       configuration/GetRepositoryElements"/>
    <wsdl:output message="dsc:GetRepositoryElementsResponseMsg" 
       wsa:Action="http://schemas.microsoft.com/windows/2008/12/wdp/distributedscan/
       configuration/GetRepositoryElementsResponse"/>
 </wsdl:operation>

Upon receiving a dsc:GetRepositoryElementsRequestMsg, the server MUST respond with an dsc:GetRepositoryElementsResponseMsg or a SOAP fault as follows:

• If the server cannot validate the arguments of the dsc:GetRepositoryElementsRequestMsg, the server MUST return a dsc:InvalidArgs SOAP fault.

• If the server encounters an unexpected error from which it can recover while processing the dsc:GetRepositoryElementsRequestMsg, the server MUST return a dsc:ServerErrorTemporaryError SOAP fault.

• If the server encounters an unexpected error from which it cannot recover while processing the dsc:GetRepositoryElementsRequestMsg, the server MUST return a dsc:ServerErrorInternalError SOAP fault depending on the severity of the unexpected error.

• If the server can successfully process the dsc:GetRepositoryElementsRequestMsg, the server MUST return a dsc:GetRepositoryElementsResponseMsg with the following requirements:

  • The dsc:GetRepositoryElementsResponseMsg MUST have one dsc:RepositoryElements child, which MUST contain as many dsc:ElementData children as there were dsc:Name children in the request message. The dsc:ElementData children MUST be in the same order as the dsc:Name children in the request message.

  • Each dsc:ElementData child corresponding to an dsc:Name child of the request's dsc:RequestedElements MUST have the following characteristics:

    • The attributes of the dsc:ElementData child MUST be set as follows:

      • The Name attribute MUST be set to the same value as the value of the corresponding dsc:Name element of the request.

      • If the requested element exists on the server, the Valid attribute MUST be set to "true", otherwise, if the requested element is not known by the server, the Valid attribute MUST be set to "false".<13>

      • Vendor-defined attributes MAY be added.

    • The contents of the element MUST be set as follows:

      • If the element is a configuration element, an dsc:RepositoryConfiguration child element MUST be added.

      • If the element is a status element, an dsc:RepositoryStatus element MUST be added.

      • Vendor-defined child elements MAY be added.