7 Appendix B: Product Behavior

Article
02/15/2022

The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products.

Microsoft Office 2010 suites
Microsoft Office 2013
Microsoft SharePoint Designer 2010
Microsoft SharePoint Designer 2013
Windows SharePoint Services 2.0
Windows SharePoint Services 3.0
Microsoft SharePoint Foundation 2010
Microsoft SharePoint Foundation 2013
Microsoft Office 2016
Microsoft SharePoint Server 2016
Microsoft Office 2019
Microsoft SharePoint Server 2019
Microsoft Office 2021
Microsoft SharePoint Server Subscription Edition
Microsoft Office 2024 Preview

Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition.

Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription.

<1> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface specified is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface specified is of the type described in [MSDN-WCCSWP].

<2> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface is of the type described in [MSDN-WCCSWP].

<3> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface is of the type described in [MSDN-WCCSWP].

<4> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface is of the type described in [MSDN-WCCSWP].

<5> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface is of the type described in [MSDN-WCCSWP].

<6> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the IsASP property is set to TRUE, the Web Part connection interface is of the type described in [MSDN-WPCO]. If the IsASP property is set to FALSE, the Web Part connection interface is of the type described in [MSDN-WCCSWP].

<7> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, each Web Part connection transformation implements its own format for the XML.ConnDesign.Compatibility.sWebPart.sg.tParts.tWebPart.tg.mi.xInfo element. For example, the Microsoft.SharePoint.WebPartPages.Communication.RowFilterTransform uses a format of a single string matching ([^=]+)=([^=]+) where the first matching group (before the equals sign) is the name of the field to filter on, and the second matching group (after the equals sign) is the value to filter on. In contrast, the Microsoft.SharePoint.WebPartPages.Communication.RowParametersInTransform also uses a single string, but this matches (\(([^=\(\)])+=([^=\(\)])+\))+, where there are repeated groups separated by parenthesis that are formatted such that, within each of those repeated groups, each part that is before an equals sign is a name of a parameter and each part after an equals sign is the value of that parameter.

<8> Section 2.2.3.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, this is a fully-qualified type name deriving from System.Web.UI.WebControls.WebParts.WebPartTransformer. For example: System.Web.UI.WebControls.WebParts.RowToParametersTransformer, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken= b03f5f7f11d50a3a.

<9> Section 2.2.4.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the additional attributes are namespace declarations.

<10> Section 2.2.4.3: In Windows SharePoint Services 3.0, SharePoint Foundation 2010 and SharePoint Foundation 2013, the implementation is specific to each Web Part connection interface type. For example, the Micrososft.SharePoint.WebPartPages.Communication.IListProvider interface uses XML of the form:

 <s:element name="ListProviderInitEventArgs">
    <s:complexType>
       <s:sequence>
          <s:element name="Field" minOccurs="0" maxOccurs="unbounded">
             <s:complexType>
                <s:sequence />
                <s:attribute name="FieldName" type="s:string" />
                <s:attribute name="FieldDisplayName" type="s:string" />
             </s:complexType>
          </s:element>
       </s:sequence>
    </s:complexType>
 </s:element>

Whereas the Micrososft.SharePoint.WebPartPages.Communication.IParametersInProvider interface uses XML of the form:

 <s:element name="ParametersInConsumerInitEventArgs">
    <s:complexType>
       <s:sequence>
          <s:element name="Parameter" minOccurs="0" maxOccurs="unbounded">
             <s:complexType>
                <s:sequence />
                <s:attribute name="ParameterName" type="s:string" />
                <s:attribute name="ParameterDisplayName" type="s:string" />
                <s:attribute name="Description" type="s:string" />
                <s:attribute name="Required" type="s:boolean" />
  
             </s:complexType>
          </s:element>
       </s:sequence>
    </s:complexType>
 </s:element>

Each implementation of different Web Part connection interfaces has its own schema for the contents of InitEventArgsType.*.

<11> Section 2.2.5.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if the storage value is set to "None", this is interpreted as "Personal" when reading, updating, and deleting Web Parts, and causes an error when adding Web Parts.

<12> Section 3.1.4.2: Windows SharePoint Services 2.0 does not support this operation.

<13> Section 3.1.4.2.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the DWP format and the format described in [MSDN-WPCDF] are supported.

<14> Section 3.1.4.2.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the value of AddWebPartToZone.zoneId corresponds to the ID property of a WebPartZone control in the page.

<15> Section 3.1.4.2.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, Web Parts that have no valid zone are kept in the database, but are not rendered on the page. They can later be moved to a valid Web Part zone on the page once one is created.

<16> Section 3.1.4.2.2.1: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 assign a new Web Part zone index to Web Parts when a user first browses to a page that includes a Web Part with invalid or duplicate indices.

<17> Section 3.1.4.3: Windows SharePoint Services 2.0 does not support this operation.

