情境3-健康風險評估-Bundle Health Risk Assessment PAD - 身體活動與飲食實作指引 v0.1.0

身體活動與飲食實作指引, published by 衛生福利部國民健康署. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hpapa2025/pad/ and changes regularly. See the Directory of published versions

Resource Profile: 情境3-健康風險評估-Bundle Health Risk Assessment PAD

Official URL: https://fhir.hpa.gov.tw/pad/StructureDefinition/Bundle-health-risk-assessment-pad				Version: 0.1.0
Active as of 2025-10-30				Computable Name: BundleHealthRiskAssessment

此健康風險評估-Bundle Health Risk Assessment PAD Profile說明本IG如何進一步定義資料交換基本單位(TW Core Bundle) Profile以呈現健康風險評估之內容

CDS Hooks欄位整理(試算表)

呼叫CDS Service

HTTP Request

CDS Client（臨床決策支援用戶端）必須以POST方法，將一份JSON文件送給CDS Service（臨床決策支援服務）。
CDS Service（臨床決策支援服務）呼叫端點（endpoint）：http://34.81.89.26/cds-services/chronic-disease-risk-evaluator.

要求欄位如下：

CDS Hook欄位必選填資料類型說明

hookInstance 必填 string 用於此次呼叫CDS Hooks的唯一識別碼(UUID)

hook 必填 string 固定填"patient-view"

context 必填 object 因CDS Hooks規範須填userId、patientId。格式為 [ResourceType]/[id]

prefetch 必填 object "patient": "Patient/"
"conditions": "Condition?patient=&clinical-status=active&_sort=-_id"
"observations": "Observation?patient=&code=8302-2,29463-7,8280-0,85354-9,2093-3,2571-8,1558-6,72166-2"

CDS Hook欄位	必選填	資料類型	說明
`hookInstance`	必填	string	用於此次呼叫CDS Hooks的唯一識別碼(UUID)
`hook`	必填	string	固定填"patient-view"
`context`	必填	object	因CDS Hooks規範須填userId、patientId。格式為 `[ResourceType]/[id]`
`prefetch`	必填	object	`"patient": "Patient/"` `"conditions": "Condition?patient=&clinical-status=active&_sort=-_id"` `"observations": "Observation?patient=&code=8302-2,29463-7,8280-0,85354-9,2093-3,2571-8,1558-6,72166-2"`

範例

curl
  -X POST \
  -H 'Content-type: application/json' \
  "http://34.81.89.26/cds-services/chronic-disease-risk-evaluator"

{
  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
  "hook": "patient-view",
  "context": {
    "userId": "Patient/Z123456789",
    "patientId": "Z123456789"
  },
  "prefetch": {
    "patient": {
      "resourceType": "Patient",
      "id": "Z123456789",
      ...
    },
    "conditions": {
      "resourceType": "Bundle",
      ...
    },
    "observations": {
      "resourceType": "Bundle",
      "id": "f7bc41a5-1fb3-4f5e-adc4-781074683808",
      ...
    }
  }
}

CDS Service回覆

當呼叫成功時，CDS Service 必須（SHALL）回傳一個HTTP 200的回應，其內容為一個包含cards陣列（array）的物件。 For successful responses, CDS Services SHALL respond with a 200 HTTP response with an object containing a cards array.

HTTP狀態碼（HTTP Status Codes）

狀態碼說明

200 OK 呼叫成功並正確回傳結果。

412 Precondition Failed CDS Service無法取得執行決策支援所需的FHIR資料，可能是prefetch資料格式有誤。

狀態碼	說明
`200 OK`	呼叫成功並正確回傳結果。
`412 Precondition Failed`	CDS Service無法取得執行決策支援所需的FHIR資料，可能是prefetch資料格式有誤。

範例

Example response

{
    "cards": [
        {
            "summary": "47%",
            "indicator": "critical",
            "source": {
                "label": "CHD",
                "url": "https://cdrc.hpa.gov.tw/health-guide.html"
            }
        },
        {
            "summary": "54%",
            "indicator": "critical",
            "source": {
                "label": "Stroke",
                "url": "https://cdrc.hpa.gov.tw/health-guide.html"
            }
        },
        {
            "summary": "您本身已有糖尿病，請多注意血糖變化。",
            "indicator": "info",
            "source": {
                "label": "Diabetes",
                "url": "https://cdrc.hpa.gov.tw/health-guide.html"
            }
        },
        {
            "summary": "您已有高血壓，請多注意血壓變化。",
            "indicator": "info",
            "source": {
                "label": "Hypertension",
                "url": "https://cdrc.hpa.gov.tw/health-guide.html"
            }
        },
        {
            "summary": "65%",
            "indicator": "critical",
            "source": {
                "label": "MACE",
                "url": "https://cdrc.hpa.gov.tw/health-guide.html"
            }
        }
    ]
}

