Www.novell.com Intermediate Programming with the Novell GroupWise ® Object API John Cox DSE...

www.novell.com

Intermediate Programming with the Novell GroupWise® Object API

John CoxDSE Worldwide Developer SupportNovell, Inc.devsup@novell.com

Vision…one NetA world where networks of all types—corporate and public, intranets, extranets, and the Internet—work together as one Net and securely connect employees, customers, suppliers, and partners across organizational boundaries

MissionTo solve complex business and technical challenges with Net business solutions that enable people, processes, and systems to work together and our customers to profit from the opportunities of a networked world

Agenda

• Overview• API Design• Using the Object API• Developer Resources

agenda

Novell GroupWise® Object API

• Access to GroupWise information store

• Address book and document management Mail messages Appointments Tasks Notes Phone messages

COM Automation

• Accessible through any language that supports Component Object Model (COM)

Visual Basic Delphi C++

Agenda

agenda

FieldFieldDefinitionDefinition

AddressAddressBookBook AccountAccount

AddressAddressBookBookEntryEntry

FieldField

AddressAddress

BusyBusySearchSearch

ElementElement

TimeBlockTimeBlock

ApplicationApplication

AccountAccountRightsRights

AddressAddressFilterFilter

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

AppointmentAppointment

DocRefDocRef

MailMail

TaskTask

NoteNote

PhonePhoneMessageMessage

SharedSharedNotificationNotification

FieldField

AttachmentAttachment

QueryQuery

LookupLookupTablesTables DocumentDocument

DocumentDocumentLibraryLibrary

DocumentDocumentTypeType

AddressAddress

DocumentDocumentversionversion

DocumentDocumentVersionVersionViewerViewer

FieldDefFieldDef

Agenda

agenda

Demo (Login)

GroupWise Login

hands o

Objective

• Build an application that allows a user to enter a user id and password and confirms that the user has logged into GroupWise

FieldField

AddressAddress

ElementElement

TimeBlockTimeBlock

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

DocRefDocRef

MailMail

TaskTask

NoteNote

FieldField

QueryQuery

LookupLookupTablesTables

DocumentDocument

AddressAddress

DocumentDocumentVersionVersion

FieldDefFieldDef

Step 1: Application 1. Application1. Application

FieldField

AddressAddress

ElementElement

TimeBlockTimeBlock

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

DocRefDocRef

MailMail

TaskTask

NoteNote

FieldField

QueryQuery

DocumentDocument

AddressAddress

FieldDefFieldDef

Step 2: Account1. Application1. Application

2. Account2. Account

Early Binding vs Late Binding

• Early binding ( GroupWare Type Library / GWCMA1.DLL)

Dim gwApplication As Application Set gwApplication = New Application2

• Late binding Dim gwApplication As Object Set gwApplication = CreateObject("NovellGroupWareSession")

Advantages of Early Binding

• Development

• Better Debugging

• Faster Run-time

Account Login

• Account login ( [String UserID],

[String CommandLine],[String Password],

[LoginConstants WhenToPrompt], [Variant Reserved] )

• Account MultiLogin(...) * GroupWise 5.5 and above

• Account Proxy( Variant UserID )

Visual Basic (Early binding)

• Login()

Dim gwApplication As Application Dim gwAccount As Account

Set gwApplication = New Application Set gwAccount = gwApplication.Login(“UserID”,, “Pswd”)

Demo (Fields and FieldDefinitions)

Fields and FieldDefinitions

hands o

Objective

• Build an application that will add a FieldDefinition of type string to your GW account

• Add your own custom field to a message• List the Field names, types and values for

the first message in your MailBox

Field-Related Objects

• Field

• Fields

• FieldDefinition

• FieldDefinitions

FieldField

AddressAddress

ElementElement

TimeBlockTimeBlock

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

DocRefDocRef

MailMail

TaskTask

NoteNote

FieldField

QueryQuery

DocumentDocument

AddressAddress

