This example demonstrates how to get application about info.

// Request About info object
MobileCRM.AboutInfo.requestObject(
	function (aboutInfo) {
		/// <param name="aboutInfo" type="MobileCRM.AboutInfo"/>
		var appReport = "About Info : \n";
		for (var prop in aboutInfo)
			appReport += prop + ": " + aboutInfo[prop] + "\n";
 
		MobileCRM.bridge.alert(appReport);
	},
	MobileCRM.bridge.alert  // alerts an error
);

This example demonstrates how to create a folder in the application storage.

MobileCRM.Application.createDirectory("TestData/MyFolder", function () {
	MobileCRM.bridge.alert("Folder was created");
}, function () {
	MobileCRM.bridge.alert("Folder wasn't created");
});

This example demonstrates how to delete an application storage folder.

MobileCRM.Application.deleteDirectory("TestData/MyFolder", function (res) {
	MobileCRM.bridge.alert("Folder was deleted");
}, function () {
	MobileCRM.bridge.alert("Folder wasn't deleted");
});

This example demonstrates how to delete an application storage file.

MobileCRM.Application.deleteFile("TestData/MyFile.txt", function (res) {
	MobileCRM.bridge.alert("File was deleted");
}, function () {
	MobileCRM.bridge.alert("File wasn't deleted");
});

MobileCRM.Application.directoryExists("TestData/MyFolder", function (exists) {
	MobileCRM.bridge.alert(exists ? "Exists" : "Doesn't exist");
}, MobileCRM.bridge.alert)

MobileCRM.Application.fileExists("TestData/MyFile.txt", function (exists) {
	MobileCRM.bridge.alert(exists ? "Exists" : "Doesn't exist");
}, MobileCRM.bridge.alert)

This example demonstrates how to change the DOM element color to specific color from application theme defined in Woodford.

MobileCRM.Application.getAppColor("ListForeground", function (color) {
	/// <param name="color" type="String">String containing the color definition (e.g. "#FF0000" for red color).</param>
	if (color) {
		MobileCRM.bridge.alert("ListForeground color = " + color);
		var element = document.getElementById("mainTable");
		if (element)
			element.style.color = color;
	}
});

This example demonstrates how to load the image from application storage if exists and show it in <img> element.

var imagePath = "Images/MobileCrm/Images.MonoTouch/Logo/Logo@2x.png";
MobileCRM.Application.fileExists(imagePath, function (exists) {
	if (exists) {
		MobileCRM.Application.readFileAsBase64(imagePath, function (data) {
			var imgElement = document.getElementById("test-image");
			if (imgElement)
				imgElement.src = "data:image/jpeg;base64," + data;
		}, MobileCRM.bridge.alert);
	}
	else
		MobileCRM.bridge.alert("File '"+ imagePath +"' doesnt'exist");
});

This example demonstrates how to initiate the application synchronization.

// Following line initiates immediate foreground synchronization.
// If required "Sync login" is active, it causes all forms being closed and "Sync Login" form is being shown.
MobileCRM.Application.synchronize(false);
 
// Following line initiates the background synchronization, if the last synchronization was performed before given Date.
// It requires "Save password" being active and "Sync login" inactive
MobileCRM.Application.synchronize(true, new Date("Dec 25, 2017"));

This example demonstrates how to store the image data into application storage root and show it in <img> element using relative URL.

function saveAndShowImage(base64ImageData) {
	/// <param name="base64ImageData" type="String">String containing base64-encoded image data.</param>
	MobileCRM.Application.writeFileFromBase64("ExternalImage.jpg", base64ImageData, function () {
		var imgElement = document.getElementById("test-image");
		imgElement.src = "../ExternalImage.jpg"; // Offline HTML is opened from the WWW folder and image was stored into the root folder
	}, MobileCRM.bridge.alert);
}

This example demonstrates how to close current form from Javascript.

MobileCRM.bridge.closeForm();

This example demonstrates how to switch the Android WebView into debugging mode which enables remote connection from Google Chrome device inspector.

MobileCRM.bridge.enableDebug();

This example demonstrates how to enable zooming on Android iFrame. Method "enableZoom" has dummy implementation on other platforms.

MobileCRM.bridge.enableZoom(true);

This example demonstrates how to get the window "width" and "height".

MobileCRM.bridge.getWindowSize(
	function (obj) {
		MobileCRM.bridge.alert("window size : " + obj.width + " x " + obj.height);
	},
	MobileCRM.bridge.alert
);

This example demonstrates how to append a text to the JSBridge log which is included in About/SendLog reporting.

/// This method can be used to add specific information into the JSBridge log.
MobileCRM.bridge.log("This will be added to end of JSBridge log.");

This example demonstrates how to register custom global event. Other iFrame can raise the event and provide the parameters. See raiseGlobalEvent for example of raising such an event.

MobileCRM.bridge.onGlobalEvent("MyCustomEvent", function (args) {
	MobileCRM.bridge.alert("Retreived arguments from raised event 'MyCustomEvent' " + JSON.stringify(args));
}, true);

This example demonstrates how to use global event listener to handle the EntityFormClosed event for refreshing the product list on Order form after editing one of its product details.

MobileCRM.bridge.onGlobalEvent("EntityFormClosed", function (closedEntityForm) {
	/// <param name='closedEntityForm' type='MobileCRM.UI.EntityForm'>An EntityForm object representing the form that was closed.</param>
	if (closedEntityForm.entity.entityName == "salesorderdetail")
		onProductChanged(closedEntityForm.entity.id);
}, true);

This example demonstrates how to raise a custom global event. Other iFrame can register the callback which will be then called with specified parameters. See onGlobalEvent for example of registering such an event.

MobileCRM.bridge.raiseGlobalEvent("MyCustomEvent", {
	testTitle: "My Title",
	testData: { aaa: 1, bbb: 2 },
	testDirectVal: 666
});

This example demonstrates how to obtain and modify MobileCRM.Configuration object. It checks if user is working in Online mode and calls a function with user's credentials obtained from MobileCRM._Settings object.

MobileCRM.Configuration.requestObject(
	function (config) {
		/// <param name="config" type="MobileCRM.Configuration">/<param>
		if (config.isOnline) {
			var settings = config.settings;
			queryXYStatistics(settings.userName, settings.password, settings.domain);
		}
		// we have done no changes, thus return false to disallow sending the changes back to C#.
		return false;
	},
	function (err) {
		/// <param name="err" type="String">/<param>
		MobileCRM.bridge.alert("An error occurred: " + err);
	},
	null
);
function queryXYStatistics(userName, password, domain) {
	// Use CRM credentials let's say for an AJAX call to a WebService...
}

This example demonstrates how to format current date to a string having pre-defined or custom format.

MobileCRM.CultureInfo.initialize(function (currentCulture) {
	///<param name='currentCulture' type='MobileCRM.CultureInfo' />
	var formatDate = new Date();
 
	var monthDayPattern = "MM-MMMM, ddd-dddd";
	var customDate = MobileCRM.CultureInfo.formatDate(formatDate, monthDayPattern);
 
	var fullDateTime = MobileCRM.CultureInfo.fullDateTimeString(formatDate);
	var longDate = MobileCRM.CultureInfo.longDateString(formatDate);
	var longTime = MobileCRM.CultureInfo.longTimeString(formatDate);
	var shortDate = MobileCRM.CultureInfo.shortDateString(formatDate);
	var shortTime = MobileCRM.CultureInfo.shortTimeString(formatDate);
	var mothDay = MobileCRM.CultureInfo.monthDayString(formatDate);
	var yearMonth = MobileCRM.CultureInfo.yearMonthString(formatDate);
 
	var result =
		monthDayPattern + ": " + customDate + "\n" +
		"full date time : " + fullDateTime + "\n" +
		"long date : " + longDate + "\n" +
		"short date : " + shortDate + "\n" +
		"long time : " + longTime + "\n" +
		"short time : " + shortTime + "\n" +
		"day of month : " + mothDay + "\n" +
		"year of month : " + yearMonth + "\n";
 
	MobileCRM.bridge.alert(result);
}, MobileCRM.bridge.alert, null);

This example demonstrates how to initialize CultureInfo object providing information about current culture.

MobileCRM.CultureInfo.initialize(function (currentCulture) {
	///<param name='currentCulture' type='MobileCRM.CultureInfo' />
	var cultureInfo =
		"Display name: " + currentCulture.displayName + "\n" +
		"ISO name: " + currentCulture.ISOName + "\n" +
		"Native name: " + currentCulture.nativeName + "\n\n" +
		"Number format: " + JSON.stringify(currentCulture.numberFormat) + "\n\n" +
		"DateTime format: " + JSON.stringify(currentCulture.dateTimeFormat) + "\n" +
		"Right to left: " + currentCulture.isRightToLeft + "\n";
 
	// for further details about date, time and number format,
	// see MobileCRM.DateTimeFormat and MobileCRM.NumberFormat
 
	MobileCRM.bridge.alert(cultureInfo);
}, MobileCRM.bridge.alert, null);

