For userattr and mapi commands only.
labeled <fallguy> is an optional subexpression that you can use to identify the e-mail recipient (or sender) for whom the data lookup command returned a True value and who, as a consequence, caused the control trigger to activate. The email address of this recipient (or sender) is assigned to the <fallguy> variable for inclusion in a user notification message.
This is especially useful if an e-mail is sent to lots of people, but only a small number of these are on the list of unauthorized recipients. <fallguy> permits you to identify these unauthorized recipients in a notification dialog, which in turn enables the sender to remove them from the addressees before resending the email.
<fallguy> is a variable name chosen by you. Like all user notification variables, it must be enclosed in percent marks. You must not choose a variable name already used by CA DataMinder. One way to ensure your chosen variable name is acceptable is to include your company in the variable name. For example:
%XYZ_interdicted_user%
<fallguy> subexpressions are most easily understood in terms of data lookup commands that use an IS operator. In the example below, if an unauthorized recipient in the Equity Markets team causes a control trigger to activate, the address of that recipient is written to the %XYZ_interdicted.users% variable:
userattr WITH all %recipient% labeled %XYZ_interdicted_users% WHERE Team IS "Equity Markets"
For example, a user attempts to send an e-mail to various people including unauthorized recipient Frank Schaeffer. %XYZ_interdicted_users% is therefore set to 'Frank Schaeffer' or fschaeffer@unipraxis.com. (Where possible, <fallguy> returns the user’s e-mail display name.)
If multiple unauthorized recipients are detected, the Data Lookup command writes all of them to %XYZ_interdicted_users%. These are displayed in the notification dialog as a comma-separated list:
fschaeffer@unipraxis.com,srimmel@unipraxis.com
If you use an IS NOT operator in a data lookup command, <fallguy> works as normal and returns the e-mail address of every recipient for whom the data lookup command returned a True value. But you need to remember that the command logic is reversed!
For example, the command below returns a True value if none of the recipients are directors. In this case, the address of each recipient is written to the variable %XYZ_renotify_these_guys% (because in each case, the recipient is not a director and so the test returns a True value):
userattr WITH all %recipient% labeled %XYZ_renotify_these_guys% WHERE Rank IS NOT "director"
If none of the recipients are directors, then %XYZ_renotify_these_guys% will contain a list of addresses for all the intended recipients, for example:
fschaeffer@unipraxis.com,srimmel@unipraxis.com
|
Copyright © 2014 CA.
All rights reserved.
|
|