Creating custom service callouts

/*
* Copyright (c) 2016 by Progress Software Corporation. All rights reserved.
*/

package com.corticon.samples.extensions;

import java.util.ArrayList;
import java.util.Set;

import com.corticon.services.dataobject.ICcDataObject;
import com.corticon.services.dataobject.ICcDataObjectManager;
import com.corticon.services.extensions.Description;
import com.corticon.services.extensions.ICcServiceCalloutExtension;
import com.corticon.samples.simulation.*;

/**
* This class provides sample Corticon service callouts. Callouts provide
* a means to add custom features to Corticon for use in Corticon ruleflows.
* Callouts are for integrating with external systems such as webservices.
* In a callout you can create and delete instances of Corticon entities,
* set their properties and define associations.
*
* The samples in this class provide a simulation of retrieving patient
* medical data given a patient id. The class MedicalDataSimulator provides
* a static set of patient and procedure data. In a real implementation
* this could be a class which gets data from a webservice, database, or
* other source.
*
*/
public class MedicalRecords implements ICcServiceCalloutExtension {

private static MedicalDataSimulator md = new MedicalDataSimulator();

/**
* Service callout to retrieve patient descriptive information for
* the set of Corticon "Patient" entities.
*
* This callout demonstrates how to iterate over a set of Corticon
* entities and set attributes on them.
*/
@Description(lang = { "en" }, values = { "Service callout to retrieve patient descriptive information for the set of Corticon 'Patient' entities." })

public static void getPatientInfo(ICcDataObjectManager dataObjMgr) {
// Get the set of "Patient" entities.
Set<ICcDataObject> patients = dataObjMgr.getEntitiesByName("Patient");
if (patients != null) {
// Process each patient in the set.
for (ICcDataObject patient : patients) {
// Get the "id" attribute of the current patient.
Long id = (Long) patient.getAttributeValue("id");

if (id != null) {
// Get the simulated information for this patient.
PatientData pd = md.getPatientData(id.intValue());

if (pd != null) {
// Set patient information as entity attributes.
patient.setAttributeValue("firstName",pd.getFirstName());
patient.setAttributeValue("lastName", pd.getLastName());
}
}
}
}
}

/**
* Service callout to retrieve history of medical procedures for the
* set of Corticon "Patient" entities.
*
* This callout demonstrates how to create new Corticon entities and
* associate them with existing Corticon entities.
*/
@Description(lang = { "en" }, values = { "Service callout to retrieve history of medical procedures for the set of Corticon 'Patient' entities." })
public static void getProcedureHistory(ICcDataObjectManager dataObjMgr) {
// Get the set of "Patient" entities.
Set<ICcDataObject> patients = dataObjMgr.getEntitiesByName("Patient");
if (patients != null) {
// Process each patient in the set.
for (ICcDataObject patient : patients) {
// Get the "id" attribute of the current patient.
Long id = (Long) patient.getAttributeValue("id");

if (id != null) {
// Get the simulated information for this patient.
PatientData pd = md.getPatientData(id.intValue());

// Get the medical procedure history for this patient.
ArrayList<ProcedureData> td = pd.getProcedureRecords();

// Add procedures to the patient entity
for (ProcedureData r : td) {
// Create a new "Procedure" entity.
ICcDataObject p = dataObjMgr.createEntity("Procedure");

// Set attributes on this entity.
p.setAttributeValue("code", r.getCode());
p.setAttributeValue("description", r.getDescription());
p.setAttributeValue("date", r.getDate());

// Associate it with the current patient.
patient.addAssociation("procedure", p);
}
}
}
}
}

/**
* Service callout to save the approval state for each medical procedure
* for a set of Corticon "Patient" entities.
*
* This callout demonstrates how to iterate over a set of entities and
* associations to get the value of attributes.
*/
@Description(lang = { "en" }, values = { "Service callout to save the approval state for each medical procedure for a set of Corticon 'Patient' entities." })
public static void saveProcedureApproval(ICcDataObjectManager dataObjMgr) {
// Get the set of "Patient" entities.
Set<ICcDataObject> patients = dataObjMgr.getEntitiesByName("Patient");
if (patients != null) {
// Process each patient in the set.
for (ICcDataObject patient : patients) {
// Get the "id" attribute of the current patient.
Long id = (Long) patient.getAttributeValue("id");

// Process each "Procedure" association on the patient.
Set<ICcDataObject> procedures = patient.getAssociations("procedure");
for (ICcDataObject procedure: procedures) {

// Get the value of the "approved" and "code" attributes on the procedure.
Boolean approved = (Boolean) procedure.getAttributeValue("approved");
String code = (String) procedure.getAttributeValue("code");

// Update the procedure record.
md.setProcedureApproval(id.intValue(), code, approved);
}
}
}
}