- From: Richard Tibbett via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 30 Nov 2009 16:49:21 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/contacts
In directory hutz:/tmp/cvs-serv12719
Modified Files:
Overview.html
Log Message:
General updates to Contacts API:
- Initial Security and Policy Considerations section added.
- Use cases derived from BONDI and Nokia Contacts inputs added.
- add() method removed from Contacts interface (becomes commit() in Contact interface)
- remove() method removed from Contacts interface (becomes remove() in ContactResult interface)
- update() renamed to commit() in Contact interface.
- API usage examples updated.
- Contact interface now provides a constructor object for creating Contact objects.
- Contact interface attributes abstracted out to ContactProperties interface.
- ContactFilter removed (replaced by ContactProperties in find() methods).
- ContactError codes added.
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/contacts/Overview.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- Overview.html 11 Nov 2009 08:38:44 -0000 1.13
+++ Overview.html 30 Nov 2009 16:49:19 -0000 1.14
@@ -37,10 +37,6 @@
<p>
The Contacts API defines a high-level interface to Contacts information, such as names, addresses and other contact information. The API itself is agnostic of any underlying address book sources.
</p>
- <p>Multiple address books, taken
- from different sources, can be represented within this unified address book by specifying a consistent <code>productId</code>
- value as part of the resulting <a href="#contact-interface"><code>Contact</code></a> objects. In addition, multiple address books can be displayed by filtering
- on the required <code>productId</code> value in the resulting <a href="#contact-interface"><code>Contact</code></a> objects.</p>
<p>
The requirements for this set of interfaces are listed in the Device API Requirements
document [[DAP-REQS]].
@@ -54,177 +50,244 @@
[...1234 lines suppressed...]
<ul>
- <li><em title="must" class="rfc2119">must</em> enable listing all available address books on the device;</li>
- <li><em title="must" class="rfc2119">must</em> enable listing all contacts in the address book(s);</li>
- <li><em title="must" class="rfc2119">must</em> enable reading the details for a contact;</li>
- <li><em title="should" class="rfc2119">should</em> enable creating a new contact;</li>
- <li><em title="should" class="rfc2119">should</em> enable updating a contact;</li>
- <li><em title="should" class="rfc2119">should</em> enable deleting a contact;</li>
+ <li>The Contacts API <em title="must" class="rfc2119">must</em> enable listing all available address books on the device;</li>
+ <li>The Contacts API <em title="must" class="rfc2119">must</em> enable listing all contacts in the address book(s);</li>
+ <li>The Contacts API <em title="must" class="rfc2119">must</em> enable reading the details for a contact;</li>
+ <li>The Contacts API <em title="should" class="rfc2119">should</em> enable creating a new contact;</li>
+ <li>The Contacts API <em title="should" class="rfc2119">should</em> enable updating a contact;</li>
+ <li>The Contacts API <em title="should" class="rfc2119">should</em> enable deleting a contact;</li>
- <li><em title="should" class="rfc2119">should</em> enable filtering the list of contacts to search for a subset.</li>
+ <li>The Contacts API <em title="should" class="rfc2119">should</em> enable filtering the list of contacts to search for a subset.</li>
</ul>
Received on Monday, 30 November 2009 16:49:23 UTC