# Table of contents:

Introduction
Client/Request
- FindDocuments
Server/Response
- FindDocumentsResponse
  - FindDocumentsResult
    - Document
Examples
- Schema version w10
  - Finding a Photo document
    - Client/Request
    - Server/Response

# Introduction

FindDocuments is one of the SOAP actions the Schematized Storage Service provides.

Find one or more documents.

# Client/Request

The template used in this action is described on the Schematized Storage Service main page.

# FindDocuments

This element has only one attribute:

xmlns: This is always set to http://www.msn.com/webservices/storage/, followed by the version of the schema.

This element has five children:

<objectHandle>: Described below.
<documentAttributes>: Described below.
<documentFilter>: Described below.
<documentSort>: Described below.
<findContext>: Described below.

# objectHandle

A resource handle.

# documentAttributes

This element has two children:

<ResourceID>: If set to true, include the <ResourceID> in the response.
<Name>: If set to true, include the <Name> in the response.

# documentFilter

This element has only one child:

<FilterAttributes>: Unknown. Observed to be None.

# documentSort

This element has only one child:

<SortBy>: The sorting method:
- DateModified: Sort by date modified.

# findContext

This element has two children:

FindMethod: The finding method. Unknown. Observed to be Default.
ChunkSize: The amount of results returned per chunk.

# Server/Response

The template used in this action is described on the Schematized Storage Service main page.

# FindDocumentsResponse

This element has only one attribute:

xmlns: This is always set to http://www.msn.com/webservices/storage/, followed by the version of the schema.

This element has only one child:

<FindDocumentsResult>: Described below.

# FindDocumentsResult

This element only contains one or more <Document> elements.

# Document

This element has only one attribute:

xsi:type: The type of this <Document>:
- Photo
- Binary

This element has two children and one optional child:

<ResourceID>: The resource ID of the document.
<Name>: The display name of the document.
<WhenTaken>: Optional. Only seen when xsi:type is Photo. Always set to 0001-01-01T00:00:00.

# Examples

# Schema version w10

# Finding a Photo document

# Client/Request

POST /storageservice/SchematizedStore.asmx HTTP/1.1
SOAPAction: http://www.msn.com/webservices/storage/w10/FindDocuments
Cache-Control: no-cache
Content-Type: text/xml; charset=utf-8
Content-Length: 1360

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
>
	<soap:Header>
		<StorageApplicationHeader xmlns="http://www.msn.com/webservices/storage/w10">
			<ApplicationID>Messenger Client 8.0</ApplicationID>
			<Scenario>RoamingIdentityChanged</Scenario>
		</StorageApplicationHeader>
		<StorageUserHeader xmlns="http://www.msn.com/webservices/storage/w10">
			<Puid>0</Puid>
			<TicketToken>t=ticket&amp;p=profile</TicketToken>
		</StorageUserHeader>
	</soap:Header>
	<soap:Body>
		<FindDocuments xmlns="http://www.msn.com/webservices/storage/w10">
			<objectHandle>
				<RelationshipName>/UserTiles</RelationshipName>
				<Alias>
					<Name>4294967298</Name>
					<NameSpace>MyCidStuff</NameSpace>
				</Alias>
			</objectHandle>
			<documentAttributes>
				<ResourceID>true</ResourceID>
				<Name>true</Name>
			</documentAttributes>
			<documentFilter>
				<FilterAttributes>None</FilterAttributes>
			</documentFilter>
			<documentSort>
				<SortBy>DateModified</SortBy>
			</documentSort>
			<findContext>
				<FindMethod>Default</FindMethod>
				<ChunkSize>25</ChunkSize>
			</findContext>
		</FindDocuments>
	</soap:Body>
</soap:Envelope>

# Server/Response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: 1011

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
	xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
	<soap:Header>
		<AffinityCacheHeader xmlns="http://www.msn.com/webservices/storage/w10">
			<CacheKey>MjAyNi0wMi0wOFQxMDoxODozNi43MDVa</CacheKey>
		</AffinityCacheHeader>
		<StorageUserHeader xmlns="http://www.msn.com/webservices/storage/w10">
			<Puid>0</Puid>
			<Cid>4294967298</Cid>
			<TicketToken>t=ticket&amp;p=profile</TicketToken>
			<IsAdmin>false</IsAdmin>
		</StorageUserHeader>
	</soap:Header>
	<soap:Body>
		<FindDocumentsResponse xmlns="http://www.msn.com/webservices/storage/w10">
			<FindDocumentsResult>
				<Document xsi:type="Photo">
					<ResourceID>cid_4294967298!documents!1</ResourceID>
					<Name>Example Static Image</Name>
					<WhenTaken>0001-01-01T00:00:00</WhenTaken>
				</Document>
			</FindDocumentsResult>
		</FindDocumentsResponse>
	</soap:Body>
</soap:Envelope>