This documentation is archived and is not being maintained.

initiator Attribute

Office 2007

Designates a particular role as the initiator role.



Parent Elements

rolesDefines 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.


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