# Creating a New Email Control

This topic describes how to create a new Email control.

To learn about Email controls, see Email Control.

To learn about WebLogic Workshop controls, see Using Controls in Business Processes.

To create a new Email control:

1. If you are not in Design View, click the Design View tab.
2. Click Add on the Controls tab to display a drop-down list of controls that represent the resources with which your business process can interact.

Note: If the Controls tab is not visible in WebLogic Workshop, choose View —> Windows —> Data Palette from the menu bar. Instances of controls available to your project are displayed in the Controls tab.

3. Choose Integration Controls to display the list of controls used for integrating applications.
4. Choose Email from the list to display the Insert Control - Email dialog box.
5. In the Step 1 pane, in the Variable name for this control field, type the variable name used to access the new Email control instance from your business process or web service. The name you enter must be a valid Java identifier.
6. In the Step 2 pane, choose the Create a new Email control to use radio button.
7. In the New JCX name field, type the name of your new JCX file. The .jcx filename extension is automatically appended to the name you enter.
8. Decide whether you want to make this a control factory and select or clear the Make this a control factory that can create multiple instances at runtime check box. For more information about control factories, see Control Factories: Managing Collections of Controls.
9. In the Step 3 pane, enter the following name and address parameters:

- smtp-address—The address of the SMTP server in host:port or host form. If the port is not specified, the standard SMTP port of 25 is used.
- from-address—The originating e-mail address
- from-name—The Display name for the originating e-mail address

10. Select the type of data contained in the message body using the body-type menu.
11. Click Create.

If you need to specify reply information (name and address) or SMTP authentication parameters (username and password or password alias), assign values to the following optional parameters using the Property Editor:

- reply-to-address—The e-mail address to reply to
- reply-to-name—The display name for the reply to address
- header-encoding—A string specifying the encoding to be used for the mail headers as specified by from-name, reply-to-name, to, bc, bcc, subject, and attachments. If no header encoding is specified, the system default encoding is used.
- username—The username for servers that require authentication to send.
- password—The password associated with the smtp-username.
- password-alias—The password alias associated with the smtp-username. The alias is used to look up the password in the password store. This attribute is mutually exclusive with the smtp-password attribute.

### Email Control Methods

To learn about the methods available on the Email control, see the EmailControl Interface.