VsCode SFDX Hardis

Easy Salesforce DX projects management, even if you don't know Salesforce DX or git

Salesforce DX is great, but there are so many base commands and so many useful plugins that it's easy to get lost.

VsCode SFDX-Hardis aims to simplify the use of Salesforce DX with an intuitive UI and ready to use pre-integrated commands.

You can also use it to setup and use a complete CI/CD pipeline for your Salesforce project.

Graciously provided by Cloudity, and based on sfdx plugin sfdx-hardis

• Articles
• Assisted UI
  • Work on a task (simple)
  • Work on a task (Expert)
  • Data Import & Export
  • Debugger
  • Operations
  • Audit
  • Configuration
  • Packaging
  • Nerdy stuff
• Custom commands
• Custom plugins
• Dependencies
• Who we are

Articles

Here are some articles with examples of use of sfdx-hardis

• English

• French
  • Versions d'API Salesforce décommissionnées: Que faire ?
  • Exporter en masse les fichiers d’une org Salesforce
  • Suspendre l’accès aux utilisateurs lors d’une mise en production Salesforce

Assisted UI

Integration between VsCode SFDX Hardis UI and sfdx-hardis CLI, so you don't need to know the commands or their arguments

Work on a task (simple)

Base commands allowing to a consultant profile to work on a SFDX project without knowledge about SFDX or Git

• Start a new task
• Open my org in browser
• Pull from Salesforce org to local files
• Save / Publish my current task
• Reset selected list of items to merge

Work on a task (Expert)

Advanced commands allowing a technical profile to work on a sfdx project without knowing SFDX or Git

• Push from local files to Salesforce org
• Install a package
• Run Apex tests on Salesforce org
• Simulate SFDX Deployment
• Clean SFDX Project from defined references
• Clean SFDX Project from references not in target org
• Create scratch org (or resume creation)
• Create scratch org (force new)
• Generate new password
• Connect to a Salesforce org
• Clear local sfdx tracking files
• Clear local and remote sfdx tracking files

Data Import & Export

Manages data and files import / export using Salesforce Data Move Utility

• Export data from org with SFDMU
• Import data to org with SFDMU
• Create data import/export configuration
• Export files from org
• Create files export configuration

Debugger

Ease sources execution debugging of any type of org

Operations

Handy operations on Salesforce org

• Freeze users
• Unfreeze users
• Purge obsolete flows versions
• Delete scratch org(s)
• Activate .invalid user emails in sandbox

Audit

Audit Tools for your orgs

• Detect legacy API versions usage

Configuration

Configuration helpers

• Shortcuts to configuration files
• Configure deployment for CI
• Configure DevHub for CI

Packaging

Simplify creation and maintenance of packaging V2 packages (unlocked or managed)

• Create packaging V2 packages
• Manage package versions

Nerdy stuff

Use at your own risk :)

Custom commands

You can define your own custom commands that will appear at the beginning or the bottom of the menu.

• In .sfdx-hardis.yml file, and add property customCommands , that will contain other menus and commands under each of them. It can be defined:
  • Locally in you project, in config/.sfdx-hardis.yml file
  • In a .sfdx-hardis.yml file, in VsCode setting custom commands (ex: C:\myfolder\.sfdx-hardis.yml)
  • In a remote .sfdx-hardis.yml file, in VsCode setting custom commands (ex: http://my.server.com/.sfdx-hardis.yml)
• Icons can be any of the SVG files in this folder
• Once updated, please refresh the VsCode Sfdx Hardis Commands panel to see the changes.

Example in config/.sfdx-hardis.yml:

customCommandsPosition: first  # can be first or last
customCommands:
  - id: custom-menu
    label: Custom commands
    commands:
      - id: generate-manifest-xml
        label: Generate manifest
        icon: file.svg
        tooltip: Generates a manifest package.xml using local sfdx source files
        command: sfdx force:source:manifest:create --sourcepath force-app --manifestname myNewManifest
        helpUrl: https://megalinter.github.io/
      - id: list-all-orgs
        label: List all orgs
        icon: salesforce.svg
        tooltip: List all orgs that has already been authenticated using sfdx
        command: sfdx force:org:list --all
  - id: custom-menu-2
    label: Another custom menu
    commands:
      - id: echo
        label: Echo something
        icon: user.svg
        tooltip: Useless commands just to show that we can use not sfdx commands too
        command: echo "Something"

Custom plugins

You can define your own custom plugins that will appear in dependencies panel

• In .sfdx-hardis.yml file, and add property customPlugins , that will contain other menus and commands under each of them. It can be defined:
  • Locally in you project, in config/.sfdx-hardis.yml file
  • In a .sfdx-hardis.yml file, in VsCode setting custom plugins (ex: C:\myfolder\.sfdx-hardis.yml)
  • In a remote .sfdx-hardis.yml file, in VsCode setting custom plugins (ex: http://my.server.com/.sfdx-hardis.yml)
• Once updated, please refresh the VsCode Sfdx Hardis Dependencies panel to see the changes.

Example in config/.sfdx-hardis.yml:

plugins:
  - name: mo-dx-plugin
    helpUrl: https://github.com/msrivastav13/mo-dx-plugin
  - name: shane-sfdx-plugins
    helpUrl: https://github.com/mshanemc/shane-sfdx-plugins

Dependencies

sfdx-hardis partially relies on the following SFDX Open-Source packages

• Salesforce Data Move Utility
• SFDX Essentials
• SFDX Git Delta
• Texei Sfdx Plugin

Who we are

Powered by Hardis Group