Pakkevurderinger for ledetekstmaler

Opprette pakker

• Ledetekstmaler som inkluderer en flyt med inndata fra et tilpasset objekt, kan føre til at pakkeinstalleringen mislykkes fordi pakking av ledetekstflyter med tilpassede objekter ikke støttes.
• Inkluder bare publiserte versjoner. Utkastversjoner kan legges til i pakken, men de installeres ikke i kundeorganisasjoner for administrerte pakker.
• Eventuelle fremtidige endringer i en publisert versjon hoppes over under oppgraderingen uten feil.
• Hvis en publisert versjon er aktiv og er forskjellig fra den gjeldende versjonen, aktiveres den automatisk i kundens organisasjon.
• Hvis ingen versjoner er publisert, pakker du ikke malen. Hvis du pakker en mal uten en publisert versjon, mislykkes eventuell installering eller oppgradering på grunn av en tom mal.
• Ledetekstmaler med tilpassede modeller kan ikke pakkes.
• Hvis du inkluderer en Apex i en ledetekstmal og pakker den, må klassen være global.
• For ikke-administrerte, ulåste eller administrerte pakker bør du unngå pakkemaler som overstyrer forhåndsdefinerte OOTB-maler. Pakkede maler kan eventuelt konfigureres som overstyrbare, slik at abonnenter kan opprette lokale versjoner av malen.
• Hentere som Datasøk og Datagrafer er ikke inkludert i pakkene. I stedet er de en del av et datasett i Data 360. Salesforce uavhengige programvareleverandører (ISV-er) oppfordres til å gi henter til kunden, ellers mislykkes installeringen på grunn av manglende metadata.
• Nye versjoner kan legges til i en eksisterende mal, men tidligere publiserte versjoner kan ikke endres eller slettes. For maler som kan overstyres, kan abonnenter opprette flere overstyringsversjoner som tilpasser den pakkede malen.
• Nye versjoner kan aktiveres, og gamle versjoner kan deaktiveres. Hvis en abonnent aktiverer en overstyringsversjon, prioriteres denne versjonen foran publiseringens aktive versjon.
• Kunder kan ikke redigere pakkede maler direkte.Men hvis publiseringen aktiverer maler som kan overstyres, kan kunder opprette en ny versjon som overstyrer den pakkede malen. Kunder kan også klone malen for å opprette en uavhengig tilpasset mal.
• En mal uten aktiv versjon kan leveres, men kunder kan ikke bruke den før en versjon er aktivert. Kunder kan klone malen for å opprette en uavhengig tilpasset mal, eller hvis malen er konfigurert som overstyrbar, kan de opprette en lokal overstyringsversjon.
• Tillatelsen BehandlePromptTemplates må tildeles når du oppretter pakkeversjoner av andre generasjon (2GP). Denne snutten kan brukes i sfdx-project.json til å angi tillatelsen som skal tildeles til byggbrukeren når organisasjonen opprettes og pakken bygges.

  {
                          "packageDirectories": [{
                          "versionName": "ver 0.2",
                          "versionNumber": "0.2.0.NEXT",        
                          "path": "force-app",
                          "default": true,
                          "package": "Prompt Template 2GP Pkg",
                          "versionDescription": "",
                          "definitionFile": "config/project-scratch-def.json",
                          "packageMetadataAccess": {
                          "permissionSets": [
                          "EinsteinGPTPromptTemplateManager"
                          ]
                          }
                          }],
                          "name": "managed",
                          "namespace": "NAMESPACE",
                          "sfdcLoginUrl": "https://login.salesforce.com",
                          "sourceApiVersion": "63.0"
                          }          

Installere og oppgradere installerte ledetekstmaler

