Setting up Email Notifications in KanBo 2.7

Following article describes configuration of KanBo email notifications. Only unread notifications are sent by email. Each user can tun it on or off individually and specify sending intervals.

Contact us at support@kanbozone.com to receive most recent KanBo installation package.

Prerequisites

1. Having a Virtual Machine on which you can deploy the Email Notifications component,

2. Having a special service account with Exchange or Exchange Online license to use it for sending emails,

3. Connectivity to KanBo Database (server firewall should be unlocked for the Virtual Machine address).

Prepare the Email Notifications package

Unzip the KanBo.EmailNotifications (it can be called also KanBo.ConsoleJobHostRunner.zip) to desired location. The location can be for example a folder named "Email Notifications". In our case it is: C:\inetpub\Email Notifications.

Update KanBo.ConsoleJobHostRunner.exe file with your parameters

For detailed information about configuration follow attached readme.txt file.

1. Copy the connection string from the KanBo web.config and put them to the KanBo.ConsoleJobHostRunner.exe.config into <connectionStrings> section.

<connectionStrings>
 <add name="KanBoContentConnectionString" connectionString="Data Source=Server,1433;Database=KanBoContentName;User ID=UserID;Password=UserPassword;MultipleActiveResultSets=True" providerName="System.Data.SqlClient" />
 </connectionStrings>

2. Configure the plugins section. In the first part, you can configure:

wait_after(1s) catch log_time(debug)

We recommend to set this settings as follows.

<plugin alias="job-host" name="mail-job" options="wait_after(1s) catch log_time(debug)">
         <job name="mail"></job>
      </plugin>

Sometimes relative paths does not work on certain environments - can you try to provide full path to the Email Notifications package instead of ".".

 <plugin alias="plugin-loader.directory" path="." />

3. Configure the second part of plugins section.

With SSL

Change the following values: 

  • https://YourKanBoAddress - to your KanBo Address
  • YourTitle - choose a title, i.e.:KanBo
  • sender@YOURDOMAIN.com in sender email and username - the email account to send emails from
  • Password to password this email account password
  • mail.YOUR_DOMAIN.COM  in Host to your email hosting address. In case of Office 365 installation, it can be smtp.office365.com.
  • Your KanBo path in Your KanBo Directory value
<job.email-notifications name="mail" link="{https://Your KanBo Address.domain}" title="{YourTitle}" template="template.html" limit="10" testrendering="true">
        
        <sender email="{sender@YOURDOMAIN.COM}" type="SmtpClient">
                    <smtpclient deliverymethod="Network" username="{sender@YOURDOMAIN.COM}" password="{PASSWORD}" enablessl="True" host="{mail.YOUR_DOMAIN.COM}" port="587" pickupdirectorylocation="{YourKanBoDirectory}"></smtpclient>
                </sender>
      </job.email-notifications>

Without SSL

<job.email-notifications name="mail" link="{https://Your KanBo Address.domain}" title="{YourTitle}" template="template.html" limit="10" testrendering="true">
        
        <sender email="{sender@YOURDOMAIN.COM}" type="SmtpClient">
                    <smtpclient deliverymethod="Network" username="{sender@YOURDOMAIN.COM}" password="{PASSWORD}" host="{mail.YOUR_DOMAIN.COM}" port="587" pickupdirectorylocation="{YourKanBoDirectory}"></smtpclient>
                </sender>
      </job.email-notifications>

 

Create a Task in the Task Scheduler (On Premise)

Here is the simple example how to add KanBo Notification Task to the Windows Task Scheduler. Full manual for Windows Scheduled Tasks you can find in the Microsoft web site: https://technet.microsoft.com/en-us/library/cc766428.aspx

1. Execute Task Scheduler. Type basic data: a) Name b) Select user with proper privileges to execute task. We recommnd also to select "Run with highest priviledges".

 

2.If connection string to the KanBo database is Integrated Security=true, please be sure that typed user has read/write permissions to the KanBo database. Select Triggers tab and create a new trigger and use the following configuration:

  • Begin the task - On a Schedule
  • Settings: Daily
  • Advanced settings: Repeat task every 15 minutes for a duration of Indefinitely
  • Stop task if it runs longer than 30 minutes
  • Select Enabled

3. Select Actions tab and add new action pointing to the KanBo.ConsoleJobHostRunner.exe file within the folder where you unpacked the MailNotificationWebJob.zip file.

After this action is completed, select OK and confirm your administrator credentials.

Enter Your email notifications package location in the Start In (optional) field. 

Example: C:\inetpub\Email Notifications\KanBo.EmailNotifications

4. Enable Email notifications in KanBo web.config

Open KanBo web.config and find “<add key="KanBoEmailNotifications" value="true" />” and ensure value is set to true and save the web.config.

After that clear your browser cache.


Create a WebJob on Azure (Azure/Cloud installation scenario)

Navigate to your KanBo Azure website (http://manage.windowsazure.com).

Enter your Web Application and select Webjobs from the left pane menu.

Click on +Add button.

Set up KanBo email notifications on Azure

Enter name: KanBoEmailNotifications.

Upload the zip File with MailNotificationsWebJob.

Set type to Continous, set Scale to Single Instance.

Click OK to save your WebJob.

Set up KanBo email notifications on Azure

Click on your Webjob and then, select Start button. As a result, a status of this Webjob will be changed to Running.

Set up KanBo email notifications on Azure

Turn on email notifications on your KanBo account

1. Click on your avatar and click on Show Profile to enter your user profile

Specify there your email and save the changes.

 

2. Navigate to MySettings by clicking on your user picture.

3. My Settings section will appear. Enter Notifications and set email notifications. You can disable them or configure them to appear every 15 minutes, 60 minutes or 24 hours.

From now on when you have a new notification in KanBo and you don't read it within KanBo or on your mobile App you will get email summing up all your unread KanBo notifications. Below you can see an example of an email generated by KanBo.

 

Is this article helpful for you?