TID101021 (gw5xob64) - Object API Address Book - AddressBook5

From Developer Community

The Object API provides direct access to the GroupWise data store. This series of examples will demonstrate access to the Address Book. These samples build on each other so the developer can see the Address Book development in a step by step process. All the examples contain this same information document, so find the example that most closely meets your needs and go straight to the code!

DETAILED DESCRIPTION

ADDRESSBOOK1 - This is a VERY BASIC example of the Address Book. AddressBook1 will log you into GroupWise and display 5 fields in the System Address Book.

ADDRESSBOOK2 - AddressBook2 shows how sorting of the Address Book can be done. THE SORTING SHOWN IN THIS EXAMPLE HAS BEEN INTENTIONALLY SLOWED TO SEE HOW THE SORT ROUTINE MOVES THE DATA. The sorting is done using 2 StringGrids and a list box. The Address Book information is placed in the HiddenStringGrid, then the field to sort on and the row number are moved to the HiddenListBox where SORTED = True. Then, based on the row numbers in the HiddenListBox, the information from the HiddenStringGrid is moved to the DisplayStringGrid. This example displays the HiddenStringGrid and the HiddenListBox for demonstration purposes.

For this demonstration the sort is done in 2 steps. The Begin Sort copies the field to sort on (as determined by the first field on the left in the DisplayStringGrid) to the HiddenListBox, appends spaces to position SORT_FIELD_LENGTH (or truncates it at position SORT_FIELD_LENGTH), then appends the row number from the HiddenStringGrid (the stringgrid on the bottom).

The End Sort looks at each line in the HiddenListBox (in order of course), strips off the first SORT_FIELD_LENGTH characters, and uses the row number remaining to know which row in the HiddenStringGrid to move to the next available row in the DisplayStringGrid.

The result is a sorted DisplayStringGrid.

ADDRESSBOOK3 - In AddressBook3 the HiddenListBox and HiddenStringGrid are actually hidden (gee - what a concept). Sorting is also run a full speed.

ADDRESSBOOK4 - Sorting is now automatic when ever a column is moved to the far left position. The big feature here is the search engine provided to search on the sorted column. A slightly more sophisticated search is shown in AddressBook5.

ADDRESSBOOK5 - Sorting is now based on the field chosen in the SortComboBox. The field to sort on can be in any position in the Address Book. The search is improved for Address Books that require more than one full screen. Searching is ALWAYS on the sorted column!

[edit]