ForceNG is a micro-library that makes it easy to use the Salesforce REST APIs in AngularJS applications. ForceNG allows you to easily login into Salesforce using OAuth, and to access your Salesforce data using a simple API.

ForceNG is similar to ForceTK, but has no jQuery dependency, is implemented as an AngularJS service, and is using promises instead of callback functions.

The main target for ForceNG are applications running on your own server (Heroku or elsewhere), or locally on a mobile device and accessing Salesforce through REST services. If your application is hosted inside Salesforce (in a Visualforce page), consider using Visualforce Remoting or Remote Objects to access your Salesforce data.

This is an early version. I appreciate any feedback, comments, and help if you think this library is useful.

• No jQuery dependency
• Implemented as an AngularJS services and using promises
• Plain JavaScript (ForceJS) and Angular Service versions
• Complete OAuth login workflow
• Works transparently in the browser and in Cordova using the In-App browser plugin or the Salesforce Mobile SDK plugin for OAuth (coming soon)
• Automatically refreshes OAuth access_token on expiration
• Simple API to manipulate data (create, update, delete, upsert)
• Node.js or Play/Scala proxies with CORS support available separately
• Includes simple Bootstrap sample app

1. Initialize (Optional):

   ForceJS is built to work out of the box with sensible defaults. You only need to invoke force.init() if you want to override these defaults:

   force.init({
       appId: '3MVG9fMtCkV6eLheIEZplMqWfnGlf3Y.BcWdOf1qytXo9zxgbsrUbS.ExHTgUPJeb3jZeT8NYhc.hMyznKU92',
       apiVersion: 'v32.0',
       loginUrl: 'https://login.salesforce.com',
       oauthRedirectURL: 'http://localhost:8200/oauthcallback.html',
       proxyURL: 'http://localhost:8200'
   });
   

2. Login:

   force.login().then(
       function () {
           console.log('Login succeeded');
       },
       function () {
           alert('Login failed');
       });
   

3. Invoke a function: query(), create(), update(), delete(), upsert(), or the generic request():

   force.query('select id, firstName, lastName from contact').then(
       function (contacts) {
           $scope.contacts = contacts.records;
       },
       function() {
           alert("An error has occurred");
       });
   

Because of the browser's cross-origin restrictions, your JavaScript application hosted on your own server (or localhost) will not be able to make API calls directly to the *.salesforce.com domain. The solution is to proxy your API calls through your own server. You can use your own proxy server, but to provide an integrated development experience, ForceJS works smoothly with ForceServer, a simple development server for Force.com. It provides two main features:

• A Proxy Server to avoid cross-domain policy issues when invoking Salesforce REST services. (The Chatter API supports CORS, but other APIs don’t yet)
• A Local Web Server to (1) serve the OAuth callback URL defined in your Connected App, and (2) serve the whole app during development and avoid cross-domain policy issues when loading files (for example, templates) from the local file system.

Visit the force-server repository for more information.

You can use ForceNG with your own proxy server as well.

Navigate to the directory where you created index.html, and type:

force-server

This command will start the server on port 8200, and automatically load your app (http://localhost:8200) in a browser window. You'll see the Salesforce login window, and the list of contacts will appear after you log in.

You can change the port number and the web root. Type the following command for more info:

force-server --help

If you develop a hybrid application using the Mobile SDK, you often switch back and forth between running the app in the browser and on device: Developing in the browser is generally faster and easier to debug, but you still need to test device-specific features and check that everything runs as expected on the target platforms. The problem is that the configuration of OAuth and REST is different when running in the browser and on-device. Here is a summary of the key differences:

ForceJS abstracts these differences and allows you to run your app in the browser and on device without code or configuration change.

A plain JavaScript version (ForceJS) is available here.

• ForceTK: Proven toolkit for Salesforce REST APIs. Leverages jQuery
• NForce: node.js a REST API wrapper for force.com, database.com, and salesforce.com.
• ngForce: Streamlined Visualforce Remoting integration in your AngularJS apps running in a Visualforce page
• JSForce: Integrate your JavaScript application with Salesforce in different scenarios