기록 내역 위젯을 언제 사용해야 하는지, 그리고 필요에 따라 어떻게 구성할 수 있는지 알아보세요.
이 기능을 사용할 수 있는 대상
규제 대상 요금제 사용자.
기록 내역 위젯(RHW)은 특정 테이블 레코드와 관련된 기록된 데이터를 표시합니다. 여기에는 다음이 포함될 수 있습니다:
- 테이블 레코드의 변경 사항
- 완료 레코드의 데이터
- 전자 서명(해당 레코드가 서명된 데이터로 포함된 경우)
Tulip의 GxP 데이터 수집 방식을 이해하는 것은 레코드 이력 위젯을 언제 사용해야 하는지 파악하는 데 중요합니다.
이 위젯은 다음과 같이 특정 제조 품목의 이력을 캡처하고자 하는 사용 사례에 사용할 수 있습니다.
- 로그북
- 규정 준수 및 추적성
- 디지털 이력 기록
레코드 이력 위젯은 어떻게 작동합니까?
기록 이력 위젯은 다음 소스에서 데이터를 수집하고 표시하여 특정 기록 ID에 대한 가시성을 제공합니다.
- 앱
- 테이블 API
- 테이블 UI(관리자 인터페이스)
- Automation
위의 다이어그램은 다양한 소스별 업데이트 예시를 보여줍니다.
레코드 이력 위젯은 하나의 레코드 ID와 관련된 다음 데이터를 표시합니다.
- 앱, 테이블 UI, 테이블 API, 자동화를 통해 해당 레코드의 필드에 발생한 모든 변경 사항
- 앱의 경우, 완료 시점에 레코드 자리 표시자가 가리키던 모든 완료 데이터
- 서명된 데이터로 해당 레코드가 포함된 모든 서명
이 위젯은 스크롤 가능한 보기로 레코드의 시간순 이력을 표시하며, 새로 고침 시(예: 단계 변경) 업데이트됩니다. 이 보기를 통해 사용자는 레코드 생성 이후 해당 레코드에 발생한 일이나 관련 사항을 확인할 수 있습니다.
예를 들어, 앱을 통해 레코드가 업데이트되거나 자동화 또는 테이블 UI를 통해 변경된 경우, 해당 변경 사항은 위젯에 순차적으로 기록됩니다.
위의 워크플로 다이어그램은 레코드 이력 위젯이 다양한 출처의 레코드 정보를 어떻게 수집하는지 보여줍니다. 각 단계에서는 원본 변수의 새로운 이터레이션을 저장합니다. 레코드 이력 위젯은 앱 사용 기간 동안 이루어진 각 업데이트를 상세히 보여줍니다.
레코드 기록 위젯에서는 데이터가 어떻게 표시되나요?
섹션
각 소스에서 수집된 데이터는 섹션과 항목을 통해 시각화됩니다. 모든 데이터는 시간순으로 표시되며, 섹션은 동일한 세션에 속한 데이터를 그룹화합니다. 세션은 데이터 소스에 따라 다음과 같은 다양한 요소로 정의됩니다:
- 앱: 사용자 + 앱(버전) + 방송국
- API: API(토큰)
- 테이블 UI: 사용자 + 관리자 인터페이스
- 자동화: 자동화 이름
이전 항목과 동일한 세션에서 생성된 항목이 없을 경우 새로운 섹션이 표시됩니다. 예를 들어:
- 앱을 실행 중인 사용자가 변경되었습니다
- 레코드가 먼저 앱에서 업데이트된 후 관리자 인터페이스에서 다시 업데이트됨
항목
각 섹션에는 하나 이상의 항목이 포함됩니다. 항목에는 레코드 변경, 서명 또는 완료 기록에 대한 정보가 포함될 수 있습니다. 모든 항목에는 타임스탬프가 함께 표시됩니다.
레코드 변경과 관련된 항목
레코드 변경과 관련된 항목은 수정 내역을 포함하여 레코드의 전체 이력을 보여줍니다. 여기에는 다음이 포함됩니다:
- 기록 생성
- 기록의 업데이트
- 기록 삭제
- 삭제된 모든 레코드
- 단계/앱 변경 사항 (이 단계에서 데이터가 수집된 경우 해당 항목이 생성됩니다)
위의 예시는 사용자(John Smith) + 앱(Assemble History Tester) + 스테이션(이름 없음) 섹션 헤더와 함께 2개의 항목을 보여줍니다. 첫 번째 항목은 앱 단계를 나타내고, 두 번째 항목은 이전 값과 새 값이 포함된 업데이트된 레코드를 보여줍니다.
선택적으로, 취소되거나 자동 로그아웃된 앱 완료 항목은 일반 완료 항목과 구별하기 위해 “취소됨” 배지가 표시된 상태로 흐리게 표시될 수 있습니다. 이 UI 동작을 활성화하려면 CSM 또는 Tulip 관리자에게 문의하십시오.
다양한 유형의 데이터 수집
완료 기록
완료 기록은 변수 값, 로드된 레코드 자리 표시자, 사용자, 스테이션 등의 메타데이터와 같은 앱의 처리 데이터를 캡처합니다. 앱이 완료되거나 취소되거나 ‘모든 앱 데이터 저장’ 트리거 액션이 실행될 때마다 해당 앱에 대한 새로운 완료 기록이 생성됩니다. 수집된 데이터는 기록 내역 위젯에서 ‘기록된 처리 데이터’로 표시됩니다.
기록 내역 위젯에 완료 데이터를 포함하기 위한 요구 사항:
- 완료 레코드가 생성될 때 해당 레코드가 테이블 레코드 플레이스홀더에 로드되어야 합니다
- 테이블 레코드 자리 표시자가 ‘분석용으로 저장’으로 설정되어 있어야 합니다
기록 내역에 표시되는 데이터:
- 변수 값: "분석용으로 저장"으로 설정된 모든 변수가 포함됩니다.
- 레코드 ID: “분석용으로 저장”으로 설정된 레코드 플레이스홀더에 로드된 모든 레코드의 ID입니다. 단, 레코드 이력이 표시되는 해당 레코드는 제외됩니다.
테이블 레코드 데이터 변경
테이블 레코드 데이터 변경은 다음 세 가지 경로를 통해 수행할 수 있습니다:
- 앱 내에서 레코드 자리 표시자를 통해 ( Y 스테이션에서 앱 X 실행)
- 테이블 UI(관리자 인터페이스)
- 테이블 API
- 자동화
레코드 이력 위젯은 테이블 레코드 변경과 관련된 다음과 같은 정보를 표시합니다:
- 어떤 변경이 있었나요?
- 누가 업데이트했나요?
- 어느 채널에서 업데이트가 이루어졌나요? (앱, 테이블 UI, 테이블 API)
- 어떤 인터페이스에서 업데이트되었나요?
- 변경 시점은 언제였나요?
레코드 플레이스홀더를 통한 레코드 변경
“John Smith는 Y 역에서 앱 X를 실행했습니다”위젯 내 개별 레코드 표시에 가해진모든변경 사항은 테이블 레코드의 변경 전후 스냅샷이 포함된 섹션에 표시됩니다. 이러한 변경 사항은 어떤 앱을 사용하든 상관없이 나타납니다.
예시
테이블 UI(관리자 인터페이스)를 통한 레코드 변경
“관리자 인터페이스를 통해 레코드를 업데이트했습니다”테이블 관리자 인터페이스를 통해 이루어진변경 사항은새로운 섹션에 표시됩니다. 다음을 포함하여 모든 변경 사항은 별도의 항목으로 나타납니다:
- 로그인한 사용자
- 변경 유형
- 이전 값 대 새 값
- 타임스탬프
예시
Table API를 통한 레코드 변경
*“API를 통해 레코드 업데이트됨”*지정된 테이블 레코드를 변경하는 API 요청은 다음을 포함하여 새로운 섹션에 표시됩니다:
- API 토큰
- 변경 유형
- 기존 값 대 새 값
- 타임스탬프
예시
자동화를 통한 레코드 변경
*“자동화 X가 레코드를 업데이트했습니다”*테이블 레코드의 변경은 자동화를 사용하여 수행할 수 있습니다. 이러한 자동화는 다음을 포함하여 새로운 섹션에 표시됩니다:
- 자동화 이름
- 변경 유형
- 이전 값 대 새 값
- 타임스탬프
예시
구성
앱 단계에 기록 내역 위젯 추가하기
- 앱 편집기에서 도구 모음의 [삽입 ]을 클릭합니다.
- '기록 내역'을 선택합니다.
구성 옵션
컨텍스트 창에서 레코드 기록 위젯을 구성합니다.
연결된 자리 표시자
레코드 및 레코드 기록을 불러올 레코드 자리 표시자를 선택합니다.
인쇄 활성화
Tulip Player에서 레코드 이력을 인쇄할 수 있는 옵션입니다. 이 옵션을 활성화하면 위젯 헤더에 인쇄 버튼이 표시됩니다.
기본 정렬
위젯 내 데이터를 다음 중 하나로 정렬하도록 선택하십시오:
- 최신순
- 오래된 순서부터 최신 순서까지
필터
기록 내역을 동적으로(변수, 테이블 레코드 또는 앱 정보를 통해) 필터링하거나, 필터 유형에 따라 결정된 정적 값을 통해 필터링할 수 있습니다. 사용 가능한 필터 유형은 다음과 같습니다:
- 날짜/시간
- 앱 이름
- 단계 이름
- 테이블 필드 이름(레코드 자리 표시자가 연결된 테이블의 필드)
- 사용자(앱을 이용하는 사용자)
Tulip은 데이터를 사용자가 더 쉽게 이해할 수 있는 형태로 분류해 주기 때문에, 최소한 다음 필터를 사용할 것을 권장합니다:
- 날짜 및 시간
- 앱 이름
- 단계 이름
레코드 업데이트 시 “이전” 값 숨기기
이 기능을 활성화하면 사용자는 레코드의 업데이트 내용과 ‘새로운’ 값만 볼 수 있습니다.
프로세스 데이터 숨기기
이 기능을 활성화하면 앱에서 저장된 변수 데이터가 위젯에 표시되지 않습니다. 위젯에는 테이블 업데이트 내역, 서명 데이터, 앱 이름, 단계 이름 및 타임스탬프만 표시됩니다. 이는 순수 검토 앱과 같이 (프로세스 데이터 없이) 개요를 파악하는 데 유용합니다.
서명 완료된 항목만 표시
이 기능을 활성화하면 사용자는 전자 서명 기록만 볼 수 있습니다.
자주 묻는 질문
로그 유형의 세분화된 데이터가 생성되는 것을 방지하려면 어떻게 해야 합니까?
테이블 레코드가 입력 필드에 로드되고 사용자가 해당 입력 필드에 로그를 입력하면, 동일한 항목 내에서 매우 세분화된 로그 유형의 데이터가 생성됩니다. 이로 인해 레코드 기록 내에 많은 “항목”이 생성될 수 있으며, 결과적으로 검토 프로세스가 더 어려워질 수 있습니다. 입력 필드의 데이터 소스로 테이블 레코드를 사용하는 것은, 특히 GxP 고객의 경우 모범 사례가 아닙니다. 대신, 입력 필드를 변수에 연결한 다음 ‘모든 앱 데이터 저장’ 단계를 통해 완료 기록에 저장할 수 있습니다.
정적 값을 사용할 때 ‘테이블 필드 이름 필터’에 주의해야 하는 이유는 무엇입니까?
기록 이력 위젯은 데이터 필터링에 필드의 현재 이름을 사용합니다. 사용자가 테이블 필드 이름을 변경했는데도 필터가 여전히 이전 필드 이름을 사용하면 데이터 검토 시 불일치가 발생할 수 있습니다. 대신 테이블 레코드를 필터로 사용할 수도 있습니다.
“단계 X에서 완료 데이터가 누락되었습니다” 오류는 어떻게 해결하나요?
이 문제는 사용자가 테이블 레코드에 대해 작업을 수행할 때마다 앱을 완료하지 않을 때 발생할 수 있습니다. 즉, 사용자가 한 번의 완료 과정에서 여러 레코드를 처리하거나, 테이블 레코드 자리 표시자에 ‘분석을 위해 저장하지 않음’이 선택되어 있는 경우입니다.
