Cookbook

 1import com.nm.sdk.data.expeval.AbstractFunction;
 2import com.nm.sdk.data.expeval.Description;
 3import com.nm.sdk.data.expeval.ExecutionContext;
 4import com.nm.sdk.utils.StringUtils;
 5
 6public class AbbreviateFunction extends AbstractFunction {
 7
 8    public AbbreviateFunction() {
 9        descriptions = new Description[]{
10                new Description(0, "return", "Returns the abbreviation of the given text.", new String[]{"Abbreviate('hello world',5)"}, new Class[]{String.class}, "String", false),
11                new Description(1, "text", "The text to be abbreviated", "'hello world'", new Class[]{String.class}, "String", false),
12                new Description(2, "length", "The length of the abbreviated text", "5", new Class[]{Integer.class}, "Integer", false),
13        };
14    }
15
16    @Override
17    public Object calculate(Object[] parameters, ExecutionContext context) {
18        return StringUtils.abbreviate((String) parameters[0], (Integer) parameters[1]);
19    }
20}

1private Function function=new AbbreviateFunction();
2
3// register a function
4Nm.getInstance().getExpressionLanguageService().putFunction(function);
5
6// unregister a function
7Nm.getInstance().getExpressionLanguageService().removeFunction(function.getName());

 1String scriptFunctionCode=
 2   "Function AbbreviateText(String $text, Integer $length) : String Begin"+ 
 3   "   Return com.nm.sdk.utils.StringUtils.abbreviate($text, $length);"+
 4   "End";
 5
 6ScriptFunction sf = (ScriptFunction) Nm.getInstance().getBusinessObjectRepository().get(ScriptFunction.TYPE, "AbbreviateText", HeadFilter.INSTANCE);
 7
 8if (sf == null) {
 9    // create a new function
10    sf = new ScriptFunction();
11    sf.setId("AbbreviateText"); // the ID is used in the script
12    sf.setName("AbbreviateText"); // a cleartext name might be any thing
13    sf.setDefinition(scriptFunctionCode);
14    // add to repository
15    try {
16        // insert
17        sf = (ScriptFunction) Nm.getInstance().getBusinessObjectRepository().insert(sf);
18        List refs = new ArrayList();
19        refs.add(sf.getObjectRef());
20        // commit
21        Nm.getInstance().getBusinessObjectRepository().commit(refs, null);
22    } catch (DuplicateObjectException e) {
23        e.printStackTrace();
24    } catch (IllegalIdException e) {
25        e.printStackTrace();
26    } catch (ObjectNotFoundException e) {
27        e.printStackTrace();
28    }
29} else {
30    // update an existing function
31    sf = (ScriptFunction) sf.deepClone();
32    sf.setDefinition(scriptFunctionCode);
33
34    // update repository
35    try {
36        // update
37        sf = (ScriptFunction) Nm.getInstance().getBusinessObjectRepository().update(sf);
38        List refs = new ArrayList();
39        refs.add(sf.getObjectRef());
40        // commit
41        Nm.getInstance().getBusinessObjectRepository().commit(refs, null);
42    } catch (ObjectNotFoundException e) {
43        e.printStackTrace();
44    }
45}
46
47}

1/**
2Get the display name of a person
3@return the display name of a person
4*/
5Function getDisplayName() : String Begin 
6   Return JOIN($this.firstName, ' ', $this.lastName);
7End

 1/**
 2Create a Person
 3@param $fristName the person first name
 4@param $lastName the person last name
 5@return a person with given first- and lastname
 6*/
 7StaticFunction createPerson(String $firstName, String $lastName) : APerson Begin 
 8   APerson $p := new APerson;
 9   $p.firstName := $firstName;
10   $p.lastName := $lastName;
11   Return $p;
12End