ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL

既存のアプリケーションパッケージに定義されているリリースチャネルを変更します。リリースチャネルを変更したり、リリースチャネルに割り当てられたバージョンやパッチを変更したり、リリースチャネルのリリースディレクティブを設定したりするには、このコマンドを使用します。

注釈

このトピックの構文は、リリースチャネルを使用するアプリケーションパッケージにのみ適用されます。詳細については、 リリースチャネルを使用してアプリを公開する をご参照ください。リリースチャネルを使用しないアプリケーションパッケーのジリリースディレクティブを設定するには、 ALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE をご参照ください。

こちらもご参照ください。

ALTER APPLICATION PACKAGEALTERAPPLICATIONPACKAGE ... VERSIONALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE SHOW RELEASE DIRECTIVES

構文

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

パラメーター

name

アプリケーションパッケージの識別子を指定します。識別子にスペース、特殊文字、または大文字と小文字が混在する場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

MODIFY RELEASE CHANNEL release_channel

このリリースディレクティブが適用されるリリースチャネルを指定します。指定がない場合、リリースディレクティブはすべてのリリースチャネルに適用されます。

サポートされている値は次のとおりです。

  • ALPHA

  • QA

  • DEFAULT

リリースチャネルの詳細については、 リリースチャネルを使用してアプリを公開する をご参照ください。

VERSION = version_identifier . PATCH = patch_num

指定されたカスタムリリースディレクティブのバージョンとパッチレベルを変更します。

SET

アプリケーションパッケージに設定する1つ(または複数)のプロパティを指定します(空白、コンマ、または改行で区切り)。設定できるプロパティの詳細については、 CREATE APPLICATION をご参照ください。

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

デフォルトでコンシューマーにインストールされる、アプリケーションパッケージのバージョンとパッチレベルを設定します。

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

指定されたアカウントのカスタムリリースディレクティブを作成します。

ACCOUNTS 句を使用して、このリリースディレクティブが適用されるアカウントのリストを指定します。

これらのアカウントにインストールするバージョン識別子とパッチ番号を指定するには、 VERSION と PATCH 句を使用します。

UPGRADE_AFTER = 'timestamp'

自動アップグレード処理を開始する日時を指定します。コンシューマーは、この日までにアプリを新しいバージョンまたはパッチに手動でアップグレードすることができます。

この値には、有効な日付と時刻の形式を指定できます。

UNSET

アプリケーションパッケージの設定を解除する1つまたは複数のプロパティやセッションパラメーターを指定します。これにより、デフォルトにリセットされます。

UNSET RELEASE DIRECTIVE release_directive

アプリケーションパッケージから指定されたカスタムリリースディレクティブを削除します。

使用上の注意

  • リリースディレクティブを変更するには、アプリケーションの OWNERSHIP 権限か、 MANAGE VERSIONS グローバル権限が必要です。

  • オプションのプロパティの値を指定しない場合、コマンドはアプリケーションマニフェストファイルで指定された値を使用します。

  • コマンドとアプリケーションマニフェストファイルでプロパティに値を指定した場合は、コマンドで指定した値が優先されます。

以下の例では、バージョン V1 をデフォルトのリリースチャネルに追加します。

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

以下の例では、デフォルトのリリースチャネルのデフォルトのリリースディレクティブを変更し、バージョンを V1 に、パッチを 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                                                                                   |         |       |
+---------------------------------------------------------------------------------------+---------+-------+