<18> Section 3.1.4.3: The syntax of the configuration file used in the implementation of this operation in Windows SharePoint Services 3.0 and SharePoint Foundation 2010 is described in [MSDN-WCSO] as follows:

 <s:schema elementFormDefault="qualified">
    <s:element name="WorkflowConfig">
       <s:complexType>
          <s:sequence>
             <s:element name="Template" minOccurs="0" maxOccurs="1">
                <s:complexType>
                   <s:attribute name="AllowStartOnMajorCheckin" type="s:boolean" use="optional" />
                   <s:attribute name="AssociationURL" type="s:string" use="optional" /> 
                   <s:attribute name="BaseID" type="s:string" use="optional"/> 
                   <s:attribute name="Category" type="s:string" use="optional" /> 
                   <s:attribute name="Description" type="s:string" use="optional" /> 
                   <s:attribute name="DocLibID" type="s:string" use="optional"/> 
                   <s:attribute name="DocLibURL" type="s:string" use="optional" /> 
                   <s:attribute name="PreviewHref" type="s:string" use="optional" />
                   <s:attribute name="PreviewRequiresGeneration" type="s:string" default="false" use="optional" />
                   <s:attribute name="PreviewVersion" type="s:string" use="optional" />
                   <s:attribute name="RequireManagePermission" type="s:boolean" use="optional" /> 
                   <s:attribute name="RestrictLanguage" type="s:integer" use="optional" /> 
                   <s:attribute name="Ruleset" type="s:string" use="optional" />
                   <s:attribute name="RulesVersion" type="s:string" use="optional"/> 
                   <s:attribute name="RulesHref" type="s:string" use="optional" /> 
                   <s:attribute name="ShowPreview" type="s:boolean" use="optional" />
                   <s:attribute name="StartManually" type="s:boolean" use="optional" /> 
                   <s:attribute name="StartOnChange" type="s:boolean" use="optional" /> 
                   <s:attribute name="StartOnCreate" type="s:boolean" use="optional" /> 
                   <s:attribute name="TaskContentType" type="s:string" use="optional" /> 
                   <s:attribute name="Type">
                      <s:simpleType>
                         <s:restriction base="s:string">
                            <s:enumeration value="RulesOnly" />
                         </s:restriction>
                      </s:simpleType>
                   </s:attribute>
                   <s:attribute name="Visibility" use="optional"> 
                      <s:simpleType>
                         <s:restriction base="s:string">
                            <s:enumeration value="RootPublic" />
                            <s:enumeration value="Public" />
                            <s:enumeration value="DraftRootPublic" />
                            <s:enumeration value="DraftPublic" />
                         </s:restriction>
                      </s:simpleType>
                   </s:attribute>
                   <s:attribute name="XomlVersion" type="s:string" use="optional"/> 
                   <s:attribute name="XomlHref" type="s:string" use="optional"/> 
                </s:complexType>
             </s:element> 
             <s:element name="Association" minOccurs="0" maxOccurs="1"> 
                <s:complexType> 
                   <s:sequence> 
                   </s:sequence>
                   <s:attribute name="ListID" type="s:string" use="optional" />
                   <s:attribute name="TaskListID" type="s:string" use="optional" /> 
                   <s:attribute name="HistoryListID" type="s:string" use="optional" /> 
                   <s:attribute name="RequireManagePermission" type="s:boolean" use="optional" /> 
                   <s:attribute name="StartManually" type="s:boolean" use="optional" /> 
                   <s:attribute name="StartOnCreate" type="s:boolean" use="optional" /> 
                   <s:attribute name="StartOnChange" type="s:boolean" use="optional" /> 
                </s:complexType>
             </s:element>
             <s:element name="ContentTypes" minOccurs="0" maxOccurs="1"> 
                <s:complexType>
                   <s:sequence> 
                      <s:element name="ContentType" minOccurs="0" maxOccurs="unbounded"> 
                         <s:complexType> 
                            <s:sequence> 
                               <s:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> 
                            </s:sequence> 
                            <s:attribute name="ContentTypeID" type="s:string" use="required" />
                            <s:attribute name="RequiresGeneration" type="s:boolean" default="false" use="optional"/>
                            <s:attribute name="Form" type="s:string" />
                            <s:attribute name="WorkflowForm" type="s:string" />
                            <s:anyAttribute namespace="##any" processContents="lax"/> 
                         </s:complexType> 
                      </s:element> 
                   </s:sequence> 
                </s:complexType> 
             </s:element>
             <s:element name="Initiation" minOccurs="0" maxOccurs="1"> 
                <s:complexType> 
                   <s:sequence> 
                      <s:element name="Fields" minOccurs="0" maxOccurs="1"> 
                         <s:complexType>
                            <s:sequence>
                               <s:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
                            </s:sequence>
                         </s:complexType> 
                      </s:element> 
                      <s:element name="Parameters" minOccurs="0" maxOccurs="1"> 
                         <s:complexType> 
                            <s:sequence> 
                               <s:element name="Parameter" minOccurs="0" maxOccurs="unbounded">
                                  <s:complexType> 
                                     <s:attribute name="Type" type="s:string" use="required" /> 
                                     <s:attribute name="Name" type="s:string" use="required" /> 
                                  </s:complexType>
                               </s:element>
                            </s:sequence> 
                         </s:complexType>
                      </s:element>
                      <s:element name="DefaultData" minOccurs="0" maxOccurs="unbounded"> 
                         <s:complexType> 
                            <s:sequence> 
                               <s:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> 
                            </s:sequence>
                         </s:complexType>
                      </s:element> 
                   </s:sequence> 
                   <s:attribute name="URL" type="s:string" use="optional" />
                </s:complexType>
             </s:element>
             <s:element name="Extended" minOccurs="0" maxOccurs="1"> 
                <s:complexType> 
                   <s:sequence> 
                      <s:element name="Fields" minOccurs="0" maxOccurs="1"> 
                         <s:complexType>
                            <s:sequence>
                               <s:element name="Field" type="core:AddOrUpdateFieldDefinition" minOccurs="0" maxOccurs="unbounded"/>
                            </s:sequence>
                         </s:complexType>
                      </s:element>
                   </s:sequence>
                </s:complexType>
             </s:element>
             <s:element name="MetaData" minOccurs="0" maxOccurs="1">
                <s:complexType>
                   <s:all>
                      <s:element name="TaskForms" minOccurs="0" maxOccurs="1">
                         <s:complexType>
                            <s:sequence>
                               <s:element name="TaskForm" minOccurs="0" maxOccurs="unbounded">
                                  <s:complexType>
                                     <s:sequence>
                                     </s:sequence>
                                     <s:attribute name="TaskType" type="s:integer" />
                                     <s:attribute name="FormUrn" type="s:string" />
                                  </s:complexType>
                               </s:element>
                            </s:sequence>
                         </s:complexType>
                      </s:element>
                      <s:element name="Modifications" minOccurs="0" maxOccurs="1"> 
                         <s:complexType>
                            <s:sequence>
                               <s:element name="Modification" minOccurs="1" maxOccurs="unbounded"> 
                                  <s:complexType>
                                     <s:sequence>
                                     </s:sequence>
                                     <s:attribute name="TypeId" type="s:string" use="required"/>
                                     <s:attribute name="NameFormat" type="s:string" use="required"/>
                                     <s:attribute name="FormURN" type="s:string" use="required"/>
                                  </s:complexType> 
                               </s:element>
                            </s:sequence>
                            <s:attribute name="ModificationUrl" type="s:string" use="required"/>
                         </s:complexType> 
                      </s:element>
                      <s:element name="Instantiation_FormURI" type="s:string" minOccurs="0" maxOccurs="1">
                         <s:complexType mixed="true">
                            <s:sequence />
                            <s:attribute name="RequiresGeneration" type="s:boolean" default="false" use="optional" />
                            <s:attribute name="Version" default="v1.0" use="optional">
                               <s:restriction base="s:string">
                                  <s:pattern value="[v|V]\d+\.\d+" />  
                               </s:restriction>
                            </s:attribute>
  
                         </s:complexType>
                      </s:element>
                      <s:element name="Association_FormURN" type="s:string" minOccurs="0" maxOccurs="1">
                         <s:complexType mixed="true">
                            <s:sequence />
                            <s:attribute name="RequiresGeneration" type="s:boolean" default="false" use="optional" />
                            <s:attribute name="Version" default="v1.0" use="optional">
                               <s:restriction base="s:string">
                                  <s:pattern value="[v|V]\d+\.\d+" />  
                               </s:restriction>
                            </s:attribute>
                         </s:complexType>
                      </s:element>
                      <s:element name="SigClientSettings" type="s:string" minOccurs="0" maxOccurs="1"/>
                      <s:element name="HasStatusColumn" type="s:boolean" minOccurs="0" maxOccurs="1"/>
                      <s:element name="HasTaskList" type="s:boolean" minOccurs="0" maxOccurs="1"/>
                      <s:element name="HasHistoryList" type="s:boolean" minOccurs="0" maxOccurs="1"/>
                      <s:element name="ExtendedStatusColumnValues" minOccurs="0" maxOccurs="1">
                         <s:complexType>
                            <s:sequence>
                               <s:element name="StatusColumnValue" type="s:string" minOccurs="0" maxOccurs="unbounded" />
                            </s:sequence>
                         </s:complexType>
                      </s:element>
                   </s:all>
                </s:complexType>
             </s:element>
             <s:element name="AssociateOnActivation" type="s:boolean" minOccurs="0" maxOccurs="1"/>
          </s:sequence>
          <s:attribute name="Version" type="s:string" />
       </s:complexType>
    </s:element>
 </s:schema>

