Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Builds a Salesforce artifact to be deployed to Salesforce Organizations or sandboxes.

Supports Full or Partial Deploy projects. Local developer files like jsconfig.json and .eslintrc.json are automatically excluded from the artifact generated.

In Full Deployment mode, it supports:

  • Building an existing Salesforce zip file from the FD_TEMP_DIR (by copying it to the artifacts folder)

  • Building an existing directory structure with a package.xml in it.

  • In this mode, all object types that are supported by the Salesforce API are supported by FlexDeploy.

In Partial Deployment mode, it supports:

  • Building a package structure from files checked out of SCM when no package.xml is present. It is automatically created from the items selected for deployment.

  • Building a package structure from files stored in a Salesforce Organization or Sandbox.

  • Building a package structure with a mixture

    or

    of SCM and Salesforce sourced files. The package.xml file is generated automatically to upload the correct information to Salesforce.

  • In this mode, see the Supported

    SalesForce

    Salesforce Metadata Types list for information on what types of objects are supported.

...

Target Properties

Property Name

Property Code

Required

Description

Salesforce Account Code

FDSF_ACCOUNT_CODE

Yes

Salesforce Account with all the required properties like User, Password, Client Id, etc.

Salesforce HTTPS protocol

FDSF_HTTPS_

USER

PROTOCOL

Yes

No

The

username to connect to Salesforce with.The sandbox name is automatically appended if necessary if you forget to append it

HTTPS protocol to use to secure the connection. Defaults to TLSv1.2.

Salesforce API Version

FDSF_API_VERSION

No

The Salesforce API version to target.

This Default will likely change with each FlexDeploy server and Saleforce plugin release in the future.

The maximum supported version of Salesforce API that is supported is linked to the version of FlexDeploy currently running.

Salesforce Cli Path

FDSF_CLI_PATH

No

The Salesforce CLI Path. (Eg: C:\Program Files\Salesforce CLI\bin)

Project File Excludes

FD_PARTIAL_FILE_EXCLUDES

No

Controls files excluded from Project Files. Enter expressions separated by ##. Leave empty to select all files. Begin or end the expression with * for simple wildcards. Otherwise,
regex is used. (e.g. /java/*##*.java##*person*##/java/.*[tT]est.*\.java)

Cloud Account Properties

Property Name

Property Code

Required

Description

Salesforce User Email

FDSFCA_USER

Yes

Authentication User Email.

Salesforce Password

FDSF

FDSFCA_PASSWORD

YesFDSF_SANDBOX

No

The Salesforce password for Salesforce User.

If you are using a security token, paste the 25-digit token value to the end of your password.

If you don't know the security token, see http://salesforce.stackexchange.com/questions/95259/where-is-reset-security-token-option-in-salesforce

Sandbox name

JWT Key File

FDSFCA_SERVER_KEY_FILE

No

The name of a sandbox to access, or leave blank to access the production organization.

The sandbox is automatically appended to the user name if forgotten.

Salesforce HTTPS protocolFDSF_HTTPS_PROTOCOLNoThe HTTPS protocol to use to secure the connection. Defaults to TLSv1.2.Salesforce API VersionFDSF_API_VERSIONNo

The Salesforce API version to target.

This Default will likely change with each FlexDeploy server and Saleforce plugin release in the future.

The maximum supported version of Salesforce API that is supported is linked to the version of FlexDeploy currently running.

Path to a file containing the private key

Client Id

FDSFCA_CLIENT_ID

No

OAuth client ID (sometimes called the consumer key)

Development Org Type

FDSFCA_ORG_TYPE

No

Enter Org type for Development Environment. Eg: Sandbox or DevHub or Developer

Salesforce URL

FDSFCA_URL

No

The login URL of the instance the org lives on

Sandbox Name

FDSFCA_SANDBOX

No

The name of a Sandbox to access

Project Properties

Property Name

Property Code

Required

Description

Granular Salesforce Object Types

FDSF_GRANULAR_DEPLOYMENT_OBJECTS

No

Salesforce Object Types to be used with granular support. Values are separated by commas. As of now the supported object for this is Custom Labels. 

Each custom label will be a separate file when pull from Salesforce and stored as an individual file in the SCM (GIT repository). During the build, the individual files will be merged and will generate a new file with all the custom labels. 

Inputs

Input Name

Input Code

Required

Description

Outputs

Output Name

Required

Description

Package Name(s)

FDSF_PACKAGE_NAME

No

Package Name(s) to build. Separate Package Names with commas.

Generate Package XML

FDSF_INP_GENERATE_PACKAGE_XML

No

Determine if package.xml is to be generated in Full Build operation. Ignored in Partial Deployment projects

Default value is true

Artifacts

This operation produces artifacts that will be stored in the artifacts repository.

...

This operation will select all available endpoints associated to the environment/instanceTarget.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Special Considerations

Currently, when using Partial Deploy, some objects show up as two separate files in the file listing screen. If building from SCM, users must select both of them for the deployment to succeed. If building from Salesforce, or using the Full Deployment model, this is unnecessary.