Überlegungen zu Salesforce CLI für Aufforderungsvorlagen

Was ist Salesforce CLI?

Salesforce CLI ist eine Befehlszeilenschnittstelle, die die Entwicklung und Erstellung von Automatisierungen bei der Arbeit mit Ihrer Salesforce-Organisation vereinfacht. Sie können damit Metadaten zwischen Ihrer Organisation und einem lokalen DX-Projekt synchronisieren, das in einem Quell-Repository wie GitHub gespeichert ist.

Klicken Sie hier, um Salesforce CLI herunterzuladen. Detaillierte Dokumentation finden Sie im Salesforce CLI Setup Guide.

Verwenden von Salesforce CLI mit Aufforderungsvorlagen

Aufforderungsvorlagen werden in einer Organisation mit dem Metadatentyp GenAiPromptTemplate dargestellt. Verwenden Sie Salesforce CLI-Standardbefehle, um bestimmte GenAiPromptTemplate zwischen Ihrem DX-Projekt und Ihrer Organisation bereitzustellen und abzurufen.

Bereitstellen:

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

Abrufen:

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

Ersetzen Sie TemplateName durch den Namen Ihrer Aufforderungsvorlage und myorg@username.com durch den eindeutigen Benutzernamen oder Aliasnamen Ihrer Organisation.

Weitere Informationen zu den project-Befehlen und anderen CLI-Befehlen, die Sie verwenden können, finden Sie unter Salesforce CLI Command Reference.

Aktivieren und Deaktivieren von Eingabeaufforderungsvorlagen

• Sie können <versionIdentifier> verwenden, <activeVersionIdentifier> eine Vorlage zu aktivieren, oder Sie können eine Vorlage auf der Benutzeroberfläche aktivieren und sie für die richtige XML abrufen.
• Wenn eine Vorlage verwendet wird, blockieren Sie die Deaktivierung einer Version, sofern keine andere Version aktiviert ist.
• Wenn eine Aufforderungsvorlagenversion veröffentlicht und nicht verwendet wird, kann jede Version aktiviert oder deaktiviert werden.
• Wenn keine Vorlage verwendet wird, ist die Versionsdeaktivierung zulässig, ohne dass eine andere Version aktiviert werden muss.

Erstellen neuer Aufforderungsvorlagen

• Rufen Sie nach dem Hinzufügen einer neuen Vorlage die Vorlage ab, da die <versionIdentifier> nach dem Erstellen der Version automatisch generiert wird.
• Wenn Sie über eine Vorlage mit <versionIdentifier> und <activeVersionIdentifier> verfügen, können Sie sie in einer anderen Organisation bereitstellen. Der versionIdentifier stellt sicher, dass Sie ihn nicht für alle Organisationen in CI/CD-Pipelines bereitstellen oder abrufen müssen.

Löschen von Aufforderungsvorlagen

• Aufforderungsvorlagen können nicht über die CLI gelöscht werden.
• Aufforderungsvorlagenversionen können mit der CLI gelöscht werden. Wenn sie gelöscht wird, wird sie aus der Version in XML entfernt.
• Eine Vorlagenversion kann aus der XML gelöscht und über die CLI bereitgestellt werden. Die gelöschte Version wird in der Zielorganisation gelöscht, es sei denn, diese Version ist aktiv und wird verwendet.
• Wenn eine Vorlage mit einer aktiven Version verwendet wird, kann sie nicht gelöscht werden.

Bereitstellen von Aufforderungsvorlagen

• Sie müssen über mindestens eine Vorlagenversion verfügen, um die Vorlage bereitstellen zu können.

Nur die aktive Vorlagenversion bereitstellen

Eine Einstellung unter Setup unter Einstein steuert, ob nur die aktive Aufforderungsvorlagenversion über die CLI bereitgestellt wird. Diese Einstellung ist standardmäßig deaktiviert.

Wenn diese Einstellung aktiviert ist, befolgt die Bereitstellung die folgenden Regeln.

• Nur die aktive Version jeder Vorlage wird in der Zielorganisation bereitgestellt. Alle inaktiven Versionen werden stillschweigend übersprungen.
• Wenn eine Vorlage keine aktive Version aufweist, schlägt die Bereitstellung mit einem Fehler fehl.
• Vorhandene Versionen in der Zielorganisation werden nie gelöscht. Die Bereitstellung ist nur angehängt.
• Wenn die aktive Version bereits in der Zielorganisation vorhanden ist, gelten die folgenden Bedingungen.
  • Wenn sich die Version im Entwurfsstatus befindet, wird der Inhalt aktualisiert und die Version aktiviert.
  • Wenn die Version veröffentlicht wird, wird der Inhalt nicht geändert (veröffentlichte Versionen sind unveränderlich). Nur der Aktivierungsstatus wird geändert.
• Wenn die aktive Version in der Zielorganisation nicht vorhanden ist, wird eine neue Version erstellt und aktiviert.
• Wenn die Vorlage in der Zielorganisation nicht vorhanden ist, wird nur mit der aktiven Version eine neue Vorlage erstellt.
• Diese Einstellung gilt nicht für Szenarien verwalteter Pakete.

Wenn diese Einstellung deaktiviert ist, gilt das Standardverhalten.

• Alle Versionen werden wie heute bereitgestellt. Keine Verhaltensänderung.

Ändern von Aufforderungsvorlagen

• Wenn eine Aufforderungsvorlagenversion veröffentlicht und nicht verwendet wird, kann sie nicht geändert werden.
• Veröffentlichte Versionen können nicht geändert werden. Die Bereitstellung ist erfolgreich und veröffentlichte Versionen werden übersprungen.
• Wenn Sie <versionIdentifier> manuell festlegen und dupliziert haben, überschreiben sich die neue und die alte Version gegenseitig, sofern sich diese Versionen im Entwurfsstatus befinden. Andernfalls wird die erste veröffentlichte Version beibehalten und die zweite übersprungen, da veröffentlichte Versionen unveränderlich sind.

Sonstige Überlegungen

• Wenn eine Vorlage überschrieben wurde, können Benutzer sie nicht erneut mit einem Änderungsset, einer CLI oder einer Connect-API überschreiben.