initiator Attribute

Designates a particular role as the initiator role.

Type

xsd:string

Parent Elements

Definition

    <xsd:attribute name="initiator" type="xsd:string" use="optional" ></xsd:attribute>
  

Remarks

If a user creates a new InfoPath document from a form template, that user is assigned to the role that has been designated as the initiator role. If no role is designated as the initiator role in the form definition file of a form (that is, if the initiator attribute is not included for the roles element), users who create forms from the accompanying form template retain the roles to which they are assigned in the membership element of the roles element. After a form has been saved, closed, and reopened, InfoPath no longer checks for the initiator attribute.

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 initiator attribute as it is used in the roles 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\groupname1" memberOf="C" />
   </xsf:membership>
</xsf:roles>