Datapolis Process System SDK

Search:

Contents
:
IndexBookmarkPrint
Home > Activities > Activity XMLs > Datapolis Process System Lookup Fields

Datapolis Process System Lookup Fields

 

 

Datapolis Process System contains special Lookup Fields that are very helpful during workflow creation. In general, lookup fields acts as a link to the particular data source used by a workflow. The lookup field could be represented as a link to given SharePoint Web, List or another SharePoint object or Datapolis Process System Parameter.

 

Attributes


Each Lookup Field includes following attributes:

 

Name Description
Name It is unique name of a field. The Name is used to identify the field in the RootPath attribute of an activity parameter.
Title Title which is displayed in Datapolis Process System Designer
Type Type of a field. It represents data source used in Datapolis Process System. It could be a SharePoint object e.g. Site, WebCollection, List etc. or Datapolis Process System Parameter.
ValueType Type of a value returned by a lookup field. It can be one from the following types:
Type
String
Int
Bool
Double
DateTime
Guid
Object

StandardReturnValue Hint which describes type of the ValueType. For example when lookup field points to a SharePoint list then ValueType is a String but this string is in fact URL address of the list hence StandardReturnValue will describe ValueType as a URL address.

Examples


This section provides examples on using lookups in activity development and workflows creation process.

Selecting list

This example shows how to limit lookup nodes so only SharePoint list or library can be selected.

 

Attribute Value
DataType OneLookup
SelectableTypes List
AllowChildrenTypes Current SharePoint SiteCollection Site WebCollection Web ListCollection List

As the result following options are only visible in Datapolis Process System Designer :

 

 

Choosing site template

This example shows how to limit lookup nodes so only site, language and site template can be selected. 'Create web site' uses the same configuration.

 

  • First parameter is site (ex. Name="ParentWebUrl").
Attribute Value
DataTyp OneLookup
SelectableTypes Web
AllowChildrenTypes Current SharePoint SiteCollection Site WebCollection Web

 

 As the result following options are only visible in Datapolis Process System Designer :

 

On lookup tree there will be only site collections and sites visible. When particular site or site collection is chosen it will provide Id to the activity (SPWeb.ID) (see Site).

  • The second parameter is language (ex. Name="WebLanguage").
Attribute Value
DataType OneLookup
SelectableTypes WebTemplateLanguage
AllowChildrenTypes WebTemplateLanguage
RootPath @ParentWebUrl/WebParameterCollection/WebTemplateCollection/

As the result following options are only visible in Datapolis Process System Designer :

 

 

Only nodes of type WebTemplateLanguage are visible and can be selected. The difference between this parameter and previous parameters is selected RootPath. This attributes selects the root node of lookup tree. It takes selected path from ParentWebUrl (the '@' means that this part of path is lookup from another parameter) and combines it with '/WebParameterCollection/WebTemplateCollection/'. In ParentWebUrl we could choose only web so in lookup tree will be shown web templates of selected web - as on the provided image. When particular WebTemplateLanguage is selected it will provide LCID to the activity (SPWeb.Locale.LCID) - see Language

  • Last parameter is web template (ex. Name="WebTemplate").
Attribute Value
DataType OneLookup
SelectableTypes WebTemplate
AllowChildrenTypes WebTemplate
RootPath @WebLanguage

 

As the result following options are only visible in Datapolis Process System Designer :

 

 

See Site templates for more information about site templates nodes structure. The difference between this parameter and previous parameters is selected RootPath. RootPath contains only WebLanguage. WebTemplate is a child node of a WebLanguage so it has to be configured in this way - see WebTemplate. When particular WebTemplate is selected it will provide template name to the activity (SPWebTemplate.Name).