sfdx-hardis configuration

Type: object

Configuration file definition for sfdx-hardis Salesforce DX plugin

 No Additional Properties

root allowedOrgTypes

Allowed org types

Type: array of enum (of string)

Types of orgs allowed for config & development. If not set, sandbox and scratch are allowed by default

 No Additional Items

Each item of this array must be:

root allowedOrgTypes allowedOrgTypes items
Type: enum (of string)

Must be one of:

  • "sandbox"
  • "scratch"

Example:

[
    "sandbox"
]

root autoCleanTypes

Auto-Cleaning types

Type: array of enum (of string)

When saving a sfdx-hardis task, the list of cleanings will be automatically applied to sfdx sources

 No Additional Items

Each item of this array must be:

root autoCleanTypes autoCleanTypes items
Type: enum (of string)

Must be one of:

  • "caseentitlement"
  • "checkPermissions"
  • "dashboards"
  • "datadotcom"
  • "destructivechanges"
  • "localfields"
  • "listViewsMine"
  • "minimizeProfiles"
  • "productrequest"
  • "systemDebug"

Example:

[
    "dashboards",
    "datadotcom",
    "destructivechanges"
]

root autoRemoveUserPermissions

Auto-Remove User Permissions on profiles

Type: array of string

When saving a sfdx-hardis task, these permissions will be removed from profiles

 No Additional Items

Each item of this array must be:

root autoRemoveUserPermissions autoRemoveUserPermissions items
Type: string

Example:

[
    "EnableCommunityAppLauncher",
    "FieldServiceAccess",
    "OmnichannelInventorySync"
]

root autoRetrieveWhenPull

Auto-Retrieve when pull

Type: array of string

When calling hardis:scratch:pull, if you define metadatas (named or not), they will also be retrieved using force:source:retrieve

 No Additional Items

Each item of this array must be:

root autoRetrieveWhenPull autoRetrieveWhenPull items
Type: string

Examples:

[
    "CustomApplication"
]

[
    "CustomApplication:MyApp1",
    "CustomApplication:MyApp2"
]

root apexTestsMinCoverageOrgWide

Minimum apex test coverage %

Type: number Default: 75.0

Minimum percentage of apex code coverage accepted
Examples:

80.0

95.0

root availableProjects

Available projects

Type: array of string

List of business projects that are managed in the same repository. Will be used to build git branch name when using hardis:work:new

 No Additional Items

Each item of this array must be:

root availableProjects availableProjects items
Type: string

Example:

[
    "sales_cloud",
    "service_cloud",
    "community"
]

root availableTargetBranches

Available target branches

Type: array of string

List of git branches that can be used as target for merge requests

 No Additional Items

Each item of this array must be:

root availableTargetBranches availableTargetBranches items
Type: string

Example:

[
    "develop",
    "develop_next"
]

root branchPrefixChoices

New branches prefixes choices

Type: array Default: [{"title": "Feature", "value": "feat", "description": "New feature, evolution of an existing feature... If you don't know, just select Feature"}, {"title": "Debug", "value": "fix", "description": "A bug has been identified and you are the right person to solve it !"}]

When calling hardis:work:new, you can override the default branch prefixes. Input title, value and description for each of them

 No Additional Items
Example:

[
    {
        "title": "Feature",
        "value": "feat",
        "description": "New feature, evolution of an existing feature... If you don't know, just select Feature"
    },
    {
        "title": "Debug",
        "value": "fix",
        "description": "A bug has been identified and you are the right person to solve it !"
    }
]

root cleanXmlPatterns

Clean XML Patterns

Type: array of object

List of patterns to automatically clean XML files

 No Additional Items

Each item of this array must be:

root cleanXmlPatterns cleanXmlPatterns items
Type: object

Clean XML pattern and xpaths

 No Additional Properties

root cleanXmlPatterns cleanXmlPatterns items globPattern

Glob pattern

Type: string

Glob pattern to identify XML files to clean
Example:

"/**/*.flexipage-meta.xml"

root cleanXmlPatterns cleanXmlPatterns items xpaths

XPath list

Type: array of string

XPaths to identify elements to remove

 No Additional Items

Each item of this array must be:

root cleanXmlPatterns cleanXmlPatterns items xpaths xpaths items
Type: string

Example:

[
    "//ns:flexiPageRegions//ns:name[contains(text(),'dashboardName')]"
]

Example:

[
    {
        "globPattern": "/**/*.flexipage-meta.xml",
        "xpaths": [
            "//ns:flexiPageRegions//ns:name[contains(text(),'dashboardName')]"
        ]
    },
    {
        "globPattern": "/**/*.layout-meta.xml",
        "xpaths": [
            "//ns:relatedLists//ns:relatedList[contains(text(),'RelatedSolutionList')]"
        ]
    }
]

root customCommands

Custom commands

Type: array of object

List of custom commands for VsCode SFDX-Hardis extension

 No Additional Items

Each item of this array must be:

root customCommands customCommands items
Type: object

Custom command definition

 No Additional Properties

root customCommands customCommands items id

Id

Type: string

Identifier of the menu (can be any string)

root customCommands customCommands items label

Label

Type: string

Label of the menu

root customCommands customCommands items commands

Label

Type: array of object

List of commands of the menu

 No Additional Items

Each item of this array must be:

root customCommands customCommands items commands commands items
Type: object

Custom command definition

 No Additional Properties

root customCommands customCommands items commands commands items id

Id

Type: string

Identifier of the command (can be any string)

root customCommands customCommands items commands commands items label

Label

Type: string

Label of the command that will appear in menu

root customCommands customCommands items commands commands items icon

Icon

Type: string

Icon (can be any of svg icons of this list: https://github.com/hardisgroupcom/vscode-sfdx-hardis/tree/master/resources

root customCommands customCommands items commands commands items tooltip

Tooltip

Type: string

Text that will appear when user will hover the command

root customCommands customCommands items commands commands items command

Command

Type: string

Command line to run when clicking on the menu

root customCommands customCommands items commands commands items helpUrl

Help url

Type: string

URL for help page of the command

Example:

[
    {
        "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"
            },
            {
                "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\""
            }
        ]
    }
]

root customCommandsPosition

Custom commands position

Type: enum (of string) Default: "first"

Position of custom commands in the menu (first or last)

Must be one of:

  • "first"
  • "last"

Examples:

"first"

"last"

root customOrgColors

Custom Org Colors

Type: object

Custom colors set by VsCode SFDX Hardis

Additional Properties of any type are allowed.

root customOrgColors additionalProperties
Type: object

root customPlugins

Custom plugins

Type: array of object

List of additional plugins that will be displayed in VsCode SFDX-Hardis Dependencies panel

 No Additional Items

Each item of this array must be:

root customPlugins Plugin

Plugin

Type: object

Plugin definition

 No Additional Properties

root customPlugins Plugin name

Name

Type: string

Name of the plugin npm package
Examples:

"mo-dx-plugin"

"shane-sfdx-plugins"

root customPlugins Plugin helpUrl

Name

Type: string

Url of plugin documentation
Examples:

"https://github.com/msrivastav13/mo-dx-plugin"

"https://github.com/mshanemc/shane-sfdx-plugins"

Example:

[
    {
        "name": "mo-dx-plugin",
        "helpUrl": "https://github.com/msrivastav13/mo-dx-plugin"
    },
    {
        "name": "shane-sfdx-plugins",
        "helpUrl": "https://github.com/mshanemc/shane-sfdx-plugins"
    }
]

root dataPackages

Data packages

Type: array of object

List of data packages

 No Additional Items

Each item of this array must be:

root dataPackages dataPackages items
Type: object

Data package

 No Additional Properties

root dataPackages dataPackages items dataPath

SFDMU Data project path

Type: string

Path to SFDMU project

