SubjectWord |
|
Description
Takes the subject line of the message that impelled the job and breaks up the text of the subject line into words based on whitespace. The macro then returns a word or words based on the numerical order (1-based index) of the text fragments.
Arguments
1.SubjectWord - Name of the Macro.
2.Index - The 1-based index of the word or words to return. This value must be >0.
3.Include Remaining - The optional parameter indicating whether to return all fragments following the target fragment. The options are true or false. If not specified the default value is false.
Examples
<SubjectWord|1>
If the message subject was "pasUnity: Report File" the value returned would be "pasUnity:".
<SubjectWord|1|false>
If the message subject was "pasUnity: Report File" the value returned would be "pasUnity:".
<SubjectWord|1|true>
If the message subject was "pasUnity: Report File" the value returned would be "pasUnity: Report File".
<SubjectWord|2>
If the message subject was "pasUnity: Report File" the value returned would be "Report".
<SubjectWord|2|false>
If the message subject was "pasUnity: Report File" the value returned would be "Report".
<SubjectWord|2|true>
If the message subject was "pasUnity: Report File" the value returned would be "Report File".
Notes
The SubjectWord function will not generate an error if a job was not impelled by a message - it will just emit a blank value. If the index value is greater than the number of words in the subject a blank value will be returned.
Copyright © 2024 pasUNITY, Inc.
Send comments on this topic.
Created with an evaluation copy of HelpSmith.
To remove this notice, you should purchase the full version of the product.