Quick Reference

├── notification-templates
│   └── en.json
├── builtin-reports
│   └── foo-report
│       ├── foo_image.png
│       └── foo_report.jrxml
├── jasper-reports
│   └── bar-report
│       ├── master.jrxml
│       └── report.json
├── model
│   └── MyCustomObject.mez
├── sql-scripts
│   └── myStartupScript.sql
├── services
│   └── UserInvite.mez
├── utilities
│   └── dateStringFormatter.mez
└── web-app
	├── email-templates
    │   └── template1.html
    ├── images
    │   ├── BarMenuIcon.png
    │   └── FooMenuIcon.png
    ├── lang
    │   └── en.lang
    ├── presenters
    │   ├── PresenterFilesCon.mez
    │   └── TainingDslUnits.mez
    └── views
    │   ├── BarView.vxml
    │   └── FooView.vxml
	└── static
		├── dashboard.html
        ├── dashboard.css
		└── dashboard.js

<info label="some.lang_file.label">
   <binding variable="helloWorld" />
</info>

string helloWorld;
void init() { 
  helloWorld = "Hello, World";
}

//this is a comment
 
/* this is a multi-
	line comment */
 
unit UnitName;

MyCustomFoo globalScopedFoo;

void myFunction () {
	globalScopedFoo = MyCustomFoo:new();
}

MyCustomFoo myReturnTypeFunction () {
	MyCustomFoo localScopedFoo = MyCustomFoo:new();
	return localScopedFoo;
}

<?xml version="1.0" encoding="UTF-8"?>
<ui xmlns="http://uiprogram.mezzanine.com/View" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://uiprogram.mezzanine.com/View ../View.xsd">
   <view label="view_heading.for_this_view" unit="LinkedUnit"
         init="onPageLoadFunction" destroy="onPageExitFunction">
   
      <!-- this is a comment -->
   
      <info label="at.least.one.widget">
         <binding variable="variableInLinkedUnit" />
         <binding variable="otherUnit:variableInOtherUnit" />
      </info>
   </view>
</ui>

<view label="view_heading.nurse_management" unit="NurseManagement">

<view label="view_heading.nurse_details" unit="NurseDetails">
	<button label="action.back" action="back" />

unit NurseDetails;
 
//returns member of auto-generated enum DSL_VIEWS
DSL_VIEWS back() {	
    return DSL_VIEWS.NurseManagement; //corresponds to vxml file name
}

object Person 
{
    string fname;
    string sname;
    int age;
}

persistent object Person
{
    string fname;
    string sname;
    int age;
}

int[] integerCollection;
MyCustomObject[] objectCollection;
MyCustomObject fourthObject = objectCollection.get(3);
MyCustomObject objectAtIndex = objectCollection.get(i); 

if(name == "Tom") {
    Mez:log("Hello Tom!");
} else if (name == "Frank") {
    Mez:log("Hello Frank!");
} else {
    Mez:log("Hi! Who are you?");
}

for(int i = 1; i <= 10; i++) {
    Mez:log(i);
}

int i = 0;
for(; i < 10;) {
    Mez:log("While style loop!");
}

SomeObject[] objectCollection = SomeObject:all();
foreach(SomeObject currentObject: objectCollection) {
	currentObject.description = "Foreach style loop!";
}

try {
    Mez:log("inside try statement");
    // throws an exception now ...
} catch (ex){
    Mez:log("inside catch statement");
} finally {
    Mez:log("inside finally statement");
}

void throwStatementExample(){
    Mez:log("Throwing an exception now ...");
    string error = "Oops, something went wrong!";
    throw error;
}

date value = Date:fromString("2017-01-02");
datetime value = Date:fromTimeString("2017-1-20 08:45:12 GMT");

int value = Integer:fromString("12");

decimal value = Decimal:fromString("12.01");

bigint value = 1631104351673l; //note the 'l' at the end of the literal
bigint value = "1631104351673";//no 'l' when converting from string
bigint value = 1234; //implicit converstion from int
bigint value = Date:now();//implicit conversion from datetime

uuid value = Uuid:fromString("c1bd11cb-4bb2-43e5-88b4-009ed40fc69f");

string s = value; //value = any of above types
string s = String:concat("", value);

json jsonPerson = /%
	{
		"name": "John",
		"surname": "Smith",
		"phoneNumber": "555-6162"
	}
%/;