WorkflowConfig: Root element of the workflow configuration file.

WorkflowConfig.Template: Specifies information about the location of the workflow markup and invariant information about the workflow.

WorkflowConfig.Template.DocLibID: The GUID of the document library that contains the workflow markup.

WorkflowConfig.Template.DocLibURL: The URL of the document library that contains the workflow markup. If docLibID is specified, then this value is ignored.

WorkflowConfig.Template.BaseID: The GUID that uniquely identifies the workflow. This value is invariant across updates to the workflow.

WorkflowConfig.Template.XomlHref: The site-relative URL of the workflow Extensible Application Markup Language (XAML) file.

WorkflowConfig.Template.XomlVersion: The version number of the workflow XAML file at the location specified in XomlHref.

WorkflowConfig.Template.RulesHref: The site-relative URL of the workflow rules file.

WorkflowConfig.Template.RulesVersion: The version number of the workflow rules file specified by RulesHref.

WorkflowConfig.Template.Category: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.Description: A textual description available for the server to show in UI elements that gives the user information about what the workflow is expected to do. This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Template.ShowPreview: If set to TRUE, the server will enable, if possible, the current state of the workflow in a diagram when the user accesses the current state of the workflow in the UI. This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Template.PreviewHref: If this value begins with a slash (/), it refers to a site-collection relative URL. If this value does not begin with slash, it refers to a site-relative URL. If set and ShowPreview is set to TRUE, the server will, if possible, render the diagram located at PreviewHref to show the current state of the workflow when the user accesses the current state of the workflow through the UI. This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Template.PreviewVersion: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.PreviewRequiresGeneration: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.Type: If this is set to "RulesOnly", this workflow does not use XAML to define the execution of the workflow. It uses the workflow rules file specified by RulesHref. If this is set to "RulesOnly", Ruleset is set. This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Template.Ruleset: If set, this specifies which rule in the workflow rules file to evaluate when the workflow is executed. If it is set, Type is set to "RulesOnly". This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Template.Visibility: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.AssociationURL: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.AllowStartOnMajorCheckin: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.StartManually: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.StartOnChange: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.StartOnCreate: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.RequireManagePermission: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.RestrictLanguage: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Template.TaskContentType: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Association: Information about how the client authoring the workflow can associate the workflow with objects on the server.

WorkflowConfig.Association.ListID: The GUID of the list with which the workflow is associated.

WorkflowConfig.Association.TaskListID: The GUID of a list with different content types applied to it. In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if this attribute is empty or null, the server selects an existing task list or creates a new task list with a default name. If the server either reuses an existing task list or creates a new task list, all future references to WorkflowConfig.Association.TaskListID use the value of the GUID identifier of the list. See also HasTaskList.

WorkflowConfig.Association.StartManually: If set to TRUE, indicates that the server makes the workflow available for starting manually through UI elements. If set to FALSE, indicates that the server does not make the workflow available for starting manually through UI elements.

WorkflowConfig.Association.StartOnChange: If set to TRUE, indicates that the server starts the workflow when a list item or document in the WorkflowConfig.Association.ListID list or document library is modified. If set to FALSE, indicates that the server does not start the workflow when a list item or document in the WorkflowConfig.Association.ListID list or document library is modified.

WorkflowConfig.Association.StartOnCreate: If set to TRUE, indicates that the server starts the workflow when a list item or document in the WorkflowConfig.Association.ListID list or document library is created. If set to FALSE, indicates that the server does not start the workflow when a list item or document in the WorkflowConfig.Association.ListID list or document library is created.

WorkflowConfig.Association.HistoryListID: The GUID of a list in which to place list items that record information about the workflow. In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if this attribute is empty or null, the server selects an existing list or creates a new list with a default name. If the server either reuses an existing list or creates a new list, all future references to WorkflowConfig.Association.HistoryListID use the GUID for the list. See also HasHistoryList.

WorkflowConfig.Association.RequireManagePermission: If set to TRUE, the server requires additional permissions for a user to start the workflow through UI elements. If set to FALSE, the server does not require additional permissions for a user to start the workflow through UI elements. This attribute is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.ContentTypes: This element is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.ContentTypes.ContentType: This element is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.ContentTypes.ContentType.ContentTypeID: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.ContentTypes.ContentType.Form This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.ContentTypes.ContentType.WorkflowForm This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.Initiation: Specifies information for processing a form used to start a workflow.

WorkflowConfig.Initiation.URL: Specifies the site-relative URL of the initiation form.

WorkflowConfig.Initiation.Parameters: Specifies the set of parameters needed to successfully start the workflow.

WorkflowConfig.Initiation.Parameters.Parameter: Specifies a single parameter needed for starting the workflow.

WorkflowConfig.Initiation.Parameters.Parameter.Name: The name of the parameter.

WorkflowConfig.Initiation.Parameters.Parameter.Type: The .NET type of the parameter, for example: "System.String".

WorkflowConfig.Initiation.Fields: Specifies the set of fields that appear in the initiation form.

WorkflowConfig.Initiation.Fields.Field: The standard Field elements of the AddOrUpdateFieldDefinition type, as described in [MS-LISTSWS] section 2.2.4.1.

In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, there are only two pieces of information used by the server: the Name attribute of the Field element and the value of the Default child element.

When constructing the name-value pairs to pass to the workflow at initiation, the server builds a set of name-value pairs from the default values of each Field element, merges this with name-value pairs from the workflow initiation form, and converts each value to the .NET type, as specified by a WorkflowConfig.Initiation.Parameters.Parameter element in which the name of the Parameter element exactly matches the name of the Field element.

If the DefaultData element is present, the server uses the contents of that element, instead of following the algorithm outlined previously.

