crm-nks-base

Arbeidsflyt

All utvikling av ny funksjonalitet gjøres i separate feature branches. Ved merge til master i dette repositoriet vil det automatisk genereres en pakkeversjon som installeres i følgende sandboxer:

• NKS
• SIT

Dependencies

Pakken er avhengig av følgende pakker:

• crm-platform-base
• crm-platform-access-control
• crm-arbeidsgiver-base
• crm-nks-integration

Funksjonelt oppsett

Det er noen viktige elementer som må sette opp korrekt for at funksjonalitet for NKS skal fungere som den skal.

• Opprettelse av nødvendige delingsregler for Case og LiveChatTranscript for å dele alle records med NKS veiledere
• Assignment til public group NKS Veiledere.
  • Dette er viktig da de nevnte delingsreglene deler all data med medlemmer av denne gruppen såfremt dataen ikke inneholder sensitiv informasjon om sosiale tjenester
• Oppdatering av custom setting Access Token Scope med riktige scopes for APIene man ønsker å sette opp (f.eks Oppgave, og Dokarkiv)
  • Har man tilgang kan f.eks disse finnes for preprod ved å navigere til riktig klient i Azure

Komme i gang

1. Salesforce DX-bruker. Kontakt #crm-plattform-team på Slack om du ikke har dette
2. Installer Salesforce DX CLI (SFDX)
   • Last ned fra Salesforce.com
   • Eller benytt npm: npm install sfdx-cli --global
3. Klon dette repoet (GitHub Desktop anbefales for ikke-utviklere)
4. Installer SSDX
   • Med SSDX kan du lage scratch orger og gjøre deklarative endringer (gjøre endringer i nettleseren på Salesforce, altså ikke-utvikling)
   • Trenger du ikke verktøy utvikling kan du stoppe her
5. Installer VS Code (anbefalt)
6. Installer Salesforce Extension Pack
7. Installer AdoptOpenJDK (kun versjon 8 eller 11)
8. Åpne VS Code Settings og søk etter salesforcedx-vscode-apex
9. Under Java Home, legg inn følgende:
   • macOS: /Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home
   • Windows: C:\\Program Files\\AdoptOpenJDK\\jdk-11.0.3.7-hotspot (merk at versjonsnummer kan endre seg)

Utvikling

Utvikling foregår i hovedsak på to fronter, i nettleseren i din scratch org og på din maskin i din prefererte IDE. Ved endringer i nettleseren på din scratch org (som lever i skyen), så må alle endringer pulles til din maskin. Ved endringer av metadata i din IDE, må endringer pushes til din scratch org.

Ved å bruke VS Code som IDE, er det lagt inn konfigurasjon som automatisk pusher endringer av metadata til din scratch org ved lagring. For å pulle endringer fra kan man enten bruke Salesforce DX CLI til å pulle, men også pushe om man ikke ønsker automatisk push. Se under for kommandoer. Man kan også bruke hjelpeverktøyet SSDX (nevnt over) for å pushe, pulle, åpne scratch org-er, slette gamle, blant annet.

• sfdx force:org:open for å åpne instansen(salesforce applikasjonen din).
• sfdx force:source:pull for å hente endringer som du gjør i konfigurasjon i applikasjonen online.
• sfdx force:source:push for å publisere endringer du gjør i kode lokalt til applikasjonen online.

Scratch oppsett

For å gjøre utvikling og testing enklere så er det lagt inn en del metadata under force-app\scratch-org. Metadataen består av permissions, apps og flexipages som gjør innholdet lettere tilgjengelig sånn at man slipper å sette opp dette hver gang man spinner opp en scratch org.

Innholdet pushes og pulles til/fra scratch orgen på samme måte som annen metadata. Denne mappen slettes når vi bruker github actions for å lage pakker.

Annet

For spørsmål om denne applikasjonen, bruk #crm-nks på Slack.