generateComparisonReport
@since 5.7.0.1
The operation generates the Comparison report as PDF and adds it to the execution reports tab. Compares the package version artifact against the Salesforce Org and generates a report with all the differences. This operation can be used in Build, PreDeploy, Deploy, or Utility workflow.
The typical use case would be generating a report as part of preDeploy to generate the report for the Salesforce Org that the package getting deployed to. So that users can review and approve the change to complete the deployment. You can use it after building the package version artifact in the build workflow by specifying the input of Salesforce Org accounts. So that it will generate a report for each Salesforce Org selected.
The report generates the following Pages:
Summary page with package details and summary of counts indicated total, new, and modified objects.
Count of New and Modified objects for each Object Type that is part of the packaged artifact.
List of New Objects (if new objects are part of packaged artifact)
List of Modified Objects (if modified objects are part of packaged artifact)
Changes for each modified object (if modified objects are part of packaged artifact)
Please note that if you have sub-components in the package, it will compare to the full object file in this version. When you read the report consider only your sub-component section in the Changes (#5 above) section.
Environment/Instance Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Salesforce Account Code |
| Yes | Salesforce Account with all the required properties like User, Password, Client Id, etc. |
Cloud Account Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Salesforce User Email | FDSFCA_USER | Yes | Authentication User Email. |
Salesforce Password | FDSFCA_PASSWORD | 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 |
JWT Key File | FDSFCA_SERVER_KEY_FILE | No | 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 |
|---|---|---|---|
|
|
|
|
Inputs
Input Name | Input Code | Required | Description |
|---|---|---|---|
Salesforce Account Code |
| No | Multi-Select input to generate a report for specified accounts instead of environment’s Salesforce Org. If not provided, it gets the Salesforce Org from the environment’s property. |
Outputs
Output Name | Required | Description |
|---|---|---|
FDSF_OUT_OBJECTTYPE_COUNT | No | Count for each Object type. It contains new and modified count for each object type that is in the package. It returns in the list format: [[ObjectType1, NewCount, ModifiedCount],[ObjectType2, NewCount, ModifiedCount],[ObjectType3, NewCount, ModifiedCount]] eg: [[ApexClass, 1, 0]] |
FDSF_OUT_NEW_OBJECTS | No | List of new objects |
FDSF_OUT_MODIFIED_OBJECTS | No | List of Modifid objects |
FDSF_OUT_NEW_COUNT | No | Total new objects count. |
FDSF_OUT_MODIFIED_COUNT | No | Total modified objects count. |
Artifacts
This operation consumes artifacts from the artifacts repository.
Endpoint Selection
This operation will select all available endpoints associated with the environment/instance.
Endpoint Execution
This operation will execute on any one of the selected endpoints and will be random in the determination of which one.
- style