Discuss this help topic in SecureBlackbox Forum

WebDAV: Download group of vCards

If you need to download the complete address book or many vCards at once, you can do this in one request using "CARDDAV:addressbook-multiget" report defined in RFC 6352. AddressBookMultigetFirst(), AddressBookMultigetNext(), AddressBookMultigetClose() methods of TElWebDAVClient class are used to request and process such reports.

First of all you should call TElWebDAVClient.AddressBookMultigetFirst() method to perform the request and get the property values for the first vCard from a report 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 downloaded vCard;
• Hrefs - a list of vCard URLs to download;
• 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 AddressBookMultigetNext() method calls. AddressBookMultigetNext() should be called until it returns false. Each call returns values for requested properties for a single vCard. After all results are processed AddressBookMultigetClose() 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