WorkflowConfig.Initiation.DefaultData: If set, the server uses the contents of this element for the data that is described in the WorkflowConfig.Initiation.Fields.Field element. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Extended.Fields: The contents of the Fields element are standard Field elements of the AddOrUpdateFieldDefinition type, as described in [MS-LISTSWS] section 2.2.4.1. When a workflow association is created for a list or document library, the server adds each of these Field elements to that list or document library. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData: The child elements of this element specify various additional properties of a workflow. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.TaskForms: Each TaskForm child element describes one form used to modify a workflow task and how an integer refers to the form. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.TaskForms.TaskForm: Describes how an integer used in a workflow can refer to a task form that has a URN. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.TaskForms.TaskForm.TaskType: Specifies the integer used to refer to a task form. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.TaskForms.TaskForm.FormUrn: Specifies the URN of the form to modify the task. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications: Each child Modification element specifies a workflow modification. A workflow modification is a form in the UI that enables the user to pass data directly to the workflow. The internal workflow logic specifically activates each modification and could deactivate the modification during the lifetime of the workflow. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications.Modification: Specifies one workflow modification. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications.Modification.TypeId: Specifies the identifier that the workflow uses to activate and deactivate the workflow modification. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications.Modification.NameFormat: Specifies the text displayed to users to begin interaction with the workflow modification. If the client places the token {0} in the string, the internal workflow logic can replace it with implementation-specific text. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications.Modification.FormURN: Specifies the URN of the form to display to the user when the user is interacting with the workflow modification. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Modifications.ModificationUrl: Specifies the URL of a form that loads the workflow modification by the URN of the workflow modification. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Instantiation_FormURI: Specifies the URN of the form to display to the user to start the workflow. The server can use this value in conjunction with Initiation.URL. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Instantiation_FormURI.RequiresGeneration: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.MetaData.Instantiation_FormURI.Version: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.MetaData.Association_FormURN: This element is ignored for the AssociateWorkflowMarkup request. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.Association_FormURN.RequiresGeneration: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.MetaData.Association_FormURN.Version: This attribute is ignored for the AssociateWorkflowMarkup request.

WorkflowConfig.MetaData.SigClientSettings: Specifies additional properties that be returned to the client in subsequent calls to the WorkflowConfig.Metadata.SigClientSettings element. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.HasStatusColumn: If set to TRUE, the server provide a field of data on the list item or document on which the workflow is running that indicates the current status of the workflow. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.ExtendedStatusColumnValues: Each child StatusColumnValue element specifies a value that indicates a possible current status of the workflow. These are in addition to any values that the server implementation provides. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.ExtendedStatusColumnValues.StatusColumnValue: Specifies one value for which the internal workflow logic can choose to set the indicator for the list item or document on which the workflow is running to create user-accessible information about the current status of the workflow. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.HasTaskList: If set to TRUE, this workflow has a list to which to add list items that track work that is assigned to users of the system. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.HasHistoryList: If set to TRUE, this workflow has a list to which to add list items that describe the execution of the workflow. The server enable the workflow to add items to this list, and the server can also add items to this list. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.MetaData.AssociateOnActivation: If set to TRUE, this workflow is available to be activated when a feature containing the workflow is activated. This element is ignored in Windows SharePoint Services 3.0.

WorkflowConfig.Version: Specifies which version of the server was in use when the XAML was last modified. This attribute is ignored in Windows SharePoint Services 3.0.

<19> Section 3.1.4.3:

<20> Section 3.1.4.4: Windows SharePoint Services 2.0 does not support this operation.

<21> Section 3.1.4.4: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, when formatConversionOption element is set to "ConvertToWebPartDesignerPersistenceFormat", the input format expected is the DWP format defined in wpv2:WebPart (section 2.2.4.2) or the .webpart format defined in webParts, and the output format is ASP.NET page markup. When formatConversionOption is set to "ConvertToWebPartExportFormat", the input format expected is ASP.NET page markup, and the output format is the DWP format specified in wpv2:WebPart or the .webpart format defined in webParts, depending on the Web Part.

The webParts element specifies a Web Part as follows:

 <s:schema  xmlns:s="http://www.w3.org/2001/XMLSchema" 
    xmlns:wpv3="http://schemas.microsoft.com/WebPart/v3">
    <s:element name="webParts">
       <s:complexType>
          <s:sequence>
             <s:element name="webPart" type="wpv3:webPart" minOccurs="1" maxOccurs="1" />
          </s:sequence>
       </s:complexType>
    </s:element>
 </s:schema>

webParts: Container for one wpv3:webPart element.

webParts.webPart: A wpv3:webPart element specifying a single Web Part.

The webPart complex type specifies a Web Part as follows:

 <s:schema xmlns:s="http://www.w3.org/2001/XMLSchema" 
     targetNamespace="http://schemas.microsoft.com/WebPart/v3"
     xmlns:wpv3="http://schemas.microsoft.com/WebPart/v3">
    <s:complexType name="propertyContainerType">
       <s:sequence>
          <s:choice>
             <s:element name="property" type="wpv3:propertyType" minOccurs="0" maxOccurs="unbounded" />
             <s:element name="ipersonalizable" minOccurs="0" maxOccurs="1">
                <s:complexType>
                   <s:sequence>
                      <s:element name="property" type="wpv3:propertyType" minOccurs="0" maxOccurs="unbounded" />
                   </s:sequence>
                </s:complexType>
             </s:element>
          </s:choice>
       </s:sequence>
    </s:complexType>
    <s:complexType name="webPart">
       <s:sequence>
          <s:element name="metaData" minOccurs="1" maxOccurs="1">
             <s:complexType>
                <s:sequence>
                   <s:element name="type" minOccurs="1" maxOccurs="1">
                      <s:complexType>
                         <s:sequence>
                         </s:sequence>
                         <s:attribute name="name" type="s:string">
                         </s:attribute>
                         <s:attribute name="src" type="s:string">
                         </s:attribute>
                      </s:complexType>
                   </s:element>
                   <s:element name="importErrorMessage" type="s:string" minOccurs="1" maxOccurs="1">
                   </s:element>
                </s:sequence>
             </s:complexType>
          </s:element>
          <s:element name="data" minOccurs="1" maxOccurs="1">
             <s:complexType>
                <s:sequence>
                   <s:element name="properties" type="wpv3:propertyContainerType" minOccurs="1" maxOccurs="1"/>
                   <s:element name="genericWebPartProperties" type="wpv3:propertyContainerType" minOccurs="0" maxOccurs="1"/>
                </s:sequence>
             </s:complexType>
          </s:element>
       </s:sequence>
    </s:complexType>
    <s:complexType name="propertyType">
       <s:attribute name="name" type="s:string" use="required" />
       <s:attribute name="type" type="s:string" use="required" />
       <s:attribute name="null" type="s:boolean" />
    </s:complexType>
 </s:schema>

webPart: Specifies one instance of a Web Part with the descendant elements specifying the type of Web Part and its instance properties.

webPart.metaData: Specifies information related to the type of the Web Part.

webPart.metaData.type: The attributes of this element determine the type of the Web Part. If both are set, name is used. If only one is set, that is used. If neither is set, this element is not valid.

webPart.metaData.type.name: Specifies an implementation-specific<10> string to determine a binary file name and type name for the type of the Web Part.

