Page Comparison

7. Organization's Alerts

7.1 SurveyAgent

Remember that Alerts are generated by the SurveyAgent. For this scenario we are going to have 2 rules generating alerts: 'New Patient Admission" and "Milk Importance Not Discussed".

...

Code Block

language	java
linenumbers	true

package org.socraticgrid.survey.agent;
import org.drools.mas.body.content.*;
import org.drools.mas.action.message.*;
import org.drools.mas.action.message.types.*;
import org.drools.mas.action.message.invokers.*;
import org.socraticgrid.survey.agent.api.model.SurveySubmissionFact;
import org.socraticgrid.survey.agent.api.model.SurveySubmissionAnswerFact;
import org.socraticgrid.survey.agent.api.model.PreValidationResult;
import org.socraticgrid.survey.agent.log.RulesLoggerHelper;
import org.socraticgrid.surveys.model.*;
import org.socraticgrid.surveys.service.SurveyService;
import org.socraticgrid.alertmanager.service.AlertService;
import org.slf4j.Logger;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.HashMap;
import java.util.Date;
import org.drools.mas.action.helpers.*;
/* Global Services */
global SurveyService surveyService;
global AlertService alertService;
global Logger logger;
 
rule "New Patient Admission"
when
    //There is a Submission of a #5 Survey
    //And there alert was not previously sent.
    $s: SurveySubmissionFact(
            surveyId == 5,
            $chartId: q["q008"],
            alertService.parameterizedAlertExists($s.getPatientId(), "New Patient Admission") == false
    )
then
    RulesLoggerHelper.debug(logger, drools, "New Admission detected: {}", $s);

    templateVariables.put("common_patient_chartId", $chartId);
    insert( new ResolvableActionAgentNotificationCandidateFact(
        drools.getRule().getName(),     //sourceRule
        "ADMISSION",                          //sourceProgram
        (SurveySubmissionFact)$s,       //sourceFact
        $s.getPatientId(),                      //sourcePatient
        "HIGH",                                     //priority
        "ACME-NewAdmission",                   //template
        "10s",                                        //timeout
        templateVariables                     //template variables
));
end

rule "Milk Importance Not Discussed"
when
    //There is a Submission of a #4 Survey
    $s: SurveySubmissionFact(
            surveyId == 4,
            q["q007"] == "No"
    )
then
    RulesLoggerHelper.debug(logger, drools, "Milk Importance Not Discussed: {}", $s);
    insert( new ResolvableActionAgentNotificationCandidateFact(
        drools.getRule().getName(),     //sourceRule
        "NCCC",                                    ///sourceProgram
        (SurveySubmissionFact)$s,       //sourceFact
        $s.getPatientId(),                      //sourcePatient
        "HIGH",                                     //priority
        "ACME-NotDiscussed",            //template
        "10s",                                        //timeout
        null                            //template  variables
 ));
          //template variables
));
end

...

end

Some important notes about ACME-alerts.drl are:

Lines #25 and #50 define the 2 rules
In "New Patient Admission" rule (the other rule is similar):
- Line #35 logs information
- Line #37 inserts a new ResolvableActionNotificationCandidateFact that will end up notifying the ActionAgent about a new Alert.
- Line #44 specifies the Template id that we want to use. Templates and their Ids are defined in the ActionAgent.

The next step is to create a change-set that includes all the necessary .drl files. Let's call this file ACME-change-set.xml.

Code Block

language	xml
linenumbers	true

<?xml version="1.0" encoding="UTF-8"?>
<change-set xmlns='http://drools.org/drools-5.0/change-set' xmlns:xs='http://www.w3.org/2001/XMLSchema-instance'
xs:schemaLocation='http://drools.org/drools-5.0/change-set http://anonsvn.jboss.org/repos/labs/labs/jbossrules/trunk/drools-api/src/main/resources/change-set-1.0.0.xsd'>
    <add>
        <resource type="DRL" source="classpath:org/drools/mas/acl_common.drl" />
        <resource type="DRL" source="classpath:knowledge/subsession/subsession-config.drl" />
        <resource type="DRL" source="classpath:knowledge/subsession/survey-common.drl" />
        <resource type="DRL" source="classpath:knowledge/subsession/survey-prevalidation-common.drl" />
        <resource type="DRL" source="classpath:knowledge/subsession/survey-alert-common.drl" />
        <resource type="DRL" source="classpath:knowledge/subsession/ACME-alerts.drl" />
    </add>
</change-set>

Some important notes about the change-set:

From line #5 to line #9 we have some common .drl that should be included in any session.
Line #10 includes the .drl we have specifically created for ACME organization.

Once we have the rules and the change-set we need to define a new sub-session for ACME in applicationContext.xml file:

Code Block

language	xml
linenumbers	true

<bean id="ACME" class="org.drools.mas.core.DroolsAgentConfiguration$SubSessionDescriptor">
    <constructor-arg value="subsession-acme"/>
    <constructor-arg value="ACME-change-set.xml"/>
    <constructor-arg value="${agent.node}"/>
    <constructor-arg>
        <map>
            <entry key="organizationId" value="ACME"/>
        </map>
    </constructor-arg>
</bean>
...
<bean id="${agent.name}-configuration" class="org.drools.mas.core.DroolsAgentConfiguration">
    <property name="agentId" value="${agent.name}"/>
    <property name="changeset" value="agent_changeset.xml" />
    <!-- by default the mindNodeLocation is local --> 
    <property name="mindNodeLocation" value="${agent.node}"/>
    <property name="subSessions">
        <list>
            ...
            <ref local="${agent.name}-unc"/>
        </list>
    </property>
</bean>

Important notes about the contextApplication.xml file:

Line #1 defines the new sub-session for ACME organization.
Line #20 includes this new sub-session as part of the main session of the agent.

The last step is to add the routing statement in agent_cbr.drl:

Code Block

language	java
linenumbers	true

rule "Mapping"
when
then
    ...
    insert( new SessionMapping("ACME","subsession-acme") );
    RulesLoggerHelper.debug(logger, drools, "Subsession mapping created for 'ACME');
    ... 
end

7.2 Alerts Configuration

AlertConfiguration
Id	Name	Description	AlertKey	WorkspaceId	SendNotification
1			New Patient Admission	PH-Nursery	True
2			Milk Importance Not Discussed	PH-Nursery	True
3			New Patient Admission	PH-Nicu	True
4			Milk Importance Not Discussed	PH-Nicu	True

AlertConfigurationUserRecipient
Id	AlertConfigurationId	UserId
1	1	ACME-U1
2	3	ACME-U1

AlertConfigurationRoleRecipient
Id	AlertConfigurationId	RoleId
1	2	2
2	4	2

Facilities
FacilityId	OrganizationId	Name	Timezone	NFCEnabled	NFCSelfModificationEnabled	BarCodeEnabled
ACME-PH	ACME	Pearl Harbor	US/Hawaii	true	false	false

SurveyTemplates
SurveyId	Name
1	New Line Report
2	Line Maintenance
3	Infection Report
4	Breast Milk Report
5	Patient Demographics
6	Patient Discharge
7	Patient Open Lines
8	Form Open Lines
9	Admission Questions
10	Patient Final Discharge
11	AUDIT
12	MDQ

Versions Compared

Old Version 3

New Version Current

Key

Table of Contents

7. Organization's Alerts

7.1 SurveyAgent

7.2 Alerts Configuration