<notificationrecipientspicker>

When you add the <notificationrecipientspicker> tag to a board, users can select recipients to send notifications to after a record is created or edited. This granular approach allows you to customize recipients per record for each board notification. For the board record notifications to be sent they must be configured using the Board Notifications configuration. See Configure Board Notifications for more information.

To send notifications to selected recipients using the <notificationrecipientspicker> tag, you must select Board from the Recipient Type dropdown on the Fields tab when configuring recipients for board notifications.

Configuring the notificationrecipientspicker tag on the Fields tab

When added to a board in the board editor, the <notificationrecipientspicker> tag creates a button that is labeled Select by default, though that label can be changed. The button can be added to the Input view or the Display view, and the button’s location is based on where the tag is added to the board’s code.

The button that displays on a board where the tag is added

The dialog displays the selected recipient count on the Total Recipients tab.

The dialog that displays when the tag is added to a board

This method allows you to send notifications for a specified record to any people associated with the board, even if these people are not WebEOC Nexus users or added to WebEOC Nexus using Contacts. This flexibility ensures notifications per record can be directed to the appropriate recipients, whether they are users, groups, or other entities within, or outside of, WebEOC Nexus.

Tag Attributes

<notificationrecipientspicker> attributes
Attribute	Allowed Values	Requirements	Description
name	CDATA	Required	Assigns a name for the underlying SQL column that stores the selected recipients who will receive the notification.
button-text	Text	Optional	Assigns a label to the button. If you do not provide a value, the label text defaults to "Select."
showUsers	Boolean	Optional	Determines whether the Recipients tab is displayed on the dialog. The default value is "true."
showPositions	Boolean	Optional	Determines whether the Positions tab is displayed on the dialog. The default value is "true."
showNotificationGroups	Boolean	Optional	Determines whether the Notification Groups tab is displayed on the dialog. The default value is "true." Notification groups are configured in Contacts.
showGroups	Boolean	Optional	Determines whether the Groups tab is displayed on the dialog. The default value is "true." Groups are configured on the Accounts page, on the Groups tab.
showOrganizations	Boolean	Optional	Determines whether the Organizations tab is displayed on the dialog. The default value is "true." Organizations are configured on the Accounts page, on the Organizations tab.
showTotalRecipients	Boolean	Optional	Determines whether the Total Recipients tab is displayed on the dialog. The default value is "true."

Example

Copy Code

<notificationRecipientsPicker name="recipients_to_notify" showGroups="false" showNotificationGroups="true" />