{"id":9063,"date":"2013-05-21T11:42:01","date_gmt":"2013-05-21T17:42:01","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/techblog\/?p=9063"},"modified":"2023-05-12T13:23:34","modified_gmt":"2023-05-12T19:23:34","slug":"messaging-scheduled-tasks","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/techblog\/?ht_kb=messaging-scheduled-tasks","title":{"rendered":"Messaging & Scheduled Tasks"},"content":{"rendered":"

Messaging & Scheduled Tasks<\/strong><\/p>\n

Our customer (Betty), runs a small fitness center where members pay a monthly fee to utilize the facilities. Every time a member submits a payment, Betty enters the date in a maintainer to keep track of when the last payment was received from that member. Every Sunday, Betty checks to see which members are behind on their payments, and sends them an email reminder of the late payment. Betty would like to automate the process, and have m-Power send the message for her to make the process more efficient and less time consuming.<\/p>\n

Utilizing the m-Power Messaging & Scheduled Tasks utility, we can create this solution for Betty in a few easy steps.<\/p>\n

This is the maintainer, it contains the names and email addresses of the members:<\/p>\n

\"MaintainerView\"<\/a><\/p>\n

The first step is to setup m-Power to send emails. Click Admin, click Utilities, and then click Messaging & Scheduled Tasks. From the Main menu drop down, click Task & Message configuration. Here we will fill in the information for our email services. This is what the page looks like after filling in the values:<\/p>\n

\"FakeMessageSetup\"<\/a><\/p>\n

These values will differ depending on the email provider being used.\u00a0 If m-Power is already configured in your system to send emails, you will find these values in Admin –> Edit Data Dictionary Files –> Servlet Properties.<\/p>\n

Next, we will create the retrieval that will serve as our email body, and we will create the distribution list that holds the email addresses where we want to send our messages.<\/p>\n


Create a Single Record Inquiry over the same table where the maintainer writes the dates of payment. In m-Painter, we can delete or hide the main table and type in the text for our email body. Then from the retrieval properties, set the hide_header_footer to \u2018Yes\u2019 since we do not want the header and footer in the email. Notice in the retrieval we are using the name of the customer and the date of the last payment, from the variable, to create a more personalized message.<\/p>\n

\"EmailRetrieval\"<\/a><\/p>\n

Next we will create the distribution list. From the retrieval tab, click Create New, and then select the Address Distribution List as the template.<\/p>\n

\"DistributionListTemplate\"<\/a><\/p>\n

Select the same table from the maintainer. Sequence the application by the email address. As you can see the Address Distribution List does not look like an application, it just holds the list of email addresses where to send the message. I create a record selection combined with a calculation to send the message to only those members whose payment is older than a month.<\/p>\n

\"DistributionListMenu\"<\/a><\/p>\n

The next step is to add a new Group to the messaging utility. Click Admin, then click Utilities, and then click Messaging & Scheduled Tasks. \u00a0Click the green plus sign to add a new group, give it a name and a description. Click Accept.<\/p>\n

\"CreateGroup\"<\/a><\/p>\n

Next click Add Task, when we click Add Task we are offered two options: New Message or New Summary. In our case we need to send a message, so we will select New Message.<\/p>\n

\"ClickAddTask\"<\/a><\/p>\n

In the next window we will find four tabs. Let\u2019s go over each one of them.<\/p>\n

In the Message Type tab type a message description. Under Message Source, we have two options: Static Message or m-Power Application. Static message will allow us to type the text for our message, without the need for an application. This is not a good idea in our case, because we want to send the message only to those customer that have not paid, and we want the message to be customized with their names and last date of payment received. So we will select m-Power Application. Then we are prompted with the location of the application that will be our message. I our case the retrieval 20.<\/p>\n

\"MessageType\"<\/a><\/p>\n

Clicking the Message Format tab will allows us to choose what type of message we want to send, we will select Email. We will embed the message in the email body, and we will select HTML as the output format.<\/p>\n

\"MessageFormat\"<\/a><\/p>\n

The next tab is the Recipients tab. Here we will select the Send 1 message per recipient choice, since we will personalize the message with the customer name and the last date of payment received. Select the dictionary and the application that is our distribution list. For our example we can leave the rest as default.<\/p>\n

\"Recipients\"<\/a><\/p>\n

The last tab is the Message Text tab. Here we set the email subject for the email. Optionally, we can specify a different email as the sender email address.<\/p>\n

 <\/p>\n

\"MessageText\"<\/a><\/p>\n

We are now finished setting up the email message. The next step is to send the message to our customers. There are three ways that we can send a message form m-Power. The simplest way is by triggering the message from the URL. This method is best for testing purposes, or if you need to send a message one time only. To run the message simple point you URL to: \/mrcjava\/servlet\/DICTIONARY.Task?group=NAME_OF_GROUP
\nThis will trigger the message to be sent only that one time.<\/p>\n

\"URLcall\"<\/a><\/p>\n

The second way of sending the message is by sending it automatically after a maintainer has completed an action. This could be used to send an email confirmation after a change or update was done to the table via the maintainer. To trigger the message from the maintainer, open the maintainer properties, and click the After Actions tab. Here you will find four properties where you can set the group to be triggered depending on the action performed by the maintainer. For or example I chose the all_message, which will trigger the message after any action (Add, Update, Delete)<\/p>\n

\"MaintainerCall\"<\/a><\/p>\n

The third way of triggering the message is by setting a scheduled task. Using this method we can setup when and how often the message will be sent. To schedule a task: navigate to the Messaging & Scheduled Tasks, hover over the Main Menu and click Scheduled Tasks.
\nClick the green plus sign to schedule a new task. A drop down will allow you select the Task Group you will like to schedule. Then click the button on the Frequency row. Here we will specify \u2018week\u2019 because we want to send one message a week. Then we select a day and time, Sunday at 06:00 will work for us. NOTE: The time is specified in military time, 06:00 will mean 6am, if you wanted to send the message at 6pm it would be: 18:00.<\/p>\n

\"ScheduledTasks\"<\/a><\/p>\n

Click Accept. We are back at the Scheduled Tasks page. The task we just scheduled will display here.\u00a0 NOTE: the schedule task will not run until Tomcat has restarted to allow the new setting to be loaded. From this screen you can restart Tomcat by clicking the Reload Tomcat Now link, if you have the permissions to do so. Otherwise you will need to ask your server administrator to restart Tomcat.<\/p>\n

\"ScheduledTasksView\"<\/a><\/strong><\/p>\n

Promoting the Task to Production<\/strong><\/p>\n

Now that we are finished, we can test the message and confirm that everything is working as expected. It is time to promote the task to production. To promote the task to production we will need to move all the applications involved: the email body (retrieval), the Distribution List (retrieval), and the maintainer if one was used. These applications will be promoted in the regular way. Besides the application files, there are four files that also need to be promoted. These are the files, and their corresponding locations:<\/p>\n