Apex 開発者ガイド
jUninstallHandler インターフェース
管理パッケージをアンインストールした後に、カスタムコードを実行できます。
名前空間
使用方法
アプリケーション開発者は、このインターフェースを実装して、登録者が管理パッケージをアンインストールした後に自動的に実行される Apex コードを指定できます。これにより、登録者の組織の詳細に基づいてクリーンアップおよび通知タスクを実行できます。
アンインストールスクリプトには、デフォルトのガバナ制限が適用されます。パッケージを表す特別なシステムユーザとして実行するため、スクリプトによって実行されるすべての操作は、パッケージによって行われているように見えます。このユーザには、UserInfo を使用してアクセスできます。このユーザは実行時にのみ確認でき、テストの実行中には確認できません。
スクリプトが失敗すると、アンインストールは続行しますが、スクリプトによる変更はコミットされません。スクリプト内のエラーは、パッケージの [Apex エラーを通知] 項目に指定されたユーザにメールされます。ユーザが指定されていない場合、アンインストールの詳細は利用できません。
アンインストールスクリプトには、次の制限があります。一括処理ジョブ、スケジュールされたジョブ、および今後のジョブを開始するために使用することはできません。つまり、セッション ID にアクセスしたり、コールアウトを実行したりすることはできません。
onUninstall メソッドは、次の情報を提供するコンテキストオブジェクトを引数として取ります。
- アンインストールが実施される組織の組織 ID。
- アンインストールを開始したユーザのユーザ ID。
コンテキスト引数は、データ型が UninstallContext インターフェースであるオブジェクトです。このインターフェースは、システムによって自動的に実装されます。UninstallContext インターフェースの次の定義では、コンテキスト引数にコールできるメソッドを示しています。
UninstallHandler の実装例
アンインストールスクリプトの例
以下のアンインストールスクリプトのサンプルは、パッケージのアンインストール時に次のアクションを実行します。
- アンインストールを行ったユーザと組織を示すエントリをフィードに挿入する
- そのユーザにアンインストールを確認するメール通知を作成して送信する
Test クラスの testUninstall メソッドを使って、アンインストールスクリプトをテストできます。このメソッドは、UninstallHandler インターフェースを実装するクラスを引数に取ります。
このサンプルでは、UninstallClass Apex クラスに実装されたアンインストールスクリプトのテスト方法を示します。