DX Scratch Org Operations

Updated 7 months ago by Jesus Gaviria

Get Org Details

You will be able to see relevant information about the Scratch Org such:

  • Connected Status
  • Instance URL
  • Org Id
  • Username

Generate Password

With this you will be able to generate a password which can be used with the Security token if the metadata needs to be retrieved to an IDE.

Open Scratch Org

Use this button to access right away to your Scratch Org and start making changes. 

Delete Scratch Org

This will remove the Scratch Org from your Hub and will remove all the related records on Copado (Org Credential, Environment, Git Snapshot, Deployment Flow Step).

Commit History

You can easily check latest 10 commit that are related to the selected user story.

Extensions

Configure your scratch org beyond definition file. Load Data, Metadata and all other operations that Copado Deployment offers.

In order to know more about creating deployment go to Creating a deployment article.

In order to know more about deployment step go to Deployment Steps article.

Load Metadata 

Copado DX allows different ways to load metadata into scratch org such as; Git Artifact, Package Artifacts, Patch & Release, Branch and Metadata.

In order to know more about metadata source options go to Metadata Source Options article.

How to load metadata by using Git Artifact:

  • Select the Project Template from drop down list. It will populate Org Credentials which are related to selected Project Template and have artifacts.
  • Select the Org Credential from drop down list. It will populate Artifacts.
  • Select one or more Artifacts from multi select list. Metadata of the selected artifacts will be loaded in Preview Artifact Metadata.
  • Click on Load Metadata button.

How to load metadata by using Package Artifact:

  • Select the Project Template from drop down list. It will populate Org Credentials which are related to selected Project Template and have artifacts.
  • Select the Org Credential from drop down list. It will populate Artifacts.
  • Select one or more Artifacts from multi select list. Metadata of the selected artifacts will be loaded.
  • Click on Load Metadata button.

How to load metadata by using Patch & Release:

  • Select the Release by using lookup icon. Tags will be loaded.
  • Select the Tag from Select Tag panel.
  • Select the Tag Format from drop down list. 
  • Click on Load Metadata button.

How to load metadata by using Branch:

  • Select the Repository by using lookup icon. Branches will be loaded.
  • Select the Branch from Select Branch panel.
  • Select the Branch Format from drop down list. 
  • Click on Load Metadata button.

How to load metadata by using Metadata:

  • Select the Org Credential from drop down list. All metadata of selected org credential will be loaded.
  • Click on Load Metadata button.

Org Status

Whenever a Scratch Org is created by associating it to a deployment flow, Copado will create the necessary records so developers can commit right away to the User Stories related.

If Metadata is loaded to a Scratch Org that is part of a Deployment Flow, Two new kind of branches will be created by Copado:

  • project/DX-123456789012: This Branch will appear on the Git Snapshot Record and will be also referenced in the Deployment Flow Step, this will contain the committed Metadata of all User Stories related to the parent Scratch Org
  • project/DX-123456789012-remote: This Branch will be used to calculate Org differences, and it will contain always the Metadata that can be retrieved from a SFDX pull command.

When Calculating the Org Status, Copado will use these two branches to be able to detect Remote Add, Remote Changed and Remote Deleted Metadata, that can be auto selected later whenever committing into a User Story.




How did we do?