ALTER APPLICATION PACKAGE … MODIFY RELEASE CHANNEL

Modifie les canaux de version définis pour un paquet d’application existant. Utilisez cette commande pour modifier un canal de version, modifier la version ou le correctif attribué à un canal de version, ou définir la directive de version d’un canal de version.

Note

La syntaxe de cette rubrique ne s’applique qu’aux paquets d’application qui utilisent des canaux de version. Pour plus d’informations, voir Publier une application à l’aide des canaux de version. Pour définir la directive de version d’un paquet d’application qui n’utilise pas de canaux de version, voir ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE.

Voir aussi :

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

Syntaxe

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

Paramètres

name

Spécifie l’identificateur pour le paquet d’application. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

MODIFY RELEASE CHANNEL release_channel

Spécifie le canal de version auquel s’applique cette directive de version. Si non spécifié, la directive de version s’applique à tous les canaux de version.

Les valeurs prises en charge sont les suivantes :

  • ALPHA

  • QA

  • DEFAULT

Pour plus d’informations sur les canaux de version, voir Publier une application à l’aide des canaux de version.

VERSION = version_identifier . PATCH = patch_num

Modifie la version et le niveau de correctif de la directive de version personnalisée spécifiée.

SET

Spécifie une ou plusieurs propriétés à définir pour le paquet d’application, séparées par des espaces, des virgules ou de nouvelles lignes. Pour plus de détails sur les propriétés que vous pouvez définir, voir CREATE APPLICATION.

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

Définit la version et le niveau de correctif du paquet d’application qui doit être installé par défaut pour les consommateurs.

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

Crée une directive de version personnalisée pour les comptes spécifiés.

Utilisez la clause ACCOUNTS pour spécifier la liste des comptes auxquels s’applique cette directive de version.

Utilisez les clauses VERSION et PATCH pour spécifier l’identificateur de version et le numéro de correctif à installer pour ces comptes.

UPGRADE_AFTER = 'timestamp'

Spécifie la date et l’heure de début du processus de mise à niveau automatique. Les consommateurs peuvent mettre à jour manuellement une application vers une nouvelle version ou un correctif avant cette date.

Cette valeur peut correspondre à n’importe quel format de date et d’heure valide.

UNSET

Spécifie une ou plusieurs propriétés et/ou un ou plusieurs paramètres de session à désactiver pour le paquet d’application, ce qui les réinitialise aux valeurs par défaut.

UNSET RELEASE DIRECTIVE release_directive

Supprime la directive de version personnalisée spécifiée du paquet d’application.

Notes sur l’utilisation

  • La modification de la directive de version nécessite le privilège OWNERSHIP sur l’application ou le privilège global MANAGE VERSIONS.

  • Si vous ne spécifiez pas les valeurs des propriétés facultatives, la commande utilise les valeurs spécifiées dans le fichier manifeste de l’application.

  • Si vous spécifiez des valeurs pour les propriétés dans la commande et dans le fichier manifeste de l’application, les valeurs spécifiées dans la commande sont prioritaires.

Exemples

L’exemple suivant ajoute la version V1 sur le canal de version par défaut :

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                       |
+---------------------------------------------------------------------------------------------------------+

L’exemple suivant modifie la directive de version par défaut du canal de version par défaut pour définir la version sur V1 et le correctif sur 0 :

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                                                                                   |         |       |
+---------------------------------------------------------------------------------------+---------+-------+