ALTER APPLICATION PACKAGE … MODIFY RELEASE CHANNEL¶

Modifica os canais de lançamento definidos para um pacote de aplicativo existente. Use esse comando para modificar um canal de lançamento, alterar a versão ou o patch atribuído a um canal de lançamento ou definir a diretriz de versão para um canal de lançamento.

Nota

A sintaxe neste tópico se aplica apenas aos pacotes de aplicativo que usam canais de lançamento. Para obter mais informações, consulte Publicar um aplicativo usando canais de lançamento. Para definir a diretriz de versão para um pacote de aplicativo que não usa canais de lançamento, consulte ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE.

Consulte também:: ALTER APPLICATION PACKAGE, ALTER APPLICATION PACKAGE … VERSION, ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE SHOW RELEASE DIRECTIVES

Sintaxe¶

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

Parâmetros¶

name

Especifica o identificador do pacote do aplicativo. Se o identificador contiver espaços, caracteres especiais ou caracteres com letras maiúsculas e minúsculas, toda a cadeia de caracteres deve ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

MODIFY RELEASE CHANNEL release_channel

Especifica o canal de lançamento ao qual esta diretriz de versão se aplica. Se não for especificado, a diretriz de versão se aplica a todos os canais de lançamento.

Os valores aceitos são:

ALPHA
QA
DEFAULT

Para obter mais informações sobre os canais de lançamento, consulte Publicar um aplicativo usando canais de lançamento.

VERSION = version_identifier . PATCH = patch_num

Modifica a versão e o nível de patch da diretriz de liberação personalizada especificada.

SET

Especifica uma ou mais propriedades a serem definidas para o pacote do aplicativo, separadas por espaços em branco, vírgulas ou novas linhas. Para obter mais detalhes sobre as propriedades que você pode definir, consulte CREATE APPLICATION.

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

Define a versão e o nível de patch do pacote de aplicativo que deve ser instalado para consumidores por padrão.

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

Cria uma diretriz de liberação personalizada para as contas especificadas.

Use a cláusula ACCOUNTS para especificar a lista de contas às quais esta diretiva de liberação se aplica.

Use as cláusulas VERSION e PATCH para especificar o identificador de versão e o número do patch a ser instalado para essas contas.

UPGRADE_AFTER = 'timestamp'

Especifica a data e a hora de início do processo de atualização automatizado. Os consumidores podem atualizar manualmente um aplicativo para uma nova versão ou patch antes dessa data.

Esse valor pode ser qualquer formato válido de data e hora.

UNSET

Especifica uma ou mais propriedades e/ou parâmetros de sessão a serem removidos para o pacote do aplicativo, o que os restabelece para os padrões.

UNSET RELEASE DIRECTIVE release_directive: Remove a diretriz de versão personalizada especificada do pacote de aplicativo.

Notas de uso¶

Modificar a diretriz de versão exige o privilégio OWNERSHIP no aplicativo ou o privilégio global MANAGE VERSIONS.
Se você não especificar os valores para as propriedades opcionais, o comando usará os valores especificados no arquivo de manifesto do aplicativo.
Se você especificar valores para as propriedades no comando e no arquivo de manifesto do aplicativo, os valores especificados no comando terão precedência.

Exemplos¶

O exemplo a seguir adiciona a versão V1 para o canal de lançamento padrão:

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

O exemplo a seguir modifica a diretriz de versão padrão do canal de lançamento padrão para definir a versão para V1 e o patch para 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                                                                                   |         |       |
+---------------------------------------------------------------------------------------+---------+-------+