💫 swift-sfdc README

👉🏼 Please rate/review the extension to show support! 👈🏼

🔥 NOW compatible with SFDX Project Structure & configurable project root folder!🔥

UPDATE: it is now possible to configure the project root folder in the .swift-sfdc configuration file. For backward compatibility, at first commands usage the extension will try to guess which project structure (old "ant" or newer "sfdx" structures) and store it inside its config file. Also a couple new commands for resetting/reloading the config are available. The project structure can then be updated if the guess was wrong or if it changes over time

🔥 Check Diagrams.net diagram export feature down below! 🔥

Intro

Do you ever feel like working with the salesforce.com platform wastes a lot of time? Are you tired of switching continuously between the IDE and the platform to create (and retrieve!) the metadata you need?

STOP RETRIEVING, START PUSHING!

The swift-sfdc vscode extension aims to make working with the salesforce.com platform lightning fast! Stop waiting for metadata retrieval and start creating the metadata directly in your local project, without waiting ages to synchronize it locally from the cloud!

Feel free to integrate swift-sfdc with other extensions, like ForceCode or MavensMate, to deploy the updated xml files directly to salesforce and create the best developer experience!

How it works

swift-sfdc is designed to interact with the standard salesforce project structure which you can download using tools like ant, mavensmate or forcecode, where every metadata type is contained within a subfolder of the /src/ root folder:

UPDATE: Compatible with SFDX Project structure! 🔥

Given this folder structure to your project, the extension is then able to interact with the XML metadata definitions provided by the salesforce API. You're then free to use your favourite deployment tool to update the code in your org. (Metadata deployment coming soon!) Check github repository's "samples" folder for sample configurations!

Features

Field Creation

Allows default and basic field configuration to save time while developing apex classes.

XML Definition Manipulation

Interact with the XML definition of your SObjects and start creating fields directly in your local metadata. Stop with the annoying and boring retrieval process and start pushing metadata straightforward to the platform, saving one round-trip! Keeping in mind the fast-development goal, fields are usually created with a default configuration. For example, String fields are always created with a default length of 255. You'll be free to edit the XML metadata on your own or change those configurations directly in salesforce and retrieve them again.

Default Profiles for FLS when creating new fields!

You have finally managed to save time by creating those custom fields straightforward into the SFDC metadata files. Now you can configure field-level security directly on the profiles metadata, saving even more time! 🎉🎉🎉 Field-level security defaults to edit. This is done on purpose to allow developers saving time, leaving these kind of configurations to admins later on, which will simply have to edit the existing configuration instead of creating it from scratch.

Profiles Configuration

Configure profiles directly in your local project.

Apex Classes & Visualforce Pages access

In-editor manipulation of your profiles' files to manage apex classes and visualforce page accesses.

User Permissions and cross-profile User Permission management

Not only you're going to be able to manage User Permissions for a Profile...

..but you'll be able to check them cross-profile as well:

These features are designed to simply add new permissions when they are enabled, leaving everything else as-is. Based on a pre-defined list of permissions, you'll be able to check a single profile for all permissions or all profiles for a specific one. A permission gets added to the profiles metadata files only if you enable it. Basically it's not going to be possible to add a piece of metadata where you disable a permission if it wasn't previously retrieved. It's only possible to enable new non-previously-retrieved permissions (and add them to the metadata) or disable currently enabled permissions. This is done to somehow emulate salesforce behaviour on metadata retrieval and avoid polluting files with non-useful metadata.

Field-Level Security management

Edit your profiles' Field-Level Security directly from the extension. It supports search for access level. You'll be finally able to find fields with no access and easily update them!

BETA: Diagrams.net Entity Diagram Generation 🔥

Speed up your documenting process with this quick&dirty diagram generation feature! By just selecting the entities you wish to include in the graph, this feature traces their relationships and produces an output .xml file which can be easily drag&dropped into diagrams.net, displaying the selected SObjects, their relationships with each other and the master-detail/lookup fields which link them together!

NOTE: the entities are placed in a circle when imported, so you can place them wherever you want. Feel free to move them around as you wish!

Known Issues

User Permission list might be outdated/not complete, feel free to pull request!

Release Notes

See CHANGELOG file

Disclaimer

salesforce.com and diagrams.net are owned by their respective companies and not managed by me, any kind of integration might stop working if they change their file formats/structure at any time.