Blog
Did you know that… you can add extra information to Blue Mountain RAM’s rule-based notifications from the record being highlighted?

You can include additional meaningful and helpful information on notifications by using Blue Mountain RAM macros. A “macro” is a tiny bit of code that accomplishes a small task. As you read what each macro does, consider these examples of what happens to individual records. Imagine including extra information from records that are being:

  • Created
  • Changed status
  • Modified in a monitored field
  • Requiring a review
  • Requiring a signature
Blue Mountain RAM Macros You Can Add to Your Rule-based Notifications:

@FIELDLABELX@ – Produces your organization’s label for the field referenced by X, where X equals the FID (Field Identifier) belonging to the desired field. The field must be a field or common field of the record type reported in the notification. Example: @FIELDLABEL51200009@

@FIELDVALUEX@ – Produces the data in the field referenced by X, where X equals the FID belonging to the desired field. The field supplied must be a field or common field of the record type reported in the notification. Example: @FIELDVALUE51200009@

You can use the “ID” column of the Form Properties window to identify FIDs. You can also enable “Field Coordinates” in Form Setup’s “Preview” window to identify FIDs:

@COMMENTS – This macro is exclusive to the “Change Status” category of rule-based notifications. It produces the text entered in the “Comments” field of a Change Status dialog. If no comments were entered, no text is produced by the macro. Example: @COMMENTS

@AUDITREASON – This macro is exclusive to the “Field Change” category of rule-based notifications. It produces the text entered – or pick list item chosen – in the “Audit Reason” dialog when saving a modified record. The Audit Reason dialog requires data. Example: @AUDITREASON

@PAGEVIEWURL – This macro produces a link to the record that is the subject of the notification. To use this macro successfully, two settings must be configured in Blue Mountain RAM System Configuration:

  1. “Site URL” setting in Site Settings, “Miscellaneous” section (http://AppServerName/)
  2. “Mail Format” setting in Site Settings, “Mail” section (must be set to HTML)

NOTE: The @PAGEVIEWURL macro is only useful for rule-based notifications configured as “Send to Email.” “Send to Inbox” notifications automatically include a link to the subject record.

HTML Formatted Example: <a href=”@PAGEVIEWURL”>Click here to open this BMRAM record</a> is rendered as Click here to open this BMRAM record

Plain Text Formatted Example@PAGEVIEWURL is rendered as http://servername/ql.aspx&rurl=GUID&mode=VIEW

Rule-based Notifications Can Be Formatted with Plain Text or HTML

Plain Text Example of Message Construction with Macros:

@FIELDLABEL8000006@ : @FIELDVALUE8000006@\n

@FIELDLABEL8000010@ : @FIELDVALUE8000010@\n

@FIELDLABEL8000011@ : @FIELDVALUE8000011@\n

Produces:

Request Originator : Samantha Jones

Request Type : Emergency

Priority : High 

HTML Example of Message Construction with Macros:

<table>

<tr><td>@FIELDLABEL8000006@</td>

<td>@FIELDVALUE8000006@</td></tr>

<tr><td>@FIELDLABEL8000010@</td>

<td>@FIELDVALUE8000010@</td></tr>

<tr><td>@FIELDLABEL8000011@</td>

<td>@FIELDVALUE8000011@</td></tr>

</table>

Produces:

Request Originator Samantha Jones
Request Type Emergency
Priority High

 

For further information, please consult your Blue Mountain RAM Administrator and User Manuals. If you have questions, contact our friendly Support Technicians at techsupport@coolblue.com. Also, please enjoy calling and speaking with your Regional Sales Manager (RSM) at 800-982-2388 if you are interested in Blue Mountain RAM training or Services.