Difference between revisions of "Setup for opentaps email Handling"

From Opentaps Wiki
Jump to navigationJump to search
(The Special '''opentaps''' Email Client)
Line 22: Line 22:
  
 
From this description it is evident that configuring the email for '''opentaps''' processing is a task for the same technical administrator who has set up your regular email service, or someone who is familiar with system file configuration, email setup, and programming scripts that use regular expressions.
 
From this description it is evident that configuring the email for '''opentaps''' processing is a task for the same technical administrator who has set up your regular email service, or someone who is familiar with system file configuration, email setup, and programming scripts that use regular expressions.
 +
 +
==Configure User Email Addresses==
  
 
==Outbound Email Setup==
 
==Outbound Email Setup==

Revision as of 20:10, 7 October 2009

The Special opentaps Email Client

This section discusses special opentaps processing for email, which can be configured by a technical system administrator.

opentaps includes an email client with some special features that present your business email as a part of the context for teamwork and coordination. Thus, it is well worth the effort to set up email in order that the user's email can appear in the activity information for all business transactions (Cases, Orders, Accounts, etc.) on the system.

opentaps email makes use of your existing outbound email service (SMTP) and your existing inbound email service (POP3, or IMAP) when the users email IDs are entered in opentaps by Setting User Profile, and the email server address and server authentication info are configured into the relevant opentaps system files. Also, a regular expression string is configured to provide for detecting the email addresses that are relevant to your opentaps business processing.

Some minor additional configuration of your inbound email server software is required to route email to the opentaps special address for inbound email reception.

When your outbound email is copied to this special address it is archived in context with the related opentaps transactions similar to the inbound email as we have discussed.

Finally, the teamwork context of opentaps can be enhanced further by enabling notification emails to your team members whenever certain things happen, which they should be made aware of, including:

  * When people are added or removed from activities or events
  * When people are assigned to leads and accounts
  * When catalog requests have been successfully fulfilled 
  * Optional -- When a catalog request is fulfilled an email can be sent to the customer who
      requested it.

From this description it is evident that configuring the email for opentaps processing is a task for the same technical administrator who has set up your regular email service, or someone who is familiar with system file configuration, email setup, and programming scripts that use regular expressions.

Configure User Email Addresses

Outbound Email Setup

To enable the opentaps email client to send outbound mail through your company SMTP mail server proceed as follows:

*  Open a terminal session on your opentaps server
*  Change directories on your opentaps server to the opentaps installation directory
*  Edit this file: framework/common/config/general.properties
*  Edit this line to read: mail.notifications.enabled=Y
*  Edit this line: mail.smtp.relay.host=yourmailserverurl
   (example - mail.yourcompany.com)
*  If your mail server requires an ID and password to authenticate then
   Edit: mail.smtp.auth.user=yourauthenticationname_goes_here
   Edit: mail.smtp.auth.password=yourauthenticationpassword_goes_here
   Leave these two blank if you don't use this authentication type
*  If you want to control the maximum upload size in bytes then
   Edit: http.upload.max.size=yourvalue_goes_here
*  Save your changes to this file.

This file contains special configuration options you can use for gmail compatibility as needed.

This completes the configuration for outbound email.

Inbound Email Setup

The Listener Function

Archiving Outbound Email Via the Listener

Associating Emails for Strong Context

Notification Emails for Strong Context