docs

Home Getting Started Using the Template Task Guides What’s New

Introduction to xSearch

Finding one record is easy when you know the exact customer number or sort key. Finding all the records that meet a useful description is a different job. xSearch is designed for that job.

Add xSearch to an existing Clarion ABC Browse and let users search record content, including fields they cannot conveniently locate through the browse’s current sort or locator. Matches become tagged records, with a visible indicator in the browse. The user can then decide what to do with that selection.

Search and tag instead of just filter

A normal browse filter controls which records are displayed. When the filter changes, that view changes with it.

xSearch can search across multiple fields and remember which records matched or were selected. The tag is independent of the current browse display. A user can find records, review the selection, add or remove tags manually, and then use the tagged set for another operation. The developer chooses how long tags remain available.

For example, someone might search for a customer by a person’s name, tag several records that need follow-up, switch to a different browse order, and then view only the tagged customers. They don’t have to reconstruct their selection simply because the browse display changes.

Highlights

Put tagged records to work

A user can tag a set of customers and then print a report containing only those customers, or run a process on the same subset, when the receiving report or process has its xSearch extension configured for matching tag storage. The user can be asked whether to restrict the operation to tags, with the number tagged shown in the prompt. The report’s existing selection and sort remain in effect; the report can be invoked through its ordinary button or menu. See Print Reports and Run Processes Using Tags.

Flexible enough for different applications

A small single-EXE program may use a Local Queue and require little shared configuration. A multi-DLL program can define shared queues or persistent tag files for selected data files, while keeping other browses local. This is intentional flexibility: storage is chosen per use, rather than forcing every browse to behave alike.

Getting started

Begin with Installation, Registering the Template, and Using the Template. If your application uses several APPs and DLLs, follow the dedicated Multi-DLL Guide.

Home Getting Started Using the Template Task Guides What’s New