Workshop 데이터 자동 새로고침

Auto-refresh는 모듈의 객체 집합을 감시하다 변경이 발생하면 현재 모듈의 데이터를 새로고침하는 기능입니다. 다른 사용자의 액션, 상위 데이터 통합의 갱신과 스트리밍 입력의 새 레코드 등이 변경을 일으킬 수 있습니다.

데이터 최신성이 중요한 대시보드와 공동 작업에 사용할 수 있습니다. 추가 데이터 로드와 비용이 발생하므로 실시간 갱신이 필요하지 않은 흐름에서는 사용 여부를 선택합니다.

감시 구성

편집기의 Settings 아래쪽에서 Auto-refresh를 열고 감시할 객체 집합을 등록합니다.

Auto-refresh를 선택한 뒤 패널 아래의 Settings를 펼쳐 동작을 조정합니다.

시간 간격과 모드

Minimum seconds between refresh는 두 데이터 새로고침 사이의 최소 간격입니다. 처음 변경을 받아 새로고침하는 지연을 줄이는 설정은 아니며, 모듈이 계속 다시 로드되는 것을 막습니다. 가장 짧은 간격은 10초입니다. 변경 여부와 관계없이 10초마다 무조건 다시 조회한다는 의미는 아닙니다.

Disable in edit mode를 켜면 편집 중에는 자동 갱신을 끕니다. 구성 자체는 유지되며 View 모드에서는 계속 동작합니다.

세션 중 갱신 반영 제어

Button Group 등에 다음 이벤트를 연결할 수 있습니다.

• Enable auto-refresh updates는 자동 새로고침 결과의 반영을 허용합니다.
• Disable auto-refresh updates는 그 결과의 반영을 중지합니다.

이는 사용자 세션의 갱신 반영을 제어합니다. 변수의 계산 방식은 재계산 설정과 함께 적용합니다.

데이터 최신성 표시

Data Freshness 위젯은 지정한 객체 유형과 데이터소스의 가장 최근 인덱싱 시각을 표시합니다. 갱신 후 24시간 이내에는 2 hours ago 같은 상대 시간을, 그보다 오래된 경우에는 Thu, Jul 17, 2025, 1:52 PM 같은 날짜와 시각을 표시합니다.

이 값은 인덱싱을 기준으로 한 갱신 시각입니다. 화면에서 변수를 마지막으로 계산한 시각과 구분합니다.

저장소 조건

Object Storage v2를 기반으로 하는 객체 유형만 지원합니다. 객체 집합 정의에서 연결 객체를 사용한다면 그 대상도 조건을 만족해야 합니다.

연결된 양쪽 객체 유형이 OSv2여도 링크 유형이 OSv1이면 오류가 발생할 수 있습니다. 필요한 경우 OSv1에서 OSv2로 이전합니다.

사용자 입력이 있는 화면

입력 화면에서도 자동 새로고침을 사용할 수 있지만 갱신 뒤 변수나 위젯 상태가 초기화될 수 있습니다. 영향을 받는 변수는 Automatic 재계산을 피하는 구성을 검토합니다.

변수 설정만으로 부족하다면 자동 새로고침을 사용하지 않는 별도 모듈을 iframe으로 넣거나, 입력 작업을 새 브라우저 또는 Carbon 탭의 모듈에서 수행할 수 있습니다. iframe의 보기 URL에 embedded=true를 설정하면 Foundry 사이드바를 숨길 수 있습니다. iframe 안의 별도 모듈 실행 문맥과 기본 Embedded Module 위젯을 구분합니다.

연결 객체 유형도 감시

등록한 객체 집합의 연결 유형까지 자동으로 감시하지는 않습니다. 연결 속성이나 연결 집계의 변화를 반영하려면 그 연결 유형도 명시적으로 감시합니다.

연결 유형의 변수를 Object Set Title 같은 간단한 위젯에 사용하고 섹션의 높이나 너비를 0으로 정하면 화면을 차지하지 않으면서 갱신을 유발하는 구성을 만들 수 있습니다. 렌더되는 섹션의 크기를 줄이는 방식과 섹션 자체를 숨기는 방식은 아래의 가시성 조건에서 차이가 있습니다.

필터 지원 범위

현재 terms, phrase, multiMatch, prefixOnLastToken과 objectSetLink 같은 일부 필터 유형은 감시 대상에서 지원하지 않습니다.

지원되는 필터로 대상 범위를 정할 수 있습니다. 예를 들어 기본 키로 특정 객체를 선택하면 그 객체가 바뀔 때만 새로고침하도록 구성할 수 있습니다.

필터를 지원하지 않는 경우에는 같은 유형의 필터 없는 집합을 감시하고 하위 변수에서 원하는 조건을 적용하는 방법이 있습니다. 이 방식은 실제 화면에 필요한 변경보다 자주 새로고침할 수 있습니다.

가시성과 비활성 탭

자동 새로고침 대상으로 등록한 집합은 모듈의 보이는 위젯에서 사용해야 갱신을 유발합니다. 숨겨진 drawer에서만 사용한다면 drawer가 열린 동안 동작합니다.

숨겨진 상태에서 알림이 오면 다시 보일 때까지 미뤄 두었다가 표시 시 즉시 다시 로드합니다. 브라우저 탭을 최소화했거나 현재 활성 탭이 아닐 때도 이 동작을 적용합니다.

삽입 모듈

기본 모듈 삽입은 자식의 Auto-refresh 설정을 이어받지 않습니다. 자동 갱신을 사용할 모듈에는 설정을 명시적으로 구성해야 하며 자식의 독립 자동 갱신이 기본 삽입 문맥에서 그대로 실행되지는 않습니다.

부모는 갱신하지 않고 자식만 독립적으로 갱신해야 한다면 Auto-refresh를 구성한 별도 모듈을 iframe으로 넣는 경로를 사용합니다.

문제 확인

브라우저 console에서 구체적인 오류를 확인할 수 있습니다. 갱신이 늘린 로드 작업은 Performance Profiler에서 살펴봅니다.