Introduction to GroupWise ® C3POs Glade Monson Developer Services, Novell Inc.

© March 9, 2004 Novell Inc. 2 one Net: Information without boundaries…where the right people are connected with the right information at the right time to make the right decisions. The one Net vision Novell exteNd ™ Novell Nsure ™ Novell Nterprise ™ Novell Ngage SM : : : :

© March 9, 2004 Novell Inc. 3 The one Net vision Novell Nterprise is an innovative family of products which gives you the power to enable and manage the constant interaction of people with your business systems — regardless of who they are or where they are. Novell Nterprise ™ Novell exteNd ™ Novell Nsure ™ Novell Nterprise ™ Novell Ngage SM : : : :

© January 16, 2004 Novell Inc, Confidential & Proprietary 4 Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources

© January 16, 2004 Novell Inc, Confidential & Proprietary 5 What is a C3PO? Custom 3rd-Party Object (C3PO) A COMServer object used to extend Novell GroupWise ® – Add menus, menu items and separators – Add buttons to the toolbar – Trap predefined commands – Catch GroupWise events – Build custom message types with custom message icons – Access To GroupWise Client State. Uses the Windows system registry to identify itself to GroupWise

© January 16, 2004 Novell Inc, Confidential & Proprietary 6 COM Automation Visual Basic Delphi C++ Accessible through any language that supports Component Object Model (COM)

© January 16, 2004 Novell Inc, Confidential & Proprietary 7 Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources

© January 16, 2004 Novell Inc, Confidential & Proprietary 8 C3PO objects Objects must implement specific behavior C3POServer CommandFactory GWCommand EventMonitor IconFactory

© January 16, 2004 Novell Inc, Confidential & Proprietary 9 C3POServer Init CanShutdown DeInit Methods Description CommandFactory EventMonitor IconFactory Properties

© January 16, 2004 Novell Inc, Confidential & Proprietary 10 Init WantCommand BuildCommand CustomizeContext Menu CustomizeMenu CustomizeToolBar MethodsProperties CommandFactory No properties

© January 16, 2004 Novell Inc, Confidential & Proprietary 11 BaseCmd LongPrompt Parameters PersistentID ToolTip MethodsProperties GWCommand Execute Help Undo Validate

© January 16, 2004 Novell Inc, Confidential & Proprietary 12 MethodsProperties EventMonitor No properties Notify

© January 16, 2004 Novell Inc, Confidential & Proprietary 13 Events eGW_CMDEVTID_READY eGW_CMDEVTID_SHUTDOWN eGW_CMDEVTID_DELIVERY eGW_CMDEVTID_OVERFLOW

© January 16, 2004 Novell Inc, Confidential & Proprietary 14 GetIcons MethodsProperties No properties IconFactory

© January 16, 2004 Novell Inc, Confidential & Proprietary 15 Custom Message Types Contexts GW.MESSAGE.APPOINTMENT GW.MESSAGE.DOCUMENTREFERENCE GW.MESSAGE.MAIL GW.MESSAGE.NOTE GW.MESSAGE.PHONE GW.MESSAGE.TASK GW.MESSAGE.MAIL.XXX

© January 16, 2004 Novell Inc, Confidential & Proprietary 16 C3PO logic flow Menus Context menus Toolbar buttons Initialize Customize ValidateExecute

© January 16, 2004 Novell Inc, Confidential & Proprietary 17 C3PO Logic Flow (cont.) GroupWise Commands WantCommand Execute BuildCommand GroupWise Events Notify

© January 16, 2004 Novell Inc, Confidential & Proprietary 18 CommandFactory IconFactoryC3POServer EventMonitor GWCommand

© January 16, 2004 Novell Inc, Confidential & Proprietary 19 Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources

© January 16, 2004 Novell Inc, Confidential & Proprietary 20 C3PO Creation Wizard The Wizard makes it easy

© January 16, 2004 Novell Inc, Confidential & Proprietary 21 Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources

© January 16, 2004 Novell Inc, Confidential & Proprietary 22 Menu and Menu Items Hands On Demonstration

© January 16, 2004 Novell Inc, Confidential & Proprietary 23 Objective Build a C3PO that adds a menu to the GW Client | Tools menu Add a menu item to the menu Don’t forget to register your C3PO

© January 16, 2004 Novell Inc, Confidential & Proprietary 24 Add a Menu or Menu Item

