sharepointListAdapterExtension Element

Specifies the extended information for the corresponding sharepointListAdapter element in the manifest.xsf.

Usage

  
<sharepointListAdapterExtension
	ref="xsf:xdTitle"
	queryThisFormOnly="xsf:xdYesNo"
	sharepointWebGuid="xsd:string"
/>

Element Information

Element type xsd:complexType
Namespace xsf2

Elements and Attributes

Parent Elements

Element Description
dataConnections Contains elements that specify data connections.

Child Elements

Element Description
connectoid Specifies information that describes a data connection file.

Attributes

Attribute Type Required Description Possible Values
ref xdTitle Required Specifies the name attribute of the sharepointListAdapter element in the manifest.xsf that this element extends.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
String
queryThisFormOnly xdYesNo Optional Specifies whether the query operation performed on this SharePoint data connection will apply only to the current form.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
  • yes
  • no
queryKey xsd:string Optional Specifies a string value generated by InfoPath and maintained in the manifest.xsf file that dictates whether the data cached in the form template at design time is applicable for the current state of the data connection.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
String
queryFile xsd:string Optional Specifies the name an XML file included in the form template that contains the data cached at design time if the user selected the Store a copy of the data in the form template check box in the Data Connection Wizard. The data in the XML file will be used by InfoPath if the queryKey value generated at runtime matches the value stored at design time.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
String
sharepointWebGuid xsd:string Optional Specifies the GUID of the SharePont site this form will be published to.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.
String

Definition

  
<xsd:element name="sharepointListAdapterExtension">
   <xsd:complexType>
      <xsd:sequence>
         <xsd:element ref="xsf2:connectoid" type="connectoidType" minOccurs="0" />
      </xsd:sequence>
      <xsd:attribute name="ref" type="xsf:xdTitle" use="required" />
      <xsd:attribute name="queryThisFormOnly" type="xsf:xdYesNo" use="optional" default="no" />
      <xsd:attribute name="sharepointWebGuid" type="xsd:string" use="optional" />
      <xsd:attributeGroup ref="xsf2:queryKeyFile" />
   </xsd:complexType>
</xsd:element>

Remarks

InfoPath adds the sharepointListAdapterExtension element to the manifest.xsf file when a SharePoint library or list data connection is defined using one or more of the following features:

  • The Store a copy of the data in the form template check box is selected in the Data Connection Wizard.
  • The data connection settings are specified from a data connection file (.udcx) in a data conection library.

Note   This element or attribute is optional in the form definition file (.xsf) of a form template deployed as a browser-compatible form to a server running InfoPath Forms Services.

Example

The following is an example of the sharepointListAdapterExtension element.

  
<xsf2:sharepointListAdapterExtension ref="Get Factoid Types - DL" queryKey="http://www.example.com/sites/feedback/<GetListItems xmlns="http://schemas.microsoft.com/sharepoint/soap/"><listName>{B8A0AE8E-D3FF-4DE1-8B53-C8FE1592CB3E}</listName><viewFields><ViewFields><FieldRef Name="ID"/><FieldRef Name="Title"/></ViewFields></viewFields><webID></webID></GetListItems>" queryFile="Get Factoid Types_offline.xml" queryThisFormOnly="no">
   <xsf2:connectoid name="Get Factoid Types - DL" connectionLinkType="store" siteCollection="http://www.example.com/sites" source="infopath/Data%20connection%20library/Get Factoid Types - DL.udcx" />
</xsf2:sharepointListAdapterExtension>