This documentation is archived and is not being maintained.

initiator Attribute

Office 2007

Designates a particular role as the initiator role.

Type

xsd:string

Parent Elements

ElementDescription
rolesDefines roles.

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.

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>


Show: