Video Screencast Help
Symantec to Separate Into Two Focused, Industry-Leading Technology Companies. Learn more.

Send Email

Created: 13 Jun 2012 • Updated: 19 Mar 2014 | 5 comments
Language Translations
Collaborators: SymantecWorkflowTeam, Chan Eil Fhios
SymantecWorkflowTeam's picture
+1 1 Vote
Login to vote

Send Email

Component definition

This component sends an email. You can set the from address, to address, subject line, and content of the email.

Component icon

Description of component output paths

Unknown

The component output paths are described in the following table:


Property

Description

Unknown

Unknown

Unknown

Unknown

Description of component tabs and their properties

The properties on the Email Contents tab in the Send Email component are listed and described in the following table:



Section

Property

Description

Addressing

From Address

Lets you enter the address from which the message appears to come.

Your SMTP server must be able to send this address.

 

Reply To Address

Lets you enter the reply to address for this message.

 

To Addresses

Lets you enter the list of recipients for this message.

You can use properties, variables, or manually entered text to form the list of recipients.

 

CCAddresses

Lets you enter the list of Carbon Copy recipients for this message.

You can use properties, variables, or manually entered text to form the list of recipients.

 

BCCAddresses

Lets you enter the list of Blind Carbon Copy recipients for this message.

You can use properties, variables, or manually entered text to form the list of recipients.

 

Send Confirmation To

Lets you enter the address that is to receive a confirmation when the email has been sent successfully.

Contents

Subject

Lets you enter the subject for this message.

The message can be any combination of text elements and variables.

 

Send Html Content

Lets you select if you want the body of your message to be HTML content.

 

Html Content

Lets you enter the body of your message using HTML.

 

Send Text Content

Lets you select if you want the body of your message to be Text content.

 

Text Content

Lets you enter the body of your message using Text.

 

File Attachments

Lets you select file attachments for this message.

The properties on the Email Settings tab in the Send Email component are listed and described in the following table:


Property

Description

SMTP Server Name

Lets you enter the name or IP address of the SMTP server through which mail is to be sent. Can be an IP address or a name like mail.myhost.com.

Symantec recommends that you place your SMTP server name in a project property and access it when you select Process Variables.

If your SMTP server changes, you only need to change the project property and all your Send Email components still work.

SMTP Server Port

Lets you enter the port number of the SMTP server through which mail is to be sent.

Priority

Lets you set the priority for this message.

Save Content

Lets you save the email content to a variable.

Save Content File

Lets enter the variable to which to save the email content.

The properties on the Settings tab in the Send Email component are listed and described in the following table:


Property

Description

Component Class Name

The class name of this component. This property is not editable, but useful if you call Symantec support.

Description

The description of this component. This property lets you describe how the component is used. You can use it to provide any wanted documentation for this component.

This description is included in the model reports that are created when you click Plugins > Generate Business Model.

Location

The physical location of the top left point of this component on the workflow model.

Name

The name of this component. You can change the name.

If you changed the component name when you double-clicked it on the workflow model, the changed name appears here.

Override Background Color

This property lets you change the background color of this component.

To Do

This property lets you record what you still need to do with the component. Use this property to help you remember the configuration that you want to apply to this component.

The text that you enter for this property appears at the bottom of the component editor. If you enter text for this property, a checklist symbol appears on the component in the workflow model.

Is Enabled

This property lets you enable or disable the component. By default, components are enabled. When a component is disabled, it has no effect on the Project. Uncheck Is Enabled to disable the component.

  • Execution Outcome

    If a component with more than one outcome path is disabled, you must select which outcome path you want the component to take. Click the Execution Outcome drop-down list and select the outcome path for the workflow to follow.

  • Disabled Mapping

    If the component has output parameters, you must configure all output parameters with fixed data to pass on. This configuration can be performed in the Disabled Mapping option.

Connection information

Not applicable

Component settings

Unknown

Use cases

Some examples for the Send Email component are as follows:

 
  • Vacation approval

    An employee submits a vacation request to a manager for approval. Later, the Send Email component sends an email to notify the employee of the manager's decision.

  • Server monitoring notification

    When a server's memory gets too low, the Send Email component sends an email to the server administrator.

  • Presenting a Dialog Workflow dialog to a user

    The Send Email component sends an email that includes a link to the dialog that is contained in a Dialog Workflow component.

Vacation approval

Scenario: An employee submits a vacation request. The request is presented to a manager in a Web dialog. After clicking Approve or Reject in the Web form, the process sends an email to the employee with the results of the manager's decision.

Process: This process is created as a Workflow Project type.

The following screen shot shows the process:

If the manager rejects the request, the Rejected path sends a rejection email and then ends the process. If the manager approves the request, the Approved path sends an approval email and then the process ends.

The Send Email component knows where to send the email based on how it is configured.

The following screen shot shows the Send Email component editor:

For more information on configuring the Send Email component, see the Workflow Solution User's Guide.

www.altiris.com/support/documentation.aspx

For more information on presenting a Web form to a user with the Dialog Workflow component, see the introduction to this document.

Other components in this example are as follows:

 
  • Dialog Workflow

Server monitoring notification

Scenario: A monitoring process monitors the amount of free disk space on a server. If the disk space is between 15 gigabytes and 200 gigabytes, no action is taken. If the disk space is between 5 gigabytes and 15 gigabytes, an email is sent to the server administrator with a low disk space warning. If the disk space is between zero and 5 gigabytes, an email is sent to the server administrator with an urgent low disk space warning.

Process: This process is created as a Monitoring Project type.

The following screen shot shows the process:

The GetComputerInfo component retrieves data from the server and delivers it to a Number Range Rule component. The Number Range Rule component looks specifically at the hard drive space variable and evaluates its value.

Based on the amount of space found, the process either sends an email, or takes no action. Notice that different emails are sent based on the urgency of the situation.

Other components in this example are as follows:

 
  • GetComputerInfo

  • Number Range Rule

Presenting a Dialog Workflow dialog to a user with an email

Dialog Workflow components stop a process to present a Web dialog to a user to obtain necessary information.

Before the user can input the necessary information in the Web dialog, the user must first access the dialog. Dialog Workflow components contain a start process for the purpose of presenting the user with the Web dialog. One common way to present the end user with the Web dialog is to send an email with a link to it. The Send Email component sends the email.

To present a dialog to a user with the Send Email component

  1. In your process, double-click the Dialog Workflow component to open its editor.

  2. Click the Event Configuration tab.

  3. Click the Start Process [...] button.

    The Start Process editor opens, which by default contains only a start and an end component.

  4. Add a Send Email component and connect all three components.

  5. Configure the Send Email component.

    • Set the From Address, To Address, and Subject.

    • Click on the HTML content [...] button.

    • From the left panel, drag ResponsePageLink onto the email workspace.

      A link is added in the email to the dialog that is contained in the Dialog Workflow component.

    • Click OK to exit the content editor.

    • Click OK to exit the email editor.

  6. Click OK to exit the start process editor.

 

Comments 5 CommentsJump to latest comment

Robert Lundsten's picture

Hello!

I am using this component all the time but now I recently noticed that we get time out when using this at one specific customer. Can you specify a timeout somehow? Do you have some tips?

Thanks!

0
Login to vote
reecardo's picture

I'd check the Send Email via SMTP component in the LogicBase.Components.Email library. Pretty sure you can specify a timeout there.

0
Login to vote
Robert Lundsten's picture

Hi reecardo!

Yes, I have checked the "Send Email via SMTP" and that is also missing a timeout input.
Any more ideas? :)

0
Login to vote
reecardo's picture

I think the IMAP/POP3 comps have timeout values, but I think it just means the timeout in attenpting to establish a connection to the mail server...

You might want to submit an idea for this.

0
Login to vote
jmankin's picture

if its throwing an exception on timeout you could catch it with a trigger and send back through again. I would add a counter so say after three attempts if it still cannot connect to the SMTP server to just move on.

0
Login to vote