This example demonstrates how to get specific culture information.

MobileCRM.CultureInfo.load("en-GB", function (info) {
	///<param name='info' type='MobileCRM.CultureInfo' />
	var cultureInfo =
		"Display name: " + info.displayName + "\n" +
		"ISO name: " + info.ISOName + "\n" +
		"Native name: " + info.nativeName + "\n\n" +
		"Number format: " + JSON.stringify(info.numberFormat) + "\n\n" +
		"DateTime format: " + JSON.stringify(info.dateTimeFormat) + "\n" +
		"Right to left: " + info.isRightToLeft + "\n";
 
	// for further details about date, time and number format,
	// see MobileCRM.DateTimeFormat and MobileCRM.NumberFormat
 
	MobileCRM.bridge.alert(cultureInfo);
}, MobileCRM.bridge.alert, null);

This example demonstrates how to create a new account.

var account = MobileCRM.DynamicEntity.createNew("account");
var props = account.properties;
props.name = "A Bike Store";
props.address1_line1 = "Unknown";
// ...
account.save(
	function (error) {
		if (error)
			MobileCRM.bridge.alert("An error occurred: " + error);
		else {
			// callback is called in scope of newly created MobileCRM.DynamicEntity object; thus we can access the data using "this" keyword
			var newId = this.id;
			var allProps = this.properties;
			rememberNewAccount(newId, allProps.name);
		}
	}
);

This example demonstrates how to modify an existing account. It updates the GPS coordinates for given account.

function updateGPS(accountid, latitude, longitude) {
	var account = new MobileCRM.DynamicEntity("account", accountid);
	var props = account.properties;
	props.address1_latitude = latitude;
	props.address1_longitude = longitude;
	account.save(
		function (error) {
			if (error)
				MobileCRM.bridge.alert("An error occurred: " + error);
			else {
				// callback is called in scope of newly created MobileCRM.DynamicEntity object; thus we can access the data using "this" keyword
				logModification(this.id, this.primaryName);
			}
		}
	);
}

This example demonstrates how to modify an existing account. It updates the GPS coordinates for given account.

function updateGPS(accountid, latitude, longitude) {
	// Instead of loading whole entity object, we'll create the DynamicEntity object
	// for Account entity with existing ID and provide just changed fields.
	var account = new MobileCRM.DynamicEntity("account", accountid);
	var props = account.properties;
	props.address1_latitude = latitude;
	props.address1_longitude = longitude;
	account.saveAsync()
		.then(function (savedEntity) {
			// Promise was fulfilled and we obtained full MobileCRM.DynamicEntity object with all its fields (including primary name)
			logModification(savedEntity.id, savedEntity.primaryName);
		})
		.catch(function (error) {
			// Promise was rejected with error
			MobileCRM.bridge.alert("An error occurred: " + error);
		});
}

This example demonstrates how to delete an account with given id.

// WARNING: async/await pattern requires ECMAScript 6 and it's not supported on Internet Explorer.
// It's supported by all modern browsers including mobile version of Chrome and Safari (requires Android 5+ and iOS 10+).
async function deleteAccount(accountId) {
	try {
		await MobileCRM.DynamicEntity.deleteAsync("account", accountid);
		onAccountDeleted(accountid);
	}
	catch (error) {
		MobileCRM.bridge.alert("An error occurred: " + error);
	}
}

This example demonstrates how to delete an account with given id.

MobileCRM.DynamicEntity.deleteById(
	"account",
	accountid,
	function () {
		onAccountDeleted(accountid);
	},
	function (error) {
		MobileCRM.bridge.alert("An error occurred: " + error);
	}
);

This example demonstrate how to download the note attachment image and set it into <img> element.

function downloadNoteAttachment(noteId) {
	MobileCRM.DynamicEntity.downloadAttachment("annotation", noteId, function (base64str) {
		/// <param name='base64str' type='String'>parameter contains a string with base64-encoded attachment data.</param>
		var imgElement = document.getElementById("img-result");
		if (imgElement)
			imgElement.setAttribute("src", "data:;base64," + base64str); // set the "src" attribute for out <img> element
	}, MobileCRM.bridge.alert, null);
}

This example demonstrate how to download the note attachment image and set it into <img> element.

