initiator Attribute

Microsoft Office InfoPath

initiator Attribute

Designates a particular role as the initiator role.



Parent Elements

Element Description
roles Defines roles.


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


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.


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: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" />