テーブルの管理:計算式(拡張)
## 概要
四則演算の他、専用の関数を利用した計算式を登録します。出力先は数値項目だけでなくそのほかの項目も選択可能です。
## 前提条件
1. 「サイトの管理権限」が必要です。
## 操作手順
1. [計算]タブを開き、「新規作成」ボタンをクリックしてください。
1. 「計算方法」で「拡張」を選択してください。
1. 「対象」から出力先の項目を選択してください。
1. 計算式の設定を行います。詳細は「計算式の記述方法」を参照ください。
1. 「追加」ボタンをクリックしてください。
1. 画面下の「更新」をクリックしてください。画面下に「"(タイトル)" の更新が完了しました。」とメッセージが表示されたら完了です。
## 計算式の記述方法
計算式は下記の記述方法で設定できます。
1. 項目の表示名を使用して四則演算の計算を登録できます。
![image](https://pleasanter.org/binaries/59ec55a2aa954b5fa53c2c130c087981)
1. 専用の関数を利用できます。使用できる関数は[計算式(拡張)の関数一覧](/ja/manual/formula-function-list)を参照ください。
![image](https://pleasanter.org/binaries/b35ed2dc7484434caaf7b3957e9f7a3c)
1. 表示名ではなくカラム名を角括弧([])で囲んだ記述が可能です。カラム名を角角括弧([])で囲んだ記述を行った場合、追加時点で表示名に自動的に変換します。
#### 追加前
![image](https://pleasanter.org/binaries/63ce38725a164ebebe45ecdc12c2b7db)
#### 追加後
![image](https://pleasanter.org/binaries/6e5f7e09d14f4bbbb6e7267497c162f8)
## 表示名を使用しない
「表示名を使用しない」をチェックONにすると計算式にカラム名を角角括弧([])で囲んだ記述をしても表示名に変換されずに登録できます。
#### 追加前
![image](https://pleasanter.org/binaries/c6fae410d879446e95bd2d05515b658e)
#### 追加後
![image](https://pleasanter.org/binaries/efdc53f436774f268810b7904307bb12)
## エラーを表示する
計算式でエラーが発生した場合はシステムログにエラー内容が記録されます。
例) 計算式を以下のように設定し、数値A:-10、数値B:12、数値C:11と入力後、作成ボタンをクリック
![image](https://pleasanter.org/binaries/eecc24da128047efb0300f913238d52d)
計算式でエラー発生するため、結果が表示しない。(登録処理は正常終了する)
![image](https://pleasanter.org/binaries/90387445cc694bc7870587a54095b457)
「管理」-[システムログの管理](/ja/manual/syslog)よりエラーログを確認できます。
![image](https://pleasanter.org/binaries/941cfd591b3541c987861441f6c39738)
「エラーを表示する」チェックONにした場合は、システムログにエラー内容が記録されるとともに、画面上に「アプリケーションエラー」のメッセージが画面下部に表示します。
![image](https://pleasanter.org/binaries/9cfeb3d24591499fb83beb88baa23201)
![image](https://pleasanter.org/binaries/d0cb34b4db1843d3bb0467f03a236609)
## 計算式のログ出力
1. [計算]タブを開き、「ログを出力する」にチェックを入れてください。
1. 画面下の「更新」をクリックしてください。
1. F12キー等でブラウザの開発者ツールのコンソールで作成や更新後に以下のようなログが出力されていることを確認してください。
例)
【計算式】
対象:日付A(DateA)
計算式:$DATE(数値A,数値B,数値C)
【項目の値】
数値A:2023
数値B:12
数値C:11
【ログ】
```
formulaSet: {"CalculationMethod":"Script","Target":"DateA","NotUseDisplayName":false,"IsDisplayError":false,"FormulaScript":"$DATE(model.NumA,model.NumB,model.NumC)","FormulaMapping":"{\"NumA\":\"数値A\",\"NumB\":\"数値B\",\"NumC\":\"数値C\"}","Id":1}
formulaSource: {"IssueId":51366,~途中省略~,"NumHash":{"NumA":{"Value":2023.0000},"NumB":{"Value":12.0000},"NumC":{"Value":11.0000}},~以下略~}
formulaResult: {"DateA":2023/12/11}
```
### ログの内容について
ログで出力される内容は以下の通りです。
・formulaSet:計算式の設定
・formulaSource:計算のもととなる項目の値
・formulaResult:計算結果
「formulaSet」で出力される内容については以下の通りです。
・Target:対象項目
・FormulaScript:計算式
・FormulaMapping:項目
・Id:計算式ID
## 動作イメージ
「生年月日」「年齢算出基準日」という日付項目、「満年齢」という数値項目を追加します。
![image](https://pleasanter.org/binaries/61f629d6dc2d4108bf826db97499b72d)
「対象」は「満年齢」を選択し、[計算式](/ja/manual/table-management-formula)は「$DATEDIF(生年月日, 年齢算出基準日,'Y')」と入力します。
![image](https://pleasanter.org/binaries/0e04e85222304adcbf3948787de85e49)
![image](https://pleasanter.org/binaries/deccd37bbcce4d26be8b1beb08da2834)
「作成」または「更新」ボタンを押したタイミングで自動的に計算し、保存されます。
![image](https://pleasanter.org/binaries/41d98b6a59af484cbdd5f37850280869)
すでに保存済みのレコードに対しての計算や、計算式の変更を行った場合は「同期」ボタンを押して再計算を行います。
---
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/table-management-formula">テーブルの管理:計算式</a><span>2024/12/10 up</span></li>
<li><a href="/ja/manual/formula-function-list">計算式(拡張)の関数一覧</a><span>2024/01/16 up</span></li></ul></article>
<ul><li><a href="/ja/manual/syslog">システムログ管理機能</a><span>2024/06/21 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />