Connecting to JIRA and POP3 mailboxes with tinyPM connectors

Marcin Niebudek

So you know already that tinyPM 2.2 have Sandbox with connectors that allow you to import items, issues, messages and ideas from different places. For a good start we equipped tinyPM with two connectors. One for getting issues from JIRA and one for importing e-mail messages sent to any POP3 mailbox. Now let’s have a look at how to configure them and use to populate your new Sandbox.

Connecting to JIRA

tinyPM uses JIRA API to import issues, but the API requires you to create a filter. So the first thing you need to do is to create one in your JIRA.

Creating JIRA filter for tinyPM

tinyPM will monitor any defined data source periodically so any newly reported issue. Data source are defined separately for each tinyPM project, so you will probably filter only issues from a particular project in JIRA too. To do that go to issue navigator and set filter for the issues that you want to have in tinyPM. Let’s say we want to import all open issues from project DEMO.

Saving JIRA filter

After filtering issues JIRA gives you the option to save the current filter. This is exactly what you want to do. After saving the filter under any selected name the important thing to get from JIRA is the requestId=10010 parameter which is your filter ID.

Defining tinyPM data source connected to JIRA

Now it’s time to create a data source in tinyPM. Go to projects and click on project data sources icon Project data sources. After that select “Connector for JIRA” and enter your JIRA URL, user name and password for the user that has access to JIRA and to created filter (unless you shared the filter with all JIRA users).

tinyPM sandbox with JIRA issues imported

That’s it! After few minutes you should see the currently open issues from JIRA imported into your sandbox. New onse will get there as soon as they are created in JIRA. You can create stories based on the imported issues or you can reject them them without flooding your backlog. They will get a proper comment in JIRA.

Connecting to POP3 mailbox

You can connect to any POP3 mailbox and tinyPM will import all e-mail messages sent to that address into the Sandbox. How can that be valuable? You can create a special sandbox like where you can sent any of your ideas which you may later on upgrade to a user story in tinyPM. You clients can sent any project suggestion in a simple and convenient way directly from they favorite e-mail clients.

tinyPM data source connected to POP3 mailbox

To setup POP3 data source simply configure the mailbox just like you do that in your e-mail client software. After that tinyPM will pool that mailbox every few minutes looking for new e-mails.

You can limit the list of users that are allowed to send e-mails that will be imported by tinyPM using the allowedSenders property. This property accepts comma separated list of addresses and also accepts simple * wildcard in any part of the address. On the picture above we’ve limited allowed senders to the e-mail addresses in the domain

That’s all you need to do to user the power of new tinyPM sandbox. But stay tuned as new cool connectors are coming soon! If you have any suggestions for the connectors that we should provide next please don’t hesitate to post them on


  1. Dale Blue -

    I’m trying to test out the POP3 connector with a gmail account. I think I have the right settings but the e-mail I sent does not go to the sandbox. The problem is, I don’t see anyway to change the POP3 settings after they have been created.

  2. Dale Blue -

    I’ve found the datasource configuration button on the projects page and have now deleted my original datasource definition and created a new one but it still does not work.

    I’m using my full gmail account name as the user name ‘’ and the following settings:

    The password is the same one I use to access the account directly.

    I get the following error in my catalina.out file every time the polling routine runs:

    2010-03-25 12:13:00,812 [INFO,com.agilers.tpm.sandbox.SandboxMonitor] Polling sandbox items…
    javax.mail.MessagingException: Connect failed;
    nested exception is: connect timed out
    at gnu.mail.providers.pop3.POP3Store.protocolConnect(
    at javax.mail.Service.connect(
    at javax.mail.Service.connect(
    at javax.mail.Service.connect(
    at com.agilers.tpm.connector.pop3.POP3Connector.connect(Unknown Source)
    at com.agilers.tpm.connector.pop3.POP3Connector.getNewItems(Unknown Source)
    at com.agilers.tpm.sandbox.SandboxDataSource.pollNewItems(Unknown Source)
    at com.agilers.tpm.sandbox.SandboxMonitor.pollItems(Unknown Source)
    at com.agilers.tpm.sandbox.SandboxMonitor.pollItemsFromDataSources(Unknown Source)
    at com.agilers.tpm.sandbox.SandboxMonitor.pollAllSources(Unknown Source)
    at sun.reflect.GeneratedMethodAccessor343.invoke(Unknown Source)

    Any suggestions?

  3. Marcin Niebudek -

    We moved to forum with this thread:

    As for editing data sources, we will make it more visible in the next release as well as we will try to provide a “Test connection” button.


Leave a Reply