更多CDS Hooks內容請參考：https://cds-hooks.hl7.org/

Usages:

Examples for this Profile: Bundle/bundle-health-risk-assessment-min
CapabilityStatements using this Profile: 身體活動與飲食-用戶端(PAD Client) and 身體活動與飲食-伺服端(PAD Server)

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Bundle	C	0..*	TWCoreBundle	包含resourceBundle Constraints: bdl-1, bdl-2, bdl-3, bdl-4, bdl-7, bdl-9, bdl-10, bdl-11, bdl-12
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
identifier	SΣ	0..1	Identifier	一組Resources的資料交換基本單位（Bundle）的識別碼。
type	Σ	1..1	code	document \| message \| transaction \| transaction-response \| batch \| batch-response \| history \| searchset \| collection Binding: BundleType (required): Bundle類型；應填入所綁定值集中的其中一個代碼。 Required Pattern: collection
timestamp	SΣ	0..1	instant	組成Bundle的時間。
Slices for entry	SΣC	11..*	BackboneElement	在bundle中的條目 - 將會有一個resource或資訊，這個重複的資料項目順序：對於type為「document」和「message」的bundles，第一個resource是特殊的（必須分別是Composition或MessageHeader）。對於所有bundles，條目順序的意義取決於bundle的type。 Slice: Unordered, Closed by profile:resource Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
entry:All Slices				Content/Rules for all slices
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
entry:observation-height	SΣC	1..1	BackboneElement	身高 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationBodyHeightPAD	FHIR Body Height Profile
entry:observation-weight	SΣC	1..1	BackboneElement	體重 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationBodyWeightPAD	FHIR Body Weight Profile
entry:observation-waist	SΣC	1..1	BackboneElement	腰圍 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationWaistPAD	檢驗檢查，測量及簡單的判定。
entry:observation-blood-pressure	SΣC	1..1	BackboneElement	血壓(收縮壓+舒張壓) Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationBloodPressurePAD	FHIR Blood Pressure Profile
entry:observation-chol	SΣC	1..1	BackboneElement	總膽固醇(含高密度膽固醇+低密度膽固醇) Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationCholesterolPAD	檢驗檢查，測量及簡單的判定。
entry:observation-tg	SΣC	1..1	BackboneElement	三酸甘油脂 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationTriglyceridesPAD	檢驗檢查，測量及簡單的判定。
entry:observation-fg	SΣC	1..1	BackboneElement	空腹血糖 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationFastingGlucosePAD	檢驗檢查，測量及簡單的判定。
entry:observation-smoking	SΣC	1..1	BackboneElement	吸菸習慣 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ObservationSmokingStatusPAD	Measurements and simple assertions
entry:condition-dm	SΣC	1..1	BackboneElement	糖尿病 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ConditionDiabetesMellitusPAD	有關病情、問題或診斷的詳細資訊
entry:condition-hbp	SΣC	1..1	BackboneElement	高血壓 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	ConditionHighBloodPressurePAD	有關病情、問題或診斷的詳細資訊
entry:patient	SΣC	0..1	BackboneElement	使用者基本資訊 Constraints: bdl-5, bdl-8 This repeating element order: For bundles of type 'document' and 'message', the first resource is special (must be Composition or MessageHeader respectively). For all bundles, the meaning of the order of entries depends on the bundle type
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
resource	S	1..1	PatientPAD	接受健康照護服務的個人或動物之資訊
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Bundle.type	Base	required	BundleType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
bdl-1	error	Bundle	total only when a search or history	`total.empty() or (type = 'searchset') or (type = 'history')`
bdl-2	error	Bundle	entry.search only when a search	`entry.search.empty() or (type = 'searchset')`
bdl-3	error	Bundle	entry.request mandatory for batch/transaction/history, otherwise prohibited	`entry.all(request.exists() = (%resource.type = 'batch' or %resource.type = 'transaction' or %resource.type = 'history'))`
bdl-4	error	Bundle	entry.response mandatory for batch-response/transaction-response/history, otherwise prohibited	`entry.all(response.exists() = (%resource.type = 'batch-response' or %resource.type = 'transaction-response' or %resource.type = 'history'))`
bdl-5	error	Bundle.entry, Bundle.entry:observation-height, Bundle.entry:observation-weight, Bundle.entry:observation-waist, Bundle.entry:observation-blood-pressure, Bundle.entry:observation-chol, Bundle.entry:observation-tg, Bundle.entry:observation-fg, Bundle.entry:observation-smoking, Bundle.entry:condition-dm, Bundle.entry:condition-hbp, Bundle.entry:patient	must be a resource unless there's a request or response	`resource.exists() or request.exists() or response.exists()`
bdl-7	error	Bundle	FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId (except in history bundles)	`(type = 'history') or entry.where(fullUrl.exists()).select(fullUrl&resource.meta.versionId).isDistinct()`
bdl-8	error	Bundle.entry, Bundle.entry:observation-height, Bundle.entry:observation-weight, Bundle.entry:observation-waist, Bundle.entry:observation-blood-pressure, Bundle.entry:observation-chol, Bundle.entry:observation-tg, Bundle.entry:observation-fg, Bundle.entry:observation-smoking, Bundle.entry:condition-dm, Bundle.entry:condition-hbp, Bundle.entry:patient	fullUrl cannot be a version specific reference	`fullUrl.contains('/_history/').not()`
bdl-9	error	Bundle	A document must have an identifier with a system and a value	`type = 'document' implies (identifier.system.exists() and identifier.value.exists())`
bdl-10	error	Bundle	A document must have a date	`type = 'document' implies (timestamp.hasValue())`
bdl-11	error	Bundle	A document must have a Composition as the first resource	`type = 'document' implies entry.first().resource.is(Composition)`
bdl-12	error	Bundle	A message must have a MessageHeader as the first resource	`type = 'message' implies entry.first().resource.is(MessageHeader)`
ele-1	error	ALL elements	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	ALL extensions	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`

This structure is derived from TWCoreBundle

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Bundle		0..*	TWCoreBundle	包含resourceBundle
type		1..1	code	document \| message \| transaction \| transaction-response \| batch \| batch-response \| history \| searchset \| collection Required Pattern: collection
Slices for entry	S	11..*	BackboneElement	在bundle中的條目 - 將會有一個resource或資訊，這個重複的資料項目順序：對於type為「document」和「message」的bundles，第一個resource是特殊的（必須分別是Composition或MessageHeader）。對於所有bundles，條目順序的意義取決於bundle的type。 Slice: Unordered, Closed by profile:resource
entry:observation-height	S	1..1	BackboneElement	身高
resource	S	1..1	ObservationBodyHeightPAD	FHIR Body Height Profile
entry:observation-weight	S	1..1	BackboneElement	體重
resource	S	1..1	ObservationBodyWeightPAD	FHIR Body Weight Profile
entry:observation-waist	S	1..1	BackboneElement	腰圍
resource	S	1..1	ObservationWaistPAD	檢驗檢查，測量及簡單的判定。
entry:observation-blood-pressure	S	1..1	BackboneElement	血壓(收縮壓+舒張壓)
resource	S	1..1	ObservationBloodPressurePAD	FHIR Blood Pressure Profile
entry:observation-chol	S	1..1	BackboneElement	總膽固醇(含高密度膽固醇+低密度膽固醇)
resource	S	1..1	ObservationCholesterolPAD	檢驗檢查，測量及簡單的判定。
entry:observation-tg	S	1..1	BackboneElement	三酸甘油脂
resource	S	1..1	ObservationTriglyceridesPAD	檢驗檢查，測量及簡單的判定。
entry:observation-fg	S	1..1	BackboneElement	空腹血糖
resource	S	1..1	ObservationFastingGlucosePAD	檢驗檢查，測量及簡單的判定。
entry:observation-smoking	S	1..1	BackboneElement	吸菸習慣
resource	S	1..1	ObservationSmokingStatusPAD	Measurements and simple assertions
entry:condition-dm	S	1..1	BackboneElement	糖尿病
resource	S	1..1	ConditionDiabetesMellitusPAD	有關病情、問題或診斷的詳細資訊
entry:condition-hbp	S	1..1	BackboneElement	高血壓
resource	S	1..1	ConditionHighBloodPressurePAD	有關病情、問題或診斷的詳細資訊
entry:patient	S	0..1	BackboneElement	使用者基本資訊
resource	S	1..1	PatientPAD	接受健康照護服務的個人或動物之資訊
Documentation for this format