TID102418 (DGWABInt) - Delphi Sample: Finding Address Book Entries in International GW Versions

From Developer Community

AUTHOR: WSC DOCUMENT ID: TID102418 DOCUMENT REVISION: DATE: 2001/02/22 11:27 AM ALERT STATUS: Yellow INFORMATION TYPE: Issue README FOR: DGWABINT.EXE NOVELL PRODUCT CLASS:

NetWare API

NOVELL PRODUCT and VERSION:

NetWare NDK Feb01

CATEGORY:

none

COMPILER:

Delphi 4.0

TARGET OS:

Windows 98

ABSTRACT:

DGWABInt is a Delphi 32 bit application that illustrates the use of Delphi with GroupWise's Object APIs.

The main purposes of this application are:

show usage of address book filters in non-US GW versions
allow experimentation with the "Find" method
illustrate GW applications with and without using the GW type library

Address book filters in non-US GW versions

Using filters requires the use of field names, e.g., '( MATCHES "DOE")' Unluckily, field names are language specific, and the French or German version of GroupWise have different words for 'Last name'. The above sample needs to be '( MATCHES "DOE")' in the German GW client. To set the filter correctly for non-US English GW clients, we need to identify the local names of the field names, to create correct filter expressions. For this purpose we use the field IDs and find the field name that matches our hard coded fieldID.

Addressbooks can be filtered on 5 fields ('Name', 'First Name', 'Last Name', 'E-Mail Address', 'Department'), and this routine reads the local field names for these 5 fields by locating the match to the respective fieldID.

Using the GW type library

This sample application can be used with or without the GroupWise type libraries. Without the type libraries, every GW variable is defined as Variant; otherwise the proper type is used with the advantage of speed at execution, and code completion and syntax checking at design time. Set the variable GWTLB if you want to use the type libraries

General information on how to use Delphi with the NetWare SDK can be found in the HOW-TO.DOC file.

To run the application, you must have the GroupWise client installed.

NetWare SDK used: NDK - Feb 01

Platform: Windows Win9x / WinNT / Win2k

Compilers: Borland Delphi 4.x (easyly changable to v3.x/5.x)

DETAILED DESCRIPTION

DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.

Self-Extracting File Name: DGWABINT.EXE

Files Included: Size Date Time

DGWABINT.TXT (this file) PROJECT1.CFG 325 2-22-01 11:27 AM MAIN.DFM 2128 2-22-01 11:27 AM MAIN.PAS 16547 2-22-01 11:27 AM GROUPWARETYPELIBRARY_TLB.PAS 398956 2-22-01 11:27 AM PROJECT1.DOF 1301 2-22-01 11:27 AM PROJECT1.DPR 249 2-22-01 11:27 AM PROJECT1.RES 1220 2-22-01 11:27 AM READ.ME 1965 2-22-01 11:27 AM PROJECT1.EXE 392704 2-22-01 11:27 AM DGWABINT.MSG 1876 2-22-01 11:27 AM

[edit]