jsonarray pets = /%
	[
		{
			"name": "Jasmine",
			"type": "Dog"
		},
		{
			"name": "Markus",
			"type": "Mole-rat"
		}
	]
%/;

jsonarray primeNumbersJsonArray = /%[2, 3, 5, 7, 11, 13, 17, 19, 23, 29]%/;
int[] primeNumbersPrimitiveArray = primeNumbersJsonArray;

date d = Date:addSeconds(startDate, 10);
date d = Date:addDays(startDate, 10);
date d = Date:addMonths(startDate, 10);
int diff = Date:secondsBetween(dt1, dt2);
int diff = Date:daysBetween(d1, d2);
int diff = Date:monthsBetween(d1, d2);
int yr = Date:extract(dt, "year");
date d = Date:fromString("2017-01-02");
datetime dt = Date:fromUnixTimestamp(1631104351673l);
datetime dt = Date:fromTimeString("2017-1-20 08:45:12 GMT");
datetime dt = Date:now();
date d = Date:today();

string s = String:concat("abc","def");
string[] result = String:split("abc def", " ");
string[] result = String:split("abc|def", "\\|");
int i = String:length("Hello world");
string s = String:substring("Hello World", 1, 4);
string s = String:lower("Hello World");
string s = String:upper("hello world");
bool b = String:startsWith("Hello World", "Hello");
bool b = String:endsWith("Hello World", "World");
bool b = String:regexMatch("27000111222", "^27[0-9]{9,}$");
int i = String:indexOf("Hello World", "ello");
string s = String:join(stringCollection, " ");
string s = String:translate("translation.key");
string s = /%
	This is a
	multi line string
	declaration
%/;
string encodedTest = String:urlEncode("The string ü@foo-bar");
// encodedTest = The+string+%C3%BC%40foo-ba
string s = String:regexReplaceFirst("ab32c56desd111", "[0-9]", "X");
string s = String:regexReplaceAll("ab32c56desd111", "[0-9]", "X");
string s = String:replaceAll("Hello World", "l", "L");

int value = Integer:fromString("12");

decimal value = Decimal:fromString("12.01");

uuid value = Uuid:fromString("c1bd11cb-4bb2-43e5-88b4-009ed40fc69f");

int i = Math:pow(2, 8);
decimal d = Math:sqrt(3);
decimal r = Math:random();

datetime t = Mez:now();
date d = Mez:today();
Mez:log("Hello, World");
Mez:warn("Something could go wrong");
Mez:error("Something went wrong");
Mez:alert("translation.key");
Mez:alertWarn("translation.key");
Mez:alertError("translation.key");
Mez:userRole();
Mez:email(person, "email.descriptionKey", "email.subjectKey", "email.bodyKey");
Mez:email(person.emailAddress, "email.descriptionKey", "email.subjectKey", "email.bodyKey");
Mez:email(person.emailAddress, "email.descriptionKey", "email.subjectKey", "email.bodyKey", EMAIL_TEMPLATES.email_template);
Mez:email(person.emailAddress, "email.descriptionKey", "email.subjectKey", "email.bodyKey", "farmer_purchase_invoice_report/FarmerPurchaseInvoice.jrxml", "additional_farmer_report_1/AdditionalFarmerReport1.jrxml");
Mez:emailAttach(person.emailAddress, "email.descriptionKey", "email.subjectKey", "email.bodyKey", {"farmer_purchase_invoice_report/FarmerPurchaseInvoice.jrxml", getFarmerPurchaseInvoiceFileName()}); 
uuid smsId = Mez:sms(client, "mobileNumber", "exampleKey.smsText");
MezBatch stockUpdateBatch = Mez:createBatch(fileUpload._id, fileUpload.data);
Mez:requestPaymentStatus(paymentId);
Mez:createCryptoKey(name, key);
string result = Mez:encrypt("encrypt this value");
string result = Mez:encrypt("encrypt this value", "mykey");
string result = Mez:decrypt(encryptedValueVar);
string result = Mez:decrypt(encryptedValueVar, "mykey");

Person p = Person:new();
p.save();
Person p = Person:read(getUserUUID());
Person:delete(p);
Person currentPerson = Person:user();
p.invite(p.mobileNumber);
p.invite(p.mobileNumber, p.emailAddress);
person.removeRole();
person.notify("description.key", "sms.content.key",
   "email.subj.key", "email.content.key");