root dataPackages dataPackages items importInScratchOrgs

SFDMU Data project path

Type: boolean

Path to SFDMU project

root defaultPackageInstallationKey

Defaut package installation key

Type: string

When generating a new package version protected with password, use this value as default package installation key
Examples:

"hardis"

"myPassword"

"dFGGF43656YfdFDG{{{dhgfh:::;FSEDSFd78"

root developmentBranch

Default pull/merge request target org

Type: string Default: "developpement"

When creating a new sfdx-hardis task, this git branch is used as base to create the feature/debug sub branch. The merge request will later have this branch as target.
Examples:

"developpement"

"dev_lot2"

"hotfixes"

root deploymentPlan

Deployment plan

Type: object

Deployment plan that will be performed during deployments. Can be based on packageXmlFile for sources or on dataPath for sfdmu data deployments
Example:

{
    "packages": [
        {
            "label": "Import EmailTemplate records",
            "dataPath": "scripts/data/EmailTemplate",
            "order": -21
        },
        {
            "label": "Deploy EmailTemplate",
            "packageXmlFile": "manifest/splits/packageXmlEmails.xml",
            "order": -20
        },
        {
            "label": "Deploy Flow-Workflow",
            "packageXmlFile": "manifest/splits/packageXmlFlowWorkflow.xml",
            "order": 6
        }
    ]
}

root deploymentPlan packages

List of packages to deploy

Type: array of object

During deployment, main package.xml will be split into these packages. Can also contain data packages

The following properties are required:

  • label
  • order
No Additional Items

Each item of this array must be:

root deploymentPlan packages packages items
Type: object

Source or data package to deploy

 No Additional Properties

root deploymentPlan packages packages items dataPath

Path to SFDMU data project to deploy

Type: string

Example:

"scripts/data/EmailTemplate"

root deploymentPlan packages packages items label

Source or data package label

Type: string

Examples:

"Deploy EmailTemplate"

"Import EmailTemplate records"

root deploymentPlan packages packages items order

Execution order in deployment plan

Type: number

Examples:

-20

13

50

root deploymentPlan packages packages items packageXmlFile

Path to package.xml file to use for deployment

Type: string

Example:

"manifest/splits/packageXmlEmails.xml"

root deploymentPlan packages packages items waitAfter

Wait after install (seconds)

Type: number

Delay to wait before installing the next package
Examples:

10

20

Example:

[
    {
        "label": "Import EmailTemplate records",
        "dataPath": "scripts/data/EmailTemplate",
        "order": -21
    },
    {
        "label": "Deploy EmailTemplate",
        "packageXmlFile": "manifest/splits/packageXmlEmails.xml",
        "order": -20
    }
]

root devHubAlias

Dev Hub org alias

Type: string Default: ""

Dev Hub alias, usually DevHub_ProjectName
Examples:

"DevHub_MyClientMyProject"

"DevHub_GoogleGmail"

"DevHub_AppleIWatch"

root devHubUsername

Dev Hub Username

Type: string Default: ""

Dev Hub username, used to authenticate to DevHub from CI jobs
Examples:

"cicd-user@myclient.com"

"scratch-user@google.fr"

"scratch-user@apple.fr"

root extends

Extends remote configuration URL

Type: string

You can base your local sfdx-hardis configuration on a remote config file. That allows you to have the same config base for all your projects
Example:

"https://raw.githubusercontent.com/worldcompany/shared-config/main/.sfdx-hardis.yml"

root initPermissionSets

Initial Permission Sets

Type: array

When creating a scratch org, Admin user will be automatically assigned to those permission sets

 No Additional Items

Each item of this array must be:

root initPermissionSets initPermissionSets items
Type: object or string

Permission Set or Permission Set Group

 No Additional Properties

root initPermissionSets initPermissionSets items name

Name

Type: string

Permission Set or Permission Set Group name
Example:

[
    "MyPermissionSet",
    "MyPermissionSetGroup",
    "MyPermissionSetGroup2"
]

