Microsoft Exchange and.net Integration in ADOBE COLDFUSION 8

Size: px

Start display at page:

Download "Microsoft Exchange and.net Integration in ADOBE COLDFUSION 8"

Paul Wilson
5 years ago
Views:

1 Microsoft Exchange and.net Integration in ADOBE COLDFUSION 8 Ramchandra Kulkarni Sr. Computer Scientist 29 th June

2 Agenda Exchange Integration Why Exchange Integration Scope of Exchange Integration How it works Tags for Exchange Integration Setting up Exchange Server.NET Integration Why.NET Integration Scope of.net Integration How it works How to use Setup for.net Integration 2

3 Microsoft Exchange Integration 3

4 Why Microsoft Exchange Integration? Microsoft Exchange server is widely used Difficult to integrate using Java or ColdFusion New tags to make Exchange integration very easy for CF developers 4

5 Scope of MS Exchange Integration To provide easy access to manage Calendar events messages Contacts Tasks What you can do Create, update, delete, get and respond to Calendar events Create, update and delete Contacts and Tasks Get, delete, move and set attributes of messages Supports non-english versions of Exchange Server Supports form-based authentication Supports Exchange Server versions 2000, 2003 and

6 Exchange Integration How it works ColdFusion Server WebDA HTTP / HTTPS IIS MS Exchange Server CFExchange tags use WebDAV to connect to Exchange Server Can connect over HTTP or HTTPS Can access Exchange Server from non-windows machine 6

7 CFExchange Tags Following new tags for Exchange Integration CFExchangeConnection CFExchang CFExchangeTask CFExchangeCalendar CFExchangeContact CFExchangeFilter Steps for using exchange tags Create a connection CFExchangeConnection, action = open Perform actions using CFExchange tags - action = create get modify delete Use CFExchangeFilter with GET action to narrow search results Close connection CFExchangeConnection, action = close 7

8 CFExchangeConnection <cfexchangeconnection action = "open " connection = connection_name" server = name_or_ip_of_nerver" username = user_name password = "user password" mailboxname = "Exchange mailbox" exchangeserverlanguage = language formbasedauthentication = "yes no port = port_num" protocol = "http https" proxyhost = name_ip_proxy_host" proxyport = "proxy_port > <cfexchangeconnection action = "close" connection = connection_name" > <cfexchangeconnection action = getsubfolders connection = connection_name folder = inbox/cf recurse = yes no > 8

9 CFExchange Tag Design Most tags have following actions.. Create Modify Get Delete GetAttachments DeleteAttachments Create action accepts a Struct with parameters that desribe the new Exchange Item Create action returns UID of the item Modify action takes UID of the item to be modified and Struct with only those params that are to be modified Get action can have embedded cfexchangefilter tags to narrow search CFExchangeFilter takes name-value or name-from-to parameters 9

10 CFExchangeCalendar <cfexchangecalendar action = "create event = "#event_struct# connection = connection_var result = uid_var > <cfexchangecalendar action = "get name = quey_var_name connection = connection_name > <cfexchangecalendar action = "modify event = "#event_struct# uid = uid notify = yes no connection = " connection_name"> <cfexchangecalendar action = "respond" responsetype = "accept decline tentative" uid = uid" connection = "connection_name" message = "string" notify = "yes no"> <cfexchangecalendar action = "deleteattachments" uid = uid" connection = " connection_name"> <cfexchangecalendar action = "getattachments" name = query_var_name" uid = uid attachmentpath = "directory path" connection = "connection_name" generateuniquefilenames = yes no"> 10

11 Example Getting Calendar Events  <cfexchangeconnection action = open server = username = ram password = **** connection = con1 >  <cfexchangecalendar action = get connection= con1 name= q1 > <cfexchangefilter name = starttime from = 6/1/07 to= 7/1/07 > <cfexchangefilter name = from value = user1@ram.com > </cfexchangecalendar>  <cfexchangeconnection action = close connection = con1 > 11

