userName Element

Associates a user with a particular role.

Type

xsd:complexType

Child Elements

None.

Attributes

Attribute	Type	Required	Description	Possible Values
name	`xsd:string`	Yes	Specifies the name of a user for inclusion in the membership list of a role.	string
memberOf	`xsd:string`	Yes	Specifies the role to be associated with the user.	string

Definition

<xsd:element name="userName">
  <xsd:complexType>
    <xsd:attribute name="name" type="xsd:string" use="required"></xsd:attribute>
    <xsd:attribute name="memberOf" type="xsd:string" use="required"></xsd:attribute>
  </xsd:complexType>
</xsd:element>

Remarks

InfoPath requires that a user be associated with only one role at a time.

If a user creates a new InfoPath document from a form template, that user is assigned to the role specified in the optional initiator attribute of the roles element. If no role has been designated as the initiator role, InfoPath assigns the user to the role specified in the memberOf attribute of the first entry that corresponds to the user in the membership list of the roles element. An entry in the membership list corresponds to a user if any one of the following conditions is true:

The name of the user matches the value of the name attribute of a userName element in the membership list.
The user is included in a group identified by a group element in the membership list.
The name of the user matches a name returned by a getUserNameFromData element in the membership list.

If no entry for the user is found in the membership list, InfoPath associates the user with the role specified in the default attribute of the roles element.

Note This item is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Editions Service Pack 1 or later is not installed. Any form defined by a form definition file (.xsf) that includes this item cannot be opened in InfoPath when service pack features are disabled or unavailable.

Example

The following is an example of the userName element:

<xsf:roles initiator="A" default="C" hideStatusBarDisplay="yes">
   <xsf:role name="A"/>
   <xsf:role name="B"/>
   <xsf:role name="C"/>

   <xsf:membership>
      <xsf:getUserNameFromData dataObject="catalog" select="/dfs:myFields/dfs:dataFields/d:UserA" memberOf="B"/>
      <xsf:userName name="Domain\username1" memberOf="A"/>
      <xsf:userName name="Domain\username2" memberOf="B"/>
      <xsf:group name="Domain\username3" memberOf="C"/>
   </xsf:membership>
</xsf:roles>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp