HIS資料查詢 API

由醫科提供，協助結構化工具統合運用，促進病歷紀錄自動化以及臨床決策分析

HIS函數參數

// Some code
public class StrucWebApiInput
{
    public string CHTNO { get; set; }
    public string OPDCSN { get; set; }
    public string USERIDNO { get; set; } // 身份證字號
    public DateTime TimeStamp { get; set; }
    public List<KeyValuePair<string, string>> Functions { get; set; }
}
public class StrucWebApiOutput
{
    public int Code { get; set; }
    public string Message { get; set; }
    public DateTime TimeStamp { get; set; }
    public List<FunctionValue> FunctionSets { get; set; }

    public StrucWebApiOutput()
    {
        FunctionSets = new List<FunctionValue>();
    }
}
public class FunctionValue
{
    public int Code { get; set; }
    public string Message { get; set; }
    public string Key { get; set; }
    public string Value { get; set; }
}

輸入參數

• CHTNO:病歷號

• OPDCSN:門診號/住院號

• USERIDNO: 身份證字號, 判定是否有權限取得VIP特權病患的門急診病歷，沒有傳無法回傳特權病歷內容。

• TimeStamp:時間戳記

• Functions:

  • Key: 辨識用ID

  • Value: 對應字串

對應字串說明

應對字串以符號 " . " 區隔類別、搜尋條件、取值條件 ，可用類別如下:

• LABDATA:

  • 搜尋條件:

    • InDays:幾日內的資料

    • InDr:特定醫師開立

    • InName:開立項目名稱(ex:WBC、Creatinine)；可用逗號,同時搜尋多個項目

    • InItem:開立代碼(ex:72-001、72-505)；可用逗號,同時搜尋多個項目

    • InAbnormal:異常值(H,L，未填則包含所有異常)

  • 取值條件，限定一個

    • GetValueByName:取得特定項目名稱的數值(ex:WBC、Creatinine)

    • GetDateByName:取得特定項目的日期(ex:WBC、Creatinine)

    • GetAllString:將所有搜尋到的項目以文字格式回傳

    • GetLatestString:將搜尋到的項目中，日期為最近日期的項目以文字格式回傳

對應字串範例

// Functions.Value
LABDATA.InDays(30).InDr(2517).InItem(72-001).InName(WBC,RBC).GetValueByName(WBC)

Sample query string:

// Some query string
{
  "CHTNO": "500",
  "OPDCSN": "",
  "USERIDNO":"",   // 傳入參數新增USERIDNO(身份證字號)，判定是否有權限取得VIP病患的門急診病歷
  "TimeStamp": "",
  "Functions": [
    {
      "1": "LABDATA.InDays(180).GetValueByName(PCO2)"
    },
    {
      "2": "LABDATA.InDays(30).InItem(72-333).GetDateByName()"
    },
    {
      "3": "LABDATA.InDays(30).InItem(72-333).GetValueByName(Creatinine)"
    }
  ]
}

Sample c# code

// Some code
void StructureFormWebApi()
{
    StrucWebApiInput input = new StrucWebApiInput()
    {
        CHTNO = "4007873",
        OPDCSN = "",
        USERIDNO = "",   // 傳入參數新增USERIDNO(身份證字號)，判定是否有權限取得VIP病患的門急診病歷
        TimeStamp = DateTime.Now,
        Functions = new List<KeyValuePair<string, string>>()
        {
            new KeyValuePair<string, string>("1", @"LABDATA.InDays(180).GetValueByName(PCO2)"),
            new KeyValuePair<string, string>("2", @"LABDATA.InDays(30).InItem(72-333).GetDateByName()"),
            new KeyValuePair<string, string>("3", @"LABDATA.InDays(30).InItem(72-333).GetValueByName(Creatinine)")
        }

    };
    string inputString = JsonConvert.SerializeObject(input);
    WebClient webClient1 = new WebClient();
    webClient1.Headers.Add("Content-Type", "application/json");
    webClient1.Encoding = Encoding.UTF8;
    var result = webClient1.UploadString(@"http://10.30.111.79:45678/api/StrucFunction/FetchData1", inputString);
    var res = JsonConvert.DeserializeObject<StrucWebApiOutput>(result);   
}

輸出參數

• Code:結果代碼

• Message:結果訊息

• TimeStamp:時間戳記

• FunctionSets:回傳清單(FunctionValue結構)

  • FunctionValue:

  • Code:結果代碼

  • Message:結果訊息

  • Key:對應輸入參數的Key值

  • Value:結果值

Sameple result 值

// Some result 
{
  "Code": 0,
  "Message": "API呼叫成功",
  "TimeStamp": "2024-01-08T16:48:47+08:00",
  "FunctionSets": [
    {
      "Code": 0,
      "Message": "呼叫成功，SQL回傳對應資料",
      "Key": "1",
      "Value": "    38.4"
    },
    {
      "Code": 0,
      "Message": "呼叫成功，SQL回傳對應資料",
      "Key": "2",
      "Value": "20231220"
    },
    {
      "Code": 0,
      "Message": "呼叫成功，SQL回傳對應資料",
      "Key": "3",
      "Value": "1.06"
    }
  ]
}