Permissions

It is possible to determine whether the current user has got a permission:

• from a component

ACLHelper.isGranted(component, "CREATE", function (granted) {
    console.info("granted: " + granted);
});

• from an ACL identifier

ACLHelper.isGranted(component.getACL(), "CREATE", function (granted) {
    console.info("granted: " + granted);
});

Identifier extraction

To extract identifiers from an array of components, you can use the following function:

Ids.from(components);

Tag Propagation

To propagate common tag values from one or more components to a target component, the following functions are available:

Functions	Description
predict(sourceComponent, targetComponent)	Propagate common tags from a component to a target component
predict(sourceComponents, targetComponent)	Propagate common tags from a set of components to a target component

Example: Creating a task from two documents

ContextualMenuAPI.get().registerForLoad(function(api){
	if(api.getSelected().length != 2 || api.getCategory() != "DOCUMENT"){
		return;

	var icon = new Icon();
	icon.setContent("fa fa-user flat-mauve");
	api.add("createTask", icon.asElement() , "Task", function(){
		var newTask = new Task();
		newTask.setClassId("GEC_Step0_Creation");
		TagOracle.predict(api.getSelected(), newTask);
		newTask.addAttachments("Courrier", Ids.from(api.getSelected()), "DOCUMENT");
		var popup = JSAPI.get().getPopupAPI().buildComponentCreation(newTask);
		popup.show();
	});
});

Version comparison

The compareVersion('x.y.z') function compares the input version with the deployed version:

Results	Description
-1	The deployed version is older than the supplied version *
0	The deployed version is identical to the supplied version *
1	The deployed version is newer than the supplied version *

*comparison does not take the patch number into account