4.5 GetURLSegment

In this scenario, there is a site addressed by the URL http://fabrikam on the protocol server. This site contains a list with name "Documents" that is identified by the following GUID.

 B59D96DA-59B5-48E9-842B-5F89EE514232

The Documents list contains a list item named "Customers" with the ID 1. The absolute URL of the list item is http://fabrikam/Lists/Documents/DispForm.aspx?ID=1. The following occurs:

1. The protocol client calls the GetURLSegments operation to obtain the following information:

   • The GUID of the list which contains the list item Customers.

   • The identifier of the list item customers.

2. The protocol client sends the following SOAP message to the protocol server to call GetURLSegments:

    <GetURLSegments xmlns="http://schemas.microsoft.com/sharepoint/soap/">
      <strURL>http://fabrikam/Lists/Documents/DispForm.aspx?ID=1</strURL>
    </GetURLSegments>
   

   The protocol client sends the HTTP POST to the protocol server: http://fabrikam. The POST URL is: /_vti_bin/Sitedata.asmx. The header specifies the following SOAP action:

    http://schemas.microsoft.com/sharepoint/soap/GetURLSegments
   

3. The protocol server sends the following SOAP message response:

    <GetURLSegmentsResponse xmlns="http://schemas.microsoft.com/sharepoint/soap/">
          <GetURLSegmentsResult>true</GetURLSegmentsResult>
          <strListID>{B59D96DA-59B5-48E9-842B-5F89EE514232}</strListID>
          <strItemID>1</strItemID>
    </GetURLSegmentsResponse>
   

   The response message contains the following:

   • The GUID of the list which contains the list item Customers.

   • The identifier of the list item customers.