2.2.2.7.12 linkedPICContacts
This section describes behaviors supported in versions described by endnote<28>.
The linkedPICContacts category instance contains the linked identities of the PIC contacts that represent the same presentity. The individual identities are received from the SIP Server in a NOTIFY response. The SIP protocol client replicates the data from the NOTIFY response into this category so that it can keep track of all the secondary identities for a given presentity. This category MUST be registered on the server as a private category.
The following example illustrates the format of a linkedPICContacts category instance.
-
<category name="linkedPICContacts" instance="0" publishTime="2015-01-27T21:39:25.927" container="1" version="57" expireType="static"> <LinkedPicContactList> <LinkedPicContactEntry primary-Identity="bob@hotmail.com"> <secondary-identities> <secondary-identity>bob@skypeids.net</secondary-identity> <secondary-identity>8d9a9d943984476c@skypecid.net</secondary-identity> </secondary-identities> </LinkedPicContactEntry> <LinkedPicContactEntry primary-Identity="alice@hotmail.com"> <secondary-identities> <secondary-identity>alice@skypeids.net</secondary-identity> <secondary-identity>445abd8439841238@skypecid.net</secondary-identity> </secondary-identities> </LinkedPicContactEntry> </LinkedPicContactList> </category>
Elements and attributes are defined as follows. For the full XML schema, see section 7.
The XML elements of a linkedPICContacts document MUST conform to the schema defined in section 7.10.
linkedPicContactList: A root element of the linkedPICContacts category instance. This element will contain a list of LinkedPicContactEntry elements.
LinkedPicContactEntry: A root element of an identity entry in the category.
The LinkedPicContactEntry element has the following attributes.
primary-Identity: A URL representing the primary identity on which this presentity should be contacted for all outgoing SIP Invites.
The LinkedPicContactEntry element contains the following child elements.
secondary-identities: A root element of the secondary identities that belong to the same presentity. This element will contain a list of secondary-identity elements as follows.
secondary-identity: A URL that belongs to the presentity represented in the primary-Identity attribute. This URL should receive the same permissions as the primary-Identity. Incoming SIP Invites may be received from these URL by the presentity represented in the primary-Identity attribute. This Incoming SIP Invite should be given the same permission level as that represented in the primary-Identity attribute.