FieldDefFieldDef

1. Application1. Application

2. Account2. Account3. Query, 3. Query,

Find (),Find (),

FindMessagesFindMessages()()

Object Model

4. Field4. Field

Psuedo Code (Fields and FieldDefinitions)

Begin sub routine to add FieldDefinition

Get reference to the FieldDefinitions collection from the Acc obj

Add definition with a name and type

End sub routine

Begin sub routine to add Field

Get reference to the Fields collection of a message that you will send

Add field (name & type of associated field def) along with value to store

End sub routine

Begin sub routine to list non system Fields

Get reference to Messages collection from Acc obj

Loop through the Fields collection of each object and display information where Fields.Count is greater than zero

End sub routine

Demo (Find Messages)

Find Messages

hands o

Objective

• Build an application that uses Find() to display messages based on text, numeric, and date criteria that you specify

Find() and FindMessages()

• Find() and FindMessages() Can take Filter Expression Syntax (string) Filter objects

Expression Syntax

• Text

• Numeric

• Date

Text Expressions

• Examples (SUBJECT CONTAINS "Internet") (AUTHOR MATCHES "Mr. Byg") (MESSAGE BEGINSWITH "Now hear this") (MESSAGE CONTAINS CASE ("Inter*" OR "Intra*") AND

("Test". . "Plan")) (<BOSS,STRING> MATCHES “Mr.Byg”)

Numeric Expressions

• Examples (SIZE < 12000) (NUMBER_ACCEPTED = TOTAL_RECIPIENTS) (<TOTAL_EMPLOYEES,NUMERIC> > 50)

Date Expressions

• Examples (DUEEND_DATE <= TOMORROW) (START_DATE >= 1996/2/5 AT 8:00:00) (CREATE_DATE >= THIS_YEAR 31) (<BIRTHDAY,DATE> = THIS_MONTH)

FieldField

AddressAddress

ElementElement

TimeBlockTimeBlock

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

DocRefDocRef

MailMail

TaskTask

NoteNote

FieldField

QueryQuery

DocumentDocument

AddressAddress

FieldDefFieldDef

Find (),Find (),

Object Model

Psuedo Code (Find Messages)

Begin sub routine to Find Messages

Build an expression string based on the subject entered

Append criteria that accounts for recipient count to the expression

Append criteria that accounts for the created date

Get reference to a Messages collection

Use Find with your expression to return a list of message objects

Loop through MessageList collection to display item information

End sub routine

Demo (Query)

hands o

Objective

• Build an application that lists messages based on enumeration and unary criteria that you specify

• Build a query folder to display the messages

• Query Represent either a stand-alone query or a query

associated with a query folder Can take Filter Expression Syntax (string)

Expression Syntax

• Enumerated

• Unary

• Basic (Groups and Compound)

Enumeration Expressions

• Examples (PRIORITY = HIGH) (ATTACHMENT_TYPE <> OLE) (BOX_TYPE = INCOMING)

Unary Expressions

• Examples (MAIL OR APPOINTMENT) (ACCEPTED AND COMPLETED) (DOCUMENT AND NOT HIDDEN AND NOT READ)

FieldField

AddressAddress

ElementElement

TimeBlockTimeBlock

AddressAddress

RecipientRecipient

FolderFolder

MessageMessage

DocRefDocRef

MailMail

TaskTask

NoteNote

FieldField

QueryQuery

DocumentDocument

AddressAddress

FieldDefFieldDef

Find (),Find (),

Object Model

Basic Expressions

• Groups example (TASK) OR (APPOINTMENT) AND (SUBJECT CONTAINS

"PROJECT7")

• Compound statement example (CREATE_DATE >= YESTERDAY AND CREATE_DATE <=

TODAY)

• Groups and compound statements example (FROM CONTAINS "TJEFFERSON" OR FROM CONTAINS

"jADAMS") AND (MESSAGE BEGINS WITH "When in the course" AND CREATE_DATE = 1776/7/4)

