1. www.novell.com Beginning Programming with Novell GroupWise ® C3POs John Cox DSE Worldwide Developer Support Novell, Inc. devsup@novell.com

2. Vision…one Net A 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 Mission To 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

4. Agenda Overview Objects and logic flow Novell C3PO ™ Creation Wizard Build your own C3PO Developer Resources agenda

5. What Is a C3PO ? Custom 3 rd -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  Uses the Windows system registry to identify itself to GroupWise

6. COM Automation Accessible through any language that supports Component Object Model (COM)  Visual Basic  Delphi  C++ COM

7. Agenda Overview Objects and logic flow C3PO Creation Wizard Build your own C3PO Developer resources agenda

8. C3PO Objects Objects must implement specific behavior  C3POServer  CommandFactory  GWCommand  EventMonitor  IconFactory

9. C3POServer Methods  Init  CanShutdown  DeInit Properties  Description  CommandFactory  EventMonitor  IconFactory

10. CommandFactory Methods  Init  WantCommand  BuildCommand  CustomizeContextMenu  CustomizeMenu  CustomizeToolBar No properties

11. GWCommand Methods  Execute  Help  Undo  Validate Properties  BaseCmd  LongPrompt  Parameters  PersistentID  ToolTip

12. EventMonitor Methods  Notify No properties

13. Events eGW_CMDEVTID_READY eGW_CMDEVTID_SHUTDOWN eGW_CMDEVTID_DELIVERY eGW_CMDEVTID_OVERFLOW

14. IconFactory Methods  GetIcons No properties

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

16. C3PO Logic Flow Menus Context menus Toolbar buttons InitializeInitialize CustomizeCustomizeExecuteExecute ValidateValidate

17. C3PO Logic Flow (cont.) GroupWise commandsGroupWise events Want command ExecuteExecute Build command NotifyNotify

19. Agenda Overview Objects and logic flow C3PO Creation Wizard Build your own C3PO Developer resources agenda

20. C3PO Creation Wizard The wizard makes it easy

21. Agenda Overview Objects and logic flow C3PO Creation Wizard Build your own C3PO Developer resources agenda

22. Add a Menu or Menu Item

23. Where Will The Menu Appear ?

24. Where Will The Menu Appear ? (cont.)

25. Name the Menu

26. Where Will The Menu Item Appear ?

27. Item Text, Prompt, Persistent ID

28. Summary

29. Language ?

30. .EXE or.DLL ?

31. 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

32. Regedit HKEY_LOCAL_MACHINE  Software  Novell  GroupWise  5.0  C3PO  DataTypes

33. Menu and Menu Items hands o

34. 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

35. 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

36. Capture a Command

37. Context

38. Commands

39. 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

40. Summary

41. Language ?

42. .EXE or.DLL ?

43. 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

44. Commands hands o

45. Objective Build a C3PO that captures the send command for a message of type appointment, displays a message box then sends the message Don’t forget to register your C3PO

46. 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

47. Agenda Overview Objects and logic flow C3PO Creation Wizard Build your own C3PO Developer resources agenda

48. 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