webPart.metaData.type.src: Specifies an implementation-specific<11> string to determine the location of a text file that contains the implementation of the Web Part.

webPart.metaData.importErrorMessage: Specifies the error message that the server MUST use if it is unable to successfully generate the instance of the Web Part defined by this element.

webPart.data: This element and its descendants specify the instance-specific properties of the Web Part.

webPart.data.properties: The descendant elements determine the instance properties of the Web Part.

webPart.data.genericWebPartProperties: The descendant elements determine the instance properties of the Web Part.

propertyType: Specifies one property as a name-value pair for the instance of the Web Part. The child text node defines the value of the property.

propertyType.name: Specifies the name of the property.

propertyType.type: Specifies an implementation-specific<12> string for the type of the property.

<22> Section 3.1.4.6: Windows SharePoint Services 2.0 does not support this operation.

<23> Section 3.1.4.6.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the controlType.TagName is a prefixed ASP.NET tag name, such as example:value, where example corresponds to a register directive with a matching tagPrefix, and value corresponds to a type located in a way findable with register directives. See [MSDN-Register] for more details on register directives.

<24> Section 3.1.4.6.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the UpdateResponse.Update.Method.N attribute is the method name of any public method available on the ASP.NET Control Designer (System.Web.UI.Design.ControlDesigner) for the control that is referenced by the UpdateID attribute on the same UpdateResponse.Update.Method element.

<25> Section 3.1.4.7: Windows SharePoint Services 2.0 does not support this operation.

<26> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the ItemIdType is either System.Int32 or Microsoft.SharePoint.Workflow.SPItemKey.

<27> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the FunctionName attribute specifies the name of a static Boolean function of the class specified by the ClassName attribute.

<28> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<29> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the ClassName attribute contains a fully-qualified namespace and class name.

<30> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the ItemIdType is either System.Int32 or Microsoft.SharePoint.Workflow.SPItemKey.

<31> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<32> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the ClassName attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with Windows SharePoint Services 3.0 and SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<33> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, this conforms to the schema, as follows:

 <s:schema targetNamespace="clr-namespace:Microsoft.SharePoint
 .WorkflowActions;‌Assembly=Microsoft.SharePoint.WorkflowActions,‌ Version=14.0.0.0, Culture=neutral, PublicKeyToken=null">
    <s:element name="WorkflowDataFields" minOccurs="1" maxOccurs="1">
       <s:complexType>
          <s:sequence>
             <s:element name="WorkflowDataField" minOccurs="0" maxOccurs="unbounded">
                <s:complexType>
                   <s:sequence />
                   <s:attribute name="Name" type="s:string" use="required" />
                   <s:attribute name="Type" type="s:string" use="required" />
                </s:complexType>
             </s:element>
          </s:sequence>
       </s:complexType>
    </s:element>
 </s:schema>

WorkflowDataFields: Specifies a list of local variables to add to the workflow if the ancestor action is added to the internal workflow logic.

WorkflowDataFields.WorkflowDataField: Specifies one local variable to add to the workflow if the ancestor action is added to the internal workflow logic.

WorkflowDataFields.WorkflowDataField.Name: Specifies the name of the local variable to add to the workflow.

WorkflowDataFields.WorkflowDataField.Type: Specifies the class type of the local variable to add to the workflow.

<34> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, this content is equivalent to a portion of Extensible Application Markup Language (XAML).

<35> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, this content is equivalent to a portion of a workflow rules file.

<36> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, this action is Microsoft.SharePoint.WorkflowActions.SPUserCodeWorkflowActivity.

<37> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the FunctionName attribute specifies the name of a static function of the class specified by the ClassName attribute.

<38> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, this action is Microsoft.SharePoint.WorkflowActions.SPUserCodeWorkflowActivity.

<39> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<40> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<41> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<42> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<43> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the ClassName attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<44> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<45> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<46> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<47> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<48> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the Type attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<49> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<50> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<51> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<52> Section 3.1.4.7.2.2: This attribute is not returned in Windows SharePoint Services 3.0.

<53> Section 3.1.4.7.2.2: This attribute is not returned in Windows SharePoint Services 3.0.

<54> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<55> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the From attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<56> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<57> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the To attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<58> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<59> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<60> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the Assembly attribute contains the fully-qualified name of the assembly, in .NET assembly reference syntax.

<61> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<62> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the ClassName attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<63> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the SourceType attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<64> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the DestinationType attribute contains a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<65> Section 3.1.4.7.2.2: In SharePoint Foundation 2010, the string value to replace the placeholder with is a fully-qualified namespace and class name. For information about creating classes that are compatible with SharePoint Foundation 2010, see [MSDN-BCAUSPD].

<66> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, TypeFilter is a semicolon-delimited list of namespace-qualified .NET type names. For example, the operator "contains the substring" is available only if the left-hand operand is a string, so the TypeFilter attribute for that option would be set to "System.String", and thus the "contains the substring" operator would only appear in the list of available options for a FieldBind if the value of the parameter specified in the Field attribute of that FieldBind was of type "System.String".

<67> Section 3.1.4.7.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Type attribute contains a fully-qualified .NET namespace, type, and assembly name string, for example, "System.String, mscorlib".

<68> Section 3.1.4.7.2.2: This attribute is not returned in Windows SharePoint Services 3.0.

<69> Section 3.1.4.7.2.2: This attribute is not returned in Windows SharePoint Services 3.0.

<70> Section 3.1.4.7.2.2: This attribute is not returned in Windows SharePoint Services 3.0.

<71> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<72> Section 3.1.4.7.2.2: This element is not returned in Windows SharePoint Services 3.0.

<73> Section 3.1.4.8: Windows SharePoint Services 2.0 does not support this operation.

<74> Section 3.1.4.8.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010. assemblyName is the fully-qualified name of the assembly, in .NET assembly reference syntax.

<75> Section 3.1.4.8.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, baseTypes is a list of .NET assembly qualified class names.