Psuedo Code (Query)

Begin sub routine to Query

Build an expression string based on the priority selected

Append type criteria to the expression

Append custom text field criteria

Append box type criteria

Create a query object, set Folder name (from text field) & query location (your account obj)

Look at Folder.Messages for results to populate list box

End sub routine

Agenda

•Overview•API Design•Using the Object API•Developer Resources

agenda

Developer Resources

•Training http://developer.novell.com/support/training/

•Documentation and Sample Code http://developer.novell.com/ndk/gwobjapi http://developer.novell.com/support/sample.htm

•Support 1-800-733-9673 / 1-801-861-5281 devsup@novell.com http://developer-forums.novell.com/category/

index.tpt

Www.novell.com Intermediate Programming with the Novell GroupWise ® Object API John Cox DSE...

Documents

Www.novell.com Avoiding the Top DirXML ™ Issues Sandy Swanson WSS Engineer Novell, Inc. sswanson@novell.com

Www.novell.com High-Availability Messaging: Clustering Novell GroupWise ® Stephen C. Payne Senior Consultant Protocom Development Systems stephen.payne@protocom.com.au

OCS NOVELL SOFTWARE. Novell Clients Typical Novell Configuration Novell Server Print jobs retained in server queue(s)

Www.novell.com Introduction to NDS ® iMonitor Duane Buss Senior Software Engineer Novell, Inc. dbuss@novell.com Tom Doman Senior Software Engineer Novell,

Www.novell.com Beginning Programming with the Novell GroupWise ® Object API John Cox DSE Worldwide Developer Support Novell, Inc. devsup@novell.com

Www.novell.com Customizing a Municipal Web Site with eDirectory™ and GroupWise ® WebAccess Jim Michael I.S. Manager, City of Chesterfield Novell Support

Www.novell.com Using ACLs in LDAP: Creating a Secure Novell eDirectory ™ Infrastructure Mike Richichi Assistant Director of Academic Technology Drew University

Www.novell.com Novell DirXML ™ Commands, Events, and Transformations Shon Vella Software Engineer, Consultant Novell, Inc. svella@novell.com Perin Blanchard

Www.novell.com Novell iChain ® 2.x Configuration Using the Web Server Accelerator Wizard Cary Andrews Senior Software Engineer Novell, Inc. candrews@novell.com

Www.novell.com Introduction to Novell GroupWise ® Administrative Object API Glade Monson Software Engineer Novell, Inc. gmonson@novell.com

Www.novell.com Configuring DirXML™ Drivers for ERP Systems Mark Worwetz Senior Software Engineer Novell, Inc. mworwetz@novell.com Dave Horne eSolutions

Www.novell.com eDirectory ™ In Depth Duane Buss Senior Software Engineer Novell, Inc. dbuss@novell.com Tom Doman Senior Software Engineer Novell, Inc

Www.novell.com Novell NetWare ® 6 Direction and Roadmap Pekka Lindqvist pekka.lindqvist@novell.com

Novell Storage Manager - media.zones.commedia.zones.com/images/pdf/product-flyer-novell-storage-manager.pdf · File and Networking Services Products: Novell Storage Manager “Novell

Www.novell.com Integrating NetWare ® and Linux Jim Henderson Novell Support SysOp Novell Support Forums hendersj@mindspring.com Brad Doster Novell Support

Www.novell.com Analyzing Security In A Novell Environment Alan Mark Chief Security Strategist Novell, Inc. amark@novell.com Geir Mork Manager, Products

DevSup : approche-programme et développement professionnel

Www.novell.com Expose the Power of Novell eDirectory ™ Using Novell eGuide: Advanced Configuration and Customization Nathan Jensen Software Engineer Novell,

Novell SAML Extension for Novell iChain

Www.novell.com Upgrading Legacy Novell Directory Services ® to Novell eDirectory ™ 8.6 Rick Killpack WSS Engineer Novell, Inc. rkillpack@novell.com Connie