Apex and AJAX

The AJAX toolkit includes built-in support for invoking Apex through anonymous blocks or public webService methods.

To do so, include the following lines in your AJAX code:

<script src=”/soap/ajax/15.0/connection.js” type=”text/javascript”></script>
<script src=”/soap/ajax/15.0/apex.js” type=”text/javascript”></script>

To invoke Apex, use one of the following two methods:

• Execute anonymously via sforce.apex.executeAnonymous (script). This method returns a result similar to the
API’s result type, but as a JavaScript structure.
• Use a class WSDL.

For example, you can call the following Apex class:

global class myClass
    webService static Id makeContact(String lastName, Account a)
        Contact c = new Contact(LastName = lastName, AccountId = a.Id);
        return c.id;

By using the following JavaScript code:

var account = sforce.sObject(“Account”);
var id = sforce.apex.execute(“myClass”,”makeContact”,

The execute method takes primitive data types, sObjects, and lists of primitives or sObjects.

To call a webService method with no parameters, use {} as the third parameter for sforce.apex.execute.

For example, to call the following Apex class:

global class myClass
    webService static String getContextUserName()
        return UserInfo.getFirstName();

Use the following JavaScript code:

var contextUser = sforce.apex.execute(“myClass”, “getContextUserName”, {});

If a namespace has been defined for your organization, you must include it in the JavaScript code when
you invoke the class. For example, to call the above class, the JavaScript code from above would be rewritten as follows:

var contextUser = sforce.apex.execute(“myNamespace.myClass”, “getContextUserName”,

To verify whether your organization has a namespace, log in to your Salesforce organization and navigate to Your Name > Setup > Create > Packages. If a namespace is defined, it is listed under Developer Settings.
Both examples result in native JavaScript values that represent the return type of the methods.

Use the following line to display a popup window with debugging information:


Leave a Reply