範本文件規格

範本清單

範本清單資料上傳 POST API endpoint to: url_root + 'Struct_IotDataUpload'

範本清單資料查詢 POST API endpoint to: url_root + 'Struct_IotDataQuery'

payload Header 規格

// example header info
{
    "fillID": "...",  // 每位使用者有唯一序號
    "chtno": "Shortcut",
    "deptNo": "Short",
    "sheetid": "Shortcut",
    "recType": "list",
    "user": "OL5",   // 使用者代號,部門代號
    "detail": [...]
}

detail array 為表單清單,其中 dictVal 代表表單細項: JSON details 內容 :

  • shortcut: 範本捷徑名稱

  • group: 範本隸屬哪一個作業

  • description: 範本說明

  • templateID: 範本編號 (sheetID)

  • templatename: 範本名稱, 名稱前面有 "__" 代表位於垃圾桶中

  • modifyDate: 範本修改日期

// form list (shortcut list)
{
    "fillID": "64e9669f7bac33d11d90abc9",
    "chtno": "Shortcut",
    "deptNo": "Short",
    "sheetid": "Shortcut",
    "recType": "list",
    "user": "OL5",
    "recDate": "2023-12-06 21:38:43",
    "createDate": "2023-08-26 10:42:39",
    "detail": [
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"s\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"6520d703b512bfdec8482d45\",\"templatename\":\"__test for subject\",\"modifyDate\":\"2023-12-04T14:54:53.570Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"99\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"64f9f137c0611ce82471a5d9\",\"templatename\":\"__99\",\"modifyDate\":\"2023-12-04T14:54:55.328Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"89\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"64f473d5a00771c71708ba65\",\"templatename\":\"__99\",\"modifyDate\":\"2023-12-04T14:54:56.886Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"44\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"64f473f3a00771c71708ba75\",\"templatename\":\"__44\",\"modifyDate\":\"2023-12-04T14:54:58.088Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"2\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"64f473aba00771c71708ba0f\",\"templatename\":\"__temp2\",\"modifyDate\":\"2023-12-04T14:45:25.259Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"66\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"test\",\"templateID\":\"64f9f1cbc0611ce82471a605\",\"templatename\":\"66\",\"modifyDate\":\"2023-12-04T15:04:42.378Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"979\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"656de8311bbb349268a30a40\",\"templatename\":\"780\",\"modifyDate\":\"2023-12-04T14:54:41.470Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"78\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"656de84d1bbb349268a30b00\",\"templatename\":\"780\",\"modifyDate\":\"2023-12-04T14:55:08.916Z\"}"
      },
      {
        "dictID": "",
        "dicName": "",
        "dictVal": "{\"shortcut\":\"011\",\"group\":[\"門\",\"住\",\"急\",\"手術\",\"檢查\"],\"description\":\"\",\"templateID\":\"656dec111bbb349268a30d2e\",\"templatename\":\"nutr01\",\"modifyDate\":\"2023-12-06T13:38:42.656Z\"}"
      }
    ]
  }

範本文件

範本 JSON 文件以 base64 編碼打包成 imgContent 資料上傳 POST API endpoint to: url_root + 'Struct_IotImageUpload'

範本文件資料查詢 POST API endpoint to: url_root + 'Struct_IotImageQuery' 下載 imgContent,以 base64 解碼成範本 JSON 文件

imgContent 資料範例如下:

// form data
{
    "fillID": "...",  // 範本文件索引唯一號
    "chtno": "Shortcut",
    "deptNo": "Short",
    "sheetid": "Shortcut",
    "recType": "template",
    "user": "33F",   // 範本文件所有者
    "detail": [
      {
        "dictType": "SYSTEM",
        "dictID": "60edb642-2028-494f-991c-53ce73f6e3e1",
        "dictName": "templateText",
        "imgName": "templateText",
        "imgContent": "W3siaXRlbXR5cGUiOiJmb3JtIiwiYXV0aHJlYWQiOlsiZG9jdG9yIl0sImF1dGh3cml0ZSI6WyJkb2N0b3IiXSwiZ2V0dGV4dCI6dHJ1ZSwiaXRlbSI6W3siaXRlbWlkIjoyLCJkYXRhdHlwZSI6InRleHRhcmVhIiwiZGF0YXZhbHVlIjoiIiwiZGljdGlvbmFyeSI6Im9wZC50ZXh0IiwiZGljaWQiOiI4ZDc0MGU2Zi01ODdhLTQ1NGMtOWEwNS02MDk3MjdmOWZjZjQiLCJkaWNyb2xlIjoidG9oaXMiLCJ0YWciOiIiLCJmb3JtdWxhIjoiIiwidG9jYWxjIjp0cnVlLCJ0b1NBUyI6ZmFsc2UsImZyb21kaWN0Ijp0cnVlLCJlZm9udGNvbG9yIjoiYmxhY2siLCJlZm9udHNpemUiOiIxNiIsImViYWNrY29sb3IiOiJ3aGl0ZSIsInJlcXVpcmVkIjpmYWxzZSwicmVmZXJlbmNlIjoiIn1dLCJpdGVtaWQiOiIxIn0seyJpdGVtdHlwZSI6ImphdmFzY3JpcHQiLCJjb250ZW50IjoiJCgnLmludGV4dGFyZWEnKS5jc3Moe1xuJ2ZvbnQtZmFtaWx5JzogJ01pY3Jvc29mdCBTYW5zIFNlcmlmJyxcbidiYWNrZ291bmQnOid3aGl0ZScsXG4nZm9udC13ZWlnaHQnOiAnYm9sZCcsXG59KTsifSx7Iml0ZW10eXBlIjoiaW90IiwiZWRpdG9ydmVyIjoiMS41NS4wNSIsInNoZWV0aWQiOiJmOTNhZmM5Ny05NDAzLTQ2MTMtYmQ2Ny0yZjY4M2Q4MDUyMzQiLCJmX29wZG5vIjp0cnVlLCJmX2NodG5vIjpmYWxzZSwidGVtcGxhdGVJRCI6ImY5M2FmYzk3LTk0MDMtNDYxMy1iZDY3LTJmNjgzZDgwNTIzNCIsImZfRFdsb2FkIjoiZl9EV3Bvc3RzZXR2YWx1ZSIsImZfaGlzdGV4dCI6Imhpc3RleHRieWJsb2NrIiwiZl9oaWRlcHJldmljb24iOnRydWUsImZfZGF5IjoiMCIsImRfdXJsIjoiaHR0cHM6Ly9jZ2hhc3AuY2dtaC5vcmcudHcvc3RydWN0dXJlLyIsIm1vZGlmaWVkVXNlciI6Iuael+aYhuWEkiIsIm1vZGlmaWVkRGVwdCI6Iuael+WPo+mVt+W6muaguOWtkOmGq+WtuOenkSIsIm1vZGlmaWVkRGF0ZSI6MTcwMTA2MTc4Njk1NH1d"
      }
    ]
  }

範本 decode JSON 文件說明

利用 GetData() 取得內含區塊,控制像矩陣的表單 JSON 文件,文件以 base64 編碼打成 imgContent,再利用 範本文件資料上傳 POST API 上傳到 HIS 儲存。

範本文件可通過 範本文件資料查詢 POST API,取得 base64 編碼打包資料,解碼後可得 JSON 文件,利用 SetData() 可產生表單。

範本 JSON 文件範例:

