欄位對照
把 Poieti 欄位與選項代碼對應到院方欄位代碼:格式、編碼、審核與版本。
對照工作表#
每個紀錄功能的每個範本版本一份工作表,由正式範本產生,列出欄位對照必須對應或排除的每個欄位(重複資料列的子欄位寫成 父欄位[].子欄位)、型別、條件、選項代碼、限制、poieti-canonical 的值與可用編碼。院方填寫最後七欄後交給 Poieti。
| 功能 | 版本 | 欄位數 | 工作表(CSV,UTF-8) |
|---|---|---|---|
住院整合照護紀錄(aide-care-record) | 範本 v1 | 39 | field-mapping-aide-care-record-v1.csv |
輸出入量紀錄(intake-output) | 範本 v1 | 57 | field-mapping-intake-output-v1.csv |
管路紀錄(line-record) | 範本 v1 | 9 | field-mapping-line-record-v1.csv |
入院護理評估表(nursing-admission) | 範本 v1 | 149 | field-mapping-nursing-admission-v1.csv |
傷口紀錄(wound-record) | 範本 v1 | 10 | field-mapping-wound-record-v1.csv |
病人身分欄位(patient.*)不在對照中:身分只經由 DeliveryV1 的 patient 區塊送出。
對照檔格式#
審核後的對照是版本化的 JSON 檔(schema: "poieti.his-mapping/1"),以 (id, version, feature.id, feature.templateVersion) 識別,發布後永不修改。以下為合成的示範對照(節錄):
{
"schema": "poieti.his-mapping/1",
"id": "demo-hospital",
"version": 1,
"description": "Synthetic demonstration mapping for the demo-hospital institution. The NUR_ADM form, its column codes and option codes are invented for tests and demos; they belong to no real hospital.",
"feature": {
"id": "nursing-admission",
"templateVersion": 1
},
"target": {
"form": "NUR_ADM",
"formVersion": "2026.1",
"timezone": "Asia/Taipei",
"charset": "cp950"
},
"observedAt": {
"date": "admission.wardDate",
"time": "admission.wardTime"
},
"codeTables": {
"NONE_YES": {
"none": "N",
"yes": "Y"
}
},
"fields": [
{
"source": "basic.education",
"encode": "code",
"target": "EDU",
"codes": {
"illiterate": "0",
"elementary": "1",
"junior_high": "2",
"senior_high": "3",
"college": "4",
"university_or_above": "5"
},
"required": true
},
{
"source": "basic.languages",
"encode": "joined",
"target": "LANG",
"separator": ",",
"codes": {
"mandarin": "zh",
"taiwanese_hokkien": "tw",
"hakka": "hak",
"amis": "ami",
"atayal": "tay",
"rukai": "dru",
"yami": "tao",
"english": "en",
"indonesian": "id",
"japanese": "ja",
"thai": "th",
"filipino": "fil",
"other": "oth"
}
}
],
"excluded": [
{
"source": "contacts.contactPhone2",
"reason": "NUR_ADM keeps one telephone number per contact."
},
{
"source": "family.members[].note",
"reason": "NUR_ADM has no free-text column for family members."
}
]
}| 成員 | 說明 |
|---|---|
target | 院方表單 form、formVersion、時區 timezone(預設 Asia/Taipei)與字集 charset(utf-8 或 cp950) |
observedAt | 組成臨床時間的日期與時間欄位 |
codeTables | 共用的選項代碼表 |
fields | 每個欄位的 source、encode、target 與編碼參數;required 表示院方必填 |
excluded | 不送出的欄位與原因;有值時列在 notSent |
每個功能版本都有 poieti-canonical 對照:所有可寫欄位以原欄位 ID 為代碼、保留原始 JSON 型別、字集 UTF-8。可下載 demo-hospital.nursing-admission.t1.v1.json、 poieti-canonical.aide-care-record.t1.v1.json、 poieti-canonical.intake-output.t1.v1.json、 poieti-canonical.line-record.t1.v1.json、 poieti-canonical.nursing-admission.t1.v1.json、 poieti-canonical.wound-record.t1.v1.json。
編碼方式#
| encode | 適用型別 | 輸出 |
|---|---|---|
code | 單選、選單 | 選項代碼 → 院方代碼(codes 或共用的 codeTable) |
joined | 多選 | 依範本選項順序以 separator(預設 ,)串接;空陣列為 "" |
flags | 多選 | 每個選項一個院方欄位,值為 mapping 的 true/false 字串 |
number | 數值 | decimals 0–4 位、選用 10 的次方 scale(例如公分轉毫米);小數位數不足時保留紀錄,不四捨五入;選用含端點的 min/max(院方單位,即乘上 scale 後),超出時保留紀錄(VALUE_OUT_OF_RANGE),不截到上下限 |
integer | 數值、整數選項 | 整數字串;選用含端點的 min/max,超出時保留紀錄(VALUE_OUT_OF_RANGE) |
boolean | 是/否 | mapping 的 true/false 字串 |
date | 日期 | YYYY-MM-DD、YYYYMMDD 或 ROC(民國 YYYMMDD,年三位補零) |
time | 時間 | HH:mm 或 HHmm |
partial-date | 部分日期 | text(ISO 8601 簡化格式,如 2026-10)、split(年/月/日三欄)或 reject(只收完整日期) |
text | 文字 | maxLength(UTF-16 單位)、maxBytes(目標字集位元組);不截斷 |
rows | 重複資料列 | rowFields 對應子欄位、maxRows;更正時整組取代 |
院方對照中,每個輸出值都是字串,沒有值就省略。選項代碼表必須剛好涵蓋欄位的所有選項。
檢查與阻擋#
- 發布前:來源都是可寫欄位、編碼符合型別、代碼表涵蓋所有選項、院方代碼不重複、每個可寫的非身分欄位都有對應或排除原因、代碼與分隔符號可在目標字集編碼、代碼表都有使用。
- 產生時:每個字串都檢查可否編碼(
VALUE_UNENCODABLE)與長度(VALUE_TOO_LONG),從不截斷或替換;無法對應的值為VALUE_UNMAPPABLE;不支援的部分日期為PARTIAL_DATE_UNSUPPORTED;超出欄位對照min/max的數值為VALUE_OUT_OF_RANGE。這些紀錄會保留為待送,修正後重新產生。 - cp950:只允許 MS950 能來回轉換的字元,排除各院不同的造字區(EUDC)。
missingRequired:依範本與院方必填、並考慮條件顯示與條件必填計算;只供參考,Poieti 仍會送出。
審核與版本#
- 院方填寫工作表(與病房代碼、員工編號對照)。
- Poieti 產生對照 JSON 並以範本驗證,雙方逐欄核對(含代碼表與字集)。
- 發布為新的對照檔與版本;已發布的版本永不修改,送出時記錄所用的對照版本。
- Poieti 為機構的每個功能版本選定對照版本後才會送出;缺少對照的紀錄保留為
MAPPING_UNAVAILABLE,發布後重新產生。 - 範本改版或院方欄位異動時,發布新的對照版本,並以驗收案例重新測試受影響的流程。
其他紀錄的欄位#
住院整合照護紀錄(aide-care-record v1)
| 欄位 ID | 名稱 | 型別 | 限制 | poieti-canonical 值 | 可用編碼 |
|---|---|---|---|---|---|
record.date | 日期 | date 日期 | — | string "YYYY-MM-DD" | date |
record.shift | 班別 | single 單選 | — | string(選項代碼) | code |
record.aides | 照護輔佐人員 | text 文字 | 最多 2000 字 | string | text |
record.orientation_date | 環境介紹日期 | date 日期 | — | string "YYYY-MM-DD" | date |
record.primary_caregiver | 主要照顧者 | text 文字 | 最多 200 字 | string | text |
record.items | 本班執行項目 | multi 多選 | — | string[](選項代碼,範本順序) | joined flags |
care.hair_wash | 洗頭 | text 文字 | 最多 2000 字 | string | text |
care.face_wash | 洗臉 | text 文字 | 最多 2000 字 | string | text |
care.oral_care | 口腔清潔 | text 文字 | 最多 2000 字 | string | text |
care.bath | 身體清潔 | text 文字 | 最多 2000 字 | string | text |
care.perineal_care | 會陰清潔 | text 文字 | 最多 2000 字 | string | text |
care.nail_care | 剪指甲 | text 文字 | 最多 2000 字 | string | text |
care.breakfast | 早餐 | text 文字 | 最多 2000 字 | string | text |
care.lunch | 中餐 | text 文字 | 最多 2000 字 | string | text |
care.dinner | 晚餐 | text 文字 | 最多 2000 字 | string | text |
care.toileting | 如廁 | text 文字 | 最多 2000 字 | string | text |
output.urine | 尿量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.urine[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.urine[].amount | 量 | number 數值 | 單位 mL;0–5000 | number | number integer |
output.urine[].color | 顏色 | single 單選 | — | string(選項代碼) | code |
output.stool | 大便 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.stool[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.stool[].amount | 量 | single 單選 | — | string(選項代碼) | code |
output.stool[].color | 顏色 | single 單選 | — | string(選項代碼) | code |
care.turning | 翻身 | text 文字 | 最多 2000 字 | string | text |
care.percussion | 拍痰 | text 文字 | 最多 2000 字 | string | text |
care.bed_exercise | 床上運動 | text 文字 | 最多 2000 字 | string | text |
care.sitting | 下床坐 | text 文字 | 最多 2000 字 | string | text |
care.walking | 下床走 | text 文字 | 最多 2000 字 | string | text |
activity.weight | 量體重 | repeatable 重複資料列 | 0–10 列 | object[](整組取代) | rows |
activity.weight[].time | 時間 | time 時間 | — | string "HH:mm" | time |
activity.weight[].weight | 體重 | number 數值 | 單位 kg;1–300 | number | number integer |
care.bedding | 床邊整理 | text 文字 | 最多 2000 字 | string | text |
care.rounds | 巡視 | text 文字 | 最多 2000 字 | string | text |
care.safety | 安全維護 | text 文字 | 最多 2000 字 | string | text |
care.ng_tube | 鼻胃管護理 | text 文字 | 最多 2000 字 | string | text |
care.steam | 蒸氣吸入 | text 文字 | 最多 2000 字 | string | text |
care.other | 其它 | text 文字 | 最多 2000 字 | string | text |
handover.note | 特殊交班 | text 文字 | 最多 2000 字 | string | text |
身分欄位 不在對照中。
輸出入量紀錄(intake-output v1)
| 欄位 ID | 名稱 | 型別 | 限制 | poieti-canonical 值 | 可用編碼 |
|---|---|---|---|---|---|
record.date | 紀錄日期 | date 日期 | — | string "YYYY-MM-DD" | date |
record.kinds | 本次記錄項目 | multi 多選 | — | string[](選項代碼,範本順序) | joined flags |
record.time | 結算時間 | time 時間 | — | string "HH:mm" | time |
intake.injection | 注射量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
intake.injection[].time | 時間 | time 時間 | — | string "HH:mm" | time |
intake.injection[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
intake.injection[].drug | 藥名 | text 文字 | 最多 200 字 | string | text |
intake.injection[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
intake.injection[].note | 備註 | text 文字 | 最多 200 字 | string | text |
intake.transfusion | 輸血量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
intake.transfusion[].time | 時間 | time 時間 | — | string "HH:mm" | time |
intake.transfusion[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
intake.transfusion[].product | 血品 | text 文字 | 最多 200 字 | string | text |
intake.transfusion[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
intake.transfusion[].note | 備註 | text 文字 | 最多 200 字 | string | text |
intake.diet | 飲食量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
intake.diet[].time | 時間 | time 時間 | — | string "HH:mm" | time |
intake.diet[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
intake.diet[].method | 進食方式 | text 文字 | 最多 200 字 | string | text |
intake.diet[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
intake.diet[].note | 備註 | text 文字 | 最多 200 字 | string | text |
intake.other | 其他輸入量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
intake.other[].time | 時間 | time 時間 | — | string "HH:mm" | time |
intake.other[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
intake.other[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
intake.other[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.urine | 小便量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.urine[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.urine[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.urine[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.urine[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.stool | 大便量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.stool[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.stool[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.stool[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.stool[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.sputum | 痰量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.sputum[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.sputum[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.sputum[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.sputum[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.drainage | 引流量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.drainage[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.drainage[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.drainage[].type | 引流種類 | text 文字 | 最多 200 字 | string | text |
output.drainage[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.drainage[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.other | 其他輸出量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.other[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.other[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.other[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.other[].note | 備註 | text 文字 | 最多 200 字 | string | text |
output.dialysis | 洗腎脫水量 | repeatable 重複資料列 | 0–50 列 | object[](整組取代) | rows |
output.dialysis[].time | 時間 | time 時間 | — | string "HH:mm" | time |
output.dialysis[].amount | 量 | number 數值 | 單位 mL;0–10000 | number | number integer |
output.dialysis[].loss | 另有未計量(+LOSS) | boolean 是/否 | — | boolean | boolean |
output.dialysis[].note | 備註 | text 文字 | 最多 200 字 | string | text |
身分欄位 不在對照中。
管路紀錄(line-record v1)
| 欄位 ID | 名稱 | 型別 | 限制 | poieti-canonical 值 | 可用編碼 |
|---|---|---|---|---|---|
record.date | 紀錄日期 | date 日期 | — | string "YYYY-MM-DD" | date |
record.time | 紀錄時間 | time 時間 | — | string "HH:mm" | time |
line.type | 管路種類 | text 文字 | 最多 2000 字 | string | text |
line.size | 規格/尺寸 | text 文字 | 最多 2000 字 | string | text |
line.site | 置入部位 | text 文字 | 最多 2000 字 | string | text |
line.action | 本次處置 | text 文字 | 最多 2000 字 | string | text |
line.condition | 管路及部位狀況 | text 文字 | 最多 2000 字 | string | text |
line.dressing | 敷料與固定 | text 文字 | 最多 2000 字 | string | text |
line.care | 照護紀錄 | text 文字 | 最多 2000 字 | string | text |
身分欄位 不在對照中。
傷口紀錄(wound-record v1)
| 欄位 ID | 名稱 | 型別 | 限制 | poieti-canonical 值 | 可用編碼 |
|---|---|---|---|---|---|
record.date | 紀錄日期 | date 日期 | — | string "YYYY-MM-DD" | date |
record.time | 紀錄時間 | time 時間 | — | string "HH:mm" | time |
wound.site | 傷口部位 | text 文字 | 最多 2000 字 | string | text |
wound.lengthCm | 傷口長度 | number 數值 | 單位 公分;0–100 | number | number integer |
wound.widthCm | 傷口寬度 | number 數值 | 單位 公分;0–100 | number | number integer |
wound.appearance | 傷口外觀 | text 文字 | 最多 2000 字 | string | text |
wound.exudate | 滲液狀況 | text 文字 | 最多 2000 字 | string | text |
wound.surrounding | 周圍皮膚 | text 文字 | 最多 2000 字 | string | text |
wound.pain | 疼痛分數 | number 數值 | 單位 /10;0–10 | number | number integer |
wound.care | 清潔與敷料處置 | text 文字 | 最多 2000 字 | string | text |
身分欄位 不在對照中。
入院護理評估的 149 個欄位見入院護理評估欄位。