Editar

Compartilhar via


Windows Sharepoint Services Adapter Configuration Properties

The following table lists the configuration properties that you can set for a Windows Sharepoint Services adapter receive location:

Property name Type Description Restrictions Comments
SiteUrl VT_BSTR Specify the complete URL of the Windows SharePoint Services Web site. The URI for a send port or receive location cannot exceed 256 characters. None
WssLocation VT_BSTR Specify the URL of the Windows SharePoint Services document library, relative to the SharePoint site, where the documents are retrieved. You cannot receive messages from a SharePoint list or folder. Sometimes the SharePoint document library is different from the name of that item. Check the address bar in Internet Explorer to discover the correct URL.
ViewName VT_BSTR Specify the Windows SharePoint Services view used to filter documents processed by the adapter. None All messages in a flat view will be processed.
ArchiveLocation VT_BSTR Specify the Windows SharePoint Services folder URL, relative to the SharePoint site, where the processed files are archived. None Sometimes the SharePoint document library, or folder URL is different from the name of that item. Check the address bar in Internet Explorer to discover the correct URL.
NamespaceAliases VT_BSTR Specify a comma or semicolon-delimited list of namespace aliases definitions. None None
ArchiveFileName VT_BSTR Specify the archived file Windows SharePoint Services file name. The "%SendingOrchestrationID%" and "%SendingOrchestrationType%" macros are not supported by this field. None
Overwrite VT_BSTR Specify whether existing files in the archive are overwritten. Valid values are:

- yes
- no
The default value is no.
ErrorThreshold VT_BSTR Specify the maximum number of consecutive polling failures encountered by the adapter until the receive location is disabled. Valid values are from 0 to 2147483647. Set this property to 0 in order to never disable the receive location.

The default value is 10.
PollingInterval VT_BSTR Specify the time interval, in seconds, between two consecutive queries performed by the adapter to see if any new messages are available for processing. Valid values are from 1 to 2147483647. Specifying a lower value improves the throughput and response time for the adapter.

The default value is 60.
BatchSize VT_BSTR Specify the maximum number of documents that the Windows SharePoint Services Messaging Adapter Web service will process as a batch. Valid values are from 1 to 2147483647. A processed batch might contain fewer messages than the defined batch size; however, it will never contain more messages.

The default value is 20.
OfficeIntegration VT_BSTR Specify the level of Office integration. Valid values are:

- optional - attempt to remove InfoPath processing instructions if possible or to process as is if not possible.
- no - process the document "as is."
- yes - remove InfoPath processing instructions or skip the message in case of an error.
The default value is optional.
Timeout VT_BSTR Specify time-out, in milliseconds, for the adapter runtime Web service calls made to the Windows SharePoint Services adapter Web service. Valid values are from 1000 to 2147483647. The default value is 100000.
AdapterWSPort VT_BSTR Specify the HTTP port of the IIS Web site where the Windows SharePoint Services adapter Web service is installed. None The default value is 80.
uri VT_BSTR Specify the full path to the Windows SharePoint Services document library. The URI for a send port or receive location cannot exceed 256 characters. None

The following code shows the format of the string you use to set the properties:

<CustomProps><AdapterConfig vt="8"><ReceiveLocation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><SiteUrl>http://BTS2006/sites/BASSite/</SiteUrl><WssLocation>Shared Docs</WssLocation><ViewName>Approved</ViewName><ArchiveLocation>Archive</ArchiveLocation><NamespaceAliases>po='http://POProcess/POrder'</NamespaceAliases><ArchiveFileName>PurchaseOrder0001.xml</ArchiveFileName><Overwrite>no</Overwrite><ErrorThreshold>10</ErrorThreshold><PollingInterval>60</PollingInterval><BatchSize>20</BatchSize><OfficeIntegration>optional</OfficeIntegration><Timeout>100000</Timeout><AdapterWSPort>80</AdapterWSPort><uri>wss://bts2006:80/sites/BASSite/Shared+Docs?ViewName=Approved</uri></ReceiveLocation></AdapterConfig></CustomProps>  

The following table lists the configuration properties that you can set for a Windows Sharepoint Services adapter send port:

Property name Type Description Restrictions Comments
SiteUrl VT_BSTR Specify the complete URL of the Windows SharePoint Services Web site The URI for a send port or receive location cannot exceed 256 characters. None
WssLocation VT_BSTR Specify the Windows SharePoint Services destination folder URL, relative to the SharePoint site. None Sometimes the SharePoint document library, list, or folder URL is different from the name of that item. Check the address bar in Internet Explorer to find the correct URL.
Overwrite VT_BSTR Specify whether to overwrite existing files. Valid values are:

- no
- orchestration
- rename
- yes
The default value is no.
NamespaceAliases VT_BSTR Specify a comma or semicolon-delimited list of namespace aliases definitions. None Use this field to define the namespace aliases that are used by the XPATH queries introduced in fields.

This property does not override the WSS.ConfigNamespacesAliases message context property defined by the orchestration. The two values are merged instead.
FileName VT_BSTR Specify the Windows SharePoint Services file name None When sending messages to a list, the value specified in the Filename property is ignored and will not be saved in any SharePoint column. SharePoint lists do not have a Filename column. Instead, update the Title column using one of the 16 available columns.
OfficeIntegration VT_BSTR Specify to change the document so that it automatically opens in an Office application like InfoPath or to save the document as is if no InfoPath solution is found. Valid values are:

- no
- optional
- orchestration
- yes
- yesformlibrary
The default value is optional.
TemplatesDocLib VT_BSTR Specify the name of a SharePoint document library where the InfoPath solutions are stored. This property must contain a value if the TemplatesNamespaceCol property contains a value. The document library must have at least one SharePoint column of type Single line of text which is populated with the namespace and the root node of the XML documents that can be opened with this InfoPath solution, or just the root node.
TemplatesNamespaceCol VT_BSTR Specify the name of the Templates Fallback Document Library SharePoint column that stores the namespace of the InfoPath solution. This property must contain a value if the TemplatesDocLib property contains a value.

This field is case-sensitive.
None
CustomTemplatesDocLib VT_BSTR Specify the name of a SharePoint document library where the InfoPath solutions are stored. This property must contain a value if the CustomTemplatesNamespaceCol property contains a value.

This field is case-sensitive.
None
CustomTemplatesNamespaceCol VT_BSTR Specify the name of the Templates Document Library SharePoint column that stores the namespace of the InfoPath solution. This property must contain a value if the CustomTemplatesDocLib property contains a value.

This field is case-sensitive.
None
PropertyName(n) VT_BSTR Specify the name of the Windows SharePoint Services column that exists in the destination document library. This field is case-sensitive. You can specify up to 16 columns.
PropertySource(n) VT_BSTR Specify the column value to be set for this message. None You can specify up to 16 column values.
Timeout VT_BSTR Specify the time-out, in milliseconds, for the adapter runtime Web service calls made to the Windows SharePoint Services adapter Web service. Valid values are from 1000 to 2147483647. The default value is 100000.
AdapterWSPort VT_BSTR Specify the HTTP port of the IIS Web site where the Windows SharePoint Services adapter Web service is installed. None The default value is 80.
uri VT_BSTR Specify the full path to the Windows SharePoint Services destination folder URL. The URI for a send port or receive location cannot exceed 256 characters. None

The following code shows the format of the string you use to set the properties:

Note

The definitions for PropertyName2 and PropertySource2 through PropertyName16 and PropertySource16 were omitted from this string.

<CustomProps><AdapterConfig vt="8"><SendPort xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><SiteUrl>http://BizTalkServer/sites/BASSite/</SiteUrl><WssLocation>Shared Documents/Purchase Orders</WssLocation><Overwrite>yes</Overwrite><NamespaceAliases>po='http://OrderProcess/POrder'</NamespaceAliases><FileName>PurchaseOrder0001.xml</FileName><OfficeIntegration>yesformlibrary</OfficeIntegration><TemplatesDocLib>Templates</TemplatesDocLib><TemplatesNamespaceCol>NamespaceFallback</TemplatesNamespaceCol><CustomTemplatesDocLib>Shared Documents</CustomTemplatesDocLib><CustomTemplatesNamespaceCol>Namespace</CustomTemplatesNamespaceCol><PropertyName1>Column1</PropertyName1><PropertySource1>Column1 Value</PropertySource1><Timeout>100000</Timeout><AdapterWSPort>80</AdapterWSPort><uri>wss://biztalkserver:80/sites/BASSite/Shared%20Documents/Purchase%20Orders</uri></SendPort></AdapterConfig></CustomProps>  

Note

When specifying TransportTypeData configuration data for an adapter that is built using the Adapter Framework, the name/value pairs that are used must all be stored into the <AdapterConfig> element. Since the <AdapterConfig> element specifies the VT_BSTR (vt="8") data type then the < > characters in the data must be escaped.