© January 16, 2004 Novell Inc, Confidential & Proprietary 25 Where Will the Menu Appear?

© January 16, 2004 Novell Inc, Confidential & Proprietary 26 Where Will the Menu Appear? (cont.)

© January 16, 2004 Novell Inc, Confidential & Proprietary 27 Name the Menu

© January 16, 2004 Novell Inc, Confidential & Proprietary 28 Where Will the Menu Item Appear?

© January 16, 2004 Novell Inc, Confidential & Proprietary 29 Item Text, Prompt, Persistent ID

© January 16, 2004 Novell Inc, Confidential & Proprietary 30 Summary

© January 16, 2004 Novell Inc, Confidential & Proprietary 31 Language?

© January 16, 2004 Novell Inc, Confidential & Proprietary 32.EXE or.DLL?

© January 16, 2004 Novell Inc, Confidential & Proprietary 33 Register Switch to your Windows desktop From a command prompt or Start | Run type “pathtoyourc3po\c3po.exe” /r C3PO STARTUP.BAS calls sub main procedure sub main calls RegC3PO RegC3PO registers your C3PO with GW and Windows /u will unregister a C3PO

© January 16, 2004 Novell Inc, Confidential & Proprietary 34 Regedit Software Novell GroupWise 5.0 C3PO DataTypes HKEY_LOCAL_MACHINE

© January 16, 2004 Novell Inc, Confidential & Proprietary 35 Capture a Command Hands On Demonstration

© January 16, 2004 Novell Inc, Confidential & Proprietary 36 Objective Build a C3PO that captures the send command for a message of type appointment display a message box send the message Don’t forget to register your C3PO

© January 16, 2004 Novell Inc, Confidential & Proprietary 37 Capture a Command

© January 16, 2004 Novell Inc, Confidential & Proprietary 38 Context

© January 16, 2004 Novell Inc, Confidential & Proprietary 39 Commands

© January 16, 2004 Novell Inc, Confidential & Proprietary 40 Commands (cont.) eGW_CMDID_ACCEPT eGW_CMDID_ARCHIVE eGW_CMDID_COMPLETE eGW_CMDID_COMPOSE eGW_CMDID_DECLINE eGW_CMDID_DELEGATE eGW_CMDID_DELETE eGW_CMDID_DOC_CHECKIN eGW_CMDID_DOC_CHECKOUT eGW_CMDID_DOC_RESETINUSE eGW_CMDID_FORWARD eGW_CMDID_OPEN eGW_CMDID_PRINT eGW_CMDID_PROPERTIES eGW_CMDID_REPLY eGW_CMDID_RESEND eGW_CMDID_SAVE eGW_CMDID_SAVEAS eGW_CMDID_SETALARMS eGW_CMDID_UNDELETE

© January 16, 2004 Novell Inc, Confidential & Proprietary 41 Summary

© January 16, 2004 Novell Inc, Confidential & Proprietary 42 Language ?

© January 16, 2004 Novell Inc, Confidential & Proprietary 43.EXE or.DLL ?

© January 16, 2004 Novell Inc, Confidential & Proprietary 44 Register Switch to your Windows desktop From a command prompt or Start | Run type “pathtoyourc3po\c3po.exe” /r C3PO STARTUP.BAS calls sub main procedure sub main calls RegC3PO RegC3PO registers your C3PO with GW and Windows /u will unregister a C3PO

© January 16, 2004 Novell Inc, Confidential & Proprietary 45 Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources

© January 16, 2004 Novell Inc, Confidential & Proprietary 46 Developer Resources Software, Sample Code, and Documentation Support / forums.novell.com/category/index.tpt

© January 16, 2004 Novell Inc, Confidential & Proprietary 48 General Disclaimer This document is not to be construed as a promise by any participating company to develop, deliver, or market a product. Novell, Inc., makes no representations or warranties with respect to the contents of this document, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc., reserves the right to revise this document and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. All Novell marks referenced in this presentation are trademarks or registered trademarks of Novell, Inc. in the United States and other countries. All third-party trademarks are the property of their respective owners. No part of this work may be practiced, performed, copied, distributed, revised, modified, translated, abridged, condensed, expanded, collected, or adapted without the prior written consent of Novell, Inc. Any use or exploitation of this work without authorization could subject the perpetrator to criminal and civil liability.