• Hvis Legg til eller krev inndata etter aktivering ikke er aktivert i Einstein og du endrer inndata mellom malversjoner, mislykkes pakkeinstalleringen med feilmeldingen: 'Denne appen kan ikke oppgraderes.'
• Før du installerer eller oppgraderer en pakke i produksjonsorganisasjonen, må du teste installering eller oppgradering i Sandbox og teste.
• Kunder kan ikke deaktivere en versjon etter installering eller oppgradering.
• Du kan ikke overskrive en publisert ledetekstmalversjon.
• Hvis meldingsmalmodellen er skjult, fungerer den eksisterende malen som den skal. Men hvis malen klones, blir ikke modellen tilgjengelig for bruk.
• For aktive versjoner aktiverer du dem automatisk i kundeorganisasjonen. Test alltid endringer i Sandbox-organisasjoner før du installerer eller oppgraderer en pakke.
• Einstein Generative AI må aktiveres for installasjon av pakker med ledetekstmaler, ellers mislykkes installeringen.
• Flyter aktiveres ikke automatisk når en pakke installeres. Flyter følger standardaktiveringsprosessen for administrerte pakker som er etablert.
• Partnere kan deaktivere en mal. Men hvis denne malen brukes for kunden, mislykkes oppgraderingen. For å oppgradere pakken må kunder fjerne denne malen fra bruk.
• Hvis du pakker en mal med en tilpasset LLM-modellkonfigurasjon, kontrollerer du at kundeorganisasjonen har en modell med samme navn, ellers mislykkes installeringen eller oppgraderingen.
• Tilpassede felt på Lightning som er aktivert med dynamiske skjemaer, kan referere til ledetekstmaler. Hvis du installerer en administrert pakke som inneholder en ledetekstmal som det refereres til av et tilpasset felt på en Lightning som er aktivert med dynamiske skjemaer, og denne ledetekstmalen refererer til et tilpasset felt med et navneområde som er forskjellig fra Lightning navneområde, kan pakkeinstalleringen mislykkes.

Slette installerte ledetekstmaler

• Versjoner kan ikke slettes fra en administrert mal.
• En administrert mal kan slettes fra en 2GP-pakke, men den slettes ikke i kundens organisasjon. Kunder ser de forhindrede malene og har mulighet til å slette dem.

Overstyrbare ledetekstmaler

Udgivere kan konfigurere pakkede ledetekstskabeloner til at være overstyrbare. Når en mal kan overstyres, kan abonnenter opprette lokale versjoner av malen og tilpasse ledeteksten eller konfigurasjonen. Selv om disse tilpassede versjonene er knyttet til malen, forblir de separate. Eventuell oppdatering av den publiserte versjonen påvirker ikke de tilpassede versjonene.

Abonnentoverstyringsversjoner vises i versjonsvelgeren sammen med publiseringsadministrerte versjoner. Hvis en abonnent aktiverer en overstyringsversjon, blir denne versjonen den aktive versjonen i abonnentorganisasjonen. Men aktivering av overstyringen deaktiverer ikke den pakkede versjonen, pakkeversjonen aktiveres automatisk. Denne virkemåten beholder flyter, spesielt pakkede, som kan avhenge av at malen er aktiv.

Publiseringsversjoner forblir administrert av pakken og fortsetter å motta oppdateringer via pakkeoppgraderinger.

Viktige punkter om partnere

• Hvis du vil tillate at en mal kan overstyres, bruker du <overridable>true</overridable>.
• Når innstillingen for en mal som kan overstyres, er sann og installert i kundeorganisasjonen, kan ikke innstillingen angres. Oppgraderingen mislykkes med en feil.
• Sletting av en pakket mal fra en pakke merker den som slettet i kundeorganisasjonen. Hvis en kunde sletter denne malen og malen ikke brukes, slettes også kundens overstyringer.
• Abonnenter kan bruke alternativet Lagre som ny versjon til å overstyre malen.
• Hvis den tilpassede versjonen er aktiv og malen brukes, kan den ikke slettes.
• Hvis den tilpassede versjonen er aktiv, brukes malen, men det er en aktiv administrert pakkeversjon, vil deaktivering av den tilpassede versjonen falle tilbake til den versjonen.
• Hvis den tilpassede versjonen er aktiv, brukes malen, men det ikke er noen aktiv administrert pakkeversjon, vil deaktiveringen mislykkes.
• Alternativet Maloverstyringer i Ledetekstbygger vises bare i organisasjoner med et navneområde.
• Når du kloner en mal som kan overstyres, kan ikke den klonede malen overstyres. Angi eksplisitt den nye malen som overstyrbar.