crm-journal-utilities

Package containing journal functionality for subitting documents to JOARK. Delivers generic functionality for viewing and actors cases with NAV and posting them to the archive via i.e. flow.

Dependencies

This package is dependant on the following packages

• crm-platform-base

Installation

1. Install npm
2. Install Salesforce DX CLI
   • Alternative: npm install sfdx-cli --global
3. Clone this repository (GitHub Desktop is recommended for non-developers)
4. Run npm install from the project root folder
5. Install SSDX
   • Non-developers may stop after this step
6. Install VS Code (recommended)
   • Install Salesforce Extension Pack
   • Install recommended plugins! A notification should appear when opening VS Code. It will prompt you to install recommended plugins.
7. Install AdoptOpenJDK (only version 8 or 11)
8. Open VS Code settings and search for salesforcedx-vscode-apex
9. Under Java Home, add the following:
   • macOS: /Library/Java/JavaVirtualMachines/adoptopenjdk-[VERSION_NUMBER].jdk/Contents/Home
   • Windows: C:\\Program Files\\AdoptOpenJDK\\jdk-[VERSION_NUMBER]-hotspot

Build

To build locally without using SSDX, do the following:

1. If you haven't authenticated a DX user to production / DevHub, run sfdx auth:web:login -d -a production and log in
   • Ask #crm-platform-team on Slack if you don't have a user
   • If you change from one repo to another, you can change the default DevHub username in .sfdx/sfdx-config.json, but you can also just run the command above
2. Create a scratch org, install dependencies and push metadata:

sfdx force:org:create -f ./config/project-scratch-def.json --setalias scratch_org --durationdays 1 --setdefaultusername
echo y | sfdx plugins:install sfpowerkit@2.0.1
keys="" && for p in $(sfdx force:package:list --json | jq '.result | .[].Name' -r); do keys+=$p":PACKAGE_KEY "; done
sfdx sfpowerkit:package:dependencies:install -u scratch_org -r -a -w 60 -k ${keys}
sfdx force:source:push
sfdx force:org:open

Build

Development in scratch should be done using the JOURNAL_UTILITIES lightning app in the scratch-org folder. After scratch creation it is recommended to run

npm run activateMock

To activate the mocking framework in ApiController.

Other

Questions? Ask on #crm-platform-team on Slack.