WebQuery Initial Setup Properties

IMaxWait

Use with the InProgress exit. When WebQuery is fetching a page and the call-flow exits from InProgress exit, it takes some time and therefore you should design the call flow to play some kind of greeting and to check back to WebQuery to see if fetching is done. This property defines the minimum time we afford to stay in WebQuery for this process.

INodeOffset

This is the only property that refers to the returned node. WebQuery hits the ISourceURL using the ISourceType method. When the page becomes available, it searches for the node whose InnerText property meets the ISearchText criteria and whose properties meet all the INodeQueries criteria. When the node is successfully found, the returned results are for nodes whose sourceIndex differs from the found node's sourceIndex by the amount in INodeOffset.

INodeQueries

This is an array of all the properties that we want to use in filtering a searched node. Each item of this array is a text of the form key=value.

EXAMPLE

tagName=TR
vAlign=top

INodeQueries are also case insensitive.

INodeQueries and ISearchText are filtering the node we are searching for, and the returned node will be always at a certain distance (INodeOffset) from it.

INodeQueriesCnt

The number of elements in the array INodeQueries.

ISourceType

This is the type of the URL we are hitting. Must be zero. Reserved for future use.

ISourceURL

This contains the URL being sought and it may also contain VBVoice property substitution. It may look like this:

http://www.theweathernetwork.com/cities/can/%VBVFrame1.aCity%_%VBVFrame1.aProvince%.htm

The use of property substitution may be tricky with the visual user-friendly design screen because it works by example. See below for details.

Note: There is no escape method for the percentage sign if used in this property. That is, if you have a URL containing a percentage sign you must manually replace it with its equivalent. For example,. when this sign is used in URLs it is typically followed by a number to represent a byte with its ASCII code. A space will be something like %20 and replacing it with a real space should work properly because MSHTML handles this correctly.

ISearchText

This is the text you are searching for in the page (must find it in the InnerText property of an element). It also uses property substitution, so it may appear as:

%VBVFrame1.aName%*(???)???-????

In this text you are looking in the page (that must be loaded by now) for a node whose InnerText property starts with the VBVFrame1.aName transfer property and ends with something like a phone number. Use * and ? as wildcards.

If you are looking for a text like the following and are searching for the text Pronexus:

Click Pronexus for a list of our products

It is important to use the wildcard both in the beginning and the end. The ISearchText property should be set to the following:

*Pronexus*

For ease of use, WebQuery makes the search for ISearchText case insensitive.

Note: There is no escape method for wildcards. Therefore you cannot search for text that contains an asterisk or a question mark.

ITimeOut

Sets the maximum acceptable time for fetching a page. When this time is reached, the control exists from the Timeout exit. The range is from 0 to 3600 seconds. A small value is not realistic. On the other hand, pages requiring a longer loading time might benefit from the use of the InProgress exit (see IMaxWait).

Read more about WebQuery control.