Notifications
Notifications help you build a tighter, more robust community. They drive users to your site by notifying them of a recent event, then directing them to the affected page.
Ektron's notification system creates and transmits a notification messageconsists of text and a triggering activity. When the activity occurs, the message is sent to eligible recipients. to recipienta colleague, or a member of a community group to which a person belongs, that gets a notification message.s through various agenta provider (such as email, SMS, and activity streams) that transmit messages.s, based on Ektronactivitiesevents, such as adding content, joining a community group, and submitting a micro-message. The activities may be performed by a community group, membership user, or an Ektron user. For example, a membership user wants to notify colleagues whenever a documented is uploaded to the profile page. When this occurs, an Ektron event is triggered, which causes a notification agent to send an email to the person's colleagues.
- A user performs an activity in Ektron.
- Ektron raises a corresponding event.
- The activity’s data is written to the Activity table in the database.
- Activity information is sent to the activity queue.
- Ektron verifies that the notification system is enabled.
- The notification service gets a list of users who signed up to be notified about that activity when performed by that user. That list also includes the agents that send the message (for example, Email or SMS).
- The notification service gets the message associated with the activity, formats it, and sends it to the appropriate Notification agents.
- Notification agents send the message to users compiled in Step 6.
Users can decide:
- which activities should send a Notification to their colleagues or community groups
- which Notifications they want to receive from colleagues and community groups
Conditions for Notification Messages
- Notifications must be turned on in Workarea > Settings > Community Management > Notifications > Settings.
- A message for the activity must be enabled in Workarea > Settings > Community Management > Notifications > Messages. (By default, a message is enabled for each activity.)
- A user who wants to receive Notifications must enable each type of Notification for each agent in his profile’s Activities tab.
NOTE: A user's profile Activities tab has a Community Groups subtab, which lets the user set notification preferences for all community groups. To refine preferences further, a user can access the profile of any community group and click Edit Group Notification Preferences to set preferences for that particular group.
- The user performing the action must allow the Notification to be generated by enabling it on his profile’s Activities tab.
- To receive Notifications for
- another user’s activities, you must be his colleague
- a community group’s activities, you must be a group member
NOTE: The above points regarding message recipients are general. For specific details about which recipients receive notification messages, see Notification Message Recipients
- The Notification system respects Ektron’s content permissions. As a result, content-related Notifications are only sent to users with at least read-only permission for the content. See Also: Managing Folder Permissions
For example, Julia adds content to an Ektron folder for which her colleague, Tyler, does not have permission. Tyler is not notified when content is added, even though he signed up to be notified about colleagues’ activities.
However Kristin, another colleague who has permission to edit the folder’s content and who signed up to be notified about colleagues’ activities, does receive Notification of that event.
Similarly, private content is only viewable by authorized Ektron users or membership users with at least Read-Only permissions for its folder.
Triggering a Notification Message
|
Activity Type that Triggers Message |
Colleague Action (available on Colleagues sub-tab) |
Community Group Action (available on Groups sub-tab) |
User Action to Notify Others about (available on My Activities sub-tab) |
|
Add Colleague— user adds a colleague |
|
|
|
|
Add/Edit Group Content—user uploads content to community group Workspace |
|
|
|
| Add/Edit User Workspace Content—user uploads content to his profile |
|
|
|
|
Add Site Content—user adds content to Ektron |
|
|
|
| Add/Update Site Calendar Event —event is added or changed on site Calendar |
|
|
|
| Add/Update User Calendar Event —event is added or changed on user Web Calendar |
|
|
|
| Add/Update Group Calendar Event—event is added or changed on Web Calendar |
|
|
|
|
Add User Workspace Content— user uploads content to his profile |
|
|
|
|
Blog Comment— user comments on a blog post |
|
|
|
|
Blog Post—user posts to his blog |
|
|
|
| Community Group Forum Post—user posts to forum |
|
|
|
| Community Group Forum Reply—user replies to forum post |
|
|
|
|
Content Messageboard Post—user posts to a message board associated with content |
|
|
|
|
Create Community Group—user creates a community group |
|
|
|
| Edit Content—user edits content |
|
|
|
|
Forum Post—user posts to a Forum |
|
|
|
|
Forum Reply—user replies to a Forum post |
|
|
|
|
Group Blog Comment— user comments on a community group’s blog post |
|
|
|
|
Group Blog Post—user posts to community group blog |
|
|
|
|
Group Messageboard Post—user posts to a community group message board |
|
|
|
|
Join Community Group—user joins community group |
|
|
|
| Micro-message—user posts micro-message |
|
|
|
|
User Messageboard Post—user posts to a message board associated with a user |
|
|
|
Notification Message Recipients
The following table connects Notification message activities with users who receive the notification.
Prerequisites:
- users performing the activity must have the Publish check box checked for the activity in their profile
- users being notified must have the Activity Stream, SMS, or email box checked for that activity in their profile
|
Activity that Triggers Message |
Users who receive notification |
|---|---|
|
Add Colleague—user adds a colleague |
|
|
Add Group Content— user uploads content to community group Workspace |
Community group members |
|
Add/Edit User Workspace Content— user uploads content to his profile |
Depends on folder’s share setting, which can be
|
|
Add Site Content— user adds content to Ektron |
User's colleagues |
| Add/Update Site Calendar Event —event is added or changed on site Web calendar | User's colleagues |
| Add/Update User Calendar Event —event is added or changed on site Web calendar | User's colleagues |
| Add/Update Group Calendar Event —event is added or changed on site Web calendar | Community group members |
|
Blog Post— user posts to his blog |
User's colleagues |
|
Content Messageboard Post— user posts to a message board associated with content |
Users who have permission to view the content |
|
Create Community Group— user creates a community group |
Colleagues of user who creates group |
| Edit Content—user edits content | User's colleagues |
| Edit Group Content—user edits community group content | Community group members |
|
Forum Post— user posts to a Forum |
|
|
Forum Reply— user replies to a Forum post |
Posting user's colleagues |
|
Group Blog Comment— user comments on a community group’s blog post |
Community group members |
|
Group Blog Post— user posts to community group blog |
Community group members |
|
Group Messageboard Post— user posts to a community group message board |
Community group members |
|
Join Community Group— user joins community group |
|
| Micro-message—user posts micro-message | User's colleagues |
|
User Messageboard Post— user posts to a message board associated with a user |
|
|
User or Community Blog Comment— user comments on a blog post |
Posting user's colleagues |
Setting Up Notifications
This section shows how to set up email notification to alert a user when someone uploads a document to the Workspace.
Setting up Ektron to send notificationsSetting up Ektron to Send Notifications
An Ektron Administrator performs these steps.
NOTE: For this example to work, Ektron must be set up to send emails. See Configuring email for Tasks and Content.
- Navigate to Settings > Community Management > Notifications > Settings.
- Verify that Notifications can be published. If not:
- Click Edit.
- Click the Publish Notifications check box.
- Click Save.
- Make sure the email agent is enabled by navigating to Settings > Community Management > Notifications > Agents.
- If the Ektron Email agent does not appear in the list of agents, click Add Agent.
- Select EktronEmail from the Name drop-down.
- Click the Enabled check box.
- Click Save.
- Ektron provides a standard Notification message that is sent when a user adds content to his Workspace. The message’s name is User Workspace Content Added. Optionally edit the message.
- Navigate to Settings > Community Management > Notifications > Messages.
- Click User Workspace Content Added.
- Click Edit.
- Update the email’s subject in the Subject text box.
- Edit the message in the text editor using a combination of Tokens and text:
The document @Content.Title@ was added to @SubjectUser.UserName@’s Workspace. - If you want SMS type messages, create a shorter version of the message in the Plain Text text box.
- If you want to enable SMS messages, do the following:
- Configure the SMS Agent in the
web.configfile. See Configuring SMS - Inform users receive SMS messages to perform the verification step on a cell phone.
- Inform users to check the SMS column on the notifications page for Activities by Colleagues.
NOTE: For a summary on how to enable SMS, see "How to Enable SMS" on dev.ektron.com.
- Configure the SMS Agent in the
- Click Save.
From now on, an email is sent whenever a user uploads a document to his Workspace to colleagues who signed up to receive them.
Enabling notification publishing
You must enable the Add User Workspace Content activity in your profile so that whenever you adds content to his Workspace, a notification is sent.
- Log into the site.
- Navigate to your profile page.
- Click EditProfile.
- Click the Activities tab.
- Click the My Activities sub tab.
- Click the Add User Workspace Content check box.
- Click Save.
Receiving Notifications
You must enable the receipt of notifications that are sent whenever colleagues upload an item to their Workspace.
- Log into the site.
- Navigate to his profile page.
- Click EditProfile.
- Click the Activities tab.
- Click the Colleagues sub tab.
- Click the Add User Workspace Content check box in the Email column.
NOTE: If you want to receive SMS messages, also check the box in the SMS column.
- Click Save.
Receiving SMS Messages on Your Cell Phone
NOTE: The following procedure requires that your Web site has the template SMSAgentSettings.aspx. If it does not, you may copy it from the Ektron Developer starter site, the Ektron eIntranet site, or download it from http://dev.ektron.com/codedetail.aspx?id=29600.
- Go to the Web site page:
http://<host>/SMSAgentSettings.aspx. - Enter a phone number and carrier.
- Click Save. Within a few minutes, you will receive a verification code on your phone.
- Enter the code into the
Verification Codefield. - Click Verify. The page shows that the account is verified. You can begin receiving SMS notification messages on your phone.
Setting Default Notification Preferences
Ektron provides a default set of Notifications that apply to all newly-created users. After a user is created, the use can change the preferences by editing the profile, selecting the Activities tab, and checking or unchecking activities and agents. Similarly, a community group member can access any community group profile and click Edit Group Notification Preferences to set the group's preferences. You can apply 3 types of default settings via screens on the Workarea Settings tab.
- Colleagues—Activities involving colleagues that the logged-in user wants to be notified about
- Community Groups—Activities involving community groups that the logged-in user wants to be notified about
NOTE: The Community Groups subtab sets notification preferences for all community groups. To refine preferences further, a user can access the profile of any community group and click Edit Group Notification Preferences to set preferences for that particular group.
- My Activities—Activities involving the logged-in user to display to colleagues and community group.
NOTE: The Activities tab appears only after the user is registered and if the Workarea > Settings > Community Management >Notifications > Settings > Publish Notification setting is checked.
NOTE: Activities are checked for the Activity Stream agent by default. No activities are checked for the other agents by default.
- Log in to the Ektron Workarea as an administrator.
- Navigate to Settings > Community Management > Notifications > System Default Preferences > Colleagues.
- Click Edit.
- Place a check mark next to each a default notification.
- Click Save.
Raising a Custom Activity
Ektron's Notification system lets you create and raise your own activity types. Custom activity types can generate notifications, just like standard activity types.
- In the Ektron Workarea, go to Settings > Community Management > Notifications > Activity Types.
- Click Add Activity Type. The Add Activity Type screen appears.
- Enter a unique name.
- Select an Action Scope.
- User—an activity raised by users; their colleagues are notified
- CommunityGroup—an activity raised by a community group user; group members are notified
- Save the screen. The following image shows a sample custom activity on the View All Activity Types screen.
- Interested users go to their User Profile screen’s Activities tab where they indicate if they want be notified when the custom activity occurs, and if they want to notify others.
- To raise a custom activity, call the
Ektron.Cms.Framework.Activity.Activity.Publishmethod. The method takes anActivityDataclass. You supply the following:- the Id of the Activity Type you want to raise (1001 in this example)
- the user causing the activity
- a message
NOTE: Custom activity types cannot use Community Management messages as the standard Ektron activities do.
Here is an example of that method.
Activity activityApi = new Activity(); ActivityUserInfo user = new ActivityUserInfo() ; user.Id = activityApi.UserId; ActivityData activityData = new ActivityData(); activityData.ActionUser = user; activityData.ActivityTypeId = 1001; activityData.Message = "John Doe just rated Ektron a buy!"; activityData.LanguageId = 1033; activityApi.Publish(activityData);
When publish is called, the notification service notifies users who signed up to be notified of this activity.
Working with NotificationAgents
A notification agenta provider (such as email, SMS, and activity streams) that transmit messages. is a component that sends notification messages. Each Agent is responsible for sending notifications to users when Ektron activity occurs. How that notification is sent is up to the Notification Agent itself. When a Notification Agent is created and registered, users can begin setting up notification preferences that use it.
Ektron has predefined Notification agents, including email, SMS, and Activity Stream agents.
- SMS Notifications are sent to a cell phone or another device that receives SMS messages. See Also: Configuring SMS
- Activity stream Notifications are posted via the ActivityStream server control. See Also: Activity Streams
- email Notifications are delivered to appropriate recipients inboxes. See Also: Setting Up email to Communicate Community Activities
You can customize these providers or create your own using the extendable Notification agent architecture.
Creating a Custom Agent
Ektron comes with several standard Notification Agents, including email, SMS, and Activity Stream. You can customize these agents or create your own using the extendable Notification Agent provider architecture. This section explains how to extend the object model to build a customized Notification Agent.
Each type of Notification Agent accepts configuration parameters. For example, email and SMS require an SMTP server, username, and password. These parameters can be specified in the web.config file, and read when the Agent is initialized the first time.
Each agent may also require storing settings for each user receiving notifications. For example, the SMS agent requires the user’s cell phone number and carrier, which it stores as an SMS email address. To save these properties, each Notification Agent has an associated NotificatAgentSettingsData class. This class defines any properties needed to be supplied by the user. Ektron provides APIs for storing and retrieving this information, but the developer must create an interface for users to supply the information. The SMSAgentSettings.aspx page, supplied with the Developer and Intranet starter sites, provides a good example.
Implementing Your Own Notification Agent Provider
Object Model
The NotificationAgent is the abstract base class you must extend to implement your own notification agent. Details on the class, available properties, and methods you are required to implement are below.
|
Method |
Description |
|---|---|
|
virtual void Initialize(string name, Amenable config); |
The initialize method comes from the ProviderBase base class. It supplies all name value pairs specified in the Providers If custom settings need to be provided to your agent, add them to your provider’s |
|
abstract NotificationAgentSettingsData GetAgentSettings(); |
This method should return a new instance of the NotificationAgentSettingsData class associated with your Agent. |
|
abstract void Send(NotificationMessageData message); |
This method should send the actual notification. It will be called by the notification engine for each user that needs to be notified. The NotificationMessageData has all the information you need for sending the notification, including
If your agent has a custom NotificationAgentSettingsData, you need to cast the supplied NotificationAgentSettingsData to the appropriate type so that you can access the appropriate properties. |
Adding a Custom Agent
- Insert the provider between the Notification agent’s providers tags in the
siteroot/web.configfile.<notificationAgent> <providers> <add name="CustomAgent1" type="Ektron.Cms.Notifications.Providers.CustomAgent1, Ektron.Cms.Providers" setting1="" setting2=""/> <add name="EktronEmail" type="Ektron.Cms.Notifications.Agents.EktronEmailAgent, Ektron.Cms.BusinessObjects" useSystemSettings="false" smtpServer="amh010" smtpPort="25" userName="" password="" fromEmail="[email protected]"/> <add name="SMSAgent" type="Ektron.Cms.Notifications.Agents.SMSAgent, Ektron.Cms.BusinessObjects" smtpServer="amh010" smtpPort="25" fromEmail="[email protected]" validationRequired="true"/> <add name="ActivityFeed" type="Ektron.Cms.Notifications.Agents.ActivityFeedAgent, Ektron.Cms.BusinessObjects" validationRequired="false"/> </providers>
</notificationAgent>After you add an agent to
web.config, it appears in the list of available agents in the Workarea.
- Log into the Workarea as an administrator.
- Navigate to Settings > Community Management > Notifications > Agents.
- Click Add.
- Select the custom agent from the Name drop-down box.
NOTE: If you do not see the custom agent in the Namedrop-down, check the
web.configfile to verify it is listed between the<notificationAgent>tags. - Place a check mark in the Enabled check box.
- Click Save.
Removing an Agent
When you no longer need an agent, you can remove it. This can be a 2 step process, depending on the level of removal you are trying to achieve. First, remove the agent from the list of agents in the Workarea. At this time, you can easily return the agent to the list. In the second step, you remove the agent from the web.config file.
- Log in to the Workarea as an administrator.
- Navigate to Settings > Community Management > Notifications > Agents.
- Click the title of the agent.
- Click Delete (
). - In the Delete Agent dialog box, click OK. The page refreshes, and the agent is removed from the agents list.
NOTE: To completely remove the agent from Ektron, follow these additional steps.
- Open the site root folder’s
web.configfile. - Between the
<notificationagent>’s<providers>tags, remove the agent. The following example shows agents that might appear in theweb.configfile.<notificationAgent> <providers> <add name="CustomAgent1" type="Ektron.Cms.Notifications... <add name="EktronEmail" type="Ektron.Cms.Notifications... <add name="SMSAgent" type="Ektron.Cms.Notifications... <add name="ActivityFeed" type="Ektron.Cms.Notifications... </providers> </notificationAgent>
Managing Notification Messages
Messages are used by the notification system to communicate site activities. You can view each activity’s default message from the Workarea > Settings > Community Management > Notifications > Messages screen.
You can create an HTML-based and a plain text message for each activity. Typically, HTML messages are sent as email or to the ActivityStream server control, while plain text is used in SMS style messages. Messages typically combine text and tokens. See Also: Working with Tokens
Creating a Message
- Log into the Workarea as an administrator.
- Navigate to Settings > Community Management > Notifications > Messages.
- If you are using the Multi-Site feature, select the site with which this message will be associated.
- Click Add Message. The Add Notification Message screen appears.
- Complete the fields as described below.
- Title—Enter a name for the message.
- Type—Select the type of message you want to create. Choices are:
- User—message sent when user activity occurs
- Community Group—message sent when group activity occurs
- The activity is specified at the Sub Type field.
- Sub Type—Select the activity which triggers the sending of this message. See Also: Choosing a Message Type.
- Tokens—A list of available tokens for the selected Sub Type appears. To easily insert a token into a message, highlight a token, then copy and paste it into the message. For a list of tokens and their sub types with, see Working with Tokens. To learn about how to make tokens into hyperlinks, see Making a Token into a Hyperlink.
WARNING! A message is limited to 3000 characters after its tokens are converted to text. After 3000, any remaining characters are removed.
- Default—Click this check box if you want the message to be the default one that is sent. See Also: Choosing a Message Type
- Subject—Enter a subject to be used if the message is sent as email.
- Text—Enter the text and tokens that comprise the message. The editor lets you format the text.
- Use this editor for HTML, email, and activity stream messages. See Also: Making a Token into a Hyperlink
- Plain Text—Enter the text and tokens that comprise the message you want to send. Use this field for SMS type messages and messages to be sent as plain text. (If you already composed the message in the editor above, you can select that text, then copy and paste it into the Plain Text field.)
NOTE: Most SMS systems impose a 160 character limit on messages. If you create a plain text message greater than 160 characters, Ektron divides it into several, smaller messages.
- Click Save. The message now appears in the list of Notification messages. If it is the default and an activity occurs on your Web site that matches the type and sub type, the message is sent.
Choosing a Message Type
User and Community Group messages contains several sub types of messages. The sub type is the activity that triggers the message. For example, to edit the message that notifies colleagues when a user uploads a document to his Workspace, select User from the Typedrop-down andAddWorkspaceItem from the Sub Typedrop-down.
When you create a new message, you assign it to a type and sub type, such as User Activity > Blog Post. Only the default message is active for any combination of type and subtype. So, while creating a new message, you must make it the default (via the Add Notification Message screen’s Default check box) if you want it to be sent. When you do, if another message was the default for that type and sub type, it is no longer used. For a list of Sub types, see Triggering a Notification Message.
Managing Notifications in a Multi-Site Environment
In a Multi-site environment, notifications stay within the site where the activity happened. For example, if there are 2 sites—an Intranet and Social Club site—when a user from the Intranet site performs an activity that generates a message, it does not trigger notifications on the Social Club site. Exception: A user’s colleagues receive notifications regardless of the site from which the message originated.
When a message type is created, it becomes the default message and is used by all sites. You can assign new messages of the same type to each site in your environment.
To view the messages assigned to each site, go to the View All Notification Messages screen, click the Site drop-down, and select the site.
When you create notification messages in a Multi-Site environment, you specify the site associated with message. This lets you create customized messages for each site. For example, you want a “Status Update” message targeted one way for an Intranet site and another way for your Social Club site. To accomplish this, create a 2 messages. The message for the Intranet site might state:
@SubjectUser.username@ has updated his status on Intranet with the following: @MicroMessage.Message@.
While your Social Club site might have a message that states:
@SubjectUser.username@ has updated his status on the Social Club with the following: @MicroMessage.Message@
Using SSL with Notifications
If your site uses SSLSecure Sockets Layer (https), you need to update the link in the Ektron notification service configuration file with that information. The file is at: your-server\Program Files\Ektron\EktronNotificationService\Ektron.Notification.Service.exe.config.
Change the following tags.
<siteNotification>
<sites>
<add name="769723537" url="https://your server" connectionString="server=your server; database=Intranet2; Trusted_Connection=true; User ID=;Password=;" />
</sites>
</siteNotification>
You must restart the Ektron Notification Service to enable these changes.
Using eSync with Notifications
When using eSync with Notifications, new agents are not synched. This means that you must manually add new agents to each server in your configuration.
When the agent exists on all servers in your configuration, eSync keeps them updated. For example, assume a membership user logs into the production server and updates his profile’s Activities tab by changing the activities a custom agent will perform. eSync will sync those changes with the staging server.
Configuring SMS
SMSShort Message Service (SMS); used for texting. sends community notification messages from the Ektron Web site to wireless devices such as a cell phone or PDAPersonal Data Assistant. To accomplish this, you must configure several items.
web.config—Add SMS Agent information.- Cell phone—Verify your Cell Phone with your Web Site.
- SMS Notification Agent—Configure the SMS Agent in the Ektron Workarea.
- Messages you send to the community—Set your activities to publish by SMS in your community profile.
- Messages you receive from the community—Set activities to receive by SMS in your community profile.
For a complete Knowledge Base Article entitled "How to Enable SMS Notifications", go to the following page in the Ektron Developer Center: http://dev.ektron.com/kb_article.aspx?id=29586.
Configuring web.config for SMS
- Find
web.configin your Web site root directory. - Make a copy of it for safe keeping.
- Find the
SMSAgenttag. - Enter the proper value for smtpServer for the server that sends emails in your company. For example:
smtpServer="EKMAIL291.intra.mycompany.com"
- Replace the value of fromEmail with the email from whom the notices are sent. For example:
fromEmail = "[email protected]"
- Save the file. The completed code looks like this.
<add name="SMSAgent" type="Ektron.Cms.Notifications.Providers.SMSAgent,Ektron.Cms.Providers" smtpServer="EKMAIL291.intra.mycompany.com" smtpPort="25" fromEmail="[email protected]" validationRequired="true" />
Verifying Your Cell Phone for SMS Messages
To verify that you have made a proper connection to your cell phone, you must send a verification message from the Ektron Web site to your phone. To verify your phone, do the following steps.
NOTE: The following procedure requires that your Web site has the template SMSAgentSettings.aspx. If it does not, you may copy it from the Ektron Developer starter site, the Ektron eIntranet site, or download it from http://dev.ektron.com/codedetail.aspx?id=29600.
- In a browser, enter the following address:
http://<hostname>/SMSAgentSettings.aspx. A screen appears that looks similar to the following:
- Enter your cell phone area code and phone number.
- Select your provider.
- Click Save. In a few minutes, your phone receives a message with a validation code.
- Enter that code into the Verification Code field.
- Click Verify. If the proper code is entered, the follow screen appears, showing that the SMS account is verified. If not, check the other configuration settings and try again.
NOTE: When the phone number is verified, the Account Verified checkmark appears. This will not change unless you change the cell phone number or provider.
Working with Tokens
A tokenan Ektron-defined variable that surrounded by at signs (@). For example, @SubjectUser.FirstName@. This variable gets translated in message notifications. is an Ektron-defined variables surrounded by at signs (@). When a message is generated, tokens retrieve information about Ektron users, groups, and objects. For example, the following message:
@SubjectUser.FirstName@ added a new document, ‘@Content.title@’, to his profile page.
might look like this:
“Paul added a new document, ‘How to Write Code’, to his profile page.”
In this example, @SubjectUser.FirstName@ is the first name of the user performing the action. @Content.title@ is the title of the object that was uploaded.
A message can include several token types.
- SubjectUser tokens—represent the user who performs the activity
- DirectObjectUser tokens—represent the user to which the activity is happening
- Content tokens—represent the content that was a part of the activity
- CommunityGroup tokens—represent the community group that was involved in the activity
- Blog tokens—represent the blog use in the activity
- webEvent tokens—represents the Web Calendar used in the activity
- MicroMessage tokens—represent micromessages used in the activity
Making a Token into a Hyperlink
A message tokenan Ektron-defined variable that surrounded by at signs (@). For example, @SubjectUser.FirstName@. This variable gets translated in message notifications. represent Ektron users, groups, or content. It can become a link that, when clicked, brings the user to content, a user’s profile, or community group’s profile.
To make a token into a clickable link:
- Create the message as described in Creating a Message.
- While editing the message text, highlight a token and click Hyperlink Manager (
). The hyperlink dialog box appears. - In the URL field, enter the path to the page that displays the content, user, or community group.
Make sure you include the QueryString parameter used to identify the object. The parameter should point to an ID token. For example, a message notifies your colleagues whenever you add a new colleague. The message might be:
@SubjectUser.UserName@ and @DirectObjectUser.UserName@ are now colleagues.
When creating a link for @SubjectUser.UserName@, insert the path to the user’s profile page into the URL field. It might look like this:
http://localhost/Intranet/UserProfile.aspx?id=@subjectUser.Id@Note, the QueryString parameter (
?id=)points to a token that represents the logged-in user’s ID,@subjectUser.Id@. See Also: Working with TokensFor
@DirectObjectUser.UserName@, enter the same path and change the dynamic parameter token to[email protected]@.When hyperlinking content, use its QuickLink token in the path defined in the URL field. For example, a message that sends a Notification when a user adds content might look like:
@SubjectUser.username@ added new content, @Content.Title@.
- Click OK.
Message Tokens: User and Content-Based
Add Calendar Event and Update Calendar Event
- @SubjectUser.DisplayName@
- @SubjectUser.Id@
- @SubjectUser.FirstName@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
- @WebEvent.EndTime@
- @WebEvent.Id@
- @WebEvent.Quicklink@
- @WebEvent.StartTime@
- @WebEvent.Title@
AddColleague
- @DirectObjectUser.FirstName@
- @DirectObjectUser.Id@
- @DirectObjectUser.LastName@
- @DirectObjectUser.TemplateAlias@
- @DirectObjectUser.UserName@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@,
- @System.UserProfileTemplate@
AddContent
- @Content.Icon@
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteURL@
- @System.UserProfileTemplate@
AddWorkspaceItem
- @Content.Icon@
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteURL@
- @System.UserProfileTemplate@
BlogComment
- @BlogComment.Id@
- @BlogComment.Message@
- @SubjectUser.DisplayName@
- @SubjectUser.Id@
- @SubjectUser.FirstName@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
BlogPost
- @Content.Icon@
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
CreateCommunityGroup
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @CommunityGroup.TemplateAlias@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
ContentMessageBoardPost
- @Content.Icon@
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @MessageBoard.Message
- @MessageBoard.ObjectId@
- @MessageBoard.ObjectType@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
- @SubjectUser.TemplateAlias@
- @System.GroupProfileTemplate
- @System.SiteUrl@
- @System.UserProfileTemplate@
EditContent
- @Content.Icon@
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
EditWorkspaceItem
- @Content.Icon@
- @Content.Id@
- @Content.Title@
- @Content.Quicklink@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl
- @System.UserProfileTemplate@
ForumReply
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
- @Topic.Id@, @Topic.Title@
- @Topic.Quicklink@
- @TopicReply.Id@
ForumPost
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
- @Topic.Id@, @Topic.Title@
- @Topic.Quicklink@
- @TopicReply.Id@
JoinCommunityGroup
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @CommunityGroup.TemplateAlias@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
MicroMessage
- @MicroMessage.Id@
- @MicroMessage.Message@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
UserMessageboardPost
- @DirectObjectUser.Id@
- @DirectObjectUser.FirstName@
- @DirectObjectUser.LastName@
- @DirectObjectUser.UserName@
- @MessageBoard.Message@
- @MessageBoard.ObjectId@
- @MessageBoard.ObjectType@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
- @SubjectUser.TemplateAlias@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
Message Tokens: Community Group-Based
Add Calendar Event and Update Calendar Event
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@,
- @System.UserProfileTemplate@
- @WebEvent.EndTime@
- @WebEvent.Id@
- @WebEvent.Quicklink@
- @WebEvent.StartTime@
- @WebEvent.Title@
AddWorkspaceItem
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @Content.Icon@
- @Content.Title@
- @Content.Id@
- @Content.Quicklink@
- @DirectObjectUser.FirstName@
- @DirectObjectUser.Id@
- @DirectObjectUser.LastName@
- @DirectObjectUser.UserName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteURL@
- @System.UserProfileTemplate@
BlogComment
- @BlogComment.Id@
- @BlogComment.Message@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
BlogPost
- @Content.Id@
- @Content.Quicklink@
- @Content.Title@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
CreateCommunityGroup
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
GroupMessageBoardPost
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @CommunityGroup.TemplateAlias@
- @MessageBoard.Message@
- @MessageBoard.ObjectId@
- @MessageBoard.ObjectType@
- @SubjectUser.DisplayName@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.TemplateAlias@
- @SubjectUser.UserName@
- @System.GroupProfileTemplate@
- @System.SiteUrl@
- @System.UserProfileTemplate@
JoinCommunityGroup
- @CommunityGroup.Id@
- @CommunityGroup.Name@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@
UserMessageboardPost
- @DirectObjectUser.FirstName@
- @DirectObjectUser.Id@
- @DirectObjectUser.LastName@
- @DirectObjectUser.UserName@
- @MessageBoard.Message@
- @MessageBoard.ObjectId@
- @MessageBoard.ObjectType@
- @SubjectUser.FirstName@
- @SubjectUser.Id@
- @SubjectUser.LastName@
- @SubjectUser.UserName@