Terminology関連カスタムオペレーション
機能概要
- CSV形式によるCodeSyetemのアップロード機能、及びConceptMapのインポート/エクスポート機能をサポートします。
サポートするオペレーションは以下の通りです。
$upload-code-system
- CSV形式ファイル、ZIPファイルをアップロードし、CodeSystemリソースとして取込みます。
※ ZIPファイルの中身はconcepts.csv と hierarchy.csv(オプション)
リクエスト形式
POST [base]/CodeSystem/$upload-code-system?[parameters]
- CSVファイルの場合
- Content-Type:text/csv; charset=CSVファイルの文字コード
- ZIPファイルの場合
- Content-Type:application/zip; charset=CSVファイルの文字コード
入力パラメータ
# | パラメータ名 | 多重度 | 説明 | 備考 |
---|---|---|---|---|
1 | system | 1..1 | コードシステムのURL | |
2 | version | 0..1 | コードシステムのバージョン | 指定しない場合、URLが一致しバージョンが存在しないリソースが対象 |
3 | kind | 1..1 | アップロードするファイルの種類 | 0:CSVファイル(concepts.csv) 1:ZIPファイル(concepts.csv、hierarchy.csv) 2:ICD10対応標準病名マスター(MEDIS) 3:医薬品HOTコードマスター(MEDIS) ※HOT13のみ |
4 | category | 0..1 | アップロードするファイルの分類 | ICD10対応標準病名マスターの場合必須 0:病名基本テーブル 1:修飾語テーブル |
リクエストボディ
- CSVファイルの場合
- テキストデータとして指定
- ZIPファイルの場合
- バイナリデータとして指定
※ 必須入力パラメータ(system、kind)、またはリクエストボディが指定されていない場合はエラーが返却されます。
CSVフォーマット
concepts.csv(コード一覧を記載したCSV)
CODE
:概念を識別するコードDISPLAY
:ユーザーに表示するテキスト
※ #
で始まるコメント 行および空白行は無視されます。
hierarchy.csv(コードの親子関係を記載したCSV)
PARENT
:親のコンセプトコード(concept.code)CHILD
:子のコンセプトコード(concept.code)
※ #
で始まるコメント行および空白行は無視されます。
ICD10対応標準病名マスター
- MEDIS ICD10対応標準病名マスターを参照してください。
医薬品HOTコードマスター
- MEDIS 医薬品HOTコードマスターを参照してください。
例
CSVファイルの場合
リクエスト
POST [base]/CodeSystem/$upload-code-system?system=http://hl7.org/fhir/CodeSystem/example&kind=0
リクエストボディ
CODE,DISPLAY
F,完治
N,不変
W,悪化
レスポンス
{
"resourceType": "CodeSystem",
"id": "4",
"meta": {
"versionId": "4",
"lastUpdated": "2021-10-27T13:35:46.351+09:00"
},
"url": "http://hl7.org/fhir/CodeSystem/example",
"status": "active",
"content": "complete",
"concept": [
{
"code": "F",
"display": "完治"
},
{
"code": "N",
"display": "不変"
},
{
"code": "W",
"display": "悪化"
}
]
}
ZIPファイルの場合
リクエスト
POST [base]/CodeSystem/$upload-code-system?system=http://hl7.org/fhir/CodeSystem/example&kind=1
リクエストボディ
concepts.csv
CODE,DISPLAY
CHEM,化学
HB,ヘモグロビン
MICRO,微生物学
C&S,培養と感受性
C,培養
hierarchy.csv
PARENT,CHILD
CHEM,HB
MICRO,C&S
C&S,C
レスポンス
{
"resourceType": "CodeSystem",
"id": "14",
"meta": {
"versionId": "2",
"lastUpdated": "2021-10-29T16:22:17.082+09:00"
},
"url": "http://hl7.org/fhir/CodeSystem/example",
"status": "active",
"content": "complete",
"concept": [
{
"code": "CHEM",
"display": "化学",
"concept": [
{
"code": "HB",
"display": "ヘモグロビン"
}
]
},
{
"code": "MICRO",
"display": "微生物学",
"concept": [
{
"code": "C&S",
"display": "培養と感受性",
"concept": [
{
"code": "C",
"display": "培養"
}
]
}
]
}
]
}
$upload-delta-add
- CSVファイルまたはZIPファイルによる、CodeSystemリソースの差分の追加処理を実行します。
※ ZIPファイルの中身はconcepts.csv と hierarchy.csv(オプション)
POST [base]/CodeSystem/$upload-delta-add?[parameters]
- CSVファイルの場合
- Content-Type:text/csv; charset=CSVファイルの文字コード
- ZIPファイルの場合
- Content-Type:application/zip; charset=CSVファイルの文字コード