Difference between revisions of "Mail Scanner Nodes"

From PresenceWiki
Jump to: navigation, search
(Scan)
(Output)
Line 67: Line 67:
  
 
http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_3.png
 
http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_3.png
 +
 +
The Output Panel gives the user the ability to select which values to include in the outputted [[Data Table]]. To include a value, drag the item from the list on the left hand pane into the main (centre) pane. These are the options available:
 +
 +
* '''PS_MESSAGE_COUNT'''
 +
* '''PS_MESSAGE_NUMBER'''
 +
* '''PS_COMPLETE_CONTENT'''
 +
* '''PS_SIZE'''
 +
* '''PS_HEADERS'''
 +
* '''PS_HEADER_MESSAGE-ID'''
 +
* '''PS_HEADER_SUBJECT'''
 +
* '''PS_HEADER_RETURN-PATH'''
 +
* '''PS_HEADER_STATUS'''
 +
* '''PS_BODY'''
 +
* '''PS_PART_NUMBER'''
 +
* '''PS_PART_NAME'''
 +
* '''PS_PART_TYPE'''
 +
* '''PS_PART_TEXT'''
 +
* '''PS_PART_BINARY'''
 +
* '''PS_FILE_NAME'''
 +
* '''PS_DESCRIPTION'''
 +
* '''PS_SUMMARY'''
  
 
=== Test ===
 
=== Test ===
  
 
http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_4.png
 
http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_4.png

Revision as of 12:32, 15 January 2010

Mail Scanner

The Mail Scanner Node can connect to POP mail accounts and retrieve emails, and then convert them into a Presence Data Table. This is especially useful for creating automated processes based on emails you receive.

The POP Scanner Interface

To create a new POP scanner in your Task, either drag Task Element labelled "Scan Mail Accounts" from the Data Access toolbox, or right-click on your Task and choose "Insert New > Mail Scanner > Scan Mail Accounts" from the pop-up menu.

POP Scanners created are not reusable. This means that while you can copy and paste a POP Scanner from one Task into another (or the same Task), changes made to one will not affect the other.

This is a view of the POP Scanner interface which will be displayed:

http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_1.png

The Name and Description fields allow you to enter a descriptive name and short description of this item.

Account Details

This is the POP Mail Account Resource that you wish to connect to, which stores details such as the IMAP folder, Account Name, Password, Server Host, Port and security options. These can all be overridden by checking the "Override Values" checkbox.

Test Tab

If you want to run a test to check that your settings are correct and you can connect to your mail server, click on the "Test" tab, then click the "Test" button:

http://www.international-presence.com/wikidocs/images/pop_scanner_test_panel.png

Timeout Options

This allows you to specify that the mail scanner should time out after a period of time if the mailbox is locked, or if it is unable to connect.

In addition you can specify the amount of time to wait before releasing the mail account lock.

Failed To Connect Options

When a timeout occurs, the Task can either raise an exception (which will be caught by an Error Handler Node if one is present) or it can continue anyway. Select the option here that best suits your Task.

Scan

http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_2.png

Message Removal Options

This allows you to control how and when messages are permanently deleted from the mail server. The default option is to never delete messages either when retrieving them via the Mail Scanner editor or from within a Presence Task.

Alternatively you can select to delete them regardless of whether they pass the scan criteria (see below), or only if they do. This option is available separately for the mail scanner interface tests and for within Tasks.

Limit Emails

This allows you to limit the number of emails that are retrieved by this Node. You can limit the number of emails that get considered (before filtering options are taken into account) and the number of emails that get processed.

Scan Criteria

These options allow you to filter the messages that are retrieved based on selected criteria. You can filter messages based on the contents of the message header, body, and parts (e.g. attachments). For instance, you may only be interested in messages that are sent to a particular email address, or have a particular subject.

To apply criteria to the Header, Body or Parts, click the relevant tab. In the case of the Header and Parts, you will be presented with a drop-down list displaying the available parameters which can be filtered, for instance in the Header you can filter according to the value of the Message ID, Subject, Return Path, Status, etc.

The "Populate" button will cause the combo boxes to be automatically populated according to the contents of emails on the server.

Message "Read Once" Options

This option allows you to flag messages as Read in an internal Presence database to prevent the same message from being retrieved twice on subsequent executions.

To reset this list so that older messages can be re-reader, click the "Clear Out Deleted Messages" button.

Output

http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_3.png

The Output Panel gives the user the ability to select which values to include in the outputted Data Table. To include a value, drag the item from the list on the left hand pane into the main (centre) pane. These are the options available:

  • PS_MESSAGE_COUNT
  • PS_MESSAGE_NUMBER
  • PS_COMPLETE_CONTENT
  • PS_SIZE
  • PS_HEADERS
  • PS_HEADER_MESSAGE-ID
  • PS_HEADER_SUBJECT
  • PS_HEADER_RETURN-PATH
  • PS_HEADER_STATUS
  • PS_BODY
  • PS_PART_NUMBER
  • PS_PART_NAME
  • PS_PART_TYPE
  • PS_PART_TEXT
  • PS_PART_BINARY
  • PS_FILE_NAME
  • PS_DESCRIPTION
  • PS_SUMMARY

Test

http://www.international-presence.com/wikidocs/images/pop_scanner_dialog_4.png