Quire 数式フィールドリファレンス Permalink
このガイドでは、タスクフィールド、プロジェクトフィールド、メンバー、時刻ログ、カスタムフィールド拡張を含む Quire の数式フィールドリファレンスをすべて説明します。Quire で数式を記述する際にこのページをリファレンスとしてご活用ください。
タスクフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 | 備考 |
|---|---|---|---|---|
| me | メンバー | 現在のユーザー | me in assignees |
|
| low | 優先度矢印 | 低い優先度矢印 | subtasks.priority > low |
|
| medium | 優先度矢印 | 中程度の優先度矢印 | subtasks.priority > medium |
|
| high | 優先度矢印 | 高い優先度矢印 | subtasks.priority > high |
|
| urgent | 優先度矢印 | 緊急の優先度矢印 | subtasks.priority > urgent |
|
| priority | 優先度矢印 | タスクのカラー付き優先度矢印 | subtasks.priority |
優先度の詳細を参照してください。 |
| id | 数値 | タスクの一意の ID 番号 | subtasks.id |
|
| name | テキスト | タスクの名前 | subtasks.name |
|
| description | テキスト | タスクの説明 | subtask.description |
|
| status | 状態アイコン | タスクの状態アイコン | subtasks.status |
状態の詳細を参照してください。 |
| previousStatus | 状態アイコン | タスクの前の状態アイコン | subtasks.previousStatus |
previousStatusの詳細を参照してください。 |
| start | 日付と時刻 | タスクの開始日と時刻 | subtasks.start |
|
| due | 日付と時刻 | タスクの期限日と時刻 | parent.due |
|
| duration | 継続時間 | 期限日から開始日を引いた合計継続時間 | subtasks.duration |
|
| peekaboo | チェックボックス | タスクがあとで表示に設定されているかどうか | subtasks.peekaboo |
|
| archivedAt | 日付と時刻 | タスクがあとで表示に設定された日時 | parent.archivedAt |
|
| archivedBy | メンバー | タスクをあとで表示に設定したメンバー | parent.archivedBy |
|
| reshowAt | 日付と時刻 | タスクが再表示される日時 | parent.reshowAt |
|
| assignees | メンバー | タスクの担当者 | COUNT(subtasks.assignees) |
タスクに割り当てられた外部チームは含まれません。 |
| assignors | メンバー | タスクを割り当てたメンバー | subtasks.assignors |
assignorsの詳細を参照してください。 |
| externalTeam | 外部チーム | タスクに割り当てられた外部チーム | externalTeam.name |
外部チームが親タスクに割り当てられている場合、子タスクにも同じフィールドで表示されます。 |
| tags | タグ | タスクに追加されたタグ | subtasks.tags |
タグの詳細を参照してください。 |
| level | 数値 | タスクのレベル番号 | MAX(descendants.level) |
|
| editedAt | 日付と時刻 | タスクが編集された日時 | parent.editedAt |
|
| toggledAt | 日付と時刻 | タスクの状態が変更された日時 | parent.toggledAt |
|
| toggledBy | メンバー | タスクの状態を変更したメンバー | toggledBy.name |
|
| createdAt | 日付と時刻 | タスクが作成された日時 | parent.createdAt |
|
| createdBy | メンバー | タスクを追加したメンバー | createdBy.name |
|
| completedAt | 日付と時刻 | タスクが完了した日時 | parent.completedAt |
|
| completedBy | メンバー | タスクを完了したメンバー | parent.completedBy |
|
| timelogs | 時刻ログ数 | タスクに追加された時刻エントリの数 | timelogs.duration |
時刻ログの詳細を参照してください。 |
| timeSpent | 時間 | タスクに費やした合計時間 | subtasks.timeSpent |
|
| billingTimelogs | 時刻ログ数 | タスクに追加された請求可能な時刻エントリの数 | billingTimelogs.duration |
時刻ログの詳細を参照してください。 |
| billingTimeSpent | 時間 | タスクに費やした請求可能な合計時間 | subtasks.billingTimeSpent |
|
| estimated | 時間 | タスクの見積もり時間 | SUM(subtasks.estimated) |
|
| favorites | メンバー | タスクをお気に入りに追加したメンバー | favorites.name |
|
| attachments | 添付ファイル数 | タスクに追加された添付ファイルの数 | attachments.name |
添付ファイルの詳細を参照してください。 |
| comments | コメント数 | タスクに追加されたコメントの数 | comments.attachments |
コメントの詳細を参照してください。 |
| subtasks | タスクリスト | タスクの第一階層の子タスクすべてのリスト | subtasks[0].{Cost} |
|
| activeSubtasks | タスクリスト | タスクの第一階層のアクティブな子タスクすべてのリスト | SUM(activeSubtasks.{Cost}) |
|
| completedSubtasks | タスクリスト | タスクの第一階層の完了済み子タスクすべてのリスト | SUM(completedSubtasks.{Cost}) |
|
| descendants | タスクリスト | タスクのすべての階層の子タスクリスト | SUM(descendants.{Cost}) |
|
| activeDescendants | タスクリスト | タスクのすべての階層のアクティブな子タスクリスト | SUM(activeDescendants.{Cost}) |
|
| completedDescendants | タスクリスト | タスクのすべての階層の完了済み子タスクリスト | SUM(completedDescendants.{Cost}) |
|
| parent | タスク | 直接の親タスク | parent.due |
|
| section | タスク | セクションである最も近い祖先タスク | section.name |
|
| ancestors | タスクリスト | タスクのすべての親タスクのリスト | ancestors.due |
|
| project | プロジェクト | タスクが属するプロジェクト | project.name |
プロジェクトの詳細を参照してください。 |
| organization | 組織 | タスクが属する組織 | organization.name |
組織の詳細を参照してください。 |
ドット演算子によるフィールド拡張
ドット演算子(.)を使用すると、フィールドから特定のプロパティを取得できます。
例:
priority→ 優先度アイコンを返すpriority.value→ 優先度の数値を返すpriority.name→ テキストラベルを返す
この記法は priority、status、members、projects、tags、カスタムフィールドなどのフィールドに適用できます。
プロジェクトフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| id | テキスト | プロジェクト ID | project.id |
| name | テキスト | プロジェクト名 | project.name |
| start | 日付 | プロジェクトの開始日 | project.start |
| due | 日付 | プロジェクトの期限日 | project.due |
| color | カラーコード | プロジェクトの色 | project.color |
| roots | タスクリスト | プロジェクト内の第一階層タスク(ルートタスク)すべてのリスト | project.roots |
| activeRoots | タスクリスト | プロジェクト内のアクティブな第一階層タスク(ルートタスク)すべてのリスト | project.activeRoots |
| completedRoots | タスクリスト | プロジェクト内の完了済み第一階層タスク(ルートタスク)すべてのリスト | project.completedRoots |
| tasks | タスクリスト | プロジェクト内のすべてのタスクリスト | project.tasks |
| activeTasks | タスクリスト | プロジェクト内のすべてのアクティブなタスクリスト | project.activeTasks |
| completedTasks | タスクリスト | プロジェクト内のすべての完了済みタスクリスト | project.completedTasks |
| organization | 組織 | プロジェクトが属する組織 | project.organization |
組織フィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| id | テキスト | 組織 ID | organization.id |
| name | テキスト | 組織名 | organization.name |
| color | カラーコード | 組織の色 | organization.color |
サブリストフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| id | テキスト | サブリスト ID | sublists.id |
| name | テキスト | サブリスト名 | sublists.name |
| start | 日付 | サブリストの開始日 | sublists.start |
| due | 日付 | サブリストの期限日 | sublists.due |
| color | カラーコード | サブリストの色 | sublists.color |
注意: サブリストの名前または ID は必ず角括弧 [ ] で囲む必要があります。たとえば、sublists['Design'].due は「Design」という名前のサブリストの期限日を取得します。
メンバーフィールドリファレンス(assignees、assignors)
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| id | テキスト | メンバーのユーザー名 ID | assignees.id |
| name | テキスト | メンバーの名前 | assignees.name |
| テキスト | メンバーのメールアドレス | assignees.email |
|
| color | カラーコード | メンバーの色 | assignees.color |
添付ファイルフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| name | テキスト | 添付ファイルの名前 | attachments.name |
| url | テキスト | 添付ファイルの URL | attachments.url |
| size | 数値 | 添付ファイルのサイズ | attachments.size |
| createdAt | 日付と時刻 | 添付ファイルが追加された日時 | attachments.createdAt |
| createdBy | メンバー | 添付ファイルを追加したメンバー | attachments.createdBy |
コメントフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| description | テキスト | タスクに追加されたすべてのコメント | comments.description |
| attachments | 添付ファイル数 | コメントに追加された添付ファイルの数 | comments.attachments |
| createdAt | 日付と時刻 | コメントが追加された日時 | comments.createdAt |
| createdBy | メンバー | コメントを追加したメンバー | comments.createdBy |
外部チームとタグのフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| name | テキスト | 外部チームまたはタグの名前 | externalTeam.name または tags.name |
| color | カラーコード | 外部チームの色 | externalTeam.color または tags.color |
時刻ログフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| user | メンバー | タスクに時刻エントリを追加したメンバー | timelogs.user |
| start | 日付 | 時刻ログが追加された開始日 | timelogs.start |
| end | 日付 | 時刻ログが追加された終了日 | timelogs.end |
| duration | 継続時間 | タスクに追加された時刻ログの継続時間 | timelogs.duration |
| billable | チェックボックス | 時刻ログが請求可能かどうかの true/false 値 | timelogs.billable |
| note | テキスト | タスクの時刻ログのメモ | timelogs.note |
優先度と状態のフィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| name | テキスト | 優先度または状態の名前 | priority.name または status.name |
| value | 数値 | 優先度または状態の値 | priority.value または status.value |
| color | カラーコード | 優先度または状態の色 | priority.color または status.color |
通貨フィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| currency | テキスト | 通貨フィールドの通貨記号 | Cost.currency |
| value | 数値 | 通貨フィールドの通貨値 | Cost.value |
注意: 数式で使用する前に、数値カスタムフィールド(例:Cost)を作成する必要があります。
選択フィールドリファレンス
| フィールド名 | フィールドタイプ | 説明 | 例 |
|---|---|---|---|
| name | テキスト | 選択されたオプションの名前 | Categories.name |
| color | カラーコード | 選択されたオプションの色 | Categories.color |
注意: 数式で使用する前に、数値カスタムフィールド(例:Cost)を作成する必要があります。
よくある質問
Quire の数式でタスクのどのフィールドを参照できますか?
組み込みのタスクフィールドには、name、id、状態、優先度、start、due、duration、担当者、タグ、timeSpent、estimated、createdBy、completedAt などがあります。完全なリストはタスクフィールドリファレンスを参照してください。
Quire の数式で優先度や状態の数値またはカラーコードを取得するにはどうすればよいですか?
ドット記法を使用します。priority.value は数値を返し、priority.name はテキストラベルを返し、priority.color はカラーコードを返します。status にも同じ記法が適用されます。
Quire の数式で子タスクとすべての子孫を参照するにはどうすればよいですか?
第一階層の子タスクのみを対象にするには subtasks、すべての階層を対象にするには descendants を使用します。絞り込んだサブセットには activeSubtasks、completedSubtasks、activeDescendants、completedDescendants を使用します。
Quire の数式でプロジェクトフィールドを参照するにはどうすればよいですか?
project.fieldname を使用します。たとえば、project.name はプロジェクト名を返し、project.tasks はすべてのタスクを返します。絞り込んだリストには project.activeTasks または project.completedTasks を使用します。
Quire の数式で担当者名やメールアドレスなどのメンバー情報を参照するにはどうすればよいですか?
メンバーフィールドにドット記法を使用します。assignees.name は表示名を返し、assignees.email はメールアドレスを返し、assignees.id はユーザー名 ID を返します。
Quire の数式で時刻ログデータを参照するにはどうすればよいですか?
timelogs.fieldname を使用します。たとえば、timelogs.duration は時刻エントリの継続時間を返し、timelogs.billable は請求可能フラグの true/false 値を返します。請求可能なエントリのみを対象にするには billingTimelogs を使用します。
Quire の数式でサブリストの期限日または名前を参照するにはどうすればよいですか?
sublists['SublistName'].fieldname を使用します。たとえば、sublists['Design'].due は「Design」という名前のサブリストの期限日を取得します。