Quire 数式ガイド Permalink
数式を使うと、Quire 上の既存のタスクやプロジェクトのデータをもとに、新しい値を自動的に計算できます。組み込みフィールドやカスタムフィールドを参照し、演算子や関数を適用して、数値またはテキストの結果をカスタムフィールドに表示できます。
数式を記述する
Free サブスクリプションプランでは、各プロジェクトのカスタムフィールドに数式を 1 つ追加できます。より多くの数式を追加するには、サブスクリプションプランをアップグレードしてください。詳細は料金ページをご覧ください。
数式を記述するには、まず数式カスタムフィールドを作成する必要があります。作成後、既存の値を参照して計算結果を返す数式を入力できます。
たとえば、タスクの経過時間を 2 で割りたい場合は次のように記述します：
timeSpent/2
Quire は各タスクの値を自動的に計算し、カスタムフィールドに結果を表示します。
数式を追加するためのカスタムフィールドの作成方法もご覧ください。
数式で計算を行う
算術演算子
以下の演算子を使って基本的な算術計算を実行できます：
- 加算：
+ - 減算：
- - 乗算：
* - 除算：
/
たとえば、開始日を期限の日から引いてタスクの所要時間を計算するには：
due - start
ヒント： 括弧 ( ) を使うと計算の優先順位を制御できます。たとえば (due - start) *2 と記述すると、期限の日と開始日の減算が乗算より先に実行されます。
関数
関数を使うと、より高度な計算を簡単に実行できます。
たとえば、経過時間と見積もり時間の合計を計算するには：
SUM(timeSpent, estimated)
比較演算子を使って論理的な結果を返すこともできます。
priority >= high
これは、タスクの優先度がHigh以上かどうかを確認します。
Quire の数式で使用できるすべての演算子と関数をご覧ください。
数式の記述に関するベストプラクティス
ドット演算子
ドット演算子 . を使うと、関連するオブジェクトから特定の値を取得できます。
たとえば、すべての子タスクの名前を一覧表示するには：
subtasks.name
また、親タスクの優先度を取得するには：
parent.priority
ヒント： 指定できるすべてのフィールドの一覧も参照してください。
スペースを含むフィールド名
カスタムフィールドに名前を付ける際は、次の文字の使用を避けてください：引用符（"）、バックスラッシュ（\）、波括弧（}）。
数式でカスタムフィールドを参照する場合：
- スペースを含まないフィールド名はそのまま使用できます
- スペースや特殊文字（
@、#、&など）を含むフィールド名は、波括弧{ }で囲む必要があります
たとえば、Cost という名前のフィールドを追加した場合：
Cost *2
{Cost} *2
フィールド名にスペースが含まれる場合は、波括弧 { } で囲む必要があります：
{Schedule Variance} *2
注意： 大文字・小文字は区別されません。cost と Cost は同じものとして扱われます。
結果へのテキストの追加
数式の結果にテキストを含めるには、テキスト文字列を必ず引用符で囲んでください。
たとえば、アイテム ID 用とアイテム名用の 2 つのカスタムフィールドを追加した場合：
id + ":" + name
これにより、ID と名前がコロンで区切られて表示されます。
メンバー・タスク・タグの識別子
識別子を使って特定のエンティティを参照できます：
- メンバー：
@member_username - タスク：
#task_id - タグ：
#tag_name - プロジェクト：
#{project_id}
たとえば、タスク ID 23 の期限の日を参照するには：
#23.due
注意： # と ID の間にスペースは使用できません。
別の例として、プロジェクト全体の経過時間の合計を確認したい場合は、組織の概要の説明欄に次のように記述します：
SUM(#{project_id}.tasks.timeSpent)
注意：
- プロジェクト識別子
#{project_id}は、組織の概要の説明欄でのみ使用できます。タスクやプロジェクトの説明では使用できません。 - プロジェクト識別子を正しく機能させるには、プロジェクト ID を波括弧で囲む必要があります（例：
#{project_id}）。 - ユーザーのユーザー名 ID に
.、-、_が含まれる場合は、識別子を正しく機能させるために波括弧で囲む必要があります。 - タグ名にスペースや特殊文字（
.、#、数字など）が含まれる場合は、タグ識別子を正しく機能させるためにタグ名を引用符で囲む必要があります。たとえば、タグ名が depending on の場合は、#"depending on"のように引用符で囲みます。
Quire 数式のリテラル値
リテラル値とは、計算中に変化しない固定値のことです。Quire は複数のリテラル形式をサポートしています：
- 数値：
123、-1.23 - テキスト：
"text"、'text' - リスト：
[1,2,3] - 真偽値：
true、false - 時間：
12:01、123:12:23、2h 30m、2d 5s、30m - 日時：
<2022/12/25>、<12/23>、<23>、<2022/01/23 13:10:00>、<2023/12/25 16:00>、<15:15>、<now> - 日：
<today>、<today-1>、<tomorrow+3 13:10:05>、<+5>
注意：
- テキスト文字列は連結できます：
'first' "second"は'first second'と同じです。 - 日は言語に対応しています（例：ドイツ語では
<Morgen>）。 - 日の場合、
<+5>は<today+5>と同じです。 - 時間の場合、時間は 0〜23 の範囲のみ有効で、
hh:mm:ssまたはmm:ssの形式で記述します。
数式の結果を書式設定する
「書式」タブ
数式フィールドを作成または編集する際に、「書式」タブを使って数式結果の表示形式を設定できます。
- 数式カスタムフィールドを開きます。
- 「書式」タブをクリックします。
- 表示形式を選択します。
条件付きカラー
条件付き書式を使うと、重要な値を視覚的に強調表示できます。
- 「新しい条件を追加」をクリックします。
- 条件を定義して色を選択します。
- 「保存」をクリックします。
注意： 条件は上から順に適用されます。六点アイコンをドラッグして並べ替えることができます。
よくある質問
Quire で数式を使うにはどうすればよいですか？
数式カスタムフィールドを作成し、タスクフィールドを参照して計算結果を返す数式を入力します。Free プランでは、プロジェクトごとに数式フィールドを 1 つ使用できます。
Quire の数式ではどのような計算ができますか？
Quire は +、-、*、/ をサポートしています。括弧を使って計算の順序を制御できます（例：(due - start) * 2）。より高度な計算には SUM(timeSpent, estimated) などの組み込み関数を使用してください。
Quire の数式で使用できるリテラル値にはどのようなものがありますか？
使用できるリテラルには、数値（123、-1.23）、テキスト（"text"）、真偽値（true/false）、リスト（[1,2,3]）、時間（2h 30m）、日付（<2022/12/25>、<today>、<today+5>）があります。
スペースを含むカスタムフィールドを Quire の数式で参照するにはどうすればよいですか？
フィールド名を波括弧で囲みます（例：{Schedule Variance} * 2）。スペースを含まないフィールド名はそのまま使用できます。フィールド名は大文字・小文字を区別しません。
数式の結果にテキストを含めるにはどうすればよいですか？
テキスト文字列を引用符で囲みます。たとえば id + ":" + name と記述すると、ID と名前をコロンで区切って表示できます。
Quire の数式で特定のタスク、メンバー、タグを参照するにはどうすればよいですか？
#task_id（例：#23.due）、@member_username、#tag_name を使用します。スペースや特殊文字を含むタグ名には #"depending on" のように引用符を使います。
Quire の数式結果を書式設定またはカラーコードで表示するにはどうすればよいですか？
数式フィールドを開き、「書式」タブをクリックして表示形式を選択します。条件付きカラーを設定するには、「新しい条件を追加」をクリックし、ルールを定義して保存します。