[comment]: # aside:2

[comment]: # ({f589b4e2-e31d2e06})
# アクション

アクションは、モジュールの'ビジネスロジック'を担当します。アクションは通常、[コントローラー](#controller)と[アクションビュー](views#action-view)で構成されます。

モジュールは次の操作を実行できます。

-   Zabbixフロントエンドで既に定義されているアクションを呼び出す。
-   デフォルトのアクションをカスタムアクションで上書きする。
-   まったく新しいアクションを定義する。

デフォルトのアクション動作をカスタム動作で上書きするには、モジュール設定で同じ名前のアクションを定義します。
アクションが呼び出されると、デフォルトのZabbixアクションの代わりにモジュールアクションが実行されます。

アクションファイルは*actions*フォルダーに保存する必要があります。アクションは[manifest.json](manifest)で指定する必要があります。

[comment]: # ({/f589b4e2-e31d2e06})

[comment]: # ({17d83096-348a3343})
### コントローラー

アクションコントローラーのワークフロー:

1) HTTPリクエストで渡されたすべてのパラメーターが有効であることを確認します。
- コントローラーの*checkInput()*メソッドを呼び出す
- CNewValidator.phpで定義された検証ルールを使用する
- *validateInput()*メソッドを呼び出す

2) ユーザーの権限を確認します。

3) 渡されたパラメーターに従ってデータを準備します。*checkInput()*がtrueを返す場合、Zabbixはコントローラーの*doAction()*メソッドを呼び出します。

4) ビュー用の**$data**配列を準備します。*CControllerResponseData*および*setResponse()*メソッドを使用して、レスポンスを**$data**配列に保存します。

例:

````php
/**
 * Validate input parameters.
 *
 * @return bool
 */
protected function checkInput(): bool {
    $ret = $this->validateInput([
        'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED])
    ]);

    if (!$ret) {
        $this->setResponse(new CControllerResponseFatal());
    }

    return $ret;
}

/**
 * Check user permissions.
 *
 * @return bool
 */
protected function checkPermissions() {
    return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN;
}

/**
 * Execute action and generate response object.
 */
protected function do Action(): void {
    $data = [ 
        'hosts_count' => API::Host()->get([
            'countOutput' => true,
            'filter' => [
                'status' => $this->getInput('status')
            ]
        ]) 
    ];
    
    $this->setResponse(new CControllerResponseData($data));
}
````

::: notetip
Zabbixの[ソースコード](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers?at=refs%2Fheads%2Frelease%2F6.4)で利用可能なコントローラークラスの完全なリストを表示できます。
:::

[comment]: # ({/17d83096-348a3343})