Creating and Deploying Changes
Last updated
Was this helpful?
Last updated
Was this helpful?
The deployment process allows you to quickly and safely transfer new developments from your sandbox instance to a production instance. In this article, we'll go over how to perform the deployment operation in the ARM application.
Log in to your ARM account.
Click on the Deployment module.
Click on New Deployment.
On the New Deployment page, choose the basic parameters of your deployment, including the source org from which you'll be retrieving output and the destination org from which you'll be deploying the retrieved components.
Give your deployment a name.
Choose the deployment method from the Deployment From dropdown to carry out the deployment. There are approx. 10-14 different deployment ways to carry out your deployment in the ARM application.
Choose the Metadata Type(s). This allows you to deploy the entire Salesforce Org, Full Profiles, or Permission Sets.
Full Profiles fetches all the profiles available in the selected source.
Full Permission Sets fetches all the permission sets from your selected source.
Select your Destination Org.
Choose the Deployment Type:
Selective Deployment is a deployment in which only the metadata types you’ve selected are deployed from the source org to the destination org.
Full Deployment transfers all metadata types in the source org to the destination org. However, a few metadata types, such as dynamic package XML files, can’t be retrieved in this process. In this case, the irretrievable data types will generate warnings during deployment, but ARM will continue the deployment and transfer the retrievable metadata types.
This section lets you control how the profile settings and permissions are passed on from the source org during the deployment. Remember that in API version 40.0 and later, when the user deploys retrieved permission set output from one org to another, the metadata in the deployment replaces the target org metadata. In API version 39.0 and earlier, the deployment contents are merged with the current org data.
Deploy Profile Access Settings for selected components only: Select this check box to refactor the profile settings based on the selected components. Refactored profiles are deployed along with the selected components.
Once you're done with the initial setup for your deployment, click on Retrieve Metadata. You'll be redirected to the metadata selection screen, which allows you to select the metadata components for deployment. You can also use the search filter to find particular metadata types quickly.
The selected components will be listed under the Selected Items tab.
Note: Salesforce does not display inactive custom metadata components so they will not be displayed in the deployment list of metadata components. If inactive metadata components are required for the deployment, please refer to the following steps:
Activate Inactive Components: If certain components are required for deployment but are currently inactive, consider activating them in the latest Salesforce account if the option is still available, before initiating the deployment process. This can ensure that all necessary components are included in the deployment.
Consult Salesforce Documentation: For more specific guidance and troubleshooting, refer to the Salesforce documentation on metadata deployment. The documentation provides detailed information on deployment settings, component visibility, and best practices for deploying metadata. However, it is important to note that the specific behavior of inactive custom metadata not being visible may be consistent with Salesforce's intended design, even though it is not explicitly mentioned in the documentation. Please note that the specific steps and solutions may vary depending on your Salesforce setup and configuration. It is recommended to consult your Salesforce administrator or support team for assistance tailored to your specific scenario.
Once you’ve chosen the metadata members to include in the deployment, select one of the two options at the bottom of the page:
Deploy: This option will immediately deploy to the destination org.
Compare Metadata & Deploy (recommended): This option allows you to compare the metadata members between the two sources before you proceed with the deployment.
On this screen, you will be presented with a list of metadata types and their respective member lists.
Deployment via Salesforce Org Further expanding the member's list will allow you to view the members' dependent components, and selecting them means deploying the dependent components to the destination org.
The Diff tab will indicate if there are any differences between the members from the source and the target org.
Clicking on the difference icon in the right column will display a new page with details of the differences between the orgs. You will have the option to download the log from this page. If the difference report contains more than 10,000 lines, it is best practice to download the report first and view its changes.
When you have determined which metadata members to include in the deployment, click the checkbox next to each member to select it, and then click the Deploy button. It will take you to the Deployment Settings page.
Ignore warnings
When this filter is checked, metadata types that trigger warnings during the retrieval process will not cause the deployment to fail, and ARM will deploy all other metadata types as possible.
Validate only
Checking this option will validate and save the deployment label without actually executing the deployment. The label can then be used later for a Quick Deploy if the target org is a production environment against which the validation was done
Take backup
This option creates a backup of the original state of the metadata to which you can revert if the deployment fails or has other functional issues. This option will not be visible for "deployment via Vlocity components".
Ignore missing visibility settings (profiles)
With this option, differences in visibility settings between the source and destination orgs will not cause the deployment to fail. ARM will compare the source and destination orgs and keep only the common settings between both orgs. Standard fields are not supported for this option.
Remove Login IP Ranges
This option will remove IP ranges from your profile while deploying
Remove System and User Permissions
Remove the user's permission from your profile while deploying.
Do not include 'Destructive members'
Ignore installed components
When selected, ARM will scan for the components that are deployed, and if there are any managed package components located in the target org, these components will be excluded from the metadata.zip files while the remaining components are deployed.
Fetch Wavexmd components
Upon selection, this checkbox will allow you to select the respective wavexmd files belonging to the wave dashboard metadata type and deploy them via selective deployment to another Salesforce Org. This checkbox will be hidden if the WaveDashboard metadata type or its corresponding members are not picked. Note: This feature is currently applicable only for the following deployment methods:
Deployment via Salesforce Org
Deployment via Package XML
Deployment via Previous Deployment Labels
Static Code Analysis (SCA): Choose the SCA tool to detect bugs, code smells, and security vulnerabilities before the deployment begins.
SCA Supported Metadata Types:
For ApexPMD, Checkmarx, SonarQube: Apex Classes, Apex Triggers, Apex Pages, AuraDefinitionBundle, LightningComponentBundle.
For Codescan: ApexClasses, ApexPages, ApexTriggers, AuraDefinitionBundle, CustomObjects, Flow, LightningComponentBundle, PermissionSets, Profiles, Settings, SharingRules, Workflows.
Also, you can select the recipients for the alert under the SCA Mail Notifications field. Multiple recipients can be added here.
Fetch the Test Cases: Before running the deployment, you may like to run the functional test cases to test the code's functionality being deployed to the Destination Environment. Therefore, select how you would like to fetch the test cases.
Deployment Notes: In the Deployment Notes box, specify the reason for the deployment and what has changed across your Salesforce Org.
The next screen is the Deployment Summary page, where you can view the components one final time before deployment.
You won't be able to deploy the code to the target org if all of the profile objects in the package have access permissions set to "false." It's not an ARM issue; it's a Salesforce behavior.
Change the access permission to "True" in all profile objects and deploy to fix the problem; it should now work.
Please go to Admin->My account-> Salesforce Settings->Included Metadata Types, and check if the Report and Report Type are included in the Salesforce Settings. If these are not included, please include them to see them during the metadata selection for deployment.
Select your Source Org/.
The Metadata Filter section allows you to specify filters limiting the included in your deployment. You can enter filter parameters here or leave these fields blank if they do not apply.
You’ll see the list of metadata components in your target org but not in your source under the Destructive Items tab. Check the box next to a component you want to delete, and it will be deleted when you deploy. For a detailed explanation of destructive changes, refer to the article: .
If there are no differences, the right column will display theicon for each member.
If there are any differences, the right column will display theicon.
On the Deployment Settings page, you will be presented with a list of filters to use in the :
Select this checkbox if you have configured certain metadata types to skip while deploying. You can configure such metadata types under the Admin > page
Apex Test Level: Next, choose the Apex unit test level to validate your deployment. To know more about Apex tests, please refer to the article: .
You can stop the deployment if the SCA doesn't meet the criteria set globally. Go to My Account > to set the global configuration for your SCA tool.
If you have created the search and substitute rules to define custom find and substitute rules that ARM applies whenever you commit and deploy files from one Sandbox to another Sandbox, one Sandbox to Version Control, or vice-versa, such rule can be found here.
From the Apply Search and Substitute Rules list, select the rule that will be associated with the current deployment process. Use the/button to add/remove the rule and using the/button, move the rules list up and down. Based on the selection, the top rule will be deployed initially, and the process will continue for the remaining rules.
Click on Validate Deployment. You will be redirected to the screen, showing the deployment progress.
