TransformerRuleList - 범위가 지정됨, 전역
TransformerRuleList API를 사용하면 다양한 유형의 JSON 및 XML 데이터를 이름-값 쌍 출력으로 변환하기 위한 규칙 목록을 만들 수 있습니다.
이 API는 Transformer 및 TransformerDefinition API와 함께 작동합니다. 이러한 API는 XML 노드 또는 구조화된 JSON 문서의 모든 엔터티를 이름-값 쌍의 출력으로 변환합니다. 문자열, 숫자 및 기타 배열과 같은 배열 내의 객체 및 요소를 포함하여 지원되는 JSON 엔터티입니다.
TransformerRuleList API를 사용하면 출력에 포함할 소스 문서의 데이터와 소스 데이터를 변환하는 방법을 정의하는 변환 규칙 목록을 만들 수 있습니다.
TransformerDefinition API는 변환 규칙 목록을 JSON/XML 기록 경로와 연결하여 재사용 가능한 변환 정의 객체를 정의합니다. 변환 정의 개체를 사용하여 하나 이상의 소스 문서를 변환할 수 있습니다.
변환기 API는 지정된 변환 규칙 목록을 사용하여 한 번에 하나의 데이터 엔터티로 실제 데이터 변환을 수행하여 원하는 출력 데이터를 생성합니다.
TransformRuleList 객체를 인스턴스화할 때 .fromJSON() 또는 .fromXML() 메서드를 사용하여 JSON 또는 XML 소스 문서를 설명하는지 여부를 정의해야 합니다. 예:
var trl = sn_tfrm입니다. TransformerRuleList().fromJSON(); 또는 var trl = sn_tfrm. TransformerRuleList().fromXML();
그런 다음 addRule() 메서드를 사용하여 출력에 이름-값 쌍으로 포함할 소스 문서의 각 요소에 대한 변형 규칙을 정의합니다.
- 텍스트를 연결합니다.
- 더하기, 빼기, 나누기, 곱하기와 같은 수학 함수를 수행합니다.
- 값을 위로 또는 아래로 반올림합니다(반올림/반올림, 천장/바닥).
- 원본 데이터 요소를 지정된 값과 비교할 때 최소값 또는 최대값을 사용할지 여부를 정의합니다.
- 통화 코드를 적용합니다.
- 다른 측정 단위 간에 변환합니다.
- 데이터 요소 서식을 지정합니다.
- 패턴을 적용합니다.
- 지정된 데이터 요소를 지정된 값으로 대체합니다.
- 문자열을 분할하고 다시 정렬합니다.
TransformerRuleList 클래스는 범위가 지정된 서버 스크립트와 전역 서버 스크립트 모두에서 사용할 수 있습니다. 범위가 지정된 애플리케이션에서 이 클래스를 사용하는 경우 sn_tfrm 네임스페이스 식별자를 사용합니다. 또한 인스턴스에서 이 API를 사용하려면 먼저 변환 서비스 플러그인(com.glide.transform)을 활성화해야 합니다.
TransformerRuleList - addRule(문자열 규칙, 문자열 경로)
출력에 작성할 필드를 정의하는 관련 변환 규칙 목록에 항목을 작성합니다.
소스 문서의 모든 요소에 대한 규칙을 만들 수 있습니다. 예를 들어, .addRule('ticker', '$.quote.symbol') 은 출력에 "ticker" 필드를 만들고 소스의 quote.symbol에 있는 값을 복사합니다.
addRule()을 사용하여 규칙을 정의한 후에는 thenAdd(),thenReplace() 및 thenFloor()와 같은 어댑터 메서드를 사용하여 규칙의 출력 데이터를 조작합니다. 단일 규칙에 필요한 만큼 어댑터 메서드를 정의할 수 있습니다. addRule() 호출 직후의 모든 어댑터 메소드는 다음 addRule() 호출까지 해당 규칙에 적용됩니다. 어댑터 메서드는 모든 어댑터 메서드의 결과가 출력 필드에 저장된 최종 값으로 누적됩니다.
예를 들어, 다음 코드 스니펫에서 thenMultiply() 및 thenRoundDown() 은 addRule('change_percentage', '$.quote.changePercent')에 적용됩니다. addRule('close_price', '$.quote.close') 는 새 규칙을 시작합니다. 값이 $.quote.changePercent .011이면 최종 출력 값은 "1"( .011 * 100을 1 위치로 반올림)입니다.
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close') addRule() 메서드는 매개 변수summary도 지원합니다. .addRule('summary')입니다. 이 구현에서는 출력에 이름 필드 "summary:"가 생성되지만 소스의 필드와 상관 관계가 지정되지는 않습니다. 그런 다음 어댑터 메서드 thenConcat() 및 thenConcatSymbol() 을 사용하여 요약 필드의 내용을 수정할 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 규칙 | 문자열 | 대상 출력의 요소 이름입니다. |
| path | 문자열 | 옵션입니다. JSONPath 또는 XPath를 소스 문서의 데이터 요소에 추가합니다. 어댑터 메소드 thenConcat() 및 thenConcatSymbol() 은 규칙에 대해 다른 어댑터 메소드가 정의되지 않은 경우 이 매개변수를 정의할 필요가 없습니다. 다른 모든 어댑터 메서드에는 이 매개 변수가 필요합니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - setName(문자열 이름)
로깅을 위해 연결된 TransformerRuleList 오브젝트의 이름을 정의합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 연결된 TransformerRuleList 객체를 식별하는 데 사용되는 이름입니다. API가 이 이름을 고유하게 만들도록 강제하지는 않지만 인스턴스 내에서 고유한 경우 유용합니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - thenAdaptCurrency(문자열 currencyCode, 부울 outputNumericCurrencyValue)
연결된 addRule() 호출에 정의된 출력 필드에 지정된 통화 코드를 연결하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| currencyCode | 문자열 | 대상 데이터 요소에 연결할 통화 코드(예: USD, EUR 및 GBP)입니다. |
| outputNumericCurrencyValue (출력 숫자 통화 값) | 부울 | 옵션입니다. 통화 코드를 표시할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: false |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - thenAdaptDuration(문자열 inputDuration, 문자열 outputDuration)
소스 필드를 한 측정 단위에서 다른 측정 단위로(예: 분에서 초로 또는 주에서 일로) 변환하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| inputDuration (입력) | 문자열 | 소스 필드의 현재 측정 단위입니다. 유효한 값은 다음과 같습니다.
|
| 출력 지속 시간 | 문자열 | 출력에서 소스 필드를 변환할 측정 단위입니다. 유효한 값은 다음과 같습니다.
|
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('daily', '$.quote.weekly')
.thenAdaptDuration('WEEK', 'DAY');
TransformerRuleList - thenAdd(번호 피연산자)
소스 필드에 전달된 값을 추가하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드에 추가할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList.fromJSON()
.setName('Stock Report 05182019 JSON')
.addSymbol('ticker', '$.symbol')
.addSymbol('change_percentage', '$.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addSymbol('trade_price', '$.current_price')
.thenAdaptCurrency('USD', false)
.addMultiply('$.trade_quantity')
.thenAdd('4.5');
TransformerRuleList - thenApplyMap(오브젝트 맵)
연결된 소스 필드에서 문자열 목록을 검색하고 출력에서 문자열 목록을 지정된 대체 값으로 대체하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 맵 | 객체 | 이름/값 쌍.
|
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
이 예제에서 thenApplyMap() 호출은 company_info 필드의 소스 텍스트에서 Inc. 및 St.를 검색하고 출력의 company_info 필드에서 Incorporated 및 Street로 바꿉니다.
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('company_info', '$.quote.company_info')
.thenApplyMap({'Inc.': 'Incorporated', 'St.': 'Street'});
TransformerRuleList - thenApplyPattern(문자열 matchPattern, 문자열 outputPattern
지정된 정규 표현식 패턴과 소스 필드의 콘텐츠와 일치하는 어댑터를 현재 규칙에 추가한 다음 해당 콘텐츠를 두 번째 정규 표현식 패턴으로 바꾸거나 다시 포맷하고 해당 값을 출력에 저장합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| matchPattern (영문) | 문자열 | 바꾸거나 다시 포맷할 텍스트를 찾는 데 사용할 정규 표현식 패턴입니다. |
| 출력 패턴 | 문자열 | 찾은 텍스트를 업데이트하는 데 사용할 정규 표현식 패턴입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
이 예에서 "Inc."로 끝나는 회사 이름은 "Incorporated"로 변환됩니다(예: Company Inc.에서 Company Incorporated로).
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('company', '$.quote.company')
.thenApplyPattern('(.+)(\\w{3}\\.)', '$1Incorporated');
TransformerRuleList - thenCeiling(번호 피연산자)
전달된 값으로 지정된 소수점에서 소스 필드를 반올림하는 작업을 현재 규칙에 추가합니다.
지정된 소수 자릿수(0-4 반올림, 5-9 반올림)의 숫자 값을 기준으로 숫자를 반올림하는 직선 반올림과 달리 ceiling은 항상 반올림합니다. 예를 들어, 2.156 및 2.152의 상한 값은 전달된 소수점 위치 2에 대해 항상 2.16입니다. 직선 반올림의 경우 값은 각각 2.16과 2.15입니다. 음수의 경우 천장 작업은 -2.156의 천장 값이 -2.15인 것처럼 숫자를 더 양수로 만듭니다. 같은 숫자를 반올림하면 값이 더 음수(-2.16)가 됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 숫자를 반올림할 소수점 오른쪽의 소수점 위치입니다(천장 적용). 예를 들어 이 값이 2이고 원본 데이터 요소가 6.421이면 결과 값은 6.43입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Mortgage Rates 05022019 JSON')
.addRule('interest_rate', '$.quote.interest_rate')
.thenCeiling('2') // Always round the interest rate up to the hundredths place
.addRule('monthly_payment', '$.quote.total_loan_amount')
.thenDivideBy('180');
TransformerRuleList - thenConcat(문자열 값)
전달된 문자열을 출력 필드에 연결하는 현재 규칙에 어댑터를 추가합니다.
다른 어댑터 메서드와 달리 이 메서드는 소스 필드에 적용할 필요가 없습니다. 이 방법을 사용하여 출력에 완전히 새로운 데이터 문자열을 만들 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 값 | 문자열 | 현재 데이터 요소의 끝에 연결할 텍스트입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - thenConcatSymbol(문자열 기호)
이전에 규칙 목록에 정의된 필드의 값을 현재 출력 필드에 연결하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 상징 | 문자열 | 출력 필드에 추가할 규칙 목록 요소의 이름입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - thenDivideBy(Number 피연산자)
소스 필드를 전달된 값으로 나누는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드를 분할할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('dividend_per_share', '$.quote.total_dividend')
.thenDivideBy('$.quote.total_shares');
TransformerRuleList - thenDivideInto(번호 피연산자)
전달된 값을 소스 필드로 나누는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드를 분할할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('dividend_per_share', '$.quote.total_shares')
.thenDivideInto('$.quote.total_dividends');
TransformerRuleList - thenFloor(번호 피연산자)
전달된 값으로 지정된 소수 자릿수에서 소스 필드를 반올림하고 출력에 저장하는 현재 규칙에 어댑터를 추가합니다.
지정된 소수 자릿수(0-4 반올림, 5-9 반올림)의 숫자 값을 기준으로 숫자가 반올림되는 직선 반올림과 달리 floor는 항상 내림됩니다. 예를 들어, 2.156 및 2.152의 바닥 값은 전달된 소수점 위치 2에 대해 항상 2.15입니다. 직선 반올림의 경우 값은 각각 2.16과 2.15입니다. 음수의 경우 바닥 연산은 -2.156의 바닥 값이 -2.16인 것처럼 숫자를 더 음수로 만듭니다. 같은 숫자를 반올림하면 값이 더 양수인 -2.15가 됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 숫자를 내림할 소수점 오른쪽의 소수점 위치입니다(floor 적용). 예를 들어 이 값이 2이고 원본 데이터 요소가 6.427이면 결과 값은 6.42입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Mortgage Rates 05022019 JSON')
.addRule('interest_rate', '$.quote.interest_rate')
.thenFloor('2') // Always round the interest rate down to the hundreths place
.addRule('monthly_payment', '$.quote.total_loan_amount')
.thenDivideBy('180');
TransformerRuleList - thenFormat(문자열 일치 패턴, 문자열 출력 패턴)
지정된 출력 패턴과 일치하는 소스 필드의 컨텐츠 형식을 다시 지정하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| matchPattern (영문) | 문자열 | 소스 필드와 일치하는 패턴입니다. 유효한 값은 다음과 같습니다.
|
| 출력 패턴 | 문자열 | 출력에서 콘텐츠를 대체할 패턴입니다. 유효한 값은 다음과 같습니다.
|
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
이 예에서는 견적 날짜의 형식을 YYYY/MM/DD에서 YYYY MM-DD로 다시 지정합니다.
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('date', '$.quote.date')
.thenFormat('####/##/##', '#### ##-##');
TransformerRuleList - thenMax(번호 피연산자)
전달된 값을 소스 필드와 비교하고 두 값 중 큰 값을 출력 필드에 복사하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드와 비교할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Mortgage Rates 05022019 JSON')
.addRule('lowest_interest_rate', '$.quote.interest_rate')
.thenMax('3.5') // Interest rate cannot be less than 3.5%
.addRule('dividend_per_share', '$.quote.total_shares')
.thenDivideInto('$.quote.total_dividends');
TransformerRuleList - thenMin(Number 피연산자)
전달된 값을 소스 필드와 비교하고 두 값 중 낮은 값을 출력 필드에 복사하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드와 비교할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addSymbol('broker_fee_percentage', '$.quote.broker_fee')
.thenMin('10') // Maximum of 10% broker fee
.addSymbol('dividend_per_share', '$.quote.total_shares')
.thenDivideInto('$.quote.total_dividends');
TransformerRuleList - thenMultiply(Number 피연산자)
소스 필드에 전달된 값을 곱하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 필드를 곱할 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('summary')
.thenConcat('Shares of ')
.thenConcatSymbol('ticker')
.thenConcat(' closed at ')
.thenConcatSymbol('close_price');
TransformerRuleList - thenReplace(문자열 matchString, 문자열 replaceString)
소스 필드 내에서 지정된 문자열과 일치하는 모든 텍스트를 찾아 업데이트된 문자열로 대체하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| matchString (영문) | 문자열 | 바꿀 텍스트를 식별하기 위해 소스 필드와 일치하는 문자열입니다. |
| replace문자열 | 문자열 | 일치하는 텍스트를 대체할 문자열입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
이 예에서 "Inc."로 끝나는 회사 이름은 "Incorporated"로 변환됩니다(예: Company Inc.에서 Company Incorporated로).
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('company', '$.quote.company')
.thenReplace('Inc.', 'Incorporated');
TransformerRuleList - thenRoundDown(번호 피연산자)
전달된 값으로 지정된 소수 자릿수에서 소스 필드를 내림하는 현재 규칙에 어댑터를 추가합니다.
음수의 경우 thenRoundDown() 메서드는 숫자를 더 양수로 만듭니다. -2.156의 반올림 값은 -2.15입니다. thenFloor() 메서드는 같은 숫자를 음수인 -2.16으로 만듭니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 숫자를 반올림할 소수점 오른쪽의 소수점 위치입니다. 예를 들어 이 값이 2이고 원본 데이터 요소가 6.427이면 결과 값은 6.42입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList90
.fromJSON()
.setName('Mortgage Rates 05022019 JSON')
.addRule('interest_rate', '$.quote.interest_rate')
.thenRoundDown('2') // Always round the interest rate down to the hundredths place
.addRule('monthly_payment', '$.quote.total_loan_amount')
.thenDivideBy('180');
TransformerRuleList - thenRoundUp(Number 피연산자)
전달된 값으로 지정된 소수 자릿수에서 원본 데이터 요소를 반올림하는 현재 규칙에 어댑터를 추가합니다.
음수의 경우 thenRoundUp() 메서드는 숫자를 더 음수로 만듭니다. -2.156의 반올림 값은 -2.16입니다. thenCeiling() 메서드는 같은 숫자를 더 양수로 만듭니다(-2.15).
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 숫자를 반올림할 소수점 오른쪽의 소수점 위치입니다. 예를 들어 이 값이 2이고 원본 데이터 요소가 6.422인 경우 결과 값은 6.43입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Mortgage Rates 05022019 JSON')
.addRule('interest_rate', '$.quote.interest_rate')
.thenRoundUp('2') // Always round the interest rate up to the hundredths place
.addRule('monthly_payment', '$.quote.total_loan_amount')
.thenDivideBy('180');
TransformerRuleList - thenSplit(문자열 splitPattern, 문자열 replaceString)
소스 필드 내에서 문자열을 분할, 재구성 및 대체하는 현재 규칙에 어댑터를 추가하고 출력 필드에 저장합니다.
이 매개변수는 splitPattern 원본 텍스트 문자열을 세그먼트로 분할하는 방법을 나타냅니다. 이 매개 변수는 공백(' '), 쉼표(',') 또는 세미콜론(';')과 같은 일반적인 단어 구분 기호일 수 있으며 'name'과 같은 문자열일 수도 있습니다. 예를 들어 원본 텍스트가 "Smith John Michael"이고 공백 splitPattern 인 경우 사용 가능한 세그먼트는 "Smith", "John" 및 "Michael"입니다. 세그먼트를 참조하려면 $#을 사용하며, 여기서 #은 소스 텍스트 문자열에서 세그먼트 순서의 번호입니다. 예를 들어, 메서드 호출이 thenSplit(' ', '$2 $3 $1')이면 출력값은 "John Michael Smith"입니다. 또한 출력 패턴 내에 상수를 추가할 수 있습니다(예: thenSplit(' ', 'First name: $2 Middle name: $3 Last name: $1')).
| 이름 | 유형 | 설명 |
|---|---|---|
| splitPattern (분할 패턴) | 문자열 | 텍스트를 세그먼트로 분할하는 방법을 나타내는 문자열입니다. |
| replace문자열 | 문자열 | 세그먼트 참조 및 상수를 포함한 출력 문자열을 정의하는 문자열입니다. 모든 세그먼트를 참조할 필요는 없습니다. $#을 사용하여 정의된 splitPattern 세그먼트를 참조합니다. 여기서 #은 원본 데이터 요소에 있는 세그먼트의 순서 수입니다. $0을 사용하여 전체 원본 데이터 요소를 참조합니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
이 예제에서 CEO 이름은 원본 데이터에서 성, 이름이며 출력에서 이름 성으로 변환됩니다.
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock Report 05022019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('CEO', '$.quote.CEO')
.thenSplit(',', '$2 $1');
TransformerRuleList - thenSubtract(Number 피연산자)
소스 필드에서 전달된 값을 빼서 출력 필드에 저장하는 현재 규칙에 어댑터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 피연산자 | 번호 | 소스 데이터 요소에서 뺄 값입니다. |
| 유형 | 설명 |
|---|---|
| 객체 | 현재 TransformerRuleList 객체입니다. |
var transformerRuleList = new sn_tfrm.TransformerRuleList()
.fromJSON()
.setName('Stock 05182019 JSON')
.addRule('ticker', '$.quote.symbol')
.addRule('change_percentage', '$.quote.changePercent')
.thenMultiply('100')
.thenRoundDown('0')
.addRule('close_price', '$.quote.close')
.thenAdaptCurrency('USD', false)
.addRule('trade_price', '$.quote.current_price')
.addMultiply('$.quote.trade_quantity')
.thenSubtract('$.quote.discount_dollars');