runApex() for Salesforce Classic

Usage

Executes an Apex method from an Apex class that’s exposed in Salesforce.

Syntax

sforce.interaction.runApex(apexClass:string, methodName:string, methodParams:string, (optional) callback:function)

Arguments

Sample Code–JavaScript

1. An administrator creates an Apex class and Apex method:

   <!-- javascript set_clipboard -->

   global class AccountRetrieval{
   
   webService static String getAccount(String name) {
      List<Account> accounts = new List<Account>();
      for (Account account : Database.query('Select Id, Name, phone from Account where Name like \'' + name + '%\'')){
          accounts.add(account);
      }
          String JSONString = JSON.serialize(accounts);
          return JSONString;
      }
     }
   
   

2. In the location where you’ve created the Apex class and method in Salesforce, click Generate WSDL to expose the method and class so that a third-party softphone can call it.

3. Add your code to the softphone:

   <!-- javascript set_clipboard -->

   <html>
   <head>
      <script type="text/javascript" src="http://domain:port/support/api/25.0/interaction.js"></script>
      <script type="text/javascript">
          var callback = function (response) {
              if (response.result) {
                     alert(response.result);
               } else {
                      alert(response.error);
              }
           };
          function runApex() {
                   //Invokes API method
                   sforce.interaction.runApex('AccountRetrieval', 'getAccount', 'name=acme', callback);
           }
   </script>
   </head>
   <body>
          <button onclick="runApex();">runApex</button>
   </body>
   </html>
   

4. Output is returned. In this example, one account named, Acme, was found:

   [{"attributes":{"type":"Account",
   "url":"/services/data/v25.0/sobjects/Account/001x0000003DGQRAA4"},
   "Id":"001x0000003DGQRAA4","Name":"Acme","Phone":"(212) 555-5555"}]
   

Response