この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

スクリプトを使用した第二世代管理パッケージのインストールとアンインストールのカスタマイズ

登録者が第二世代管理パッケージ (管理 2GP) をインストールまたはアップグレードした後に Apex インストール後スクリプトを自動で実行するように指定することで、管理 2GP パッケージのインストールやアップグレードをカスタマイズします。また、登録者が管理 2GP パッケージをアンインストールしたときに自動的に Apex アンインストールスクリプトを実行するように指定することもできます。

詳細は、「パッケージのインストール/アップグレード時の Apex の実行」と「パッケージのアンインストール時の Apex の実行」を参照してください。

インストール後スクリプトとアンインストールスクリプトは sfdx-project.json ファイルで指定します。

1"packageDirectories": [
2      {
3         "path": "expenser-schema",
4         "default": true,
5         "package": "Expense Schema",
6         "versionName": ""ver 0.3.2"",
7         "versionNumber": "0.3.2.NEXT",
8         "postInstallScript": "PostInstallScript",
9         "uninstallScript": "UninstallScript",
10         "postInstallUrl": "https://expenser.com/post-install-instructions.html",
11         "releaseNotesUrl": "https://expenser.com/winter-2020-release-notes.html"
12        },
13        ],
14       {
15         "namespace": "db_exp_manager",
16         "sfdcLoginUrl": "https://login.salesforce.com",
17         "sourceApiVersion": "47.0",
18         "packageAliases": {
19             "Expenser Schema": "0HoB00000004CzHKAU",
20             "Expenser Schema@0.1.0-1": "04tB0000000719qIAA"
21          }

また、force:package:version:create コマンドで Salesforce CLI パラメータの --postinstallscript と --uninstallscript を使用して指定することもできます。sfdx-project.json ファイルで指定してあるスクリプトよりも、CLI パラメータで指定したスクリプトの方が優先されます。

パッケージのメタデータを指定したインストール後スクリプトとアンインストールスクリプトの用の Apex クラスをインクルードしてください。

メモ

パッケージに関連する Apex の不具合や、インストール、アップグレード、またはアンインストールの失敗に関するメール通知を受信する Dev Hub 組織の有効なユーザを指定できます。Salesforce CLI で、sfdx force:package:create --errornotificationusername me@devhub.org または sfdx force:package:update --errornotificationusername me@devhub.org を実行します。Tooling API で、Package2 オブジェクトの PackageErrorUsername 項目を使用します。

Salesforce DX 開発者ガイド

スクリプトを使用した第二世代管理パッケージのインストールとアンインストールのカスタマイズ