Person[] plist = Person:fromCsv(uploadedFile.blobData);
person.pay(shop, "ZAR", amount);
person.payWithRef(shop, "ZAR", amount, ourPayId, extraPayInfoString);
person.forcePasswordReset();
Person p = Person:fromCsvLine(personBatch.header, personBatchItem.value);

Person[] plist = Person:all();
Person[] plist = Person:equals(deleted, false);
Person[] plist = Person:empty(mobileNum);
Person[] plist = Person:between(dob, date1, date2);
Person[] plist = Person:lessThanOrEqual(age, num);
Person[] plist = Person:lessThan(age, num);
Person[] plist = Person:greaterThan(age, num);
Person[] plist = Person:attributeIn(state, state_list);
Person[] plist = Person:relationshipIn(reportsTo, person);
Person[] plist = Person:contains(name, "a");
Person[] plist = Person:beginsWith(name, "A");
Person[] plist = Person:endsWith(name, "a");
Person[] plist = Person:notEquals(deleted, true);
Person[] plist = Person:notEmpty(mobileNum);
Person[] plist = Person:notBetween(dob, date1, date2);
Person[] plist = Person:notContains(name, "a");
Person[] plist = Person:notBeginWith(name, "A");
Person[] plist = Person:notEndsWith(name, "a");
Person[] plist = Person:notAttributeIn(state, state_list);
Person[] plist = Person:notRelationshipIn(reportsTo, person);
Person[] plist = Person:union(equals(rating, "good"), equals(rating, "excellent"));
Person[] plist = Person:diff(equals(), equals());
Person[] plist = Person:intersect(equals(deleted, false, equals(active, true));
Person[] plist = Person:and(equals(deleted, false), equals(active, true));

Person p = plist.pop();
Person p = plist.drop();
int len = plist.length();
Person firstPerson = plist.first();
Person lastPerson = plist.last();
plist.append(p);
plist.prepend(p);
plist.add(i, p);
Person p = plist.get(i);
plist.remove(i);
plist.sortAsc("dob"); //sort according to date attr. "dob"
plist.sortDesc("dob");
plist.clear();
plist.notify("description.key", "sms.content.key",
   "email.subj.key", "email.content.key");
Person[] plistDoctorsSubset = plist.select(equals(title, "Dr."));

QueryResult[] result = sql:query(selectQuery, param_1, ..., param_n);
int updates = sql:execute(updateQuery, param_1, ..., param_n);

json personJsonObject = "{}";
personJsonObject.jsonPut("name", "John");
string personName = personJsonObject.jsonGet("name");

// Outbound API specific
MezApiRequest request = ...
MezApiResponse response = api:get(request);
MezApiResponse response = api:post(request);
MezApiResponse response = api:delete(request);
MezApiResponse response = api:put(request);

// Inbound API specific
api:setResponseCode(404);

//Assert:isEqual takes two values (objects or primitive types) and evaluates whether they are equal
Assert:isEqual(value1, value2, "value1 and value2 are not equal");
Assert:isEqual(1, 0, "1 and 0 are not equal");
 
//Assert:isNotEqual takes two values (objects or primitive types) and evaluates whether they are not equal
Assert:isNotEqual(value1, value1, "value1 and value1 are equal");
Assert:isNotEqual(1, 1, "1 and 1 are equal");
 
//Assert:isTrue takes one boolean value (variable/primitive/function that returns bool) and evaluates whether it is true
Assert:isTrue(false, "false is not true");
Assert:isTrue(someFunction(), "someFunction() does not return true");
 
//Assert:isFalse takes one boolean value (variable/primitive/function that returns bool) and evaluates whether it is true
Assert:isFalse(true, "true is not false");
Assert:isFalse(someFunction(), "someFunction() does not return false");
 
//Assert:isBoth takes two boolean value (variable/primitive/function that returns bool) and evaluates whether both are true
Assert:isBoth(true, false, "both true and false are not true");
Assert:isBoth(someFunction(), anotherFunction(), "someFunction() and anotherFunction() do not both return true");
 
//Assert:isEither takes two boolean value (variable/primitive/function that returns bool) and evaluates whether one is true
Assert:isEither(false, false, "neither false nor false is true");
Assert:isEither(someFunction(), anotherFunction(), "neither someFunction() nor anotherFunction() returns true");
 
//Assert:isNull takes one value (variable/primitive/function) and evaluates whether it is null or returns null
Assert:isNull(1, "1 is not null");
Assert:isNull(someFunction(), "someFunction() does not return null");
 
//Assert:isNotNull takes one value (variable/primitive/function) and evaluates whether it is not null or returns non-null
Assert:isNotNull(null, "null is null");
Assert:isNotNull(someFunction(), "someFunction() returns null");
 
//Assert:isGreater takes two values and evaluates whether the second is greater than the first
Assert:isGreater(2, 1, "1 is not greater than 2");
Assert:isGreater(value1, value2, "value2 is not greater than value1");
 
//Assert:isGreaterOrEqual takes two values and evaluates whether the second is greater than or equal to the first
Assert:isGreaterOrEqual(2, 1, "1 is not greater than or equal to 2");
Assert:isGreaterOrEqual(value1, value2, "value2 is not greater than or equal to value1");
 
//Assert:isLess takes two values and evaluates whether the second is less than the first
Assert:isLess(1, 2, "2 is not less than 1");
Assert:isLess(value1, value2, "value2 is not less than value1");
 
//Assert:isLessOrEqual takes two values and evaluates whether the second is less than or equal to the first
Assert:isLessOrEqual(1, 2, "2 is not less than or equal to 1");
Assert:isLessOrEqual(value1, value2, "value2 is not less than or equal to value1");

@Role("Manager")
object Manager { ... }

@Restrict("DevManager", equals(dept, "development"))
object Employee { ... }

@RolesAllowed("Manager", "rw")
object EmployeeRecord { ... }

@NotTracked
persistent object Person { ... }

@RoleName
string getGymEmployeeRoleName(GymEmployee employee) { ... }

// Run at 2:15 AM every day
@Scheduled("15 2 * * *")
void foobar() { ... }
 
// Run at 06:00 every week-day  (days 1 to 5)
@Scheduled("0 6 * * 1-5")
void foobar() { ... }

// Run every ten minutes
@Scheduled("*/10 * * * *")
void foobar() { ... }
 
//minute | hour | day-of-month | month | day-of-week

@ReceiveSms("Test description")
void receiveSmsNumberText(string number, string text) { ... }

@ReceiveSms("Test description")
void receiveSmsNumberTextJson(string number, string text, json aggregatorFields) { ... }
 
@ReceiveSms("Test description")
void receiveSmsObjectText(Nurse nurse, string text) { ... }
 
@ReceiveSms("Test description")
void receiveSmsObjectNumberText(Nurse nurse, string number, string text) { ... }

@OnSmsResultUpdate
void smsResultUpdateCallback(__sms_result__ smsResult) { ... }

@OnScheduledFunctionResultUpdate
void scheduledFunctionResultUpdateCallback(
   __scheduled_function_result__ scheduledFunctionResult) { ... }

@OnPaymentUpdate
void paymentUpdate(uuid id, PAYMENT_STATUS status, string message){
   Mez:log(Strings:concat("Updated Payment ", id, status, message);
}

@POST("v1/farmer/profile/documentation")
void postFarmerDocumentation(FarmerDocumentation farmerDocumentation) {...}

@ResponseExclude("middleName")
@ResponseExpand("crops")
@GET("v1/farmer/mobileNumber/{mobileNumber}")
Farmer getFarmer(string mobileNumber) {...}

@PUT("v1/farmer")
void updateFarmer(Farmer farmer) {...}

@DELETE("v1/farmer/mobileNumber/{mobileNumber}")
json deleteFarmer(string mobileNumber, bool purge) {...}

@Test
void someUnitTest() {
    string value1 = "John Doe";
    string value2 = "Jane Smith";
	Assert:isEqual(value1, value2, "value1 and value2 are not equal");
}
 
@Test
string someUnitTestWithReturn() {
    string value1 = "John Doe";
    string value2 = "Jane Smith";
	Assert:isEqual(value1, value2, "value1 and value2 are not equal");
    return value1;
}

@USSD("description1")
MezUssdMenu processUssd(int menu, int selection) {
	...
}

@USSD("description2")
MezUssdMenu processUssd(int menu, int selection, json gatewayArgs) {
	...
}

persistent object Person
{
    @FirstnameValidator("validr.msg.fname")
    string fname;
...

persistent object Person
{
    string name;

	@OneToOne
	IdentityDocument idDoc via person; 
 
    @OneToMany
    Vehicle vehicles via owner;
 
    @ManyToOne
    House home via residents;
 
	@ManyToMany
	Person children via parents;
}

validator PersonNameValidator {
    notnull(); minlen(2); maxlen(50);
}

validator BondRepaymentMonths {
	notnull(); minval(0); maxval(72);
}

validator CTMetroPhoneNumber {
    notnull(); regex("021-[7..9]{7}");
}

<button label="button.exec" action="exec" />

<action label="action.exec" action="exec" />

<textfield label="my.textfield.label" datatype="text">
    <binding variable="MyUnit:string_value" />
</textfield>

<textarea label="my.textfield.label">
    <binding variable="MyUnit:string_value" />
</textarea>

<datefield label="my.datefield.label">
    <binding variable="MyUnit:date_value"/>
</datefield>

<invite label="my.invite.label">
   <binding variable="MyUnit:user_object"/>
   <role>MyUserRole</role>
</invite>

<fileupload label="my.fileupload.label">
    <binding variable="MyUnit:object">
        <attribute name="attributeName" />
    </binding>
</fileupload>

<filebrowser label="my.filebrowser.label">
    <collectionSource function="MyUnit:values" />
</filebrowser>

<map lat="item_lat" long="item_long">
   <collectionSource variable="MyUnit:map_data">
   <markerAction label="Mmy.map.action.open" action="MyUnit:open_item"/> 
   <markerTitle value="MyUnit:get_title"/>
   <markerIcon value="MyUnit:get_icon"/>
   <markerDesc value="MyUnit:get_desc"/>
</map>

<code title="code_title.code_snippet">
    <binding variable="QuestionManagement:question">
        <attribute name="codeSnippet"/>
    </binding>
</code>

<gallery title="my.gallery.heading" imageAttribute="image" descriptionAttribute="description">
	<collectionSource function="getObjectsWithImageBlobs"/>
	<binding variable="selectedObject"/>
</gallery>

<submit label="submit.exec" action="exec" />

<info label="info.shop_owner_firstname">
    <binding variable="shop">
        <attribute name="owner.firstName"/>
    </binding>
</info>
 
<info label="info.welcome" value="info.system_admin_welcome"/>

<checkbox label="my.checkbox.label">
   <binding variable="MyUnit:bool_value" />
</checkbox>

<select label="my.select.label">
    <binding variable="MyUnit:selected_value" />
    <enum>SDS_SADSA</enum>
</select>
<select label="my.select.label">
    <binding variable="MyUnit:selected_value" />
    <collectionSource variable="MyUnit:values"/>
</select>

<table title="my.table.title" defaultSortColumn="1" defaultSortDirection="descending" csvExport="disabled">
    <collectionSource variable="MyUnit:plist"/>
    <column heading="Firstname">
        <attributeName>fname</attributeName>
    </column>
    <column heading="Surname">
        <attributeName>sname</attributeName>
    </column>
</table>

<menuitem icon="icon_name" label="my.menu.item">
   <userRole>MyUserRole</userRole>
</menuitem> 

<navigation outcome="success" target ="myview_name"/>

<wall label="my.wall.label" defaultSort="timeStamp" commentHandler="MyUnit:commentFunction" buttonLabel="my.custom.label.for.comment.button">
    <collectionSource function="MyUnit:collection" />
    <itemTitle value="MyUnit:getTitle"/>
    <itemText value="MyUnit:getText"/>
    <itemOwner value="MyUnit:getOwner"/>
    <itemTime value="MyUnit:getTime"/>
    <itemIcon value="MyUnit:getIcon"/>
</wall>

<table title="translation.key">
   ...
</table>

<submit label="translation.key">

 translation.key = {UnitFoo:globalVar}

Unit UnitFoo;
 
string globalVar;
 
init() {
   globalVar = getLabel();
   ...
}

<table title="table.label">
	<visible variable="isTableVisible"/>
	<collectionSource variable="items"/>
	<column heading="col.name.label">
		<attributeName>name</attributeName>
	</column>
	<column heading="col.desc.label">
		<attributeName>description</attributeName>
		<visible variable="isDescVisible"/>
	</column>
</table>

<checkbox label="have.at.least.one.visible.widget">
	<visible variable="isCheckboxVisible"/>
	<binding variable="checkboxVar"/>
</checkbox>

bool checkboxVar;
void init() {
	checkboxVar = getCheckboxVar() {
	...
}