Mail Target

The Mail Target provides the ability to send the data to any mail box and this feature is available in all the editions of Adeptia Connect.

Perform the following steps to create a mail target:

1. Click Configure > TARGETS > Mail Target.
   

2. Click Create Mail Target.
   
   
   
   

3. On the Create Mail Target screen, enter the details explained in the table below:
   
   

   Field Name	Description
   Name	Name of the new Mail Target.
   Description	Description of the new Mail Target.
   Protocol	Internet standard protocol to be used for sending outgoing mails. The available options are SMTP and MAPI. Based on the selected protocol, the default port number for that protocol is displayed in the Port text box. MAPI option will appear for license version. To send an e-mail through Microsoft Exchange Server, select MAPI in Protocol drop down box. To connect Adeptia Suite with Microsoft Exchange Server, you need to buy a third party tool called J-Integra for Exchange. J-Integra for Exchange is a high performance middleware bridge that enables Java Exchange interoperability. If you want to retrieve mails from an Exchange Server using J-Integra, select MAPI in the Protocol drop down box. If MAPI is selected in the Protocol drop down box: Enter name of the exchange server in Outgoing Mail Server text box. Enter the domain name in the Domain text box. Enter the name of the CDO host machine in CDO host machine text box. CDOConfig.exe is the tool that comes with the J-Integra for Exchange SDK and is used for configuring CDO. Host where CDO is configured is called CDO host machine.
   Outgoing Mail Server	Outgoing mail (SMTP) Server address
   Security Type	Protocol that provide data encryption and authentication between applications and servers in scenarios where that data is being sent across an insecure network. The available options are SSL, TLS, None. This implementation is specific, if and only if, SMTP Protocol is selected in the Protocol drop down box. Supported TLS verison is 1.2.
   Port	Port number of the Outgoing Mail Server
   From(Email-Id)	Sender's Email id.
   To Email-Id(s)	Email-Id(s) of the recipients separated by commas.
   CC	Provide the recipient's email id you want to copy for this mail target event. However, you can still change this email id later at run-time by changing the values in context variable. For steps to do change at runtime, refer towards end of this page.
   BCC	Provide the recipient's email id you want to put in BCC for this mail target event. However, you can still change this email id later at run-time by changing the values in context variable. For steps to do change at runtime, refer towards end of this page.
   Subject	Subject of the Target email.
   Authentication Type	Select the type of authentication from the Authentication Type field. The available options are Basic and OAuth 2.0.
   OAuth Account	Select one of the available OAuth accounts from this field. It is available only when you select OAuth 2.0 as an authentication type. OAuth Account field displays only those OAuth Accounts for which you have selected Use In Mail Activity check box while creating the account. Click here to know how to create an OAuth Account.
   User Id	Username of the Mail Server. In case you have selected OAuth authentication type, this field will not appear.
   Password	Password of the Mail Server. In case you have selected OAuth authentication type, this field will not appear.
   Confirm Password	Re-write the same password to confirm.
   Message Content Type	Content type of the outgoing message. The available options are HTML and Plain.
   Priority	Priority of the email. The email, which will be sent by this mail target activity, will have the priority flag as selected in this drop-down box. The available options are Normal, High, Low.
   Data Location	Location of the data in the email whether sent as an Attachment or in the email Body. Select Multipart to send both attachments and email body in the mail target. If you select Multipart option, perform the following steps: Connect the output stream of the target layout to the mail target. The output of the target layout is sent as an Attachment in the mail target. Create a Put-Context Var activity before the mail target and set the variable and Message Body in Variable Value to send it as an email Body in the mail target. For example, VariableName: Service.<<MailTargetActivityName>>.MessageBody
   File Name	Name of the file, if the data is to be sent in the email as an attachment.

4. Expand Advanced Properties.
5. Define the required character set encoding code in the Character Set Encoding Used textbox.
   
6. Select the project from the drop-down list of Project.

7. Click Save. 

   You can verify the mail target activity at the design time. For this, click Test. This verifies the values given in the Outgoing Mail (SMTP) Server, Port, User ID and Password text boxes.

Changing the values CC & BCC at Runtime

Adeptia Connect allows you to change the values of CC or BCC in a Mail Target by creating a Context Variable in the Process Flow. Note the following points while creating Context Variable:

1. Write the variable name as "Service.<<mail_target_activity_name>>.cc". For example if the mail target activity name is SF_VendorA_Targetmail, then the variable name should be Service.SF_VendorA_Targetmail.cc.
2. Write the email id that needs to be put in the cc in Variable Value. You can write multiple emails separated by comma in the variable value.
3. For using BCC write Service.<<mail_target_activity_name>>.bcc. Rest of the steps are similar to creating variable for CC.
4. Place the Context Variable after the Mail Activity in the Process Flow.
5. Click Done and save the process flow.

Adding custom email headers in a Mail Target activity

You can add custom email headers to a Mail Target activity. While creating a Mail Target activity, you’ll be able to see the Custom Email Headers section wherein you can add the email headers based on your choice.

Follow the steps below to define custom headers in a Mail Notification activity.

1. In the Custom  Email Headers section,
   
   
   • In the Header Name field, enter the name of the header.

   • In the Header Value field, enter the value for the corresponding header.

     By clicking Add Row you get more rows to add custom email headers and their values.
2. Complete the fields that follow, and then click Save.