// Some code
{

    "itemtype": "form",    (設定區塊種類)
    "item": [
      {
        "itemid": 7,     (控制項項目編號)
        "datatype": "label",   (控制項項目種類) 
        "datavalue": "This is the test Form",  (控制項項目內容)
        "dictionary": "",   (控制項項目字典名稱)
        "formula": "",    (控制項項目函數內容)
        "efontcolor": "#f44336",  (控制項文字顏色)
        "efontsize": "20",        (控制項文字大小)
        "ebackcolor": "#fff2cc",  (控制項文字背景顏色)
        "reference": ""    (控制項內容是否參照其他欄位)
      },

範本預設

範本預設以 base64 編碼打包成 imgContent 資料上傳 POST API endpoint to: url_root + 'Struct_IotImageUpload'

範本文件資料查詢 POST API endpoint to: url_root + 'Struct_IotImageQuery' 下載 imgContent,以 base64 解碼成範本預設

imgContent 資料範例如下:

// form data
{
    "fillID": "...",  // 範本預設索引唯一號
    "chtno": "Shortcut",
    "deptNo": "Short",
    "sheetid": "64e9669f7bac33d11d90abc9",  // 範本文件索引唯一號
    "recType": "templatePreset",   // 預設 recType
    "detail": [
      {
        "dictType": "SYSTEM",
        "dictID": "60edb642-2028-494f-991c-53ce73f6e3e1",  // 預設文件 templatePreset 字典ID
        "dictName": "templatePreset",
        "imgName": "templatePreset",
        "imgContent": "W3siaXRlbXR5cGUiOiJmb3JtIiwiYXV0aHJlYWQiOlsiZG9jdG9yIl0sImF1dGh3cml0ZSI6WyJkb2N0b3IiXSwiZ2V0dGV4dCI6dHJ1ZSwiaXRlbSI6W3siaXRlbWlkIjoyLCJkYXRhdHlwZSI6InRleHRhcmVhIiwiZGF0YXZhbHVlIjoiIiwiZGljdGlvbmFyeSI6Im9wZC50ZXh0IiwiZGljaWQiOiI4ZDc0MGU2Zi01ODdhLTQ1NGMtOWEwNS02MDk3MjdmOWZjZjQiLCJkaWNyb2xlIjoidG9oaXMiLCJ0YWciOiIiLCJmb3JtdWxhIjoiIiwidG9jYWxjIjp0cnVlLCJ0b1NBUyI6ZmFsc2UsImZyb21kaWN0Ijp0cnVlLCJlZm9udGNvbG9yIjoiYmxhY2siLCJlZm9udHNpemUiOiIxNiIsImViYWNrY29sb3IiOiJ3aGl0ZSIsInJlcXVpcmVkIjpmYWxzZSwicmVmZXJlbmNlIjoiIn1dLCJpdGVtaWQiOiIxIn0seyJpdGVtdHlwZSI6ImphdmFzY3JpcHQiLCJjb250ZW50IjoiJCgnLmludGV4dGFyZWEnKS5jc3Moe1xuJ2ZvbnQtZmFtaWx5JzogJ01pY3Jvc29mdCBTYW5zIFNlcmlmJyxcbidiYWNrZ291bmQnOid3aGl0ZScsXG4nZm9udC13ZWlnaHQnOiAnYm9sZCcsXG59KTsifSx7Iml0ZW10eXBlIjoiaW90IiwiZWRpdG9ydmVyIjoiMS41NS4wNSIsInNoZWV0aWQiOiJmOTNhZmM5Ny05NDAzLTQ2MTMtYmQ2Ny0yZjY4M2Q4MDUyMzQiLCJmX29wZG5vIjp0cnVlLCJmX2NodG5vIjpmYWxzZSwidGVtcGxhdGVJRCI6ImY5M2FmYzk3LTk0MDMtNDYxMy1iZDY3LTJmNjgzZDgwNTIzNCIsImZfRFdsb2FkIjoiZl9EV3Bvc3RzZXR2YWx1ZSIsImZfaGlzdGV4dCI6Imhpc3RleHRieWJsb2NrIiwiZl9oaWRlcHJldmljb24iOnRydWUsImZfZGF5IjoiMCIsImRfdXJsIjoiaHR0cHM6Ly9jZ2hhc3AuY2dtaC5vcmcudHcvc3RydWN0dXJlLyIsIm1vZGlmaWVkVXNlciI6Iuael+aYhuWEkiIsIm1vZGlmaWVkRGVwdCI6Iuael+WPo+mVt+W6muaguOWtkOmGq+WtuOenkSIsIm1vZGlmaWVkRGF0ZSI6MTcwMTA2MTc4Njk1NH1d"
      }
    ]
  }

範本預設 decode JSON 文件說明

範本預設 JSON 內容如下:

// Presets data for tumor scan form
presets = 
[
    {
        "name": "lung cancer",
        "user": "OL5",    // 個人表單
        "xmlContent": GetValue()
    },    
    {
        "name": "breast cancer",
        "user": "all",   // 共通性表單
        "xmlContent": GetValue()
    }
]

編輯權限設定

設定表單編輯器權限 JSON 文件

// Some code
{
	"permissions": [
		{
			"userID": "OL5",   // 使用者
			"edit": ["0000"],   // 可編輯表單資料夾(四碼,0代表不管制)
			"download": ["0000"],   // 可下載紀錄資料夾(四碼,0代表不管制)
			"userName": "林昆儒"    // 使用者名稱
		},
		{
			"userID": "P7Q",
			"edit": ["03F0"],
			"download": ["03F0"]
		},
		{
			"userID": "GOO",
			"edit": ["83F0"],
			"download": ["03F0"]
		},
		{
			"userID": "NZA",
			"edit": ["63F0"],
			"download": ["03F0"]
		},
		{
			"userID": "M9R",
			"edit": ["!@00"],
			"userName": "孫偉喬"
		}
	]
}

Last updated