Integration: Viewing Under Your Control

NOTE: Depending on how you originally set up vMedia, it might be located in the root of vMedia rather than in the root of IMASTER. If this is the case, any references to the IMASTER folder should be referred to as vMedia.

Running a Specific or Non-specific Document Search and Retrieval

NOTE: Searches in non-SQL backend databases are case sensitive; however, searches in SQL backend databases are not case sensitive.

NOTE: Part I only needs to be performed one time.

Part I: Configure fixed API parameters in IMASTER.INI as follows:

1. Edit the IMASTER.INI file (Start, Programs, vMedia, vMedia Config File)

2. At the end, add the following text strings in order:

[Alpha4] ViewServerID= {copy value from [StationA] or [StationS]} ViewServerPath= {copy value from appropriate Station section for the WS} SearchDBF= absolute path to the "SC" database to search ExportPath=C:\

A typical Alpha4 section for vMedia would be:

[Alpha4] ViewServerID=FVIEW ViewServerPath=C:\IMASTER\FVIEW32.EXE SearchDBF=F:\vMedia\CLS000SC.DBF ExportPath=C:\

3. Save the file and exit the editor.

Part II: Establishing the DDE conversation with the UI-less module.

When IMDDE.EXE is first invoked, either as part of a user logon script, shortcut icon, or ShellEx call from the application requesting service, the database specified in SearchDBF will be loaded in shared mode and the DDE server services will become available.

It is important to leave IMDDE running to make queries operate as quickly as possible.

Service: IMDDE
Topic: SYSTEM
Executable: IMDDE.EXE
Request Type(s) Supported: EXECUTE

Function 1: Search the vMedia Database and Display the resulting image(s):
SEARCH={expression to search on},{Custom Document Description/Annotation}

Example:

SEARCH=name="smith" .and. address="123 Any Street",UCC Filing

- If the SEARCH conditions result in exactly zero (0) matching documents, control returns to the caller and no document is displayed.
- If the SEARCH conditions result in exactly one (1) matching document, the Viewing window is invoked directly and the document is displayed.
- If the SEARCH conditions result in more than one (>1) matching document, the Search Results list dialog (grid control) displays the list of qualifying documents and the user is allowed to select (and/or multi-select) documents for viewing and printing purposes.

Invoking the Viewer Directly with a List of Pages to be Viewed

Step 1: Create the page list text file.

1. Create a text file on the workstation with a name of your choosing.

2. For each page to be viewed, populate a line in the text file in order as follows:

Full Path and filename of the first page {1 space} Description for the Title Bar/Printing/Emailing Full Path and filename of the second page {1 space} Description for the Title Bar/Printing/Emailing ...etc.

3. Close the file.

Step 2: Call the viewer passing the filename created in step 1.

Service: FVIEW

Topic: SYSTEM

Executable: FVIEW32.EXE

Request Type(s) Supported: EXECUTE

Function: listfile={full path and filespec to listfile created prior to call}, starting page # to view

Related Topics

Introduction vMedia Third-Party Integration