// WARNING: async/await pattern requires ECMAScript 6 and it's not supported on Internet Explorer.
// It's supported by all modern browsers including mobile version of Chrome and Safari (requires Android 5+ and iOS 10+).
async function downloadNoteAttachment(noteId) {
	try {
		var base64str = await MobileCRM.DynamicEntity.downloadAttachmentAsync("annotation", noteId);
		var imgElement = document.getElementById("img-result");
		if (imgElement)
			imgElement.setAttribute("src", "data:;base64," + base64str); // set the "src" attribute for out <img> element
	}
	catch (error) {
		MobileCRM.bridge.alert("An error occurred: " + error);
	}
}

This example demonstrates how to load the account entity with given id.

// WARNING: async/await pattern requires ECMAScript 6 and it's not supported on Internet Explorer.
// It's supported by all modern browsers including mobile version of Chrome and Safari (requires Android 5+ and iOS 10+).
async function getAccountData(accountId) {
	try {
		var entity = await MobileCRM.DynamicEntity.loadAsync("account", accountId);
		MobileCRM.bridge.alert(JSON.stringify(entity));
	}
	catch (err) {
		MobileCRM.bridge.alert(err);
	}
}

This example demonstrates how to load the account entity with given id.

function getAccountData(accountId) {
	/// <param name="account" type="MobileCRM.Reference"/>;
	MobileCRM.DynamicEntity.loadById(
		"account",
		accountId,
		function (entity) {
			/// <param name="entity" type="MobileCRM.DynamicEntity"/>;
			// "entity" argument contains the MobileCRM.DynamicEntity object
			MobileCRM.bridge.alert(JSON.stringify(entity.properties));
		},
		function (error) {
			MobileCRM.bridge.alert("An error occurred: " + error);
		},
		null
	);
}

This example demonstrates how to load the document body (e.g. attached image) for given annotation (Note). Following function loads locally stored attachment for note defined by its id and sets the base-64 data as image source.

function loadAccountDocumentBody(accountid){
	MobileCRM.DynamicEntity.loadDocumentBody("annotation", accountidid, function (base64str) {
		/// <param name='base64str' type='String'>parameter contains a string with base64-encoded attachment data.</param>
		MobileCRM.bridge.alert("Base64String: \n\n" + base64str);
		var imgElement = document.getElementById("img-result");
		if (imgElement)
			imgElement.setAttribute("src", "data:image/jpeg;base64," + base64str); // set the "src" attribute for out <img> element
	}, MobileCRM.bridge.alert, null);
}

This example demonstrates how to load the document body (e.g. attached image) for given annotation (Note). Following function loads locally stored attachment for note defined by its id and sets the base-64 data as image source.

// WARNING: async/await pattern requires ECMAScript 6 and it's not supported on Internet Explorer.
// It's supported by all modern browsers including mobile version of Chrome and Safari (requires Android 5+ and iOS 10+).
async function loadAccountDocumentBody(accountid){
	try{
		var base64str = await MobileCRM.DynamicEntity.loadDocumentBody("annotation", accountidid);
		MobileCRM.bridge.alert("Base64String: \n\n" + base64str);
		var imgElement = document.getElementById("img-result");
		if (imgElement)
			imgElement.setAttribute("src", "data:image/jpeg;base64," + base64str); // set the "src" attribute for out <img> element
	}
	catch (error) {
		MobileCRM.bridge.alert("An error occurred: " + error);
	}
}

This example demonstrates how to save the document body (e.g. attached image) for newly created annotation (Note). Following function locally stores the attachment (defined by file path) for newly created note.

function saveAnnotation(filePath, accountReference) {
	///<param name='filePath' type='String'>path to file for annotation attachment.</param>
	///<param name='accountReference' type='MobileCRM.Reference'>Reference to account.</param>
	var relationship = new MobileCRM.Relationship("objectid", accountReference);
	MobileCRM.DynamicEntity.saveDocumentBody(null, null, relationship, filePath, null, function (annotation) {
		///<param name='annotation' type='MobileCRM.Reference'>Reference to nelwy created annotation.</param>
		MobileCRM.bridge.alert(annotation.entityName + " '" + annotation.primaryName + "' successfully saved.");
	}, MobileCRM.bridge.alert, null);
}

This example demonstrates how to save the document body (e.g. attached image) for newly created annotation (Note). Following function locally stores the attachment (defined by file path) for newly created note.

