# 牙醫－IOPI 病人進展紀錄表 (TW Dental IOPI) 之資料模型 - 臺灣牙醫實作指引 (Taiwan Dental Implementation Guide) v0.0.1

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **牙醫－IOPI 病人進展紀錄表 (TW Dental IOPI) 之資料模型**

## Logical Model: 牙醫－IOPI 病人進展紀錄表 (TW Dental IOPI) 之資料模型 

| | |
| :--- | :--- |
| *Official URL*:http://dental-ig.fhir.tw/StructureDefinition/TWDentalIOPI | *Version*:0.0.1 |
| Active as of 2026-06-25 | *Computable Name*:TWDentalIOPIModel |

 
IOPI（Iowa Oral Performance Instrument）病人進展紀錄表之資料模型，用於記錄以 IOPI 系統進行舌頭或嘴唇肌力訓練之追蹤資料，包含每週（第0至8週）之最大壓力（Pmax）、耐力（Endurance）量測值，以及運動處方細節（用力程度、目標壓力與訓練頻率）。 

**Usages:**

* This Logical Model is not used by any profiles in this Specification

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/tw.mirdc.dental|current/StructureDefinition/StructureDefinition-TWDentalIOPI.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-TWDentalIOPI.csv), [Excel](StructureDefinition-TWDentalIOPI.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "TWDentalIOPI",
  "url" : "http://dental-ig.fhir.tw/StructureDefinition/TWDentalIOPI",
  "version" : "0.0.1",
  "name" : "TWDentalIOPIModel",
  "title" : "牙醫－IOPI 病人進展紀錄表 (TW Dental IOPI) 之資料模型",
  "status" : "active",
  "date" : "2026-06-25T00:51:39+00:00",
  "publisher" : "金屬工業研究發展中心",
  "contact" : [{
    "name" : "金屬工業研究發展中心",
    "telecom" : [{
      "system" : "url",
      "value" : "https://www.mirdc.org.tw/"
    }]
  },
  {
    "name" : "黃怡文",
    "telecom" : [{
      "system" : "email",
      "value" : "lisaiwh@mail.mirdc.org.tw",
      "use" : "work"
    }]
  },
  {
    "name" : "莊世任",
    "telecom" : [{
      "system" : "email",
      "value" : "renjuang@mail.mirdc.org.tw",
      "use" : "work"
    }]
  }],
  "description" : "IOPI（Iowa Oral Performance Instrument）病人進展紀錄表之資料模型，用於記錄以 IOPI 系統進行舌頭或嘴唇肌力訓練之追蹤資料，包含每週（第0至8週）之最大壓力（Pmax）、耐力（Endurance）量測值，以及運動處方細節（用力程度、目標壓力與訓練頻率）。",
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "TWDentalIOPI-mapping",
    "uri" : "https://dental-ig.fhir.tw",
    "name" : "TW Dental IG"
  }],
  "kind" : "logical",
  "abstract" : false,
  "type" : "http://dental-ig.fhir.tw/StructureDefinition/TWDentalIOPI",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [{
      "id" : "TWDentalIOPI",
      "path" : "TWDentalIOPI",
      "short" : "牙醫－IOPI 病人進展紀錄表 (TW Dental IOPI) 之資料模型",
      "definition" : "IOPI（Iowa Oral Performance Instrument）病人進展紀錄表之資料模型，用於記錄以 IOPI 系統進行舌頭或嘴唇肌力訓練之追蹤資料，包含每週（第0至8週）之最大壓力（Pmax）、耐力（Endurance）量測值，以及運動處方細節（用力程度、目標壓力與訓練頻率）。",
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "DentalIOPI"
      }]
    },
    {
      "id" : "TWDentalIOPI.identifier",
      "path" : "TWDentalIOPI.identifier",
      "short" : "紀錄表識別碼",
      "definition" : "病人進展紀錄表的唯一識別碼。",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Identifier"
      }],
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "紀錄表識別碼: DentalIOPI.identifier"
      }]
    },
    {
      "id" : "TWDentalIOPI.subject",
      "path" : "TWDentalIOPI.subject",
      "short" : "受評估對象（病人）",
      "definition" : "接受 IOPI 肌力訓練追蹤的病人（Patient ID）。",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference"
      }],
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "受評估病人: DentalIOPI.subject"
      }]
    },
    {
      "id" : "TWDentalIOPI.year",
      "path" : "TWDentalIOPI.year",
      "short" : "年度 (Year)",
      "definition" : "本紀錄表所屬年度。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "string"
      }],
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "年度: DentalIOPI.effectivePeriod"
      }]
    },
    {
      "id" : "TWDentalIOPI.bulbPosition",
      "path" : "TWDentalIOPI.bulbPosition",
      "short" : "球囊位置 (Bulb position)",
      "definition" : "IOPI 量測球囊放置位置（tongue=舌頭; lip=嘴唇）。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "code"
      }],
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://dental-ig.fhir.tw/ValueSet/VS-IOPIBulbPosition-twdental"
      },
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "球囊位置: DentalIOPI.bodySite"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement",
      "path" : "TWDentalIOPI.measurement",
      "short" : "每週量測與處方 (Weekly measurement)",
      "definition" : "各週次（第0至8週）之評估量測值與運動處方細節。",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "BackboneElement"
      }],
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "每週量測: DentalIOPI.component"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.week",
      "path" : "TWDentalIOPI.measurement.week",
      "short" : "週次 (Week)",
      "definition" : "量測週次（0–8）。第0週為基準值（baseline）。",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "integer"
      }],
      "minValueInteger" : 0,
      "maxValueInteger" : 8,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "週次: DentalIOPI.component.code"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.date",
      "path" : "TWDentalIOPI.measurement.date",
      "short" : "日期 (Date)",
      "definition" : "該週次量測的日期。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "date"
      }],
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "日期: DentalIOPI.component[date].valueDateTime"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.pMax",
      "path" : "TWDentalIOPI.measurement.pMax",
      "short" : "最大壓力 Pmax (kPa)",
      "definition" : "最大壓力量測值，單位 kPa。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "decimal"
      }],
      "minValueDecimal" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "最大壓力 Pmax: DentalIOPI.component[pMax].valueQuantity"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.endurance",
      "path" : "TWDentalIOPI.measurement.endurance",
      "short" : "耐力 Endurance (sec)",
      "definition" : "耐力量測值，單位秒（sec）。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "decimal"
      }],
      "minValueDecimal" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "耐力 Endurance: DentalIOPI.component[endurance].valueQuantity"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.effort",
      "path" : "TWDentalIOPI.measurement.effort",
      "short" : "用力程度 Effort (%)",
      "definition" : "運動處方之用力程度，單位百分比（%）。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "decimal"
      }],
      "minValueDecimal" : 0,
      "maxValueDecimal" : 100,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "用力程度 Effort: DentalIOPI.component[effort].valueQuantity"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.target",
      "path" : "TWDentalIOPI.measurement.target",
      "short" : "目標壓力 Target (kPa)",
      "definition" : "運動處方之目標壓力，單位 kPa。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "decimal"
      }],
      "minValueDecimal" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "目標壓力 Target: DentalIOPI.component[target].valueQuantity"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.repsPerSet",
      "path" : "TWDentalIOPI.measurement.repsPerSet",
      "short" : "每組次數 (#Reps/Set)",
      "definition" : "每一組（Set）之反覆次數。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "integer"
      }],
      "minValueInteger" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "每組次數: DentalIOPI.component[repsPerSet].valueInteger"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.setsPerSession",
      "path" : "TWDentalIOPI.measurement.setsPerSession",
      "short" : "每次組數 (#Sets/Session)",
      "definition" : "每一次訓練（Session）之組數。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "integer"
      }],
      "minValueInteger" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "每次組數: DentalIOPI.component[setsPerSession].valueInteger"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.sessionsPerDay",
      "path" : "TWDentalIOPI.measurement.sessionsPerDay",
      "short" : "每日次數 (#Sessions/Day)",
      "definition" : "每日訓練次數（Session）。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "integer"
      }],
      "minValueInteger" : 0,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "每日次數: DentalIOPI.component[sessionsPerDay].valueInteger"
      }]
    },
    {
      "id" : "TWDentalIOPI.measurement.daysPerWeek",
      "path" : "TWDentalIOPI.measurement.daysPerWeek",
      "short" : "每週天數 (#Days/Week)",
      "definition" : "每週訓練天數。",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "integer"
      }],
      "minValueInteger" : 0,
      "maxValueInteger" : 7,
      "mapping" : [{
        "identity" : "TWDentalIOPI-mapping",
        "map" : "每週天數: DentalIOPI.component[daysPerWeek].valueInteger"
      }]
    }]
  }
}

```
