Author: HCA Central Version: 1 Added to Library: 11-Nov-23 HCAVersion needed: 18 Keywords: Utility Requirements: You must configure HCA for email reading. HCA technical note #121 is a good place to start.
Package Description: See the notes on the program named Dispatch for all the details.
Program Description: Started by a mail reception and dispatches to other programs if text is found in the subject or body of the message.
You MUST have an email account for mail reading. Suggest reviewing technical note #121
Configure HCA Mail reading from the "Tools" ribbon category, "Email Background Receive" button. In that setup make sure that the program to start on an email reception is this program.
Add tags to this program with names "Mail1", "Mail2", "Mail3", etc
The tag value is the form: "code", LookFor, ProgramToStart
Where code is "S" (look in the subject text), or "B" (look in the body text).
"LookFor" is the text that must be found in the subject or body. If found then the named program is started. That program is provided with three parameters: from, subject, and body. See the Example program in this package folder.
Note that leading and/or trailing spaces in the "LookFor" string are important. If you wanted to look for "Weather" followed by a space then you would include a space before the comma that ends the text. Only include spaces if you want them to participate in the text you are searching for.
For example:
TagName: Mail1
TagValue: S,Weather,Home - On Weather Alert
When an email message is received with "Weather" is anywhere in the subject then the program "Home - On Weather Alert" is started.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
Error | Value | 0 if no error, error text otherwise | |
From | Value | Message From | |
Subject | Value | Message Subject | |
Body | Value | Message body |
Program Description: This is an example of a program that the "Responder Email - Dispatch" program can start. Copy it and use it to create your own program.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
From | Value | Email From | |
Subject | Value | Email Subject | |
Body | Value | Email Body |