12 Example Creating Recurring Events <cfscript> event = StructNew() ; event.requiredattendees = user1, user2 ; event.starttime = 6/29/07 10:00 AM ; event.endtime = 6/29/07 11:00 AM ; event.subject = CFExchange Demo ; event.message = Let s meet to see CFExchange Demo ; event.isrecurring = true; event.recurrencetype = WEEKLY ; event.recurrencefrequency = 2; event.recurrencedays = MON,THU ; event.recurrenceenddate = 6/29/08 ; </cfscript> <cfexchangecalendar action = "create" event = "#event#" result = "uid" connection = "con1 > 12

13 CFExchang <cfexchang action name connection folder = "get" = query_name" = connection_name" = exchange folder path"> <cfexchang action = "set" message = "#msg_struct#"> uid = "message UID"> Can set IsRead, Importance and Sensitivity <cfexchang action meetinguid name connection mailuid = "getmeetinginfo" = "meeting UID" = "query identifier" = "connection_name" = "message_uid"> <cfexchang action uid connection folder = "delete" = uid1,uid2,uid3" = "connection ID" = exchange folder path"> <cfexchang action = "move" destinationfolder = exchange folder path"" connection = "connection ID" folder = exchange folder path"> Other Actions getattachments deleteattachments 13

14 CFExchang Examples  <cfexchang action = get connection = con1 name = msg_query > <cfexchangefilter name = MessageType value = MeetingRequest > <cfexchangefilter name = "TimeSent" from= 6/28/07"to= 6/29/07"> </cfexchang >  <cfexchang action = move folder = inbox destinationfolder = inbox/ram connection = con1 > <cfexchangefilter name = FromId value = ram > </cfexchang > 14

15 CFExchangeContact <cfexchangecontact action = "create contact = "#contact_struct# connection = connection_var result = uid_var > < cfexchangecontact action = delete" uid = uid, " connection = "connection_name > < cfexchangecontact action = "get name = quey_var_name connection = connection_name > Other Actions getattachments deleteattachments < cfexchangecontact action = "modify contact = "#contact_struct# uid = uid connection = " connection_name"> 15

16 CFExchangeTask <cfexchangetask action task connection result = "create = "#task_struct# = connection_var = uid_var > < cfexchangetask action uid connection = delete" = uid, " = "connection_name > < cfexchangetask action name connection = "get = quey_var_name = connection_name > Other Actions getattachments deleteattachments < cfexchangetask action = "modify task = "#task_struct# uid = uid connection = " connection_name"> 16

17 Setting up Exchange Server for CFExchange IIS must be up and running on the Exchange Server Make sure that /Exchange virtual folder is created in IIS Allow access to Microsoft Exchange Server in the Web Service Extension of IIS Mailbox access can be set in Active Directory Users and Computers Go to Users node Open properties dialog box of a user Open Exchange Advanced Tab Click Mail Box Rights button 17

18 Troubleshooting and Error Handling Make sure Exchange Server is accessible from CF Server Ping Exchange Server from CF server Make sure mailbox on the Exchange Server is accessible from OWA - for 2000 and 2003 servers - for 2007 server If using https protocol make sure Exchange Server certificate is present in the certificate store of CF Server If Exchange Server requires form based authentication, then set formbasedauthentication to true in cfexchangeconnection tag In some cases cfexchangeconnection tag throws error HTTP response code : <code> 18

19 Microsoft Exchange Integration - Summary Makes it very easy to access Exchange functionality Familiar tag based solution Can access Calendar, Mail, Contact and Tasks Supports Exchange versions 2000, 2003 and 2007 Supports form based authentication Can also be used with non-english Exchange Server Supports http and https protocols 19

20 CFExchange DEMO 20

21 Microsoft.NET Integration 21

22 Why.NET Integration Leverage functionality implemented in existing.net programs Leverage Microsoft products like Word, Excel, PowerPoint etc. Acquired components and services 22

