Requests¶

Every time a user creates or modifies a request, the request managers in charge of resolving it are notified within the Data Catalog. 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 Catalog 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 Catalog will trust the server’s certificate.

  • SMTPS. The secured version of the SMTP protocol. To configure how Data Catalog 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 Catalog 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 Catalog.

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 or buttons.

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 Catalog. If a role with permissions to manage the request has the notifications by email enabled, Data Catalog will also send an email to the configured addresses. To configure the email notifications for a role follow the steps below:

1. Click the 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 or buttons.

Dialog to configure the email notifications by role¶