<76> Section 3.1.4.8.2.2: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 return an XML-encoded string that contains the XML of the following schema. Each type that is referred to or specified in this XML has a non-negative integer assigned to it.

 <s:schema elementFormDefault="qualified">
   <s:complexType name="AType">
     <s:sequence>
       <s:element name="G" type="GType" minOccurs="0" maxOccurs="unbounded" />
     </s:sequence>
     <s:attribute name="Y" type="s:string" use="required"/>
   </s:complexType>
  
   <s:complexType name="EType">
     <s:sequence>
       <s:element name="Value" minOccurs="0" maxOccurs="unbounded">
         <s:complexType>
           <s:simpleContent>
             <s:extension base="s:string">
               <s:attribute name="N" type="s:string" />
             </s:extension>
           </s:simpleContent>
         </s:complexType>
       </s:element>
     </s:sequence>
     <s:attribute name="ID" type="s:nonNegativeInteger" use="required"/>
     <s:attribute name="Y" type="s:nonNegativeInteger" use="optional"/>
   </s:complexType>
  
   <s:complexType name="GType">
     <s:sequence />
     <s:attribute name="Y" type="s:string" use="required"/>
     <s:attribute name="ID" type="s:nonNegativeInteger" use="optional"/>
     <s:attribute name="E" type="s:string" use="optional"/>
     <s:attribute name="Serial" type="s:string"  use="optional"/>
     <s:attribute name="T" type="s:string"  use="optional"/>
     <s:attribute name="Bound" type="s:string" use="optional"/>
     <s:attribute name="AssemblyQualifiedName" type="s:string" use="optional" />
   </s:complexType>
  
   <s:complexType name="PType">
     <s:sequence>
       <s:choice maxOccurs="unbounded">
         <s:element name="A" type="AType" minOccurs="0" maxOccurs="unbounded" />
         <s:element name="P" type="PType" minOccurs="0" maxOccurs="unbounded" />
       </s:choice>
     </s:sequence>
     <s:attribute name="ID" type="s:nonNegativeInteger" use="optional"/>
     <s:attribute name="F" use="optional">
       <s:simpleType>
         <s:restriction base="s:string">
           <s:pattern value="U?R?W?D?" />
         </s:restriction>
       </s:simpleType>
     </s:attribute>
     <s:attribute name="N" type="s:string" use="required"/>
     <s:attribute name="Y" type="s:string" use="optional"/>
     <s:attribute name="C" type="s:string" use="optional"/>
  
     <s:attribute name="R" type="s:string" use="optional"/>
     <s:attribute name="E" type="s:string" use="optional"/>
     <s:attribute name="Serial" type="s:string"  use="optional"/>
     <s:attribute name="T" type="s:string"  use="optional"/>
     <s:attribute name="Bound" use="optional">
       <s:simpleType>
         <s:restriction base="s:string">
           <s:enumeration value="True" />
         </s:restriction>
       </s:simpleType>
     </s:attribute>
     <s:attribute name="AssemblyQualifiedName" type="s:string" use="optional" />
   </s:complexType>
  
   <s:complexType name="RType">
     <s:sequence>
       <s:element name="Y" type="YTypeSimple" minOccurs="0" maxOccurs="unbounded" />
     </s:sequence>
     <s:attribute name="N" type="s:string" use="optional"/>
   </s:complexType>
  
   <s:complexType name="YType">
     <s:sequence>
       <s:choice maxOccurs="unbounded">
         <s:element name="P" type="PType" minOccurs="0" maxOccurs="unbounded" />
         <s:element name="A" type="AType" minOccurs="0" maxOccurs="unbounded" />
       </s:choice>
     </s:sequence>
     <s:attribute name="N" type="s:string" use="optional"/>
     <s:attribute name="ID" type="s:nonNegativeInteger" use="required"/>
     <s:attribute name="Base" type="s:nonNegativeInteger" use="optional"/>
     <s:attribute name="DataSource" use="optional">
       <s:simpleType>
         <s:restriction base="s:string">
           <s:enumeration value="True" />
         </s:restriction>
       </s:simpleType>
     </s:attribute>
     <s:attribute name="Designer" type="s:nonNegativeInteger" use="optional"/>
   </s:complexType>
  
   <s:complexType name="YTypeSimple">
     <s:sequence>
     </s:sequence>
     <s:attribute name="N" type="s:string" use="optional"/>
     <s:attribute name="ID" type="s:nonNegativeInteger" use="required"/>
   </s:complexType>
  
   <s:element name="Assembly">
     <s:complexType>
       <s:sequence>
         <s:element name="R" type="RType" minOccurs="0" maxOccurs="unbounded"/>
         <s:choice maxOccurs="unbounded">
           <s:element name="Y" type="YType" minOccurs="0" maxOccurs="unbounded" />
           <s:element name="E" type="EType" minOccurs="0" maxOccurs="unbounded" />
         </s:choice>
       </s:sequence>
       <s:attribute name="N" type="s:string" use="required"/>
     </s:complexType>
   </s:element>
  
 </s:schema>

AType: Specifies a .NET attribute of a class or property.

AType.Y: The number referring to the type of attribute to construct.

EType: Specifies an enumeration and the possible values of the enumeration.

EType.ID: The Identifier that other elements can use to refer to this enumeration type.

EType.Y: If the numerical type of the enumeration is not Int32, this number refers to the type of the enumeration.

EType.Value: Each Value element refers to one possible value for the enumeration. The text content of the element is the .NET numerical value of the enumeration value.

EType.Value.N: The .NET name of the enumeration value.

GType: Specifies an argument to an attribute constructor.

GType.Y: The number referring to the type of argument to pass to the attribute constructor.

GType.ID: If the value of Y is or exactly derives from System.Type, ID is the number of the type that is the value to be passed to the attribute constructor. If ID is set, E, Serial, T, and Bound is not set.

GType.E: If set, this specifies the value of the enumeration type to pass to the attribute constructor. If set, T, Serial, and Bound is not set.

GType.Serial: A base 64-encoded serialized form of the object to pass to the attribute constructor. If set, T, E, Bound, and ID is not set.

GType.T: A textual serialized object to pass to the attribute constructor. If set, E, ID, and Serial is not set.

PType: Specifies a property or nested property of a .NET type. This includes the default value of the property.

PType.Name: The name of the property.

PType.Y: The number that refers to the .NET type obtained or set by this property.

PType.Flags: Specifies the operations enabled for a property.

Character	Description
U	If the property cannot be used by operations supported by the client, the server returns this character as part of the Flags attribute.
R	If the property cannot be read, the server returns this character as part of the Flags attribute.
W	If the property can be written, the server returns this character as part of the Flags attribute.
D	If the property has a matching System.Workflow.ComponentModel.DependencyProperty object, the server returns this character as part of the Flags attribute.

PType.C: If a System.ComponentModel.TypeConverter exists for the type of the property, the number referring to the type converter class is returned as this attribute.

PType.ID: If the value of Y is or derives from System.Type, this is the number of the type that is the default value of the property. If set, E, Serial, T, and Bound is not set.

PType.E: If set, this specifies the value of the enumeration type as the default value of the property. If set, T, Serial, and Bound is not set.

PType.Serial: A base 64-encoded serialized form of the object as the default value of the property. If set, T, E, Bound, and ID is not set.

PType.T: A textual serialized object as the default value of the property. If set, E, ID, and Serial is not set.

RType: This element refers to another assembly, and the YTypeSimple elements contained in it are the types from that external assembly that can be referenced later.

RType.N: The name of the assembly that contains the YTypeSimple elements.

YType: This element specifies a single type that exists with the assembly specified by the ancestor Assembly element.

YType.N: The name of the type.

YType.ID: The identifier for other elements to refer to this type in the ancestor assembly.

YType.Base: The number of the parent type of this YType that is part of the baseTypes list in the call to GetAssemblyMetaData.

YType.DataSource: If set to TRUE, this YType implements the System.Web.UI.IDataSource interface.

