Use APIs to update entities and associations

function addFlightPlanToCargo(corticonDataManager) {
	let childEntity;
	let parentEntity;
	let aircraftEntity;
	const entities = corticonDataManager.getEntitiesByType('Cargo');
    entities.forEach(entity => {
        if((entity['container'] === 'reefer') && entity['volume'] === 10 && entity['weight'] === 1000) {
            //Update the attribute value to something else
            parentEntity = entity;
        }
    });
	
	const entitiesChild = corticonDataManager.getEntitiesByType('FlightPlan');
    entitiesChild.forEach(entity => {
        if(entity['flightNumber'] === 737) {
            childEntity = entity;
        }
    });
	
	//Add Association
	corticonDataManager.addAssociation(parentEntity, childEntity, 'flightPlan');
	
}	

const updateFlightPlan = {
    func: 'updateFlightPlanToCargo',
    type: 'ServiceCallout',
    description: {'en_US': 'associates FlightPlan to Cargo'},
    extensionType: 'SERVICE_CALLOUT',
    ret: 'Void',
    name: { 'en_US': 'updateFlightPlan' }
};
	

function updateFlightPlanToCargo(corticonDataManager) {
    let childEntity;
    let parentEntity;
    const entities = corticonDataManager.getEntitiesByType('Cargo');
    entities.forEach(entity => {
        if((entity['container'] === 'reefer') && entity['volume'] === 10 && entity['weight'] === 1000) {
            //Get the parent Entity
            parentEntity = entity;
        }
    });
    
    const entitiesChild = corticonDataManager.getEntitiesByType('FlightPlan');
    entitiesChild.forEach(entity => {
        if(entity['flightNumber'] === 737) {
            //Get the child Entity
            childEntity = entity;
        }
    });
    
    //Set Association
    corticonDataManager.setAssociation(parentEntity, childEntity, 'flightPlan');
    
}	

const removeFlightPlan = {
    builtin: false,
    func: 'removeFlightPlanImpl',
    type: 'ServiceCallout',
    description: {'en_US': 'removes FlightPlan associated with Cargo'},
    extensionType: 'SERVICE_CALLOUT',
    ret: 'Void',
    name: { 'en_US': 'removeFlightPlan' }
};	

function removeFlightPlanImpl(corticonDataManager) {
    let childEntity;
    let parentEntity;
    const entities = corticonDataManager.getEntitiesByType('Cargo');
    entities.forEach(entity => {
        if((entity['container'] === 'reefer') && entity['volume'] === 10 && entity['weight'] === 1000) {
            //Get the parent Entity
            parentEntity = entity;
        }
    });
    
    const entitiesChild = corticonDataManager.getEntitiesByType('FlightPlan');
    entitiesChild.forEach(entity => {
        if(entity['flightNumber'] === 737) {
            //Get the child Entity
            childEntity = entity;
        }
    });
    
    //Remove Association
    corticonDataManager.removeAssociation(parentEntity, childEntity, 'flightPlan');
    
}

Sample using Cargo
Say you want to add another Cargo to the payload for your rules to execute. You can create 
a service callout and append that cargo to the working memory.
For example:
{
        "volume": 10,
        "container": null,
        "flightPlan": {
            "aircraft": {
                "aircraftType": "Airbus",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "30.000000"
            },
            "flightNumber": 380
        },
        "weight": 1000
}
The above JSON payload has a Cargo at root and its associations nested in the JSON. 
You can use the API to add this Cargo to the working memory.
//Sample Code for using the API as below 
//Metadata for the Service Callout
const asyncAddCargoEntity = {
    func: 'asyncAddCargoEntityFct',
    type: 'ServiceCallout',
    description: {'en_US': 'This function is used to add some data to the working memory.'},
    extensionType: 'SERVICE_CALLOUT',
    name: {'en_US': 'asyncAddCargoEntity'}
};
//Service Callout Function
async function asyncAddCargoEntityFct(corticonDataManager) {
	const logger = corticonDataManager.getLogger();
	//Define the payload i.e your JSON Object
	const payload = {
        "volume": 10,
        "container": null,
        "flightPlan": {
            "aircraft": {
                "aircraftType": "Airbus",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "30.000000"
            },
            "flightNumber": 380
        },
        "weight": 1000
    };
try {
	//Api to add the Cargo to the root. Takes the entity Type and the payload.    
	const returnCode = corticonDataManager.addEntitiesAndAssociations('Cargo', payload);
		if(returnCode === success)
			logger.logDebug(`*** Cargo has been Added`);
	}
	catch ( e ) {
		logger.logError(`*** Error adding entity: ${e}`);
	}    
}
exports.asyncAddCargoEntityFct = asyncAddCargoEntityFct;
In the above example the API will add a Cargo at root and 
also add the nested association FlightPlan and the association Aircraft to the working memory.