Example:

[
    "MyPermissionSet",
    "MyPermissionSetGroup"
]

root installedPackages

Installed Packages

Type: array of object

Defines the list of packages installed on the project. Use

No Additional Items

Each item of this array must be:

root installedPackages Salesforce package

Salesforce package

Type: object

Salesforce package info (managed, unlocked or unmanaged)

 No Additional Properties

root installedPackages Salesforce package Id

(unused) PackageId

Type: string

Example:

"0A35r000000GveVCAS"

root installedPackages Salesforce package SubscriberPackageId

Subscriber Package Id

Type: string

Example:

"033b0000000Pf2AAAS"

root installedPackages Salesforce package SubscriberPackageName

Subscriber Package Name

Type: string

Example:

"Files Attachment Notes"

root installedPackages Salesforce package SubscriberPackageNamespace

Subscriber Package NameSpace

Type: string or null

Example:

"fan_astrea"

root installedPackages Salesforce package SubscriberPackageVersionId

Subscriber Version Id (IMPORTANT)

Type: string

Example:

"04t0o000003nRWAAA2"

root installedPackages Salesforce package SubscriberPackageVersionName

Subscriber Version Name

Type: string

Example:

"Summer2021"

root installedPackages Salesforce package SubscriberPackageVersionNumber

Subscriber Version Number

Type: string

Example:

"1.22.0.2"

root installedPackages Salesforce package installDuringDeployments

Install during deployments

Type: boolean Default: false

If true, during deployments this package will be installed in target org if not installed yet
Examples:

true

false

root installedPackages Salesforce package installOnScratchOrgs

Install on scratch orgs

Type: boolean Default: false

If true, this package will be installed when creating a new scratch org with sfdx-hardis
Examples:

true

false

root installedPackages Salesforce package installationkey

Package installation key

Type: string

Installation key for key-protected package
Examples:

"MyInstallationKey"

"4FzkMzUSwFfP#@"

Example:

[
    {
        "Id": "0A30N000000ALWrSAO",
        "SubscriberPackageId": "033b0000000Pf2AAAS",
        "SubscriberPackageName": "Declarative Lookup Rollup Summaries Tool",
        "SubscriberPackageNamespace": "dlrs",
        "SubscriberPackageVersionId": "04t0N000000IyYrQAK",
        "SubscriberPackageVersionName": "2.11",
        "SubscriberPackageVersionNumber": "2.11.0.1",
        "installOnScratchOrgs": false,
        "installDuringDeployments": true,
        "installationkey": "MyInstallationKey"
    },
    {
        "Id": "0A35r000000GveVCAS",
        "SubscriberPackageId": "0330o000000B3vIAAS",
        "SubscriberPackageName": "Files Attachment Notes",
        "SubscriberPackageNamespace": "fan_astrea",
        "SubscriberPackageVersionId": "04t0o000003nRWAAA2",
        "SubscriberPackageVersionName": "Summer2021",
        "SubscriberPackageVersionNumber": "1.22.0.2",
        "installOnScratchOrgs": true,
        "installDuringDeployments": true
    }
]

root installPackagesDuringCheckDeploy

Install packages during deployment checks

Type: boolean Default: false

When calling deployment check command, installs any package referred within installedPackages property
Example:

true

root instanceUrl

Instance URL

Type: string Default: ""

Salesforce instance URL used by CI for deployment or backups
Examples:

"https://myclient.force.com"

"https://google.force.com"

"https://apple.force.com"

root listViewsToSetToMine

List views to set to Mine

Type: array of string Default: []

List of ListView items to set to Mine after a delivery (that does not accept value 'Everything')

 No Additional Items

Each item of this array must be:

root listViewsToSetToMine listViewsToSetToMine items
Type: string

root sourcesToRetrofit

Metadata to retrofit

Type: array of string

List of metadata to retrieve for retrofit job

 No Additional Items

Each item of this array must be:

