Find.First

Initiates a search into the user's message store using the search parameters provided. Find.First must be specified as a subcommand of Find.Action.

Parameters

Find.First (Required)

Specifies the required subaction.

User.context (Required)

Specifies the context identifier for this user's session.

Find.UpdateList or Find.UpdateCache (Required)

Specifies the folder list context to the find window. Use Find.UpdateList for templates that use frames and use Find.UpdateCache for all other templates.

Find.enableRefresh

Specifies to enable automatic refreshing of the message list while searching.

Find.refreshRate

Specifies the number of seconds to wait before automatically refreshing the page.

Find.queryText

Specifies the text to search for.

Find.bQuerySubject

Specifies whether to search for text string in message subject:

  • true Search for query text only in message subject
  • false Search for query text anywhere in message
Find.queryName

Specifies the text to search for in address fields.

Find.bQueryToCC

Specifies whether to search for queryName in To/From fields only:

  • true Search for queryName only in To/From fields
  • false Search for queryName only in CC/BC fields
Find.folders

Specifies a comma-delimited list of folder IDs that were selected in the folder list. If a collapsed folder is checked, the sub folders do not need to be identified and returned.

Find.folderDrns

Specifies a comma-delimited list of folder DRNs selected in the folder list. This parameter can be used as an alternative to the Find.folders parameter.

Find.Sourt.draft

Specifies to search only draft message items. This parameter can be combined with other Find.Source parameters.

Find.Type.mail

Specifies to search only mail message items. This parameter can be combined with other Find.Type parameters.

Find.Type.note

Specifies to search only note message items. This parameter can be combined with other Find.Type parameters.

Find.Type.task

Specifies to search only task message items. This parameter can be combined with other Find.Type parameters.

Find.Type.appointment

Specifies to search only appointment message items. This parameter can be combined with other Find.Type parameters.

Find.Type.phone

Specifies to search only phone message items. This parameter can be combined with other Find.Type parameters.

Find.Type.document

Specifies to search only document items. This parameter can be combined with other Find.Type parameters.

Find.Source.received

Specifies to search only received message items. This parameter can be combined with other Find.Source parameters.

Find.Source.sent

Specifies to search only sent message items. This parameter can be combined with other Find.Source parameters.

Find.Source.posted

Specifies to search only posted message items. This parameter can be combined with other Find.Source parameters.

Return Values

Value

Description

Find.UpdateList or Find.UpdateCache

Defines the find list window as folder content.

Find.enableRefresh

Set if the page is to be automatically refreshed while searching.

Find.refreshRate

Number of seconds to wait before automatically refreshing the page.

Find.bSearching

1 specifies the server is still searching. The find results are not complete.

Folder.hasMore

1 specifies there are more messages than what was returned.

Folder.hasInbound

1 specifies the returned list of items contains received items.

Folder.hasOutbound

1 specifies the returned list of items contains send items.

Folder.name

Name of the folder.

Folder.queryCount

Display this number of items in the folder.

Folder.enablePrev

1 specifies that the previous button should be displayed.

Folder.enableNext

1 specifies that the display next button should be displayed.

Find.resultsTotal

Total number of items found. Might not be complete if bSearching is set.

Find.resultsFirstDispItem

Relative to the complete find results list, the number of first item displayed.

Find.resultsLastDispItem

Relative to the complete find results list, the number of last item displayed.

Item.count

Number of items returned.

Item[n].id

Identifier of the nth item within the list of items returned.

Item[n].drn

GroupWise specific identifier of the nth item returned.

Item[n].type

Type of the nth item:

  • Appointment
  • Document
  • Mail
  • Note
  • Phone
  • Task

Item[n].priority

Priority of the nth item.

Item[n].from

Sender of the nth item.

Item[n].told

List of user identifiers to whom the nth item was sent.

Item[n].subject

Subject of the nth item.

Item[n].subType

Subtype of the nth item:

  • Item.SHARED_ADDRESS_BOOK
  • Item.PERSONAL
  • Item.SHARED_FOLDER
  • Item.DISCUSSION
  • Item.WORKFLOW
  • Item.REPLY_REQUESTED

Item[n].hasAttachment

Indicates that the nth item has an attachment.

Item[n].folder

Name of the folder that contains the nth item.

Item[n].dateSent

Send date and time of the nth item.

Item[n].dateStart

Start date and time of the nth item.

Item[n].dateEnd

End date and time of the nth item.

Item[n].Status.x

Status of the nth item, where x is any of the following:

  • accepted
  • completed
  • read

Example

<FORM method=post action=/servlet/webacc>
   <INPUT type="hidden" name="User.context" value="psquRmoverPq">
   <INPUT type="hidden" name="action" value="Find.Action">
   <INPUT type="hidden" name="Find.First" value="true">
   <INPUT type="hidden" name="Find.UpdateList" value="1">
   <INPUT type="Radio" Name="Find.bQuerySubject" CHECKED
          value="false">
   <INPUT NAME="Find.queryText" TYPE="text" VALUE="test" SIZE=25 >
   <INPUT type="hidden" name="merge" value="msglist">
</FORM>