// WARNING: async/await pattern requires ECMAScript 6 and it's not supported on Internet Explorer.
// It's supported by all modern browsers including mobile version of Chrome and Safari (requires Android 5+ and iOS 10+).
async function saveAnnotation(filePath, accountReference) {
	///<param name='filePath' type='String'>path to file for annotation attachment.</param>
	///<param name='accountReference' type='MobileCRM.Reference'>Reference to account.</param>
	try{
		var relationship = new MobileCRM.Relationship("objectid", accountReference);
		var annotation = await MobileCRM.DynamicEntity.saveDocumentBody(null, null, relationship, filePath, null);
		MobileCRM.bridge.alert(annotation.entityName + " '" + annotation.primaryName + "' successfully saved.");
	}
	catch (error) {
		MobileCRM.bridge.alert("An error occurred: " + error);
	}
}

This example demonstrates how to get the localized text.

MobileCRM.Localization.initialize(startPointFn, MobileCRM.bridge.alert);
 
function startPointFn(localization) {
	// returns the localized text for localization ID "Cmd.Action".
	var actionText = MobileCRM.Localization.get("Cmd.Action");
	MobileCRM.bridge.alert(actionText);
}

This example demonstrates how to get the localized label for certain view for Account entity.

MobileCRM.Localization.initialize(startPointFn, MobileCRM.bridge.alert);
 
function startPointFn(localization) {
	var viewLabel = MobileCRM.Localization.getComponentLabel("account", "View", "Custom View");
	MobileCRM.bridge.alert(viewLabel);
}

This Example demonstrate how to get current localization loaded language.

MobileCRM.Localization.getLoadedLangId(startPointFn, MobileCRM.bridge.alert, null);
 
function startPointFn(loadedLangId) {
	// returns the localized loaded language id ("EN" for English);
	var langId = loadedLangId;
	MobileCRM.bridge.alert(loadedLangId);
}

This example demonstrates how to get the localized plural for the name of Account entity.

MobileCRM.Localization.initialize(startPointFn, MobileCRM.bridge.alert);
 
function startPointFn(localization) {
	// returns the localized plural for entity "account" ("Accounts" for English).
	var accountsLabel = MobileCRM.Localization.getPlural("account");
	MobileCRM.bridge.alert(accountsLabel);
}

[Obsolete]This example demonstrates how to create or remove N-N relationship between contact and account entities.

var competitor = new MobileCRM.Reference("competitor", competitorid);
var product = new MobileCRM.Reference("product", productid);
MobileCRM.ManyToManyReference.addRecord("competitorproduct", competitor, product,
	function () { onCreated(); },
	function (err) { showError(err); }
);

This example demonstrates how to create a new N-N relationship between competitor and product entities.

var competitor = new MobileCRM.Reference("competitor", competitorid);
var product = new MobileCRM.Reference("product", productid);
MobileCRM.ManyToManyReference.create("competitorproduct", competitor, product,
	function () { onCreated(); },
	function (err) { showError(err); }
);

This example demonstrates how to remove an existing N-N relationship between competitor and product entities.

var competitor = new MobileCRM.Reference("competitor", competitorid);
var product = new MobileCRM.Reference("product", productid);
MobileCRM.ManyToManyReference.remove("competitorproduct", competitor, product,
	function () { onRemoved(); },
	function (err) { showError(err); }
);

This example demonstrates how to get the MobileCRM.MetaEntity object.

MobileCRM.Metadata.requestObject(
	function (metaData) {
		// Request MetaEntity object by its name.
		MobileCRM.MetaEntity.loadByName(
			"account",
			function (metaEntity) {
				/// <param name="metaEntity" type="MobileCRM.MetaEntity"/>;
				var metaProperties = "MetaEntity properties \n";
				metaProperties += "can account append to contact : " + metaEntity.canAppendTo("contact") + "\n";
				metaProperties += "account C-R-W-D : " + metaEntity.canCreate(); + "-" + metaEntity.canRead(); +
				"-" + metaEntity.canWrite(); + "-" + metaEntity.canDelete();
				MobileCRM.bridge.alert(metaProperties);
			}, MobileCRM.bridge.alert,
			null
		);
	},
	MobileCRM.bridge.alert
);

This example demonstrates how to get list of values for the OptionSet field opportunity.statuscode (normally, "In Progress = 1, On Hold = 2, Won = 3, Canceled = 4, Out-Sold = 5").

MobileCRM.Metadata.getOptionSetValues(
	"opportunity",
	"statuscode",
	function (optionSetValues) {
		/// <param name="optionSetValues" type="Object"></param>
		var values = "";
		for (var name in optionSetValues) {
			var val = optionSetValues[name];
			values += name + " = " + val + "\n";
		}
		MobileCRM.bridge.alert("Opportunity option set values: \n\n" + values);
	}, 
	MobileCRM.bridge.alert, 
	null
);