Giter VIP home page Giter VIP logo

salesforce-explorer's Introduction

Salesforce Explorer

This is an electron app using the jsforce library to explore a Salesforce org. Think of it like Workbench, but for your desktop. This is a prototype and a work in progress.

alt text

Getting Started

  1. Install the dependencies using npm:
npm instal

  1. Create a connected app in a Salesforce org. You can create a new developer org here, and there are instructions for setting up a connected app here. You will want to add the grants for api access. For a callback url you can use: https://salesforce-explorer-redirect-uri.localhost.com/.

  2. Create a config file config.json in your root. It should look like this:

{
    "authorize_url": "https://login.salesforce.com/services/oauth2/authorize",
    "access_token_url": "https://login.salesforce.com/services/oauth2/token",
    "client_id": "<<<FILL THIS IN WITH YOUR CONSUMER ID>>>",
    "redirect_uri": "https://salesforce-explorer-redirect-uri.localhost.com/",
    "scopes": ["refresh_token", "api"],
    "extra": {
        "response_type": "code"
    }
}

Note that client_id will be filled in with the consumer id provided by your connected app, which you created in the previous step.

  1. Run the app in development mode:
npm start

Packaging

In order to package an app that you can run locally:

npm run make

This will prepare a binary on your local machine that you can run.

salesforce-explorer's People

Contributors

stanlemon avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar

Forkers

gt2985 nelangovan mickle00 biow0lf smn2gnt seanrussell

salesforce-explorer's Issues

Node version issue with Keytar

HI i really like this implementation and looking forward if you can let me know how to fix this node version issue.

here is the error

App threw an error during load
Error: The module '/Users/bushan/development/learning/salesforce-explorer/node_modules/keytar/build/Release/keytar.node'
was compiled against a different Node.js version using
NODE_MODULE_VERSION 57. This version of Node.js requires
NODE_MODULE_VERSION 54. Please try re-compiling or re-installing
the module (for instance, using npm rebuild ornpm install).
at process.module.(anonymous function) [as dlopen] (ELECTRON_ASAR.js:173:20)
at Object.Module._extensions..node (module.js:598:18)
at Object.module.(anonymous function) [as .node] (ELECTRON_ASAR.js:173:20)
at Module.load (module.js:488:32)
at tryModuleLoad (module.js:447:12)
at Function.Module._load (module.js:439:3)
at Module.require (module.js:498:17)
at require (internal/module.js:20:19)
at Object. (/Users/bushan/development/learning/salesforce-explorer/node_modules/keytar/lib/keytar.js:1:169)
at Object. (/Users/bushan/development/learning/salesforce-explorer/node_modules/keytar/lib/keytar.js:61:3)

screen shot 2018-01-26 at 6 26 26 pm

any help on this is really appreciated

Miscellaneous Install, Start, Rebuild Issues

@stanlemon - Thank you for this great project!

I'm fairly new to Node.js, and I wasn't quite able to get it to run on a Windows (7) machine.
I'm running Node version '8.9.4' .

I don't care that much about packaging the electron app (although that sounds very cool!) - I would like to have a working 'npm start' command. Some errors:

1. The install command at first threw a few messages concerning deprecated packages that should be updated (coffeescript, pug, jstransformer, e.g.). I installed those dependencies using npm install, and that made those messages go away.

2. On 'npm rebuild' and 'npm start', I saw the below error a few times. It looks like it's trying to set or reference an Environment Variable.

[email protected] start C:\DevTools\SFDC-Explorer
NODE_ENV=development electron main.js

'NODE_ENV' is not recognized as an internal or external command,
operable program or batch file.
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] start: NODE_ENV=development electron main.js
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] start script.

3. But I also got the rebuild to complete:

C:\DevTools\SFDC-Explorer>npm run rebuild

[email protected] rebuild C:\DevTools\SFDC-Explorer
electron-rebuild

√ Rebuild Complete

C:\DevTools\SFDC-Explorer>npm run package

[email protected] package C:\DevTools\SFDC-Explorer
electron-packager . 'Salesforce Explorer' --overwrite --out=release --asar=true

Packaging app for platform win32 x64 using electron v1.8.2
Wrote new app to release'Salesforce-win32-x64

4. This was something I ran into when I ran install again. I looked in the directory [C:\DevTools\SFDC-Explorer\node_modules\keytar\build\keytar.vcxproj] to see if that Visual C++ project file was there, and it was not - so it looks like a path problem somewhere.

C:\DevTools\SFDC-Explorer>npm install

[email protected] install C:\DevTools\SFDC-Explorer\node_modules\keytar
node-gyp rebuild

C:\DevTools\SFDC-Explorer\node_modules\keytar>if not defined npm_config_node_gyp
(node "C:\Program Files\nodejs\node_modules\npm\node_modules\npm-lifecycle\node
-gyp-bin\....\node_modules\node-gyp\bin\node-gyp.js" rebuild ) else (node "C:
\Program Files\nodejs\node_modules\npm\node_modules\node-gyp\bin\node-gyp.js" re
build )
Building the projects in this solution one at a time. To enable parallel build,
please add the "/m" switch.
C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\Platforms\x64\PlatformToolsets\v140\Toolset.targets(36,5): error MSB8036: The Windows SDK version 8.1 was not found. Install the required version of Windows SDK or change the SDK version in the project property pages or by right-clicking the solution and selecting "Retarget solution". [C:\DevTools\SFDC-Explorer\node_modules\keytar\build\keytar.vcxproj]
gyp ERR! build error
gyp ERR! stack Error: C:\Program Files (x86)\MSBuild\14.0\bin\msbuild.exe failed with exit code: 1
gyp ERR! stack at ChildProcess.onExit (C:\Program Files\nodejs\node_modules
npm\node_modules\node-gyp\lib\build.js:258:23)
gyp ERR! stack at emitTwo (events.js:126:13)
gyp ERR! stack at ChildProcess.emit (events.js:214:7)
gyp ERR! stack at Process.ChildProcess._handle.onexit (internal/child_proces
s.js:198:12)

Thanks again! Michael

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.