YType.Designer: If present, this is the number of the type used as the control designer for this YType.

YTypeSimple: This element matches a type from the parent RType element with a number that can be referenced by other elements to refer to this assembly-type pair.

YTypeSimple.N: The name of the type.

YTypeSimple.ID: The number available for other elements to refer to this assembly-type pair.

Assembly: This element contains all RType, YType, and EType objects that are present in the server system in the assembly named by the assemblyName parameter of the GetAssemblyMetaData method that are derived from or are required by sub elements of types that derive from the set of base types specified in the baseTypes parameter of the GetAssemblyMetaData method.

Assembly.N: The name of the assembly.

<77> Section 3.1.4.9: Windows SharePoint Services 2.0 does not support this operation.

<78> Section 3.1.4.9: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 follow the ASP.NET resource localization model described in [MSDN-AWPRO].

<79> Section 3.1.4.9.2.1: In ASP.NET markup for binding to global resources, the first of two values specified is the Class, and the second value is the ResourceID. In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, this operation returns all resources of the specified Class (the value of the ResourceName parameter), regardless of ResourceID. The Class corresponds to the name (as described in [MSDN-AWPRO]) of a resx file on disk (in the format described in [MSDN-RIRF]), at wwwroot\wss\VirtualDirectories\80\App_GlobalResources, where 80 is the port assigned to the server instance.

For example, the following ASP.NET Button control is bound to a localized resource as follows:

 <asp:Button runat="server" Text="<%$ Resources:WSS, master_TurnOnAccessibility %>" />

The Text property of this control is bound to the localized resource with the class "WSS", and the ResourceID of "master_TurnOnAccessibility". This presumes that the server has a resource file named "WSS.resx" and any versions of this resource file at the correct location.

<80> Section 3.1.4.9.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the return value is XML-encoded XML markup in the .resx file format described in [MSDN-RIRF].

<81> Section 3.1.4.10: Windows SharePoint Services 2.0 does not support this operation.

<82> Section 3.1.4.10.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, each Assembly element refers to one .NET assembly and namespace containing ASP.NET controls.

<83> Section 3.1.4.10.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Name attribute contains the fully-qualified name of the assembly, in standard .NET assembly reference syntax. The assembly name is formatted in a way supported by an ASP.NET "@ Register" directive, as described in [MSDN-Register].

<84> Section 3.1.4.10.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the TagPrefix attribute contains a suggested ASP.NET tag prefix to use for controls in this assembly and namespace. If present, the client uses this and the Template attribute of the Control element to generate markup for inserting that control. If this attribute is not present, the client programmatically generates a suitable tag prefix for this assembly and namespace. Windows SharePoint Services 3.0 and SharePoint Foundation 2010 use reflection on the control class and retrieve the value of TagPrefixAttribute if that attribute is present on the control. Otherwise they omit the attribute.

<85> Section 3.1.4.10.2.2: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 return all ASP.NET controls that meet all the following criteria:

The assembly that contains the control is on the safe assembly list.
The control has IsSafe and AllowRemoteDesigner set to TRUE.
The control class derives from Control and not WebPart.
The namespace that contains the control does not begin with "System".
The control class has the ToolboxDataAttribute attribute applied.

<86> Section 3.1.4.10.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, this is the class name without namespace or assembly qualification.

<87> Section 3.1.4.10.2.2: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 return the fully-qualified class name. This string is shown by the client in a tooltip when hovering over the control.

<88> Section 3.1.4.10.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, this attribute contains XML-encoded ASP.NET markup that the client uses when inserting this control. The string "{0}" is substituted for the control’s tag prefix in the Template attribute. If this attribute is missing (this will not happen in the current implementation), the client instead generates the corresponding ASP.NET markup by using the contents of the Title attribute.

<89> Section 3.1.4.11: Windows SharePoint Services 2.0 does not support this operation.

<90> Section 3.1.4.12: Windows SharePoint Services 3.0 does not support this operation.

<91> Section 3.1.4.12.2.2: In SharePoint Foundation 2010, the server reduces the RowLimit to 5 so that the client needs only five rows of data and expands any AllFields element so that the client has the list of all the FieldRef elements.

<92> Section 3.1.4.13: Windows SharePoint Services 2.0 does not support this operation.

<93> Section 3.1.4.14: Windows SharePoint Services 2.0 does not support this operation.

<94> Section 3.1.4.14: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the server returns a list of assemblies that contain all control elements that are marked as approved by server administrators as part of a configuration element.

<95> Section 3.1.4.16: Windows SharePoint Services 2.0 does not support this operation.

<96> Section 3.1.4.16.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the server can return both DWP and the format described in [MSDN-WPCDF].

<97> Section 3.1.4.18: Windows SharePoint Services 2.0 does not support this operation.

<98> Section 3.1.4.18: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the server returns markup similar to what is returned by the get document FPSE method defined in [MS-FPSE] section 3.1.5.3.6, but with additional annotations to the returned document, including but not limited to the following:

If the source document on the server contained a Unicode byte order mark, it is removed from the document and replaced by the string "<HasByteOrderMark/>".
ASP.NET controls in the page can have additional attributes applied to them that contain information to be used by the client application as rendering hints. These additional attributes have the namespace "__designer" (underscore underscore designer), such as "__designer:Preview", which contains HTML markup that can be used as a preview of what that ASP.NET control would render at runtime.
<WebPart> tags are added to the markup of Web Parts on the page, containing Web Part properties in a format similar to that defined in [MSDN-WPCDF].

<99> Section 3.1.4.18.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the server returns markup similar to what is returned by the get document FPSE method defined in [MS-FPSE] section 3.1.5.3.6, but with additional annotations to the returned document, including but not limited to the following:

If the source document on the server contained a Unicode byte order mark, it is removed from the document and replaced by the string "<HasByteOrderMark/>".
ASP.NET controls in the page can have additional attributes applied to them that contain information to be used by the client application as rendering hints. These additional attributes have the namespace "__designer" (underscore underscore designer), such as "__designer:Preview", which contains HTML markup that can be used as a preview of what that ASP.NET control would render at runtime.
<WebPart> tags are added to the markup of Web Parts on the page, containing Web Part properties in a format similar to that defined in [MSDN-WPCDF].

<100> Section 3.1.4.20: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, GetWebPartPageDocument returns similar, but not identical, results to the GetWebPartPage operation (section 3.1.4.18). It is strongly recommended that implementers of new clients that operate with a Windows SharePoint Services 3.0 or a SharePoint Foundation 2010 server use GetWebPartPage instead.

<101> Section 3.1.4.20: The GetWebPartPageDocument operation is provided for compatibility with clients that interact with Windows SharePoint Services 2.0 servers and is obsolete in Windows SharePoint Services 3.0 and SharePoint Foundation 2010. Windows SharePoint Services 3.0 and SharePoint Foundation 2010 do not support this operation on pages that contain new constructs, such as ASP.NET Web Parts.

