Discuss this help topic in SecureBlackbox Forum

WebDAV: Download group of vCards

You can search for vCards in remote address books using CARDDAV:addressbook-query report defined in RFC 6352. AddressBookQueryFirst(), AddressBookQueryNext(), AddressBookQueryClose() methods of TElWebDAVClient class are used to request and process such reports.

First of all you should call TElWebDAVClient.AddressBookQueryFirst() method to perform the request and get the property values for the first vCard from a search result. The method accepts several parameters:

• URL - address book URL;
• Properties - a set of DAV properties to return for downloaded vCards;
• AddressDataProps - a set of vCard properties to read for each found vCard;
• Filter - filter object that defines a search criteria;
• Limit - allows to limit a number of found vCards in the response. Should be set to zero if no limit is applied;
• All - should be set to true to create "allprop" request;
• Depth - request depth.
The method returns the request handle via its Ctx parameter. The returned handle should be passed to subsequent AddressBookQueryNext() method calls. AddressBookQueryNext() should be called until it returns false. Each call returns values for requested properties for a single vCard. After all results are processed AddressBookQueryClose() should be called to free allocated resources.

vCard body can be retrieved via CARDDAV:address-data property on each report processing iteration.

How To articles about WebDAV client

Discuss this help topic in SecureBlackbox Forum