매쉬업 매개 변수 구성
매쉬업에 대한 매개 변수를 만들고 구성할 수 있습니다. 이러한 매개 변수는 Parameter Value Changed 이벤트가 있는 바인딩 가능한 소스 및 대상입니다. 매쉬업 매개 변수를 구성할 때 다음 필드를 사용할 수 있습니다.
• 이름: 매개 변수의 이름입니다.
• 기본 유형:
필드 정의 기본 유형
기본 유형 | 설명 |
---|
BOOLEAN | true 또는 false 값입니다. |
DASHBOARDNAME | 대시보드의 이름입니다. |
DATASHAPENAME | 모델의 데이터 셰이프에 대한 참조이므로 특수 처리가 있습니다. |
DATETIME | 형식 적용된 날짜 및 시간입니다. |
HTML | 일부 HTML 콘텐츠입니다. |
HYPERLINK | 표준 URL(예: www.thingworx.com)입니다. |
IMAGE | 이미지로 렌더링될 수 있는 바이너리 데이터입니다. |
IMAGELINK | 이미지에 대한 URL 링크입니다. |
INFOTABLE | SQL 결과 집합과 유사한 ThingWorx에서의 데이터 표준 표현입니다. 인포테이블을 빌드, 사용 및 분석할 여러 기본 제공 서비스가 있습니다. |
INTEGER | 분수 구성 요소 없이 쓸 수 있는 숫자입니다. |
JSON | Javascript Object Notation 문자열입니다. | ThingWorx 8.4.0 이상 버전에 해당합니다. |
|
LOCATION | 표준 WGS(World Geodetic System) 84 좌표로 [경도, 위도], 고도로 표현됩니다. |
LONG | INTEGER 기본 유형이 제공하는 범위보다 긴 범위가 필요할 때 LONG 유형을 사용해야 합니다. |
MASHUPNAME | ThingWorx 매쉬업에 대한 참조이므로 특수 처리가 있습니다. |
NOTHING | 아무 것도 포함하지 않습니다(void). |
NUMBER | 숫자입니다. |
PASSWORD | 마스킹된 암호 값입니다. 자세한 내용은
암호를 참조하십시오. 암호화 방법에 대한 자세한 내용은
암호화를 참조하십시오. |
QUERY | "필터" 배열이 포함된 JSON 객체입니다. 각 필터는 "value", "type" 및 "fieldname"을 포함해야 합니다. |
SCHEDULE | CRON 기반 일정(일정 편집기를 사용하여 구성됨)입니다. |
STRING | 영숫자의 개수입니다. |
STYLETHEMENAME | 스타일 테마에 대한 참조이므로 특수 처리가 있습니다. |
TAGS | ThingWorx 태그 값입니다. |
텍스트 | 영숫자의 개수입니다. String과의 차이는 TEXT는 색인화된다는 점입니다. |
THINGNAME | 사물에 대한 참조이므로 특수 처리가 있습니다. |
THINGSHAPENAME | 모델의 사물 형태에 대한 참조이므로 특수 처리가 있습니다. |
THINGTEMPLATENAME | 사물 템플릿의 이름입니다. |
TIMESPAN | TimeSpan 객체는 양수 또는 음수의 일, 시간, 분, 초로 측정되는 시간 간격(기간 또는 경과 시간)을 나타냅니다. |
USERNAME | 시스템에 정의된 ThingWorx 사용자에 대한 참조입니다. |
XML | XML 조각 또는 문서입니다. |
• 바인딩 방향: 소스, 대상 또는 둘 다
• 도구 설명: 마우스 포인터로 가리킬 때 도구 설명으로 매쉬업 매개 변수에 추가되는 텍스트입니다.
• 할 일 표시: 선택하면 포함된 매쉬업에서 매개 변수를 구성할 때 추가 단계가 필요하다는 미리 알림이 표시됩니다.
• 삭제: 매쉬업 매개 변수를 제거합니다.
• 사용자 정의 구성 양식 추가: 매쉬업을 사용자 정의 구성으로 추가합니다.
ThingWorx 8.4.X 이상 버전의 개선된 기능
매쉬업 매개 변수를 구성할 수 있도록 다음과 같이 개선되었습니다.
• 기본 유형을 JSON 유형으로 설정할 수 있습니다.
이 기능은 고급 개발자에게 더욱 개선된 유연성을 제공합니다. 사용자가 JSON을 입력할 수 있는 JSON 편집기가 제공됩니다.
• 데이터 셰이프를 지정하지 않고 매개 변수에 인포테이블 유형을 지정할 수 있습니다.
ThingWorx 8.3.X 이전 버전에서는 데이터 셰이프가 필수입니다. 8.4.X 이상 버전에서는 데이터 셰이프가 필수가 아니므로 유연성이 더욱 개선되었습니다. 이를 통해 매쉬업에 다양한 데이터 셰이프를 제공할 수 있습니다.
• 매개 변수의 바인딩 방향 "←"(소스), "→"(대상) 및 "↔"(둘 다)를 제어할 수 있습니다.
8.3.X 이전 버전에서는 매개 변수의 방향이 항상 "둘 다"로 설정되므로 매쉬업을 포함할 때 매개 변수가 어떤 방향으로 수행될지가 명확하지 않았습니다. 이제 바인딩 방향을 제어할 수 있습니다.
• 각 매개 변수별로 "할 일" 패널에 "할 일" 표시를 추가할 수 있습니다.
따라서 포함된 매쉬업 위젯에 포함할 때 이 매개 변수를 제공할 것을 권장하는 힌트가 "할 일" 패널에 표시됩니다.
매쉬업을 포함된 매쉬업 위젯에 끌어 놓으면 포함된 매쉬업 위젯의 속성 패널에서 매개 변수를 사용할 수 있게 되며 다음 기능을 사용할 수 있습니다.
• 포함된 매쉬업 위젯에 JSON 문자열을 보낼 수 있습니다. 사용자가 JSON을 입력할 수 있는 JSON 편집기가 제공됩니다.
• 미리 정의된 데이터 셰이프가 없는 인포테이블을 포함된 매쉬업 매개 변수로 보낼 수 있습니다. ThingWorx 8.3.X 이전 버전에서는 데이터 셰이프가 필수입니다. 8.4.X 이상 버전에서는 데이터 셰이프가 필수가 아닙니다.
• 포함된 매쉬업에 대한 매개 변수의 바인딩 방향은 "←"(소스), "→"(대상)" 및 "↔"(둘 다)와 같이 쉽게 이해할 수 있습니다. 8.3.X 이전 버전에서는 매개 변수의 방향이 항상 "둘 다"로 설정됩니다.
• 매개 변수별로 "할 일" 패널에 "할 일" 표시를 추가할 수 있습니다.
예를 들어, 이미지의 다음 매개 변수는 다음과 같습니다.
포함된 매쉬업 위젯에서 예상되는 결과는 다음과 같습니다.