Att tänka på vad gäller Salesforce CLI för uppmaningsmallar

Vad är Salesforce CLI?

Salesforce CLI är ett kommandoradsgränssnitt som förenklar utveckling och automatisering när du arbetar med din Salesforce-organisation. Du kan använda den för att synkronisera metadata mellan din organisation och ett lokalt DX-projekt som lagras i ett källarkiv som GitHub.

För att ladda ner Salesforce CLI, klicka här. Se Konfigurationsguide för Salesforce CLI för detaljerad dokumentation.

Använd Salesforce CLI med uppmaningsmallar

Uppmaningsmallar representeras i en organisation med metadatatypen GenAiPromptTemplate. Använd standardkommandon för Salesforce CLI för att distribuera och hämta specifika GenAiPromptTemplate mellan ditt DX-projekt och din organisation.

Distribuera:

sf project deploy start --metadata GenAiPromptTemplate:TemplateName --target-org myorg@username.com

Hämta:

sf project retrieve start --metadata GenAiPromptTemplate:TemplateName --target-org myorg@username.com

Ersätt TemplateName med namnet på din uppmaningsmall och myorg@username.com med ditt organisations unika användarnamn eller alias.

Mer information om project och andra CLI-kommandon som du kan använda finns i Salesforce CLI Kommandoreferens.

Aktivera och inaktivera uppmaningsmallar

• Du kan använda <versionIdentifier> <activeVersionIdentifier> för att aktivera en mall, eller så kan du aktivera en mall i användargränssnittet och hämta den för korrekt XML.
• Om en mall används, blockera inaktivering av en version om inte en annan version är aktiverad.
• Om en uppmaningsmallversion publiceras och inte används kan alla versioner aktiveras eller inaktiveras.
• Om en mall inte används tillåts versionsinaktivering utan att en annan version behöver aktiveras.

Skapa nya uppmaningsmallar

• När du har lagt till en ny mall, hämta mallen eftersom <versionIdentifier> skapas automatiskt efter att versionen har skapats.
• När du har en mall med <versionIdentifier> och <activeVersionIdentifier> kan du distribuera den till en annan organisation. VersionIdentifier säkerställer att du inte behöver distribuera eller hämta den för alla organisationer i CI/CD-pipelines.

Ta bort uppmaningsmallar

• Uppmaningsmallar kan inte tas bort via CLI.
• Uppmaningsmallversioner kan tas bort med CLI. När den tas bort tas den bort från versionen i XML.
• En mallversion kan tas bort från XML och distribueras via CLI. Den borttagna versionen tas bort i målorganisationen om inte den versionen är aktiv och används.
• Om en mall används med en aktiv version kan den inte tas bort.

Distribuera uppmaningsmallar

• Du måste ha minst 1 mallversion för att distribuera mallen.

Distribuera endast den aktiva mallversionen

En inställning i Inställningar under Einstein styr om endast den aktiva uppmaningsmallversionen distribueras via CLI. Denna inställning är inaktiverad som standard.

När denna inställning är aktiverad följer distribueringen dessa regler.

• Endast den aktiva versionen av varje mall distribueras till målorganisationen. Alla inaktiva versioner hoppas tyst över.
• Om en mall inte har någon aktiv version misslyckas distribueringen med ett fel.
• Befintliga versioner i målorganisationen tas aldrig bort. Distribuering är endast tillägg.
• Om den aktiva versionen redan finns i målorganisationen gäller dessa villkor.
  • Om versionen har utkaststatus uppdateras innehållet och versionen aktiveras.
  • Om versionen publiceras ändras inte innehållet (publicerade versioner är oföränderliga). Endast aktiveringsstatusen ändras.
• Om den aktiva versionen inte finns i målorganisationen skapas och aktiveras en ny version.
• Om mallen inte finns i målorganisationen skapas en ny mall med endast den aktiva versionen.
• Denna inställning gäller inte för scenarion för hanterade paket.

Om denna inställning är inaktiverad gäller standardbeteendet.

• Alla versioner distribueras som de är idag. Ingen ändring i beteende.

Ändra uppmaningsmallar

• Om en uppmaningsmallversion publiceras och inte används kan den inte ändras.
• Ingen publicerad version kan ändras. Distribueringen lyckas och publicerade versioner hoppas över.
• Om du manuellt anger <versionIdentifier> och har duplicerat den kommer de nya och gamla versionerna att skriva över varandra om de har utkaststatus. Annars stannar den första publicerade versionen och den andra hoppas över, eftersom publicerade versioner är oföränderliga.

Andra saker att tänka på

• Om en mall har åsidosatts får användare inte åsidosätta den igen med en ändringsanvisning, CLI eller Connect API.