開発者向け機能：サーバスクリプト：items.Average
## 概要
[itemsオブジェクト](/ja/manual/server-script-items)の「Averageメソッド」です。対象テーブルと数値項目を指定して平均値を集計します。
## 制限事項
1. [数値項目](/ja/manual/table-management-num)以外では使用できません。
## 構文
```
items.Average(siteId, columnName, view)
```
## パラメータ
|パラメータ|型|必須|概要|
|:----------|:----------|:---:|:---------------------------|
|siteId|object|○|対象テーブルのサイトIDを指定|
|columnName|string|○|集計対象の数値項目を指定|
|view|string|-|選択するレコードの条件を指定|
## 戻り値
指定した数値項目の平均値をdecimal型で返却します。
## 使用例①
以下の例では、サイトIDが 2 のテーブルにある全レコードのNumA（数値A）の平均値を返却します。
##### JavaScript
```
let average = items.Average(2, 'NumA');
```
## 使用例②
以下の例では、サイトIDが 2 のテーブルで、Status（状況）が900（完了）のレコードのみを選択しNumA（数値A）の平均値を返却します。
##### JavaScript
```
let view = {
"View": {
"ColumnFilterHash": {
"Status": "[\"900\"]"
}
}
};
let average = items.Average(2, 'NumA', JSON.stringify(view));
context.Log(average);
```
## サンプルコード
<details>
<summary>1. 一覧画面で平均値との比較で行を色付け</summary>
一覧画面でテーブル内の任意の数値項目に対し平均値を取得、平均値に対し自身のレコードが低いか高いかで、行に色を付けます。
また、平均値は画面表示時で1回計算できれば良いため、UserDataに設定し持ち回ることで、余計な計算をさせないように制御します。
##### JavaScript
条件：行表示の前
```javascript
// UserDataで平均値を持ち回り
if (!context.UserData.average) {
context.UserData.average = items.Average(context.SiteId, 'NumA');
}
// 行の色付けを平均値と比較して変更
if (context.UserData.average < model.NumA) {
model.ExtendedRowCss = 'high';
} else {
model.ExtendedRowCss = 'low';
}
```
##### CSS
CSS設定例です。
```css
/* 平均より高い */
.high td:not(:nth-child(0)) {
background-color: rgb(235, 175, 175);
}
/* 平均より低い */
.low td:not(:nth-child(0)) {
background-color: rgb(185, 220, 246);
}
```
</details>
## 注意事項
こちらは[サーバスクリプト](/ja/manual/table-management-server-script)で使用するメソッドです。[スクリプト](/ja/manual/table-management-script)では使用できません。
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/table-management-num">テーブルの管理：項目：数値</a><span>2025/12/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-script">テーブルの管理：スクリプト</a><span>2025/10/28 up</span></li>
<li><a href="/ja/manual/table-management-server-script">テーブルの管理：サーバスクリプト</a><span>2026/02/10 up</span></li></ul></article>
<ul><li><a href="/ja/manual/server-script">開発者向け機能：サーバスクリプト</a><span>2025/11/27 up</span></li>
<li><a href="/ja/manual/server-script-items">開発者向け機能：サーバスクリプト：items</a><span>2025/05/13 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />
