initiator Attribute

Article
06/14/2014

Designates a particular role as the initiator role.

Type

  xsd:string

Parent Elements

Element	Description
roles	Defines 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>

Share via