<102> Section 3.1.4.20.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the server returns markup similar to what is returned by the get document FPSE method defined in [MS-FPSE] section 3.1.5.3.6, but with additional annotations to the returned document, including but not limited to the following:

If the source document on the server contained a Unicode byte order mark, it is removed from the document and replaced by the string "<HasByteOrderMark/>".
ASP.NET controls in the page can have additional attributes applied to them that contain information to be used by the client application as rendering hints. These additional attributes have the namespace "__designer" (underscore underscore designer), such as "__designer:Preview", which contains HTML markup that can be used as a preview of what that ASP.NET control would render at runtime.
<WebPart> tags are added to the markup of Web Parts on the page, containing Web Part properties in a format similar to that defined in [MSDN-WPCDF].

<103> Section 3.1.4.22: Windows SharePoint Services 2.0 does not support this operation.

<104> Section 3.1.4.22.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the supported formats for this operation are the DWP format defined in wpv2:WebPart (section 2.2.4.2) or the .webpart format defined in webParts (the element is defined in <24>).

<105> Section 3.1.4.23.2.1: An example of a query supported in Windows SharePoint Services 3.0 and SharePoint Foundation 2010 can be found at [MSDN-GETXML].

<106> Section 3.1.4.24: Windows SharePoint Services 2.0 does not support this operation.

<107> Section 3.1.4.25.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Properties element contains XML-encoded content in the DWP format defined in wpv2:WebPart (section 2.2.4.2).

<108> Section 3.1.4.25.2.2: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the Results.Result.DesignerInfo.Preview contains HTML.

<109> Section 3.1.4.26.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the formats supported for the webPartXml property are the DWP format defined in wpv2:WebPart (section 2.2.4.2) and the .webpart format defined in webParts ( the element is defined in <24>).

<110> Section 3.1.4.27: Windows SharePoint Services 2.0 does not support this operation.

<111> Section 3.1.4.27.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the formats supported for the webPartXml property are DWP format defined in wpv2:WebPart (section 2.2.4.2) and the .webpart format defined in webParts (the element is defined in <24>).

<112> Section 3.1.4.28: Windows SharePoint Services 2.0 does not support this operation.

<113> Section 3.1.4.28.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the workflowMarkupText element contains XML-encoded XAML markup, as described in [MSDN-UWM].

<114> Section 3.1.4.28.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the rulesText element contains XML-encoded RULES markup, as described in [MSDN-UWM].

<115> Section 3.1.4.28.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the configBlob element contains XML-encoded markup in the format of a workflow configuration file, as described in [MSDN-WCSO]. If the value of the flag parameter is "1", this element is empty.

The following is the schema for the workflow configuration markup:

 <s:schema elementFormDefault="qualified">
    <s:element name="WorkflowConfig">
       <s:complexType>
          <s:sequence>
             <s:any namespace="##any" minOccurs="0" maxOccurs="unbounded" />
             <s:element name="Association" minOccurs="0" maxOccurs="1">
                <s:complexType>
                   <s:sequence>
                   </s:sequence>
                   <s:attribute name="TaskListID" type="s:string" use="optional" />
                   <s:anyAttribute />
                </s:complexType>
             </s:element>
             <s:element name="ContentTypes" minOccurs="0" maxOccurs="1">
                <s:complexType>
                   <s:sequence>
                      <s:element name="ContentType" minOccurs="0" maxOccurs="unbounded">
                         <s:complexType>
                            <s:sequence>
                               <s:any namespace="##any" minOccurs="0" maxOccurs="unbounded"/>
                            </s:sequence>
                            <s:attribute name="ContentTypeID" type="s:string" use="required" />
                            <s:attribute name="Form" type="s:string" />
                            <s:anyAttribute />
                         </s:complexType>
                      </s:element>
                   </s:sequence>
                </s:complexType>
             </s:element>
             <s:any namespace="##any" minOccurs="0" maxOccurs="unbounded" />         </s:sequence>
       </s:complexType>
    </s:element>
 </s:schema>

WorkflowConfig: The root element of the workflow configuration file.

WorkflowConfig.Association: Information about how the client authoring the workflow can later associate the workflow with objects on the server.

WorkflowConfig.Association.TaskListID: The GUID of a list that will have different content types applied to it. In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if this attribute is empty or null, the server selects an existing task list or creates a new task list with a default name. If the server either reuses an existing list or creates a new task list, all future references to WorkflowConfig.Association.TaskListID use the value of the GUID of the list.

WorkflowConfig.Association.HistoryListID: The GUID of a list in which to place list items that record information about the workflow. In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, if this attribute is empty or null, the server selects an existing list or creates a new list with a default name. If the server either reuses an existing list or creates a new list, all future references to WorkflowConfig.Association.HistoryListID use the value of the GUID of the list.

WorkflowConfig.ContentTypes: The container for all ContentType elements that the client requests be present on the task list identified by WorkflowConfig.Association.TaskListID.

WorkflowConfig.ContentTypes.ContentType: Specifies one content type requested by the client to be present on the task list identified by WorkflowConfig.Association.TaskListID.

WorkflowConfig.ContentTypes.ContentType.ContentTypeID: The identifier of the content type in the form of a hexadecimal number.

WorkflowConfig.ContentTypes.ContentType.Form: The site-relative URL of the form to be used when editing an item of the ContentTypeID content type in the WorkflowConfig.Association.TaskListID list.

WorkflowConfig.ContentTypes.ContentType.WorkflowForm: If preceded by a slash (/), this string is a site-collection relative URL. If not, it is a site-relative URL. This specifies the URL of the form to be used when editing an item of the ContentTypeID content type on the WorkflowConfig.Association.TaskListID list. If Form is set, the server ignore this value. This attribute is ignored by Windows SharePoint Services 3.0.

<116> Section 3.1.4.28.2.1: In Windows SharePoint Services 3.0 and SharePoint Foundation 2010, the flag parameter is used to control whether the server creates support objects for the workflow. The following table summarizes the values for flag supported by Windows SharePoint Services 3.0 and SharePoint Foundation 2010.

Flag	Description
1	The server validates workflowMarkupText and rulesText, if present, and the server ignore configBlob. In this mode, the server merely validates the content provided and does not make permanent configuration changes as a result.
2	The server validates workflowMarkupText and rulesText, if present, and configBlob. In this mode, the server validates the content provided and creates the support objects for this workflow.

The following table summarizes whether each element is required to have content, based on the value of the flag element.

Flag	workflowMarkupText	rulesText	configBlob
1	Required non-empty.	Optionally empty.	Ignored
2	Required non-empty.	Optionally empty.	Required

<117> Section 3.1.4.28.2.2: Windows SharePoint Services 3.0 and SharePoint Foundation 2010 return the GUID of the task list for the workflow.

Share via

7 Appendix B: Product Behavior

Additional resources