ALTER APPLICATION PACKAGE … MODIFY RELEASE CHANNEL

Ändert die für ein bestehendes Anwendungspaket definierten Release-Kanäle. Verwenden Sie diesen Befehl, um einen Release-Kanal zu ändern, die Version oder den Patch zu ändern, die einem Release-Kanal zugewiesen ist, oder die Release-Richtlinie für einen Release-Kanal festzulegen.

Bemerkung

Die Syntax unter diesem Thema gilt nur für Anwendungspakete, die Release-Kanäle verwenden. Weitere Informationen dazu finden Sie unter Veröffentlichen einer App über Release-Kanäle. Weitere Informationen zum Festlegen der Release-Richtlinie für ein Anwendungspaket, das keine Release-Kanäle verwendet, finden Sie unter ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE.

Siehe auch:

ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE … VERSION, ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE SHOW RELEASE DIRECTIVES

Syntax

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  SET RELEASE DIRECTIVE <release_directive>
  ACCOUNTS = ( <organization_name>.<account_name> [ , <organization_name>.<account_name> , ... ] )
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
 MODIFY RELEASE CHANNEL <release_channel>
 MODIFY RELEASE DIRECTIVE <release_directive>
 VERSION = <version_identifier>
 PATCH = <patch_num>
 [ UPGRADE_AFTER = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  UNSET RELEASE DIRECTIVE <release_directive>
Copy

Parameter

name

Gibt den Bezeichner des Anwendungspakets an. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

MODIFY RELEASE CHANNEL release_channel

Gibt den Release-Kanal an, für den diese Release-Richtlinie gelten soll. Wenn nicht angegeben, gilt die Release-Richtlinie für alle Release-Kanäle.

Folgende Werte werden unterstützt:

  • ALPHA

  • QA

  • DEFAULT

Weitere Informationen über Release-Kanäle finden Sie unter Veröffentlichen einer App über Release-Kanäle.

VERSION = version_identifier . PATCH = patch_num

Ändert die Version und den Patch-Level der angegebenen kundenspezifischen Freigaberichtlinie.

SET

Gibt eine (oder mehrere) Eigenschaften an, die für das Anwendungspaket festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen). Weitere Informationen zu den Eigenschaften, die Sie festlegen können, finden Sie unter CREATE APPLICATION.

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

Legt die Version und den Patch-Level des Anwendungspakets fest, die standardmäßig für Verbraucher installiert werden sollen.

RELEASE DIRECTIVE release_directive . ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) . VERSION = version_identifier . PATCH = patch_num

Erstellt eine kundenspezifische Freigaberichtlinie für die angegebenen Konten.

Verwenden Sie die ACCOUNTS-Klausel, um die Liste der Konten anzugeben, für die diese Release-Richtlinie gelten soll.

Verwenden Sie die Klauseln VERSION und PATCH, um den Bezeichner der Version und die Patchnummer anzugeben, die für diese Konten installiert werden sollen.

UPGRADE_AFTER = 'timestamp'

Legt das Datum und die Uhrzeit fest, wann der automatische Upgrade-Prozess beginnt. Verbraucher können eine Anwendung vor diesem Datum manuell auf eine neue Version oder einen Patch aktualisieren.

Dieser Wert kann jedes gültige Datums- und Zeitformat sein.

UNSET

Gibt eine (oder mehrere) Eigenschaften und/oder Sitzungsparameter an, deren Einstellungen für das Anwendungspaket aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden.

UNSET RELEASE DIRECTIVE release_directive

Entfernt die angegebene kundenspezifische Freigaberichtlinie aus dem Anwendungspaket.

Nutzungshinweise

  • Für das Ändern der Freigaberichtlinie ist die OWNERSHIP-Berechtigung für die Anwendung oder die globale Berechtigung MANAGE VERSIONS erforderlich.

  • Wenn Sie die Werte für die optionalen Eigenschaften nicht angeben, verwendet der Befehl die in der Manifest-Datei der Anwendung angegebenen Werte.

  • Wenn Sie Werte für die Eigenschaften im Befehl und in der Manifest-Datei der Anwendung angeben, haben die im Befehl angegebenen Werte Vorrang.

Beispiele

Das folgende Beispiel fügt die Version V1 zum Standard-Release-Kanal hinzu:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  ADD VERSION V1;
Copy
+---------------------------------------------------------------------------------------------------------+
| status                                                                                                  |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package                       |
+---------------------------------------------------------------------------------------------------------+

Im folgenden Beispiel wird die Standard-Release-Richtlinie des Standard-Release-Kanals geändert, um die Version auf V1 und den Patch auf 0 zu setzen:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = V1
  PATCH=0;
Copy
+---------------------------------------------------------------------------------------------------------+
| status                                                                                                  |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package                       |
+---------------------------------------------------------------------------------------------------------+
ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL ALPHA
  ADD ACCOUNTS=(PM.CONNECTORS);
Copy
+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| TBD                                                                                   |         |       |
+---------------------------------------------------------------------------------------+---------+-------+