Skip to content

Latest commit

 

History

History
142 lines (106 loc) · 4.35 KB

dev-tips.md

File metadata and controls

142 lines (106 loc) · 4.35 KB

Developer Tips

Integrate Scratch Org with External Systems.

Integrate your scratch org with test instances of ODR, EMPI, or Filescan Connect Web Service.

Install the needed certificates:

  • Download moh_dev_certs.jks.
  • Go to Setup > Identity > Certificate and Key Management > Create a self-signed certificate dev_cert from Key 4096 and save.
  • Go to Setup > Identity > Identity Provider > Enable. Choose dev_cert and save.
  • Go to Setup > Certificate and Key Management > and click "Import from Keystore"
  • Upload the jks file. Enter "JKS Password" listed in moh-dev-certs.txt

Create the needed Named Credentials

The names of these Named Credentials are CASE SENSITIVE as they are api names that are referenced in code. Please match this carefullly, especially for EMPI as the Label and Name do not match.

Go to Setup > Named Credentials.

Create new Legacy Named Credential "EMPI"

Create new Legacy Named credential "FilescanConnectWs"

  • Label: FilescanConnectWs
  • Name: FilescanConnectWs
  • URL: https://filescan-dev.hlth.gov.bc.ca
  • Certificate to "fcws".
  • Identity Type: Anonymous
  • Athenticaion Protocol: No Authentication needed

Create new Legacy Named Credential "ODR Credentials"

Receive Accuroute Emails on Scratch Org

Receive fax job status emails from the developer instance of Filescan Connect Web Service (filescan-dev.hlth.gov.bc.ca)

Go to Setup > Email Services

Open "FcEmailService" > click "New Email Address", and enter these values:

  • Email Address Name: "FcEmailservice"
  • Email Address: "FcEmailservice"
  • Active: true
  • Context User: "User User" (scratch org user)
  • Accept Email From: (empty)

Save.

Salesforce CLI commands

# Open the org configured as default alias
$ sfdx force:org:open

# Open the org with the given alias.
$ sfdx force:org:open -u temp_org

# Delete the given org.
$ sfdx force:org:delete -u <alias>

# Delete the given org and skip prompt.
$ sfdx force:org:delete -u <alias> -p

# Upload local file changes to scratch org
$ sfdx force:source:push

# Download scratch org changes to local file system
$ sfdx force:source:pull

# List changes between local file system and scratch org.
$ sfdx force:source:status

# List orgs authenticated to SFDX CLI
$ sfdx force:org:list

# display information about an org, including expiration date.
$ sfdx force:org:display [-u alias]

Git commands


# Switch to a branch 
$ git checkout <branch_name>

# Create a new branch and switch to it
$ git checkout -b branch_name 

# Download changes from remote branch to local branch
$ git pull

# See what changes have been staged, which haven’t and which files aren’t being tracked by git
$ git status 

# Displays the last 10 commits made on the current branch.
$ git log --oneline -10

# Reset current branch to match its remote branch. 
$ git clean -fd
$ git reset --hard

Miscellaneous tips

Opens the current directory in Visual Studio Code

$ code .

Pull all recent changes to main, create a new branch for a new ticket, then create a scratch org for it.

$ git checkout main
$ git pull
$ git checkout -b ESA-<ticket number>
$ ./dev-setup.sh

Submit changes for release

Run commands

$ sfdx force:source:pull
$ code .

Use VS Code Source Control panel to carefully inspect changed files.

Stage files to be committed.

Add a commit message. Commit.

Push branch to remote repository.

On the remote repository (github.com), create a pull request from your branch to main.

Wait for “build check” to finish.

Merge feature branch to main.

Delete feature branch.