MetaServer > Help > Forward Email

030-120 MetaServer Export – Forward Email

MetaServer’s Forward Email feature allows you to forward your original, imported email (including attachments, if applicable) to a specified recipient(s). Fields can be used to specify the email recipient(s) and subject.

Some example use-cases:

– Forward the original email to trigger a business process.
– Forward the original email to a predefined email address to save it in a document management system.
– Forward the original email if it has an invalid attachment to a pre-defined email address for exception processing.

In our example, we will make use of the “CB – FLOATING DATA” workflow. This workflow is automatically installed with CaptureBites MetaServer.

In this example workflow, if an email is rejected during import (invalid attachment, etc.), we will forward it to management.

 

To add a Forward Email action, select the action after which you want to insert the Forward Email action and press Add -> Forward Email. The Setup window will automatically open.

 

You can also open an existing Forward Email action by double-clicking the action or by pressing the setup button on the right side of the action or in the ribbon, as shown below.

 

TIP: The thumbnail on the right will follow you, so you can easily refer to the Setup window. Click on the thumbnail to make the image larger.

Don’t forget to add a description to your action.

01 – SMTP Server: replace the placeholder CaptureBites SMTP Server settings with your own SMTP Server details. The CaptureBites SMTP server is only meant for demo and test purposes, please use your own server settings when the workflow is used in production.

Your SMTP Server settings can be found by contacting your IT department or through your e-mail provider. SMTP settings for Gmail can be found as step 2 here. For Office 365, you can find the SMTP settings here.

1) Address: enter your email provider’s SMTP server address.

2) User name: the user name is typically your email address. When in doubt, contact your IT department.

3) Password: enter your SMTP server password. This is often the password you use to log into your email system. When in doubt, contact your IT department.

4) Timeout: if you have a slow or erratic internet connection, consider increasing the Timeout setting.

5) Check internet connection: if you only send internal email, which doesn’t require an internet connection, you can disable this option.

6) SSL: SSL (secure socket layer) is a way of encrypting your email data as it travels across the internet. Check with your email provider if they require SSL and enable this option if they do. Gmail, for example, requires SSL.

7) Port: the SMTP Port is often 25 or 587 if you don’t use SSL. Port 465 is typically used in combination with implicit SSL.

TIP: If you want to use Gmail as your SMTP server, first login to Gmail on the station running MetaServer via a browser. In that way, the IP address of that station becomes white listed on the Google SMTP servers and you can send e-mails from MetaServer. Gmail’s security strategy changes frequently and Gmail also sets limits to the number of emails you can send through smtp.gmail.com. So, we advise to only use smtp.gmail.com for tests or if the number of emails sent by MetaServer is limited.

02 – Email header: here, you enter the email header information.

1) From: enter the sender’s email address.

 

2) Display name: this is the sender’s “friendly” name. For example, you could send emails as noreply@company.com and use “Please do not reply” as the friendly name. The email address will then be converted into the “friendly” display name at the receiver’s end.

 

3) To: you can enter the recipient’s email address manually or select a field holding the value. You can enter multiple email addresses, or the selected field can hold multiple email addresses.

You can optionally specify the display name by separating it with a comma “,”.
For example: jps@customer.com, James P. Sullivan.

You can also specify multiple recipients by separating them with semi-colons “;” or colons “:”. For example: john@customer.com,John Doe;jane@customer.com,Jane Doe.

Some more examples of valid email addresses:
– jps@customer.com
– randallboggs@customer.com:mike.wazowski@customer.com,Mike Wazowksi;jps@customer.com,James P. Sullivan

TIP: You can use a field to hold multiple email addresses at once.

Use the same syntax when you set the field value using a Set Field Value rule in your Extract action preceding the Forward Email action. Then, in the To: field, select the MetaServer field holding your email addresses.

 

TIP: You can forward an email conditionally.

Use a Set Field value rule in an Extract Action preceding the Forward Email action. Then, in the To: field, select your MetaServer field holding your email address (e.g. “Email To”).

If you set the “Email To” field to blank with the Set Field value rule, the email will not be sent.  If you set it to 1 or more email addresses, the email will be sent.

 

4) Subject: you can compose your email subject by combining fixed values, fields and metadata. Click on the drop-down arrow to pick from a list of possible values. You can see an example of your Subject line below the input field.

 

03 – Test: enter your email address in the “To” input field as the recipient and press the “Test” button to check your connection. You will receive an email confirming that the connection is successful. Don’t forget to change it back to the correct recipient after testing.

 

TIP: you can copy the current settings and paste them in another setup window of the same type. Do this by pressing the Settings button in the bottom left of the Setup window and by selecting Copy. Then open another setup window of the same type and select Paste.