Comment ドラフト

コメント

タスクに付けられた記録・申し送り・返信。フィールドの変更履歴は含めない（履歴は Temporal API が持つ）。

型 IRI	https://datamodels.jp/ns/task/Comment
@context	https://datamodels.jp/context/task/v1.jsonld （エイリアス、互換性のある最新版） https://datamodels.jp/context/task/v1.0.0.jsonld （このバージョン、不変）
JSON Schema	/schema/task/Comment/v1.json /schema/task/Comment/v1.0.0.json
例	key-values · normalized
ソース	github.com/geolonia/datamodels

属性

task

必須

対象のタスク

• 値: Relationship → Task
• IRI: https://datamodels.jp/ns/task/task

author

作成者（人・組織・チームのエンティティ）

• 値: Relationship → 人・組織・チーム
• IRI: https://schema.org/author

text

必須

本文

• 値: Property, string
• IRI: https://schema.org/text

textFormat

本文の形式

• 値: Property, string: text | markdown | textile | html
• IRI: https://datamodels.jp/ns/task/textFormat

inReplyTo

返信先のコメント

• 値: Relationship → Comment
• IRI: https://datamodels.jp/ns/task/inReplyTo

isPrivate

非公開なら true。既定は false

• 値: Property, boolean
• IRI: https://datamodels.jp/ns/task/isPrivate

sentAt

送信・投稿日時

• 値: Property, string (date-time)
• IRI: https://schema.org/dateSent

source

元システムにおけるこのオブジェクトの URL

• 値: Property, string (uri)
• IRI: https://smart-data-models.github.io/data-models/terms.jsonld#/definitions/source

externalId

元システムにおける識別子

• 値: Property, string
• IRI: https://datamodels.jp/ns/task/externalId

例（key-values）

{
  "id": "urn:ngsi-ld:Comment:takamatsu:1234:3",
  "type": "Comment",
  "task": "urn:ngsi-ld:Task:takamatsu:1234",
  "author": "urn:ngsi-ld:Team:takamatsu:genchi-1",
  "text": "水位上昇中、注視継続。対策本部へ申し送り。",
  "textFormat": "text",
  "isPrivate": false,
  "sentAt": "2026-08-21T11:05:00+09:00",
  "source": "https://tracker.example.jp/issues/1234#note-3",
  "externalId": "5678"
}

例（normalized）

{
  "@context": [
    "https://datamodels.jp/context/task/v1.0.0.jsonld",
    "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context-v1.8.jsonld"
  ],
  "id": "urn:ngsi-ld:Comment:takamatsu:1234:3",
  "type": "Comment",
  "task": {
    "type": "Relationship",
    "object": "urn:ngsi-ld:Task:takamatsu:1234"
  },
  "author": {
    "type": "Relationship",
    "object": "urn:ngsi-ld:Team:takamatsu:genchi-1"
  },
  "text": {
    "type": "Property",
    "value": "水位上昇中、注視継続。対策本部へ申し送り。"
  },
  "textFormat": {
    "type": "Property",
    "value": "text"
  },
  "isPrivate": {
    "type": "Property",
    "value": false
  },
  "sentAt": {
    "type": "Property",
    "value": {
      "@type": "DateTime",
      "@value": "2026-08-21T11:05:00+09:00"
    }
  },
  "source": {
    "type": "Property",
    "value": "https://tracker.example.jp/issues/1234#note-3"
  },
  "externalId": {
    "type": "Property",
    "value": "5678"
  }
}

Link ヘッダー

Link: <https://datamodels.jp/context/task/v1.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"

データの検証とブローカーへの送り方は使い方を参照。

対応する標準: GitHub Issue コメント

GitHub Issue コメント

このモデル	対応先	備考
task	issue_url
author	user
text	body
textFormat	対応なし	常に markdown
sentAt	created_at
source	html_url
externalId	id

対応する標準: Redmine のジャーナル（注記）

Redmine のジャーナル（注記）

notes が空のジャーナル（フィールド変更のみ）は対象外

このモデル	対応先	備考
task	issue_id
author	user
text	notes
textFormat	対応なし	インスタンス設定（textile / markdown）
isPrivate	private_notes
sentAt	created_on
source	<base_url>/issues/<issue_id>#note-<n>
externalId	id

注記

• Upstream considered (2026-09-18): Smart Data Models dataModel.IssueTracking (Open311 service_requests/services; IUDX IssueReporting), both citizen-complaint records shaped by one country's municipal process, not task models; dataModel.Transportation CityWork and dataModel.PredictiveMaintenance, domain-specific. RFC 8984 (JSCalendar Task) is the universal reference and supplies the value spaces used here. See issue #22.
• The core is deliberately small. System-specific data (time spent, milestones, watchers, custom fields, map rotation) belongs in extensions.
• Trackers often keep comments and field-change history in one log; only the written note is a Comment. History belongs to the temporal API.

このページのモデル内容は CC BY 4.0 で提供されています。 LICENSE-CONTENT