MedTech 서비스 디바이스 매핑과 함께 사용자 지정 함수를 사용하는 방법

JMESPath를 식 언어로 사용할 때 많은 함수를 사용할 수 있습니다. JMESPath 사양의 일부로 사용할 수 있는 기본 제공 함수 외에도 더 많은 사용자 지정 함수를 사용할 수 있습니다. 이 문서에서는 MedTech 서비스 디바이스 매핑과 함께 MedTech 서비스 관련 사용자 지정 함수를 사용하는 방법을 설명합니다.

MedTech 서비스 매핑 디버거를 사용하여 MedTech 서비스 디바이스 및 FHIR® 대상 매핑을 만들고 업데이트하고 문제를 해결하도록 지원할 수 있습니다. 매핑 디버거를 사용하면 Azure Portal을 벗어나지 않고도 실시간으로 인라인을 쉽게 보고 조정할 수 있습니다. 매핑 디버거는 테스트 디바이스 메시지를 업로드하여 해당 메시지가 정규화된 메시지로 처리되고 FHIR 관찰로 변환된 후 어떻게 표시되는지 확인할 수도 있습니다.

함수 시그니처

각 함수에는 JMESPath 사양을 따르는 시그니처가 있습니다. 이 시그니처는 다음과 같이 나타낼 수 있습니다.

return_type function_name(type $argname)

시그니처는 인수에 유효한 형식을 나타냅니다. 인수에 잘못된 형식이 전달되면 오류가 발생합니다.

앞에서 설명한 대로 이러한 함수는 JmesPath를 식 언어로 지정할 때만 사용할 수 있습니다. 기본적으로 식 언어는 JsonPath입니다. 식을 정의할 때 식 언어를 변경할 수 있습니다.

예시:

"templateType": "CalculatedContent",
    "template": {
        "typeName": "heartrate",
        "patientIdExpression": {
            "value": "insertString('123', 'patient', `0`) ",
            "language": "JmesPath"
        },
        ...
    }

이 예제에서는 insertString 식을 사용하여 환자 ID patient123을 생성합니다.

리터럴 값

상수 값을 함수에 제공할 수 있습니다.

• 숫자 값은 백틱(`)으로 묶어야 합니다.
  • 예: add(`10`, `10`)
• 문자열 값은 작은따옴표(')로 묶어야 합니다.
  • 예: insertString('mple', 'sa', `0`)

자세한 내용은 JMESPath 사양을 참조하세요.

예외 처리

예외는 디바이스 데이터 처리 수명 주기 내의 다양한 시점에서 발생할 수 있습니다. 예외가 발생할 수 있는 다양한 시점은 다음과 같습니다.

수학 함수

추가

number add(number $left, number $right)

오른쪽 인수에 왼쪽 인수를 추가한 결과를 반환합니다.

예:

divide

number divide(number $left, number $right)

왼쪽 인수를 오른쪽 인수로 나눈 결과를 반환합니다.

예:

multiply

number multiply(number $left, number $right)

왼쪽 인수에 오른쪽 인수를 곱한 결과를 반환합니다.

예:

pow

number pow(number $left, number $right)

왼쪽 인수의 오른쪽 인수 거듭제곱 값을 구한 결과를 반환합니다.

예:

subtract

number subtract(number $left, number $right)

왼쪽 인수에서 오른쪽 인수를 뺀 결과를 반환합니다.

예:

문자열 함수

insertString

string insertString(string $original, string $toInsert, number pos)

문자열 original에 toInsert 값을 삽입하여 새 문자열을 생성합니다. 이 문자열은 문자열 original 내의 위치 pos에 삽입됩니다.

위치 인수가 0부터 시작하는 경우 0의 위치는 문자열 내의 첫 번째 문자를 나타냅니다.

제공된 위치 인수가 original의 길이 범위를 벗어나면 오류가 발생합니다.

예:

날짜 함수

fromUnixTimestamp

string fromUnixTimestamp(number $unixTimestampInSeconds)

지정된 Unix 타임스탬프에서 ISO 8061 호환 타임스탬프를 생성합니다. 타임스탬프는 Epoch(1970년 1월 1일) 이후부터의 초 수로 표시됩니다.

예:

fromUnixTimestampMs

string fromUnixTimestampMs(number $unixTimestampInMs)

지정된 Unix 타임스탬프에서 ISO 8061 호환 타임스탬프를 생성합니다. 타임스탬프는 Epoch(1970년 1월 1일) 이후부터의 밀리초 수로 표시됩니다.

예:

다음 단계

MedTech 서비스 디바이스 매핑 개요

MedTech 서비스 FHIR 대상 매핑 개요

MedTech 서비스 시나리오 기반 매핑 샘플 개요