BPT Taskbox over Email
Stable Version 1.1.0
Published on 31 Jan by 
Created on 23 Jan
Details
This component brings the BPT Taskbox to your favorite device and e-mail client! Each user sets up connection details for his (IMAP) mailbox. Once that is done, the user receives new messages for each new Taskbox item available, and items are automatically removed when opened by other users.
Read More

How to use

  1. Install this component and its dependencies on the required environment.
  2. Setup, if necessary:
    • In ServiceCenter locate the BPTEmailServices module, and open the site properties tab.
    • The DefaultFromName and DefaultFromAddress site properties holds the display name and address of the sender (From field) of the generated e-mail messages. This defaults to "BPT" and "bpt@outsystems" respectivelly and users can customize them, but you can also set different defaults.
    • The EncryptionPassword site property is set to a cryptographically secure random value on first use. But you may also set it to any long (>10) random sequence of characters if you prefer. Do not change it after setting up the first user, as changing this will invalidate all e-mail account passwords!
    • The MaximumSyncActivities site property holds the maximum number of activities that are synced to an e-mail account. The default is 100, but you can change it at any time.
    • In ServiceCenter open the timers tab for the same module
    • Configure the SynchronizeAllActivityMessages timer to run as often as you prefer. New/closed activities are only synced to e-mail accounts when the timer runs. By default it runs every 15min, which means it may take up to 30min until you get a notification for a new activity, for instance (15min to sync, plus 15min for the device to re-check the e-mail account).
  3. Now allow each of your users to go to https://your-environment-address/BPTEmail and configure their e-mail account details. These should be self-explanatory.
  4. You're free to add a dependency to the BPTEmailServices module, BPTEmail_SynchronizeAllActivityMessages action, to run it manually to synchronize all accounts. This runs the timer again, taking advantage of the OutSystems' safeguard that prevents two instances from the same timer from running at the same time, so it's safe to call at any time.

That's it!


Component features:

  • Regularly synchronizes BPT Taskbox items with an IMAP mailbox.
  • New items are created directly on the mailbox, rather than sent by e-mail — this allows them to also be deleted when necessary, such as when a role-based taskbox item was opened by someone else.
  • Mailbox connection data is kept on database server
  • Mailbox connection password is encrypted on the server, with a cryptographically secure random password per each component installation.
  • If a user is disabled (made inactive) in the Users application, his BPT messages will remain on his mailbox, but they will stop syncing.
  • If a user is deleted in the Users application, his BPT messages will be removed from his mailbox. This only works if the user hasn't changed his mailbox's password, of course.

You can see a demo of this component on YouTube: https://youtu.be/dlHZ8zrmHSo


Important notes

If

  • your BPT implementation uses a custom Taskbox and this customization changes the algorithm that OutSystems uses to determine which are a user's available Taskbox items, or
  • you have a user provider that is not the OutSystems default Users

then you should change and adapt this application to your needs.


This component has dependencies with "S22.Imap" and "CryptoAPI" Forge components.

Any questions, be sure to e-mail the author: outsystems@pedrofreire.com 

What’s new (1.1.0)

Version 1.1.0 changes

Added support for the Due date in the e-mail text.

Reviews (0)
Category
Connectors, Data Connector, Collaboration, Components, Libraries
Support Options
This component is not supported by OutSystems. You may use the discussion forums to leave suggestions or obtain best-effort support from the community, including from Pedro Freire who created this component.
Dependencies
See all 2 dependencies
Requirements
Platform
10.0.0.402
Database
All
Stack
.NET
Component Consumers
BPT Taskbox over Email has no consumers.
Weekly Downloads 
Related Components
Google Drive Connector
OutSystems R&D
Google Drive Connector allows your OutSystems Applications to use the Google Drive REST API to interact with your files.
988
OutSystems UI Mobile
OutSystems R&D
Create amazing native mobile applications using this fully integrated UI framework for OutSystems, with dozens of UI patterns ready to use.
7275
Google Maps
Labs
Google Maps is a Google Maps Javascript V3 API component, providing Web Blocks and Actions to add interactive maps, markers and directions, along with event driven functionality.
10602
More from Pedro Freire
Wit.ai Connector
Wit.ai Connector Team
Natural Language for Developers
S22.Imap
Pedro Freire
An extension interface to the MIT-licensed S22.Imap NuGet package. Current version compiled with S22.Imap version 3.6.0.
106
S22.Imap Client
Pedro Freire
E-mail client example using S22.Imap as its underlying library.