Cylon.js For Force.com
Cylon.js (http://cylonjs.com) is a JavaScript framework for robotics and physical computing using Node.js
This module provides an adaptor and driver for Force.com (http://force.com/). It uses the official JSforce module (https://github.com/jsforce/jsforce).
How to Install
$ npm install cylon cylon-force
How to Use
var Cylon = ; Cylon; Cylonstart;
To run the above example:
SF_USERNAME='yourusername' SF_SECURITY_TOKEN='yourpasswordandtoken' node examples/salesforce.js
How to Connect
To setup Salesforce connection, authentication, app/object creation and streaming follo the instructions in: https://github.com/hybridgroup/cylon-force/blob/master/salesforce-setup.md
Connecting to Salesforce using cylon-force
If you are using a Salesforce developer account(or personal account), you only need to provide sfuser
(username)
and sfpass
(password + security_token to connect to the API as explain in Salesforce site) in the robot connection, as shown here:
connections: sfcon: adaptor: 'force' sfuser: processenvSF_USERNAME sfpass: processenvSF_SECURITY_TOKEN
However if you are part of an organization, and having trouble querying/updating objects and streaming events,
you probably need to provide the organization credentials for authorization, this are the orgCreds/oauth2 credentials,
you can either pass orgCreds
or oauth2
parameter to the connection, as shown below and explain in the
JSForce Docs:
var cylon = ; cylon; cylonstart;
If you provide all credentials and still have problems to create/query/update objects and stream info from salesforce please create an issue here: cylon-force issues.
Documentation
We're busy adding documentation to our web site at http://cylonjs.com/ please check there as we continue to work on Cylon.js
Thank you!
Contributing
For our contribution guidelines, please go to https://github.com/hybridgroup/cylon/blob/master/CONTRIBUTING.md .
Release History
For the release history, please go to https://github.com/hybridgroup/cylon-force/blob/master/RELEASES.md .
License
Copyright (c) 2013-2015 The Hybrid Group. Licensed under the Apache 2.0 license.