root sourcesToRetrofit sourcesToRetrofit items
Type: string

Example:

[
    "CustomField",
    "Layout",
    "PermissionSet"
]

root monitoringCommands

Monitoring commands

Type: array of object

List of monitoring commands to run with command hardis:org:monitor:all

 No Additional Items

Each item of this array must be:

root monitoringCommands monitoringCommands items
Type: object

Monitoring command

 No Additional Properties

root monitoringCommands monitoringCommands items key

Key

Type: string

Unique identifier of the monitoring command. Can be used with monitoringDisable

root monitoringCommands monitoringCommands items title

Title

Type: string

Title of the command (will appear in logs)

root monitoringCommands monitoringCommands items command

Command

Type: string

Bash command to run

root monitoringCommands monitoringCommands items frequency

Frequency

Type: string

daily or weekly

Example:

[
    {
        "title": "Detect calls to deprecated API versions",
        "key": "LEGACYAPI",
        "command": "sfdx hardis:org:diagnose:legacyapi",
        "frequency": "weekly"
    },
    {
        "title": "My custom command",
        "key": "MY_CUSTOM_KEY",
        "command": "sfdx my:custom:command",
        "frequency": "daily"
    }
]

root monitoringAllowedSectionsActions

Monitoring Allowed Sections Actions

Type: object

Override list of Setup Audit Trail elements that won't be considered as suspect by monitoring tools

Additional Properties of any type are allowed.

root monitoringAllowedSectionsActions additionalProperties
Type: object

root monitoringDisable

Disabled monitoring commands

Type: array

List of commands to skip during monitoring jobs

 No Additional Items

Each item of this array must be:

root monitoringDisable enum_monitoring_commands
Type: enum (of string)

Must be one of:

  • "AUDIT_TRAIL"
  • "LEGACY_API"
  • "LINT_ACCESS"
  • "UNUSED_METADATAS"
  • "METADATA_STATUS"
  • "MISSING_ATTRIBUTES"
  • "UNUSED_LICENSES"

Example:

[
    "METADATA_STATUS",
    "UNUSED_METADATAS"
]

root monitoringExcludeUsernames

Monitoring usernames to exclude

Type: array of string

List of usernames to exclude while running monitoring commands

 No Additional Items

Each item of this array must be:

root monitoringExcludeUsernames monitoringExcludeUsernames items
Type: string

Example:

[
    "deploymentuser@cloudity.com",
    "mc-cloud-user@cloudity.com"
]

root msTeamsWebhookUrl

MsTeams WebHook Url (ALL)

Type: string Default: ""

Url of the Ms Teams channel Web Hook that can be used to send ALL notifications
Example:

"https://my.msteams.webhook.url"

root msTeamsWebhookUrlCritical

MsTeams WebHook Url (CRITICAL)

Type: string Default: ""

Url of the Ms Teams channel Web Hook that can be used to send CRITICAL notifications
Example:

"https://my.msteams.webhook.url"

root msTeamsWebhookUrlSevere

MsTeams WebHook Url (SEVERE)

Type: string Default: ""

Url of the Ms Teams channel Web Hook that can be used to send SEVERE notifications
Example:

"https://my.msteams.webhook.url"

root msTeamsWebhookUrlWarning

MsTeams WebHook Url (WARNING)

Type: string Default: ""

Url of the Ms Teams channel Web Hook that can be used to send WARNING notifications
Example:

"https://my.msteams.webhook.url"

root msTeamsWebhookUrlInfo

MsTeams WebHook Url (INFO)

Type: string Default: ""

Url of the Ms Teams channel Web Hook that can be used to send INFO notifications
Example:

"https://my.msteams.webhook.url"

root notificationsDisable

Disabled notification types

Type: array

List of notifications types to skip sending

 No Additional Items

Each item of this array must be:

root notificationsDisable enum_notification_types
Type: enum (of string)

