Professional InfoPath 2003 [Electronic resources]

Ian Williams, Pierre Greborio

نسخه متنی -صفحه : 166/ 129
نمايش فراداده

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