haggy / Proton-IDE

Salesforce.com IDE for the Atom editor

Proton IDE

Salesforce.com IDE for the Atom editor

NOTE: This IDE is still in BETA and is being actively developed. If you encounter any issues please check the known issues and log an issue in Github if it does not already exist. Thanks and enjoy!

Installation

Proton is available as an Atom package. Use cmd+, on a Mac or ctrl+, on Windows to pull up your Atom settings. Search for Proton IDE.

Configuration

Once the install is complete, we need to set the project directory (where all your projects will be saved). To do this:

• Click Atom in the menu and click Open Your Config
• Find the following lines (it will be near the very bottom of the configuration file): If you don't see it, click Packages -> Proton -> Login/New Project, then check your config again

'proton':
  'project_path': ''

• In between the empty single quotes, add the full path to your project. NOTE: This directory must exist so make sure to create it if it doesn't.
• Do not add a trailing slash. For example, if you're on a Mac and you want your project to be in your home directory in a folder called atom you would use: /Users/yourusername/atom

That's it! Keep reading for instructions on using the Proton IDE.

Creating a new SFDC project

• Navigate to Packages -> Proton
• Select Login/New Project
• Enter you username and password for a Salesforce instance (NOTE: You may need to append your security token onto your password)
• Select the org type (Is it Production, Sandbox or Developer?)
• Click Login
• When you see a successful login message, click on the Select Metadata tab
• This will load all the available Metadata from your org (NOTE: At this time, only the main dev resources are available)
• Enter a project name (no spaces)
• Click Create Project

Saving your file to SFDC

To deploy the changes you made to a file:

• Right click anywhere in the active file window and click Proton: Save to server OR
• Navigate to Packages -> Proton and click Save current file

Refreshing a file from SFDC

If you want to pull the most recent version of a file from SFDC:

• Right click anywhere in the active file window and click Proton: Refresh from server OR
• Navigate to Packages -> Proton and click Refresh current file

Deleting a file from SFDC

If you want to delete a file from SFDC (and locally):

• Right click anywhere in the active file window and click Proton: Delete from server OR
• Navigate to Packages -> Proton and click Delete current file

Creating new metadata

You can create new Classes/Triggers/Pages/Components right from the IDE.

• Navigate to Packages -> Proton -> Create Metadata
• Click on the metadata type that you'd like to create
• Fill in all required fields
• Click create

Interactive Query Editor

Proton IDE has a rich query editor built-in. It allows you to query/sort/update data in your org right from the IDE!

To open the editor:

• Navigate to Packages -> Proton -> Run Interactive Query

To perform a query:

• The top 3 fields are for you select/from/where statements. NOTE: Don't include the select, from, or where keywords.
• NOTE: You can also query relationally (Account.Name, Account.Owner.Name etc..)
• Click Execute Query or press [ENTER]

To search and sort:

• Use the column headers to sort.
• Use the search box to search table data.

To update data:

• Double click on the cell that you want to update
• Enter the new value and press [ENTER]
• You can edit multiple rows before saving
• When finished, click Save Rows

Running code against your org

You can execute anonymous apex from Proton and view the full debug log.

• Navigate to Packages -> Proton -> Execute Anonymous Apex
• Enter Apex code into the editor and click "Execute"
• The debug log will be displayed under the Results tab