Distribution Rules (Mail)

You can use distribution rules to determine which profile receives the data of an email for processing. See also section Input Agents That Are Forced to Receive All the Data.

A new rule can be created via the context menu. The distribution rules are processed from top to bottom. If the first rule takes effect, the email data is forwarded to the (processing) profile of this rule (1). You can either have the rules sorted by the scoring (2) or you can sort them manually (3). The scoring is calculated internally according to the rules of the profile scoring.

If no matching processing profile is found for an email, it will be moved to the Unresolved area or discarded. See also section Non-assignable Emails.


images/download/attachments/36575644/Verteilungsregel_4_EN-version-1-modificationdate-1561518335000-api-v2.png


Following is the dialogue for creating a new distribution rule. There, you specify which conditions must be fulfilled in an email for this distribution rule to apply.


images/download/attachments/36575644/Verteilungsregel_EN-version-2-modificationdate-1561527192000-api-v2.png


(4) Here you specify which part of the email should be examined.

(5) The subject the email has to have.

(6) The file name pattern, the attachment of the email has to have (several names can be specified). You have to set (4) accordingly.

(7) The sender the email has to have.

(8) The profile to which the email data should be forwarded. If no profile is selected, this profile (i.e. the fetching profile) is used to process the data. The processing profile has to have an Input Agent of type Message (only those are available for selection).

(9) Here you can select a comparison channel (of type Mail). The comparison criteria are set in (10). Note: As background, it should be mentioned that every incoming email in Lobster_data internally gets a channel ID assigned. A matching ID is the ID of a channel, whose own ID (the own email address for a channel of type Mail) matches the receiver address of the incoming email and whose partner ID (the email address of the partner for a channel of type Mail) matches the sender address of the incoming email. The internally determined channel ID is then compared with the ID of the channel selected here.

(10) The following options are available.


Matches the set channel

The internally determined channel matches the channel selected here.

Matches own identifier

The own ID (the own email address for a channel of type Mail) of the channel selected here matches the own ID of the internally determined channel (i.e. with the receiver address of the incoming email).

Matches polling channel

The selected channel here has to match the fetching channel (see POP3 (Mail), for example).

Channel is ignored

The channel selected here is ignored.

System Variables


If a profile with a time-driven Input Agent Mail is triggered by another profile, subsequent jobs receive the job number of the originating job (which had triggered) in system variable VAR_ORIGINATOR_JOBNR.