To pass a JSONArray
//Metadata for the Service Callout
const asyncAddCargoEntity = {
    func: 'asyncAddCargoEntityFct',
    type: 'ServiceCallout',
    description: {'en_US': 'This function is used to add some data to the working memory.'},
    extensionType: 'SERVICE_CALLOUT',
    name: {'en_US': 'asyncAddCargoEntity'}
};
//Service Callout Function
async function asyncAddCargoEntityFct(corticonDataManager) {
	const logger = corticonDataManager.getLogger();
	const payload = [
    {
        "volume": 10,
        "container": null,
        "flightPlan": {
            "aircraft": {
                "aircraftType": "Airbus",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "30.000000"
            },
            "flightNumber": 380
        },
        "weight": 1000
    },
    {
        "volume": 40,
        "container": null,
        "weight": 1000,
		"flightPlan": {
            "aircraft": {
                "aircraftType": "Boeing",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "50.000000"
            },
            "flightNumber": 737
        }
    },
    {
        "volume": 20,
        "container": null,
        "weight": 30000
    },
    {
        "volume": 10,
        "container": null,
        "needsRefrigeration": true,
        "weight": 1000
    }
];
try {
	//API to add Cargo's to the working memory
	//In the above example, 4 Cargo entities will be added to working memory    
	const returnCode = corticonDataManager.addEntitiesAndAssociations('Cargo', payload);
		if(returnCode === success)
			logger.logDebug(`*** Cargos have been Added`);
	}
	catch ( e ) {
		logger.logError(`*** Error adding entity: ${e}`);
	}    
}
//Exports
exports.asyncAddCargoEntityFct = asyncAddCargoEntityFct;

To add a flightPlan association to Cargo, the JSON payload might look like this:									
{
            "aircraft": {
                "aircraftType": "Airbus",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "30.000000"
            },
            "flightNumber": 380
}
									
The above JSON has FlightPlan and nested Aircraft.
You can add this association to the existing Cargo using the sample below -
//Metadata for the Service Callout
const asyncAddFlightPlanAssociationEntity = {
    func: 'asyncAddFlightPlanEntityFct',
    type: 'ServiceCallout',
    description: {'en_US': 'This function is used to add some flight plan to the cargo entity.'},
    extensionType: 'SERVICE_CALLOUT',
    name: {'en_US': 'asyncAddFlightPlanAssociationEntity'}
};
//Service Callout Function
async function asyncAddFlightPlanEntityFct(corticonDataManager) {
	const logger = corticonDataManager.getLogger();
	const payload = {
            "aircraft": {
                "aircraftType": "Airbus",
                "maxCargoWeight": null,
                "tailNumber": null,
                "maxCargoVolume": "30.000000"
            },
            "flightNumber": 380
        };
try {
		//This API gets the Cargo entities in working memory
		const entities = corticonDataManager.getEntitiesByType('Cargo');
		/* Logic to determine which Cargo you want to associate this
		   Flight Plan with.
		   In this example we are using volume and if the volume of the Cargo
		   equals 10 then we are going to attach the flight plan to the Cargo
		   The logic determines the parent entity and that parent entity in passed
		   to the API below
		*/
		let entityParent;
		for (let entity of entities) {
			if(entity['volume'] === 10) {
				entityParent = entity; //Determines the parent Entity to be used.
				break;
			}
		}
		/* This call then passes in the parent entity, the role name FlightPlan as defined
		in the vocabulary and the above payload. If there are no errors, success is returned from the API
		and the association will be attached to the Cargo */
		const success = corticonDataManager.addAssociationsToEntity(entityParent, "FlightPlan", payload);
		logger.logDebug(`*** Data Added`);
	}
	catch ( e ) {
		logger.logError(`*** Error adding entity: ${e}`);
	}  
}	
//Exports
exports.asyncAddFlightPlanEntityFct = asyncAddFlightPlanEntityFct;