Workplace Lookup Multi Select Advanced Settings

NOTE: This field is not supported in actions.

Append Source to URL

This checkbox is used to specify whether or not the referring URL should be included in the lookup’s link value on the item’s display form.

• If the checkbox is selected, the URL will be appended to the item’s link

• If the checkbox is not selected, the URL will be excluded from the link value

Create New Item URL

Use this property to specify the URL to be opened so that users can create additional/new Lookup items without having to leave the current form. This property supports the Common Use Variables stated at the beginning of this help topic.

Enforce Post

When enabled, forces information to be passed into the page as a post request, rather than a get request. This disables the ability to add ?Parameter=Value to the page.

Loading HTML

This property allows you to specify any text or HTML value to be displayed within a search-enabled lookup’s selection form page while any busy activity is occurring. If no value is specified, the user will be presented with the default loading screen with the spinning gears animation.

Lookup ID Key Source

The XML node location of the value that will be used by the Workplace Lookup to assign a unique identification key to each choice item. If the Lookup Configuration has been set up to utilize a different Lookup Value to Store and URL to XML, this property becomes required for the Workplace Lookup to function correctly. This property can be specified in one of two ways:

1) A simple xpath query, represented by the following:
:xpath=(your xpath query here)

2) An XML string, which allows you to specify a more complex value consisting of multiple xpath queries and static text values. The XML string will contain a values root node with child value nodes representing your individual string pieces. The value nodes contain a single attribute type which tells the property whether it should treat the value as static text or an xpath query. The attribute values are type="text" or type="xpath".

Default: empty

Example:             :xpath=NewDataSet/Table1/Title
                                <values>
                                                <value type="xpath">NewDataSet/Table1/Title</value>
                                                <value type="text"> - </value>
                                                <value type="xpath">NewDataSet/Table1/Description</value>
                                </values>

TIP: If there is no single value that you can use to uniquely identify each choice, try using the second property to join two or more values to create one unique value.

Lookup Link Source

The XML node location of the value that will link the choice back to its parent details. This link is utilized on the item display form from within SharePoint. This property is optional. It can be specified in one of two ways:

1) A simple xpath query, represented by the following:
:xpath=(your xpath query here)

Default: empty

Lookup Selection Setup

The XML node location of the display text to be presented by the lookup to users as the choices for selection. This property can be specified in one of two ways:

1) A simple xpath query, represented by the following:
:xpath=(your xpath query here)

2) An XML string, which allows you to specify a more complex value consisting of multiple xpath queries and static text values. The XML string must contain a values root node with child value nodes representing your individual string pieces. The value nodes contain a single attribute type which tells the property whether it should treat the value as static text or an xpath query. The attribute values are type="text" or type="xpath".

Default: empty

NOTE: The values returned by this property cannot contain a semicolon in the content, as this character is used for item separation.

Lookup Value to Store

The XML node location of the value that will be stored in the SharePoint list when the item is selected and the list item is saved. This property is optional; if no value is provided, the lookup will utilize the value represented by the URL to XML. This property can be specified in one of two ways:

1) A simple xpath query, represented by the following:
:xpath=(your xpath query here)

Default: Value of the URL to XML property

Pass Through XML

Use this property to pass page parameters onto the page specified in the URL to XML property. This supports the Common Use Variables stated at the beginning of this help topic. You must encode the < and > symbol when using the parameters (e.g., < < and > >).

Example:

<Pass>

<PTRequest>SearchString</PTRequest>

<PTName>SearchString</PTName>

</Pass>

</PassThrough>

Return All Search Items

(Boolean) Select this option to force a user to search on a value before any data will be returned. This can prevent users from straining a web server when working with lookups that have large data sets.

URL to XML

The URL of the data source referenced by the Workplace Lookup Multi Select to populate its choices. This property also supports the Common Use Variables stated at the beginning of this help topic.

Default: empty

Examples: http://domain.com/LookupDataSources/Contacts
<%SiteURL%>/LookupDataSources/Contacts

URL to XML with Filter

This is a required setting; if left blank, no data will be returned. It establishes a connection to your filtered data source connection. This property also supports the Common Use Variables stated at the beginning of this help topic.

Note: The Workplace Lookup will pass a query string parameter "filter=" with the value of the search filter on the right side of the equation. If using the External Data Provider, you will need to make sure you have provided this parameter as part of the value nodes.