ThingWorx Flow > 기본 제공 서비스, 유틸리티 및 장치 > 유틸리티 및 장치 > 개발자 도구 > 맵퍼
맵퍼
맵퍼 작업을 사용하여 다양한 작업의 출력을 결합하고 값을 조작하고 객체, 컬렉션, 배열 또는 문자열을 다시 구조화하여 사용자 정의 출력을 만듭니다. 이렇게 하면 여러 작업의 특정 필드 값 또는 출력을 검색하고 결합하도록 복잡한 Node.js 코드를 작성할 필요가 없습니다.
워크플로에서 맵퍼 작업을 사용하려면 다음 단계를 완료합니다.
1. 을 클릭하고 개발자 도구에 있는 맵퍼 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음 을 클릭하거나 작업을 두 번 클릭합니다. 맵퍼 창이 열립니다.
2. 필요한 경우 레이블을 편집합니다. 기본적으로 레이블 이름은 작업 이름과 동일합니다.
3. 을 클릭하여 키-값 쌍을 만듭니다.
a. 을 클릭하고 데이터 유형 목록에서 다음 옵션 중 하나를 선택합니다.
▪ 배열 - 지정된 키가 배열을 반환하는 경우 사용합니다.
▪ 컬렉션 - 지정된 키가 객체 배열을 반환하는 경우 사용합니다.
▪ 객체 - 지정된 키가 객체를 반환하는 경우 사용합니다.
▪ 문자열 - 지정된 키가 문자열 값을 반환하는 경우 사용합니다. 기본적으로 모든 키-값 쌍의 데이터 유형은 문자열입니다.
b. 원하는 경우 키 필드의 이름을 바꿉니다.
c. 이 필드에 값을 제공하거나 이전 작업의 출력을 이 필드에 입력으로 매핑합니다. 올바른 데이터 유형의 출력을 매핑해야 합니다.
데이터 유형을 컬렉션 또는 객체로 설정한 경우 컬렉션 또는 객체 옆에 있는 을 클릭하여 컬렉션 또는 객체 아래에 키-값 쌍을 추가할 수 있습니다.
d. 을 클릭하여 지정된 입력에 대한 Node.js 함수를 추가합니다.
e. 기본 제공 함수를 사용하거나 사용자 정의 함수를 생성하거나 기본 제공 함수와 사용자 정의 함수의 조합을 사용합니다.
▪ 사용자 고유의 입력을 지정하거나 코드 편집기에서 을 클릭하고 이전 작업의 출력을 입력으로 매핑합니다.
▪ 사용자 정의 함수 코드를 작성하거나 함수를 클릭하여 기존 함수를 선택 또는 수정합니다.
f. 저장을 클릭합니다. 사용자 정의 함수가 값 필드의 입력으로 추가됩니다.
g. 을 클릭하여 여러 키/값 쌍을 추가합니다. 추가한 키-값 쌍을 삭제하려면 을 클릭합니다.
4. 완료를 클릭합니다.
출력 스키마
사용자가 제공한 키-값 쌍에 따라 맵퍼 작업은 동적 출력 스키마를 반환합니다.
맵퍼의 기본 제공 함수
맵퍼 작업은 사용할 수 있는 다음 기본 제공 함수(lodash 라이브러리에서 가져옴)를 제공합니다.
배열 함수
_.Compact - 지정된 배열에서 false 값을 제거합니다.
_.difference - 지정된 개수의 배열에서 첫 번째 배열에 고유한 값이 포함된 배열을 반환합니다.
_.flatten - 배열을 단일 수준 깊이로 결합합니다.
_.flattenDeep - 전체 배열을 결합합니다.
_.intersection - 지정된 모든 배열에 공통되는 값이 포함된 배열을 반환합니다.
_.first - 지정된 배열의 첫 번째 요소를 검색합니다.
_.last - 지정된 배열의 첫 번째 요소를 검색합니다.
_.uniq - 지정된 배열에서 중복 값을 제거합니다.
객체 함수
_.pick - 지정된 객체 속성과 일치하는 요소가 포함된 객체를 반환합니다.
_.get - 객체의 지정된 경로에 표시되는 요소의 값을 반환합니다.
_.keys - 객체의 열거 가능한 속성 이름의 배열을 만듭니다.
문자열 함수
_.camelCase - 문자열 대/소문자를 camelCase로 변경합니다.
_.capitalize - 문자열의 첫 번째 문자를 대문자로 변경하고 나머지는 소문자로 변경합니다.
_.kebabcase - 문자열 대/소문자를 kebabCase로 변경합니다.
_.lowercase - 지정된 문자열을 소문자로 변환합니다.
_.lowerfirst - 문자열의 첫 번째 문자를 소문자로 변환합니다.
_.replace - 지정된 조건과 일치하는 문자열을 특정 문자열로 바꿉니다.
_.repeat - 지정된 문자열을 지정된 횟수만큼 반복합니다.
_.trim - 지정된 문자열에서 선행 및 후행 공백과 지정된 문자를 제거합니다.
_.escape - 지정된 문자열의 &, <, >, ' 및 " 문자를 해당 HTML 엔티티로 변환합니다.
_.unescape - 지정된 문자열의 HTML 엔티티 &amp, &lt, &gt, &quot 및 &#39를 해당 문자로 변환합니다.
숫자 함수
_.add - 두 숫자를 더합니다.
_.ceil - 숫자를 지정된 자릿수까지 반올림합니다.
_.divide - 두 숫자를 나눕니다.
_.floor - 숫자를 지정된 자릿수까지 반내림합니다.
_.multiply - 두 숫자를 곱합니다.
_.subtract - 두 숫자를 뺍니다.
컬렉션 함수
_filter - 지정된 필터 조건을 충족하는 요소가 포함된 배열을 반환합니다.
_.find - 지정된 조건을 충족하는 첫 번째 요소를 반환합니다.
도움이 되셨나요?