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>
Parameter¶
nameGibt 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_channelGibt 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.
SETGibt 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_numLegt 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_numErstellt 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.
UNSETGibt 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_directiveEntfernt 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;
+---------------------------------------------------------------------------------------------------------+
| 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;
+---------------------------------------------------------------------------------------------------------+
| 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);
+---------------------------------------------------------------------------------------+---------+-------+
| status | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| TBD | | |
+---------------------------------------------------------------------------------------+---------+-------+