Person field
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 8, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Defines how to specify a person field in an activity entry.

To specify a person field, the type attribute of the <snx:field> element must be set to person. For example:

<snx:field

...

type="person">

...

</snx:field>


An <snx:field> element of type="person" can contain the following child elements:

Table 1. Child elements of the <snx:field type="person"> element

Element
How treated on input
Description
<email>
Optional
email address of the user that this person field represents. The person's email address must be in the directory or a 400 Bad Request error message is returned. This element is only supported if IBM® Connections is configured to expose emails. Otherwise, <snx:userid> is used.
<snx:userid>
Required
User ID of the user that this person field represents.
<name>
Ignored
Full name of the user that this person field represents.

 


The <email> and <name> elements are in the Atom namespace. The <snx:userid> element is in the http://www.ibm.com/xmlns/prod/sn namespace.

Example


<snx:field

name="Chair"

fid="4DBG09219C7310DD5199A4DFF2D59700001A"

position="6000"

type="person">

<name>Jane Doe</name>

<email>jdoe@us.example.com</email>

<snx:userid>937965j0-4f0c-1028-5a06-db07163b51b2</snx:userid>

</snx:field>