Attributes
action
Description
Specifies an action on an editing component, initiated by an onClick event, using the syntax Component::Action.
Attribute of
button
Type
xsd:NMTOKEN
aggregation
Description
Specifies how form property data should be processed to obtain a single value for a form library report.
Use
The aggregation attribute can either be an aggregation action or an indication of the particular element in the collection. It uses the following aggregation actions: sum, count, average, min, max, first, last, merge, and plaintext.
Attribute of
field
Type
xsd:NMTOKEN
allowCustomization
Description
Determines if the form can be modified or customized by users.
Attribute of
solutionProperties
Type
xsf:xdYesNo
application
Description
Identifies the name of the application used to design the Microsoft Office InfoPath 2003 form.
Use
In InfoPath 2003 the only allowed value is “InfoPath Design Mode”.
Attribute of
applicationParameters
Type
xsd:string
attribute
Description
Required attribute of attributeData. Specifies the name of the attribute to be inserted or modified.
Attribute of
attributeData
Type
xsd:string
author
Description
Identifies the author of the form definition.
Attribute of
xDocumentClass
Type
xsd:string
autoComplete
Description
Switches the auto-completion of controls on or off.
Attribute of
editWith
Type
xsf:xdYesNo
automaticallyCreateNodes
Description
Defines whether XML nodes will be automically generated when controls are inserted in the view in design mode. This attribute corresponds to the Automatically create data source check box at the bottom of the controls task pane.
Attribute of
solutionProperties
Type
xsf:xdYesNo
bottomMargin
Description
Specifies the bottom margin when printing a view.
Use
This attribute must be set by editing the XSF file, since there is no design mode interface.
Attribute of
printSettings
Type
xsd:float
caption (button element)
Description
Provides the display caption for a button.
Use
If editWith element is used. If no icon is specified, the caption alone is used. If both caption and icon are specified, both are displayed. If neither is specified, a blank button is displayed.
caption (editWith element)
Description
Specifies an identifier for alternate forms of XML data to be used in the editing component.
caption (initialXmlDocument element)
Description
Defines the text string to be used as the name of the form in the Template Gallery and in the most recently used list.
caption (menu element)
Description
The caption for a menu.
caption (submit element)
Description
The name of the submit button and corresponding menu item that will appear on the File menu.
caption (taskpane element)
Description
The caption used in the task pane drop-down list box.
caption (toolbar element)
Description
The title of the toolbar, when the toolbar is floating.
caption (view element)
Description
The caption for the view in the view list.
columnName
Description
Identifies the column name in the SQL table underlying the form list view.
Attribute of
field
Type
xsf:xdTitle
commandText
Description
The SQL command for querying an ADO data source.
Attribute of
adoAdapter
Type
xsd:string
component
Description
The name of the editing component referenced with the button element.
Attribute of
editWith
Type
xsd:NMTOKEN
connectionString
Description
The connection string containing all the parameters needed to connect to the ADO data source.
Attribute of
adoAdapter
Type
xsd:string
container
Description
An XPath expression that sets the context in which a form control can be selected and its actions enabled.
Use
In design mode, InfoPath generates XPath patterns giving the full path from the root of the document. If you edit the form definition manually, you can use relative paths and predicates in your expressions.
Attribute of
xmlToEdit
Type
xsd:string
dataFormSolution
Description
Identifies the form as a database form.
Use
Allowed attribute values are “yes” and “no” (default). Forms with a primary data source based on ADO or Web services connection that have a query view should have this attribute set to “yes” in order for them to work properly.
Attribute of
xDocumentClass
Type
xsf:xdYesNo
default
Description
The identifier of the view chosen to be the default view. If not specified, the view will default to the first view element in document order. When a document instance is loaded, the default view is loaded initially.
Attribute of
views
Type
xsd:string
description
Description
A description of the form displayed in the FileNew and FileOpen dialog boxes.
Attribute of
xDocumentClass
Type
xsd:string
disableMenuItem
Description
Enables or disables the FileSubmit menu item.
Attribute of
submit
Type
xsf:xdYesNo
enabled
Description
Specifies whether form merging is enabled for a form.
Attribute of
importParameters
Type
xsf:xdYesNo
expression
Description
An XPath expression used to validate the XML node specified in the errorCondition element.
Attribute of
errorCondition
Type
xsd:string
expressionContext
Description
Specifies the node on which the expression specified in the errorCondition element is rooted.
Attribute of
errorCondition
Type
xsd:string
field
Description
Defines a single field for form library columns.Specifies a relative XPath expression from the xmlToEdit element.
Attribute of
editWith
Type
xsd:string
fileUrl
Description
Contains the URL of a static XML file used as a data source.
Attribute of
xmlFileAdapter
Type
xsd:anyURI
followingSiblings
Description
Specifies a relative XPath expression for the XML nodes prior to which the insertion of an XML fragment should occur.
Attribute of
chooseFragment
Type
xsd:string
footer
Description
The content of the page footer for a print view.
Attribute of
printSettings
Type
xsd:string
fullyEditableNamespace
Description
Defines the namespace for a form’s XML schema that can be edited in design mode.
Attribute of
solutionProperties
Type
xsd:anyURI
handlerObject
Description
Identifies the unique name of the domEventHandler object in the script code.
Use
The referenced script must use this name to define event handler functions for the specified XML node. For example, a script may contain functions such as onValidate and onAfterChange that are called whenever the specified events occur at the matching XML node.
Attribute of
domEventHandler
Type
xsd:string
header
Description
The content of the page header in a print view.
Attribute of
printSettings
Type
xsd:string
href (initialXmlDocument element)
Description
Specifies the name of the XML template file to be used when a user chooses FileFill Out a Form.
href (taskpane element)
Description
The URL of the HTML file containing the task pane data.
href (useHttpHandler element)
Description
The URL to which the form should be submitted.
icon
Description
Contains a URL or identifier for an image used for a button.
Use
If a URL is used, the image must be in BMP or GIF format. If the value is an integer, it will be interpreted as a system ID, allowing access to internal system icons (.ico).
Attribute of
button
Type
xsd:string
initOnLoad
Description
Specifies if a data object should be initialized automatically on form load.
Attribute of
dataObject
Type
xsf:xdYesNo
item
Description
An XPath expression that specifies the nodes to be edited with components in the contained editWith elements.
Attribute of
xmlToEdit
Type
xsd:string
language
Description
Identifies the name of the scripting language used to implement the business logic of a form.
Attribute of
scripts
Type
xsf:xdScriptLanguage
lastOpenView
Description
The name of the view that was last open in the application while editing/viewing the form. The next time the form is opened in the application, this view is automatically opened.
Attribute of
solutionProperties
Type
lastVersionNeedingTransform
Description
Identifies, temporarily, the value of the documentVersionUpgrade for upgrade with an XSLT file if the script is currently being used for the upgrade.
Attribute of
solutionProperties
Type
xsf:xdSolutionVersion
leftMargin
Description
Specifies the left margin when printing a view.
Use
This attribute must be set by editing the XSF file, since there is no design mode interface.
Attribute of
printSettings
Type
xsd:float
location
Description
Contains the namespace URI and URL of the XML schema for a form, followed by a space and the filename. Schemas without namespaces are listed with just the XSD filename.
Attribute of
documentSchema
Type
xsd:string
marginUnits
Description
Specifies the margin unit size when printing a view.
Use
This attribute must be set by editing the XSF file, since there is no design mode interface.
match (domEventHandler element)
Description
Identifies the XML node for which the event handler is declared.
match (errorCondition element)
Description
Identifies the XML node on which the custom validation is declared.
match (override element)
Description
Identifies the XML node for which the error message override is defined.
match (partFragment element)
Description
An XPath expression that identifies the elements and attributes inside the input SOAP message that are to be replaced at run time.
maxLength
Description
Defines the length of a field (number of bytes).
Attribute of
field
Type
xsd:byte
maxVersionToUpgrade
Description
Inclusive value for the latest form that needs to be upgraded.
method
Description
Specifies the HTTP method to use for a form submit operation.
Attribute of
useHttpHandler
Type
xsd:NMTOKEN
minVersionToUpgrade
Description
Inclusive value for the oldest XML that can be upgraded. This is defined to prevent running an upgrade XSLT on XML documents so different from the current one that the XSLT may cause data loss.
Attribute of
useTransform
Type
xsf:xdSolutionVersion
name (button element)
Description
Associates the OnClick event handler of a button with a script function.
Use
Although name is optional, it is required for buttons that use scripting code.
name (dataObject element)
Description
The unique name for the data object.
name (extension element)
Description
The unique name for the specified InfoPath extension.
name (field element)
Description
The name of the field to be used on the form list view.
name (file element)
Description
The name of the file.
name (importSource element)
Description
The name of the source form defined in the processing instruction of the XML document.
name (menuArea element)
Description
A name that corresponds to one of the built-in InfoPath top-level menus.
name (operation element)
Description
The unique name of the Web service method.
name (property element)
Description
The name of the property.
name (toolbar element)
Description
The name of a toolbar, which must be unique within a form.
name (view element)
Description
Identifies the view.
name (xDocumentClass element)
Description
Unique URN for the form.
name (xmlToEdit element)
Description
Associates actions on an editing component with buttons defined in menus and toolbars.
node
Description
Defines the XPath expression needed to extract the value of the specified property from the XML document.
Attribute of
field
Type
xsd:string
onAfterSubmit
Description
Specifies whether the form should be closed or kept open, or if a new form should be created after a successful submission.
Attribute of
submit
Type
xsd:NMTOKEN
orientation
Description
The orientation of the page in a print view.
Attribute of
printSettings
Type
xsd:NMTOKEN
parent
Description
This attribute gives a relative XPath from the xmlToEdit container node. It refers to the node in the XML under which this fragment should be inserted. The default value is “.”.
Attribute of
chooseFragment
Type
xsd:string
printView
Description
Specifies the name of an alternate view to use for printing a view.
Attribute of
view
Type
xsd:string
productVersion
Description
Identifies the version (build) number of the InfoPath application with which a form has been created. It is represented in the format nnnn.nnnn.nnnn.nnnn (major.minor.revision.build).
Attribute of
xDocumentClass
Type
xsd:string
proofing
Description
Switches the proofing features, such as the spelling checker, on or off.
Attribute of
editWith
Type
xsf:xdYesNo
publishUrl
Description
Identifies the publish location of a URL-based, sandboxed solution. This is set automatically when a form is published or deployed using InfoPath design mode. When a form is opened, the value is used to check if it has been moved from its original published location.
Attribute of
xDocumentClass
Type
xsd:string
queryAllowed
Description
Optional attribute of adoAdapter that specifies whether data can be retrieved from the data source through the query method of the data adapter object.
Use
Allowed values are “yes” (default) and “no”.
Attribute of
adoAdapter, webServiceAdapter
Type
xsf:xdYesNo
removeAncestors
Description
Specifies the number of ancestor (parent) elements to be removed when the last item is removed.
Attribute of
editWith
Type
xsd:nonNegativeInteger
replaceWith
Description
Contains an XPath expression that identifies a unique node inside the InfoPath 2003 main document DOM that should be used at specified locations inside the input SOAP message when making the Web service call.
Attribute of
partFragment
Type
xsd:string
required
Description
Identifies whether a field element accepts NULL values. Allowed values are “yes” and “no” (default).
Attribute of
field
Type
xsf:xdYesNo
requireFullTrust
Description
Identifies the form to be a fully trusted URN solution.
Use
Allowed values are “yes” and “no”. If set to “yes”, the form must be identified by a URN specified in the name attribute.
Attribute of
xDocumentClass
Type
xsf:xdYesNo
rightMargin
Description
Specifies the right margin when printing a view.
Use
This attribute must be set by editing the XSF file, since there is no design mode interface.
Attribute of
printSettings
Type
xsd:float
rootSchema
Description
Identifies an XML schema as the top-level schema of the form.
Attribute of
documentSchema
Type
xsf:xdYesNo
schema (dataObject element)
Description
Refers to a schema file associated with a data object.
schema (importSource element)
Description
Identifies a schema URN for a form that is the source of an import or merge operation.
scriptLanguage
Description
Identifies the name of the scripting language used to implement the business logic of the form.
Attribute of
solutionProperties
Type
xsf:xdScriptLanguage
serviceUrl
Description
The Web service URL where the request should be sent.
Attribute of
operation
Type
xsd:string
shortMessage
Description
Short error message to return in case of invalid data.
Attribute of
errorMessage
Type
xsd:string
showErrorOn
Description
Identifies XML nodes on which an error should be displayed when the form is filled out.
Attribute of
errorCondition
Type
xsd:string
showIf
Description
Optional attribute that specifies the display property of a button.
Use
The showIf attribute only applies to buttons used with editing components.Allowed values are as follows:
always (default).
enabled. Shows the button only if the action is contextually enabled.
immediate. Shows the button only if the action is contextually immediate
Attribute of
button
Type
xsd:NMTOKEN
showSignatureReminder
Description
Specifies if a dialog box should be shown reminding the user that the form should be signed before submitting.
Attribute of
submit
Type
xsf:xdYesNo
showStatusDialog
Description
Specifies if the status dialog box should be shown after the submit operation.
Attribute of
submit
Type
xsf:xdYesNo
signatureLocation
Description
An XPath expression that points to the node that is used for storing the digital signature.
Attribute of
documentSignatures
Type
xsd:string
soapAction
Description
The value of the SOAPAction attribute in the SOAP request message.
Attribute of
operation
Type
xsd:string
solutionFormatVersion
Description
The version number that represents the format of the form definition file in the form nnnn.nnnn.nnnn.nnnn (major.minor.revision.build). Version number of InfoPath form definition format will be updated for major format upgrades, and it helps InfoPath in determining if the current form is compatible with the current product version in which it is being opened.
Attribute of
xDocumentClass
Type
xsf:xdSolutionVersion
solutionVersion
Description
Identifies the version number of the form. It is represented in the format nnnn.nnnn.nnnn.nnnn (major.minor.revision.build).
Attribute of
xDocumentClass
Type
xsf:xdSolutionVersion
source
Description
Points to a resource file in the form template that contains the schema for the input SOAP message of the selected operation of the Web service.
Attribute of
input
Type
xsd:string
src
Description
Provides a relative URL to the specified script source file.
Attribute of
script
Type
xsf:xdFileName
submitAllowed (adoAdapter element)
Description
Optional attribute of adoAdapter that specifies whether data can be submitted to the data source through the submit method of the data adapter object.
Use
Allowed values are “yes” and “no” (default).
submitAllowed (webServiceAdapter element)
Description
Optional attribute of adoAdapter that specifies whether data can be submitted to the data source through the submit method of the data adapter object.
Use
Allowed values are “yes” and “no” (default).
tooltip
Description
Optional attribute of the button element that provides the pop-up text for a toolbar button.
Attribute of
button
Type
xsf:xdTitle
topMargin
Description
Specifies the top margin when a view is printed.
Use
This attribute must be set by editing the XSF file, since there is no design mode interface.
Attribute of
printSettings
Type
xsd:float
transform (importSource element)
Description
Identifies the XSLT transform to be used during a merge operation.
transform (mainpane element)
Description
Specifies the XSLT transform for the main part of the form.
transform (useTransform element)
Description
Specifies the upgrade XSLT filename relative to the form template.
type (editWith element)
Description
Specifies the formatting of a text field. The following values are allowed: “plain” (default), “plainMultiline”, “formatted”, “formattedMultiline”, and “rich”.
type (errorMessage element)
Description
Specifies whether a short or a long error message is displayed.
type (field element)
Description
The XML Schema data type of a field element.
type (property element)
Description
Associates actions on an editing component with buttons defined in menus and toolbars.
value (attributeData element)
Description
Specifies the value of the attribute to be inserted.
value (property element)
Description
Specifies the value of a file property.
viewable
Description
Identifies whether this field should be added to the default view or not. Allowed values are “yes” and “no” (default).
Attribute of
field
Type
xsf:xdYesNo
viewContext
Description
Use
This corresponds to a condition on the current selection in the view. The condition is satisfied if there is some common ancestor of the current selection (in the HTML tree) that has the corresponding xd:CtrlId.This can be used to disambiguate controls when two instances of the same control have the same XML context, so that the XML context is identical.
Attribute of
xmlToEdit
Type
xsd:string
wsdlUrl
Description
Contains the URL of the WSDL file describing the Web service.
Attribute of
webServiceAdapter
Type
xsd:string