23 Scope of.net Integration Call local or remote.net assemblies Can call assemblies outside firewall No.NET runtime required on ColdFusion machine CFObject and CreateObject enhanced to create.net objects Can access.net assemblies on multiple machine Secure communication possible using SSL Hot deployment of assemblies ColdFusion components cannot be called from.net directly.net UI components cannot be created from CF 23

24 How.NET Integration Works in CF CFML Application View.NET Assembly Invokes Java Proxy Uses Config file Read Classes Invokes` Java Side Agent ColdFusion Side TCP / HTTP SSL.Net Side Agent.NET Side 24

25 Syntax for creating.net Object <cfobject type=".net" class=".net class" name="object name" assembly="list of assemblies" [optional] protocol="tcp http" [optional] secure="true false" [optional] server="ipaddress [optional] port="port"> [optional] CreateObject(".NET", ".NET class") CreateObject(".NET", ".NET class", "assembly list") CreateObject(".NET", ".NET class", "assembly list", "IP Address, port ) CreateObject(".NET", ".NET class", "assembly list", "IP Address", "port", "protocol", "secure") 25

26 Invoking method on.net Object Constructors use init < cfobject type=.net class= com.comp.account assembly= act.dll name= act > <cfset act.init( Rupesh, 1000)> Static method <cfset types = act.getaccounttypes()>  Calling methods <cfset balance = act.getbalance()> Accessing public fields (using Get_fieldname() and Set_fieldname()) <cfset types = act.get_name()>  No setter if the field is final 26

27 Calling Local.NET Assembly.NET extensions need to be installed on CF machine No additional setup is required Proxies are generated automatically Proxies are cached for future reference till they are changed Default port of.net agent application is

28 Calling Remote.NET Assembly JNBDotNetSide.exe must be running on the.net side Use jnbproxy.exe and jnbproxygui.exe to create java proxies Proxies for supporting classes are generated automatically Add class names to JNBDotNetSide.exe.config Copy proxy jar to CF machine Generating proxies not required if same assembly exist on the CF machine 28

29 Data Type Conversion Any.NET to CF data type conversion Primitive, Date, HashTable, ArrayList, and DataTable to CF types Only primitive CF to.net data type conversion Primitive, Date, Array List is string and converted as such in.net Not supported Struct and Query To disable automatic conversion of complex.net data types use -Dcoldfusion.dotnet.disableautoconversion=true can use DotNetToCFType to manually convert types Use javacast() if required javacast enhanced to support byte, short,char and their arrays. 29

30 When to use Javacast Ambiguous Method Arguments Example 1 public void foo(int param) public void foo(short param) foo(12) X foo(javacast( short, 12)) - Example 2 public void foo (String arg1) public void foo (int arg1) foo( 123 ) X foo(javacast( String, 123 )) - 30

31 Web Services Vs CF8.NET Invocation Web Services Loose Coupling Coarse granular and less programmatic control Low on performance Stateless Most useful when calling external systems (third party services like weather/stock price Web Services) Runtime Unification Tight Coupling Fine granular and more programmatic control as it is like invoking local objects High on performance Stateful Most useful when used with internal systems of enterprise. 31

32 .NET Integration Summary Seamless. You don t need to know much about.net Location independent. Can be local or remote Can be even outside the firewall (over the web). Platform independent. CF on any platform.net will of course be on a windows Hot deployment of assemblies Communication with multiple.net side Secure Auto conversion from/to basic CF data types to/from.net 32

33 DEMO.NET Integration Demo 33

34 Questions? rakulkar@adobe.com 34

35 35

Basic object (component)

Basic object (component) Object Oriented Coldfusion : 1 : Intro to Object.cfc Posted At : August 22, 2007 11:25 PM Posted By : Adrian J. Moreno Related Categories: ColdFusion, Primers, OOP Think of a Coldfusion Component, first