표현식

표현식 함수는 JavaScript 표현식을 평가하는 데 사용할 수 있는 비시각적 위젯입니다. JavaScript 표현식을 작성하여 매쉬업에서 데이터에 대한 유효성 검사, 계산, 변환 및 비교 작업을 수행할 수 있습니다.

매개 변수 옵션을 사용하여 함수에 대한 새 매개 변수를 만들 수 있습니다. 각 매개 변수의 데이터 유형 및 기본값을 설정할 수 있습니다. 매개 변수는 함수가 데이터 값을 저장하는 데 사용합니다. 매개 변수를 만들어 매쉬업의 속성 필드 및 데이터 서비스와 같은 소스의 데이터를 바인딩할 수 있습니다. 모든 매개 변수는 함수에 대한 매개 변수 섹션에 바인딩 가능한 속성으로 나열됩니다.

출력 기본 유형 옵션을 사용하여 매개 변수의 출력 데이터 유형을 선택할 수 있습니다. 데이터 비교 표현식은 부울 출력을 반환합니다. 계산 또는 문자열 조작은 숫자 또는 문자열 데이터 유형을 반환합니다. Output 속성에 대한 대상 위젯이 출력 기본 유형을 지원하는지 확인합니다.

표현식 필드를 사용하여 JavaScript 코드를 정의할 수 있습니다. 산술, 비교 및 정규식을 정의할 수 있습니다.

산술 표현식

• 단순 표현식 - 단순 연산자를 사용하여 더하기, 빼기, 곱하기 및 나누기를 수행합니다. 예:

(Parameter1 + Parameter2) / Parameter3은 Parameter1과 Parameter2의 합을 Parameter3으로 나눈 값을 반환합니다.

• 복잡한 표현식 - 함수를 사용하여 지수, 제곱근 및 자연 로그와 같은 계산을 수행합니다.

Math.pow(Parameter1, Parameter2)는 Parameter1을 Parameter2의 거듭 제곱으로 올린 값을 반환합니다.

비교 표현식

모든 JavaScript 비교 연산자를 사용하여 입력 매개 변수의 데이터를 비교할 수 있습니다.

정규식

표현식 함수는 정규식에 JavaScript 표시법을 지원합니다. 정규식을 사용하면 다음 구문을 사용하여 입력 데이터의 유효성을 검사하고 필터링할 수 있습니다.

• /<expression>/.test(<parameter>)

◦ <expression> - 평가할 정규식입니다.

◦ test() - 지정된 데이터 매개 변수를 표현식과 비교하는 방법입니다.

◦ <parameter> - 평가할 데이터를 포함하는 매개 변수의 이름입니다.

• /^(?:\d{3}\-){2}\d{4}$/.test(phoneNumber)

◦ ^ - 문자열의 시작입니다.

◦ (?:\d{3}\-){2} - 세 자리 숫자 다음에 대시가 나오고 이 패턴이 두 번 반복되는 값(###-###-)과 일치합니다.

◦ \d{4} - 단일 숫자가 네 번 반복되는 값(####)과 일치합니다.

◦ $ - 문자열의 끝입니다.

JavaScript 예외 로깅

예외는 JavaScript 표현식에서 오류를 반환할 때 발생합니다. TW.log.error 메소드를 사용하여 예외를 로깅할 수 있습니다. 다음 예에서는 함수가 정의되지 않았기 때문에 예외가 발생합니다.

try {
	undefinedFunction();
}
catch (e){
	TW.log.error("The function does not exist: " + e);
}

런타임 동안 오류가 로깅됩니다. 상단 도구 모음에서 로그 표시/숨기기를 클릭하여 Mashup Builder 로그를 표시하거나 숨깁니다.

표현식 함수 옵션

다음과 같은 구성 옵션을 설정할 수 있습니다.

• 설명 - 함수에 대한 설명을 설정합니다.

• 매개 변수 - 함수에 대한 사용자 정의 매개 변수를 지정합니다.

• 식 - 평가할 JavaScript 식입니다.

• 자동 평가 - 입력 매개 변수 데이터가 변경될 때 표현식을 자동으로 평가합니다.

• 첫 번째 값에서 실행 - 첫 번째 값이 전달될 때 JavaScript 표현식을 평가합니다. 두 번째 값이 전달될 때는 표현식이 평가되지 않습니다.

• 데이터 변경 유형 - 변경된 이벤트가 트리거되는 때를 제어합니다.

• 출력 기본 유형 - 표현식 출력의 데이터 유형입니다.

• 초기 출력 사용 안 함 - 식을 계산하기 전에 함수가 초기 정의되지 않은 값을 Output 속성에 할당하지 않도록 합니다.

표현식 함수 만들기

1. 함수 패널에서

을 클릭합니다. 새 함수 대화 상자가 열립니다.

2. 드롭다운 목록에서 식을 선택합니다.

3. 함수의 이름을 입력한 후 다음을 클릭합니다.

4. 식에 평가할 JavaScript 식을 입력합니다.

5. 데이터 입력 매개 변수 추가

a. 매개 변수 추가를 클릭합니다.

b. 매개 변수 이름을 입력합니다.

c. 기본값과 도구 설명을 입력한 다음 매개 변수 기본 유형을 선택합니다.

6. 출력 기본 유형 드롭다운 목록에서 데이터 유형을 선택합니다.

7. 완료를 클릭합니다.

함수는 표현식 카테고리 아래의 함수 패널에 추가됩니다.

속성

표현식 함수에는 다음과 같은 속성이 포함됩니다.

속성	설명	기본 유형	기본값	바인딩 가능 여부 (Y/N)	로컬리제이션 가능 여부 (Y/N)
Evaluate	표현식을 평가하는 바인딩 가능한 서비스입니다.	해당 없음	해당 없음	Y	N
Changed	데이터가 변경될 때 이벤트를 트리거하는 바인딩 가능한 속성입니다.	해당 없음	해당 없음	Y	N
Output	평가된 표현식의 출력입니다. 표현식 필드에서 직접 이 속성에 대한 바인딩을 설정할 수 있습니다. 바인딩을 설정하려면 output=<> 을 입력합니다. 이 속성이 초기 정의되지 않은 값을 보내지 않도록 하려면 초기 출력 사용 안 함 확인란을 선택합니다.	해당 없음	해당 없음	Y	N

도움이 되셨나요?