USER MANUALS

Requests

Every time a user creates or modifies a request, the request managers in charge of resolving it are notified within the Data Marketplace. If required, they can be notified by email too. From the Requests dialog you can configure the details of these email notifications.

The first time you access the Requests dialog you need to specify the parameters of the email server of your organization in the Email server pill:

  • Host. The hostname or IP address of the machine where the email server is running.

  • Port. The port where your email server is listening on.

  • Authentication. Enable this option in case your email server requires authentication and enter the credentials used for the connection in the Username and Password fields.

  • From email address. The email address from which Data Marketplace will send email notifications.

  • Protocol. Select the protocol used by your email server between:

    • SMTP. The usual protocol for sending emails. Enable the Use STARTTLS command option to switch the connection to a TLS-protected connection before issuing any login commands. If the server does not support STARTTLS, the connection continues without the use of TLS. Note that an appropriate trust store must be configured so that the Data Marketplace will trust the server’s certificate.

    • SMTPS. The secured version of the SMTP protocol. To configure how Data Marketplace will check the server’s certificate you have the following options:

      • Enable the All servers are trusted option to trust by default any server’s certificate.

      • Specify a list of hostnames in the Trusted servers field to only accept the certificate of a server in the list.

      • Leave the Trusted servers field blank and Data Marketplace will rely on its configured trust store to validate the server’s certificate.

  • Debug. In case you run into any issues with the email notifications, you should activate the debug mode to identify its cause. Proceed as follows and you will get more information about the whole process in the log file <DENODO_HOME>/logs/vdp-data-catalog/vdp-data-catalog.log:

    1. Select the Debug option.

    2. Add the following logger to the file <DENODO_HOME>/conf/data-catalog/log4j2.xml:

      <Logger name="com.denodo.webapp.datacatalog.business.common.email" level="DEBUG" />
      
    3. Restart Data Marketplace.

Dialog to configure the email server

Dialog to configure the email server

Once the email server is properly configured, the other pills in the dialog will be enabled so you can specify who will receive the notifications by email.

In the Email by request type pill you define the list of email addresses that will receive a notification every time a request of a particular type is created or modified. To configure the email notifications for a request type follow the steps below:

  1. Unfold the section of the request type you want to configure.

  2. Enable the Send notification by email option.

  3. Enter the list of email addresses in the To email address field. Notice that you can add or remove an email address using the add or remove buttons.

Dialog to configure the email notifications by request type

Dialog to configure the email notifications by request type

In the Email by role pill you can be more specific on who will receive a notification by email. Remember that in the Permissions dialog you define which roles are in charge of managing a request based on its type and in the element on which it is created. When a request is created or modified by its owner, those users with a role that allows them to manage it will receive a notification within the Data Marketplace. If a role with permissions to manage the request has the notifications by email enabled, Data Marketplace will also send an email to the configured addresses. To configure the email notifications for a role follow the steps below:

  1. Click the edit button of the role.

  2. Enable the Send notification by email option.

  3. Enter the list of email addresses in the To email address field. Notice that you can add or remove an email address using the add or remove buttons.

Dialog to configure the email notifications by role

Dialog to configure the email notifications by role

Note

The section Email by role requires the permission permissions and the user must be able to execute the LIST ROLES statement in order to see the existing roles and assign email addresses to them.

Take into account that the subject and body of email notifications can be customized. For more information, you can refer to the section Email Templates.


Configuration

Request configuration

Request configuration.

In this section users with the configure requests privilege can change the requests configuration.

  • Show Request managers. If enabled, it will show the emails configured for the managers that can handle the current request. They will be visible when creating a request or viewing its details.

Note

Users with configure requests privilege will also see the roles and whether email sending is enabled.

Add feedback