Must be one of:

  • "AUDIT_TRAIL"
  • "APEX_TESTS"
  • "BACKUP"
  • "DEPLOYMENT"
  • "LEGACY_API"
  • "LINT_ACCESS"
  • "UNUSED_METADATAS"
  • "METADATA_STATUS"
  • "MISSING_ATTRIBUTES"
  • "UNUSED_LICENSES"

Example:

[
    "METADATA_STATUS",
    "UNUSED_METADATAS"
]

root poolConfig

Scratch org pool configuration

Type: object

Configuration allowing to generate and fetch scratch orgs from scratch org pool
Example:

{
    "maxScratchOrgsNumber": 10,
    "storageService": "kvdb.io"
}

root poolConfig minScratchOrgRemainingDays

Min scratch org remaining days

Type: number Default: 25

When pool scratch org is less than this number, it is deleted and another one is created

root poolConfig maxScratchOrgsNumber

Maximum number of scratch orgs

Type: number

Maximum number of active scratch orgs in the scratch org pool

root poolConfig maxScratchOrgsNumberToCreateOnce

Maximum number of scratch orgs to create once

Type: number

Maximum number of scratch orgs to create in one CI job

root poolConfig storageService

Storage service for scratch org pool

Type: string

Remote service allowing to store scratch org pool details

root productionBranch

Production branch name

Type: string Default: ""

Name of the git branch corresponding to production environment
Examples:

"master"

"main"

"production"

root projectName

Project Name

Type: string Default: ""

Identifier for the project (can be the client and project)
Examples:

"MyClientMyProject"

"GoogleGmail"

"AppleIWatch"

root retrofitBranch

Retrofit branch name

Type: string Default: ""

Name of the git branch where retrofit merge requests targets to
Examples:

"preprod"

"dev"

"maintenance"

root retrofitIgnoredFiles

Retrofit ignored files

Type: array of string

When calling hardis:org:retrieve:sources:retrofit, list of files to ignore (discard just after retrieve)

 No Additional Items

Each item of this array must be:

root retrofitIgnoredFiles retrofitIgnoredFiles items
Type: string

Example:

[
    "force-app/main/default/applications/MyAppIWantToManageInProduction.app-meta.xml",
    "force-app/main/default/flexipages/MyFlexipageWithDashboards.flexipage-meta.xml"
]

root scratchOrgInitApexScripts

Scratch org init apex scripts

Type: array of string

Apex scripts to call after scratch org initialization

 No Additional Items

Each item of this array must be:

root scratchOrgInitApexScripts scratchOrgInitApexScripts items
Type: string

Example:

[
    "scripts/apex/init-scratch.apex",
    "scripts/apex/init-custom-settings.apex"
]

root scratchOrgDuration

Duration of Scratch Org

Type: number Default: 30

Defines the lifespan of the scratch org in number of days, from 1 to 30

Value must be greater or equal to 1 and lesser or equal to 30

root sfdmuCanModify

SFDMU can modify

Type: string Default: ""

Instance host name to allow SFDMU to deploy data in a production org
Example:

"myproject.force.com"

root skipUpdateForceIgnore

Skip update .forceignore file

Type: boolean Default: false

Defines if sfdx-hardis will propose to upgrade local .forceignore file

root skipUpdateGitIgnore

Skip update .gitignore file

Type: boolean Default: false

Defines if sfdx-hardis will propose to upgrade local .gitignore file

root targetUsername

Target Username

Type: string Default: ""

Salesforce username used by CI for deployment or backups
Examples:

"deployments@myclient.com"

"deployments@google.fr"

"deployments@apple.com"

root useDeltaDeployment

Use Delta Deployment

Type: boolean Default: false

Defines if sfdx-hardis will deploy in delta from minor to major branches

root linterIgnoreRightMetadataFile

Linter ignore permission set or/and profile

Type: string Default: ""

Ignore profiles or permission sets
Examples:

"Profile"

"Profile:ProfileA"

"PermissionSet"

"PermissionSet:PermissionSetA, Profile:ProfileA"