Send Mails

Introduction
This documentation describes the installation, configuration and use of the Step Plugin for sending emails within a task in Goobi workflow. The list of recipients and the text can be configured individually for different steps. All fields from the VariableReplacer are also available. This means that metadata or information on the task, step or project can also be accessed.
Details
Text
Identifier
intranda_step_sendMail
Source code
​https://github.com/intranda/goobi-plugin-step-sendMail​
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 2022.03
Documentation date
30.03.2022
How the plugin works
The plugin is usually executed fully automatically within the workflow. It first determines whether there is a block in the configuration file that has been configured for the current workflow with regard to the project name and work step. If this is the case, the mail is generated and sent to the configured recipients.
Operation of the plugin
This plugin is integrated into the workflow in such a way that it is executed automatically. Manual interaction with the plugin is not necessary. For use within a workflow step, it should be configured as shown in the screenshot below.
Integration of the plugin into the workflow
Installation
The plugin consists in total of the following files to be installed:
plugin_intranda_step_sendMail.jar
plugin_intranda_step_sendMail.xml
The first file must be installed in the following directory:
/opt/digiverso/goobi/plugins/step/plugin_intranda_step_sendMail.jar
In addition, there is a configuration file that must be located in the following place:
/opt/digiverso/goobi/plugins/config/plugin_intranda_step_sendMail.xml
Configuration
The configuration of the plugin is done via the configuration file plugin_intranda_step_sendMail.xml and can be adjusted during operation. The following is an example configuration file:
<?xml version="1.0" encoding="UTF-8"?>
<config_plugin>
    <!--
        order of configuration is:
        1.) project name and step name matches
        2.) step name matches and project is *
        3.) project name matches and step name is *
        4.) project name and step name are *
    -->
    <config>
        <!-- which projects to use for (can be more then one, otherwise use *) -->
        <project>*</project>
        <step>*</step>
        <!-- mail account -->
        <smtpUser>[email protected]</smtpUser>
        <smtpPassword>password</smtpPassword>
​
        <!-- server configuration -->
        <smtpServer>example.com</smtpServer>
        <smtpUseStartTls>false</smtpUseStartTls>
        <smtpUseSsl>true</smtpUseSsl>
​
        <!-- displayed sender address -->
        <smtpSenderAddress>[email protected]</smtpSenderAddress>
        <!-- receiver, can be repeated -->
        <receiver>[email protected]</receiver>
        <receiver>[email protected]</receiver>
​
        <!-- message -->
        <messageSubject>subject text</messageSubject>
        <messageBody>body &lt;br /&gt; &lt;h1&gt;with html&lt;/h1&gt;</messageBody>
    </config>
</config_plugin>
Parameter
Explanation
project
This parameter determines for which project the current block <config> should apply. The name of the project is used here. This parameter can occur several times per <config> block.
step
This parameter controls for which workflow steps the block <config> should apply. The name of the workflow step is used here. This parameter can occur several times per <config> block.
<smtpServer>
This parameter sets the SMTP server.
<smtpUseStartTls>
This parameter controls whether the access should run like TLS.
<smtpUseSsl>
This sets whether communication should be encrypted via SSL.
<smtpUser>
Dieser Parameter legt den Nutzernamen fest.
<smtpPassword>
This defines the password to be used.
<smtpSenderAddress>
The field <smtpSenderAddress> defines the displayed sender, which can also be different from the user name.
<receiver>
The field <receiver> can be used multiple times and contains the email addresses of the recipients.
<messageSubject>
This parameter allows the subject to be defined. The use of variables is possible here.
<messageBody>
In <messageBody> the mail itself is defined. Plain text or HTML formatted text can be written here. In addition, access to the Goobi variable system is possible here, so that information on the task, project, properties or metadata can also be used in the mail.

Step Plugins - Previous

Generate ARKs

Next - Step Plugins

Archiving image folders

Last modified 3mo ago

Copy link

On this page

Introduction

How the plugin works

Operation of the plugin

Installation

Configuration