탐색
 |
이 함수는 탐색 위젯을 대체합니다. 동일한 기능을 만들려면 버튼 위젯의 Clicked 속성을 함수에 바인딩합니다.
|
탐색 함수는 응용 프로그램 내의 매쉬업 간에 이동하는 데 사용할 수 있는 비시각적 위젯입니다. 지정한 대상 매쉬업을 열려면 이벤트를 Navigate 서비스에 바인딩합니다. 유효성 검사기 함수의 True 속성과 같은 다른 함수에서 이벤트를 바인딩할 수 있습니다. 이를 통해 매쉬업에서의 탐색을 제어하는 JavaScript 표현식을 정의할 수 있습니다. 대상 매쉬업에 바인딩 가능한 매개 변수가 포함되어 있으면 매쉬업 간에 매개 변수 값을 전달할 수도 있습니다.
ThingWorx 9.3 이상에서는 함수를 사용하여 원격 서버에서 데이터를 보내고 검색할 수 있습니다. 다른 도메인에서 호스트되는 원격 서버에 대한 연결은 보안을 위해 웹 브라우저에서 차단되는 경우가 많습니다. 그러나 대상 창 유형이 팝업 또는 모달 팝업으로 설정된 경우에도 계속 탐색 함수를 사용하여 원격 서버에 대한 요청을 보내고 검색할 수 있습니다. 함수 Result 속성을 사용하여 서버에서 데이터를 검색하고 해당 데이터를 매쉬업의 위젯, 함수 또는 데이터 서비스에 바인딩합니다.
함수 옵션
탐색 함수를 만들거나 수정할 때 다음 옵션을 구성할 수 있습니다.
|
옵션
|
설명
|
|---|---|
|
설명
|
함수에 대한 설명을 설정합니다.
|
|
대상 매쉬업
|
리디렉션할 매쉬업의 이름을 지정합니다.
|
|
대상 창 유형
|
대상 창 유형을 다음 옵션 중 하나로 설정합니다.
• 새로 만들기 - 새 창에서 열립니다.
• 바꾸기 - 현재 창에서 열립니다.
• 팝업 - 팝업 창에서 열립니다.
• 모달 팝업 - 팝업 창에서는 팝업 내에서만 닫을 수 있습니다.
• 전체 화면 - 전체 화면 모드에서 열립니다.
|
|
누락된 매쉬업 메시지
|
대상 매쉬업을 사용할 수 없는 경우 표시할 메시지를 지정합니다.
|
|
팝업 제목
|
팝업 창의 제목을 지정합니다.
|
|
팝업 너비
|
팝업 창의 너비를 설정합니다.
|
|
팝업 높이
|
팝업 창의 높이를 설정합니다.
|
|
레거시 높이 증가 포함
|
팝업 창의 높이에 21픽셀을 추가할지 여부를 제어합니다. 이 옵션은 ThingWorx 9.3.3 또는 이전 버전에서 만든 함수에 사용할 수 있습니다. 높이 증가를 비활성화하려면 이 속성을 false로 설정합니다. ThingWorx 9.3.4 이상에서 새 함수를 만들 때 실제 값을 사용하여 팝업 높이를 설정합니다.
|
|
바꿀 때 다시 로드
|
현재 매쉬업이 새 매쉬업으로 대체될 때 브라우저 창을 다시 로드합니다.
|
|
닫기 버튼
|
팝업 창에 닫기 버튼을 표시합니다.
|
|
바깥쪽을 클릭하여 닫기
|
사용자가 창 바깥쪽의 영역을 클릭할 때 팝업을 닫습니다.
|
|
팝업 스크롤 막대
|
팝업 창에 스크롤 막대를 추가합니다.
|
|
리디렉션 대상
|
탐색할 대상의 유형을 설정합니다. 대상을 매쉬업 또는 URL로 설정할 수 있습니다.
|
|
URL
|
사용자를 리디렉션할 URL입니다.
|
|
URL 대상 유형
|
대상 URL이 열리는 방식을 지정할 수 있습니다. URL은 새 창, 현재 창, 팝업 또는 모달 팝업에서 열 수 있습니다. 데이터를 보내거나 검색하려면 대상 URL을 팝업 또는 모달 팝업 창에서 열어야 합니다.
|
|
팝업 차단 메시지 표시
|
팝업 창이 브라우저에 의해 차단될 때 경고 메시지를 표시합니다.
|
|
팝업 차단 메시지
|
팝업 창이 차단될 때 표시할 메시지를 설정합니다.
|
탐색 함수 만들기
1. 함수 패널에서 
을 클릭합니다. 새 함수 대화 상자가 열립니다.
을 클릭합니다. 새 함수 대화 상자가 열립니다.2. 드롭다운 목록에서 탐색을 선택합니다.
3. 함수의 이름을 입력한 후 다음을 클릭합니다.
4. 대상 매쉬업에서 탐색할 매쉬업을 입력합니다.
5. 필요에 따라 옵션을 수정합니다.
6. 완료를 클릭합니다.
탐색 함수가 함수 패널에 추가됩니다.
대상 매쉬업 매개 변수
탐색 함수를 사용하면 현재 매쉬업의 값을 대상 매쉬업의 매개 변수로 전달할 수 있습니다. 대상 매쉬업을 선택하면 해당 매개 변수가 탐색 함수에 대한 옵션 대화 상자의 매쉬업 기본값에 표시됩니다. 각 매개 변수에 대한 기본값을 지정할 수 있습니다.
대상 매쉬업의 매개 변수도 탐색 함수 아래에 나열됩니다. 속성을 매쉬업 매개 변수에 바인딩할 때 기본값을 덮어씁니다.
함수 속성
속성 | 설명 | 기본 유형 | 기본값 | 바인딩 가능 여부 (Y/N) | 로컬리제이션 가능 여부 (Y/N) |
|---|---|---|---|---|---|
Navigate | 사용자를 지정된 매쉬업 또는 URL로 리디렉션하는 서비스입니다. | 해당 없음 | 해당 없음 | Y | N |
MissingMashupMessage | 대상 매쉬업을 사용할 수 없는 경우 표시할 메시지를 지정합니다. | STRING | 해당 없음 | Y | Y |
PopupBlockedMessage | 팝업 창이 차단될 때 표시할 메시지를 설정합니다. | STRING | 해당 없음 | Y | Y |
PopupTitle | 팝업 창의 제목을 설정합니다. | STRING | 해당 없음 | Y | Y |
PopupWidth | 팝업 창의 고정 너비를 설정합니다. | NUMBER | 해당 없음 | Y | N |
PopupHeight | 팝업 창의 고정 높이를 설정합니다. | NUMBER | 해당 없음 | Y | N |
Result | 팝업 창에서 반환되는 데이터입니다. | STRING | 해당 없음 | Y | Y |
URL | STRING | 해당 없음 | Y | N | |
URLTargetType | URL 대상 창이 열리는 방식을 제어합니다. 지원되는 값은 "새로 만들기", "바꾸기", "팝업" 및 "모달 팝업"입니다. 팝업 또는 모달 팝업 창에서 데이터를 보내거나 검색할 때 사용되는 URL을 열어야 합니다. | STRING | 해당 없음 | Y | N |
함수 이벤트
속성 | 설명 | 기본 유형 | 기본값 | 바인딩 가능 여부 (Y/N) | 로컬리제이션 가능 여부 (Y/N) |
|---|---|---|---|---|---|
WindowClosed | 팝업 창이 닫힐 때 트리거되는 이벤트입니다. | 해당 없음 | 해당 없음 | Y | N |
PopupDone | 팝업 창이 닫히고 데이터가 제출될 때 트리거되는 이벤트입니다. | 해당 없음 | 해당 없음 | Y | 해당 없음 |
PopupCanceled | 데이터가 제출되기 전에 팝업 창이 닫힐 때 트리거되는 이벤트입니다. | 해당 없음 | 해당 없음 | Y | 해당 없음 |
PopupBlocked | 팝업 창이 브라우저에 의해 차단될 때 트리거되는 이벤트입니다. | 해당 없음 | 해당 없음 | Y | 해당 없음 |