Share via

2.2.2.7.12 linkedPICContacts

  • Article

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.