자동 새로 고침
중요한 시스템에 대한 데이터를 표시하는 매쉬업을 생성할 때는 최신 데이터를 표시하는 것이 중요합니다. 특정 시간 간격에 자동으로 데이터를 새로 고치려면 자동 새로 고침 함수를 사용하면 됩니다. 데이터를 매쉬업에 표시하려면 실행 시간에 서비스를 실행하는 이벤트를 사용합니다. 서비스에서 반환된 데이터는 위젯에 바인딩됩니다. 구현에 따라 서비스는 일반적으로 실행 시간에 매쉬업이 로드될 때 실행됩니다. 자동 새로 고침 함수를 사용하면 지정된 시간 값에 따라 서비스를 자동으로 실행할 수 있습니다.
지정된 시간 간격이 경과하면 Refresh 이벤트가 트리거되고 바인딩된 서비스가 실행되고 최신 데이터 집합이 위젯에 로드됩니다.
사용자가 함수를 제어하는 위젯을 추가하지 않고도 함수를 매쉬업의 백그라운드 서비스로 사용할 수 있습니다. 필요한 경우 함수를 버튼, 전환 버튼, 확인란 또는 기타 입력 위젯에 바인딩할 수 있습니다. 이렇게 하면 사용자가 자동 새로 고침을 설정 또는 해제할지, 아니면 언제든지 데이터를 새로 고치도록 할 것인지를 결정할 수 있습니다.
함수 옵션
자동 새로 고침 함수에 대해 다음과 같은 구성 옵션을 설정할 수 있습니다.
• 설명 - 함수에 대한 설명을 설정합니다.
• 자동 새로 고침 - 이 함수에 대해 자동 새로 고침을 활성화합니다.
• 새로 고침 간격 - 각 새로 고침 사이의 시간(초)을 설정합니다.
• 인증 오류 시 자동 새로 고침 사용 안 함 - 서버가 인증 오류를 반환할 때 자동 새로 고침을 비활성화하여 잘못된 요청이 대기열에 추가되지 않도록 합니다. 예를 들어, 함수가 잘못된 인증으로 여러 요청을 보내는 경우 사용자 계정이 잠길 수 있습니다. 이 동작은 기본 인증을 사용할 때만 발생하며 SSO를 사용할 때는 적용되지 않습니다. 이 옵션을 활성화하면 Refresh 이벤트를 서비스에 직접 바인딩해야 합니다. 이벤트가 서비스에 직접 바인딩되지 않으면 자동 새로 고침이 비활성화되지 않습니다.
 |
이 속성을 활성화하면 함수가 한 번에 하나의 서비스 호출을 수행합니다. 서비스 호출 왕복 시간이 구성된 간격을 초과하면 새로 고침이 지연될 수 있습니다.
|
자동 새로 고침 함수 생성
1. 함수 패널에서 
을 클릭합니다. 새 함수 대화 상자가 열립니다.
을 클릭합니다. 새 함수 대화 상자가 열립니다.2. 드롭다운 목록에서 자동 새로 고침을 선택합니다.
3. 함수의 이름을 입력한 후 다음을 클릭합니다.
4. 함수를 자동으로 새로 고치려면 자동 새로 고침 확인란을 선택합니다.
5. 새로 고침 간격 상자에 숫자 값을 입력하여 각 새로 고침 간격(초)을 지정합니다.
6. 완료를 클릭합니다.
함수는 자동 새로 고침 카테고리 아래의 함수 패널에 추가됩니다.
모범 사례
• 새로 고침 간격이 함수에 바인딩된 서비스를 실행하는 데 걸리는 시간보다 긴 기간으로 설정되어 있는지 확인하십시오. 예를 들어, 실행하는 데 3초가 걸리는 데이터 서비스가 있다고 가정합니다. 또한 일부 사용자는 네트워크 속도가 더 느려질 수 있으므로 새로 고침 간격을 설정하기 전에 매쉬업 로드 시간을 명확하게 파악해야 합니다.
• 서버에서 사용자 세션에 대한 시간 초과보다 긴 새로 고침 간격을 지정하지 마십시오.
• 데이터 서비스가 성공적으로 실행되지 않을 경우 오류 메시지를 표시하는 것이 좋습니다. 또한 LastRefresh 속성 값을 사용하여 데이터가 마지막으로 업데이트된 시간을 표시할 수 있습니다.
서비스에서 자동으로 데이터 새로 고침
위젯에 대한 데이터를 반환하는 서비스를 자동으로 새로 고치려면 다음을 수행하십시오.
1. 함수 Refresh 이벤트를 데이터 패널의 데이터 서비스에 바인딩합니다.
2. 함수 구성 대화 상자에서 자동 새로 고침 확인란이 선택되어 있는지 확인합니다. AutoRefresh 속성을 사용하여 실행 시간에 이 옵션을 설정하고 해제할 수 있습니다.
3. 함수 대화 상자에서 또는 RefreshInterval 속성에 대한 바인딩을 사용하여 새로 고침 간격 값을 지정합니다.
사용자 입력 위젯의 이벤트를 사용하여 함수를 실행하려면 다음과 같이 버튼과 전환 버튼 중 하나 또는 둘 다를 추가합니다.
• 데이터를 수동으로 새로 고치려면 버튼 위젯의 Clicked 이벤트를 함수의 ActivateWidgetRefresh 서비스에 바인딩합니다. 실행 시간에 버튼을 클릭하면 데이터가 업데이트됩니다.
• 사용자가 실행 시간에 자동 새로 고침을 설정 또는 해제하도록 하려면 전환 버튼 위젯의 State 속성 위젯을 AutoReferesh 함수 속성에 바인딩합니다.
다음 이미지는 디자인 타임의 바인딩을 보여줍니다.
• 함수는 두 위젯인 버튼 및 전환 버튼을 사용하여 제어합니다.
• 새로 고침 이벤트는 BarChartData 서비스를 트리거하는 데 사용됩니다. 이 서비스는 매쉬업의 가로 막대형 차트 위젯에 대한 데이터 값을 반환합니다.
• LastRefresh 속성은 값 표시 위젯에 바인딩됩니다.
자동 새로 고침을 구성한 후 새로 고친 서비스에 대한 성공 또는 오류 알림을 설정합니다. 예를 들어, 서비스가 업데이트된 데이터를 읽어들이는 데 실패한 경우 실패 메시지를 표시할 수 있습니다. 알림을 활성화하는 방법에 대한 자세한 내용은 데이터 서비스 알림 추가를 참조하십시오.
함수 속성
자동 새로 고침 함수에는 다음 속성이 포함됩니다.
|
속성
|
설명
|
기본 유형
|
기본값
|
바인딩 가능 여부 (Y/N)
|
로컬리제이션 가능 여부 (Y/N)
|
|---|---|---|---|---|---|
|
ActivateWidgetRefresh
|
수동으로 새로 고침을 트리거하기 위해 위젯 이벤트에 바인딩할 수 있는 바인딩 가능한 서비스입니다. 위젯 이벤트는 함수의 Refresh 이벤트를 트리거합니다.
|
해당 없음
|
해당 없음
|
Y
|
N
|
|
Refresh
|
서비스를 트리거하기 위해 바인딩할 수 있는 바인딩 가능한 이벤트입니다. AutoRefresh가 True로 설정되면 이벤트가 자동으로 트리거됩니다.
|
해당 없음
|
해당 없음
|
Y
|
N
|
|
AutoRefresh
|
실행 시간에 자동 새로 고침을 설정하고 해제하기 위해 바인딩할 수 있는 부울 속성입니다.
|
BOOLEAN
|
False
|
Y
|
N
|
|
RefreshInterval
|
각 새로 고침 사이의 시간(초)을 설정하는 바인딩 가능한 속성입니다.
|
NUMBER
|
해당 없음
|
Y
|
N
|
|
LastRefresh
|
마지막 자동 새로 고침의 날짜 및 시간을 포함하는 바인딩 가능한 속성입니다.
|
DATETIME
|
해당 없음
|
Y
|
N
|
|
RefreshDisabled
|
서비스를 트리거하기 위해 바인딩할 수 있는 바인딩 가능한 이벤트입니다. 인증 오류가 발생한 후 자동 새로 고침이 비활성화되고 인증 오류 시 자동 새로 고침 사용 안 함이 활성화되면 이벤트가 트리거됩니다.
|
해당 없음
|
해당 없음
|
Y
|
N
|
|
RefreshDisabledReason
|
인증 오류 시 자동 새로 고침 사용 안 함이 활성화되면 인증 오류로 인해 자동 새로 고침이 비활성화될 때 표시할 선택적 메시지를 지정합니다. 이 속성을 사용하면 실패에 대한 자세한 정보를 제공할 수 있습니다. 예를 들어, 이 속성을 상태 메시지 함수에 바인딩할 수 있습니다.
|
STRING
|
해당 없음
|
Y
|
Y
|