완료

Prev Next

완료 기록의 기본 사항과 애플리케이션 데이터에서 이를 최적화하여 활용하는 방법을 알아보세요.

개요

완료 레코드는 Tulip 앱의 값을 저장하는 변경 불가능한 데이터 집합입니다. 레코드는 앱이 완료되면 자동으로 저장됩니다. 또한 트리거를 사용하여 중요한 시점(예: 프로세스 완료 시)에 데이터를 저장할 수도 있습니다.

완료 기록은 테이블과 마찬가지로 데이터 저장 방식 중 하나입니다. 그러나 테이블과 달리 완료 기록은 수정하거나 변경할 수 없으므로 데이터가 정확하게 캡처됩니다. Tulip은 데이터 수집 방법으로 완료 기록과 테이블을 모두 활용할 것을 권장합니다.

애플리케이션의 컴플리션 레코드에 액세스하려면 ‘앱 정보 (App Info)’ 페이지로 이동하여 ‘컴플리션 (Completions)’ 탭을 클릭하세요.

Go to Completions

앱이 완료되거나 취소될 때마다 모든 앱에 자동으로 저장되는 완료 데이터 필드에는 다음과 같은 항목들이 있습니다:

  • 앱 사용 시간
  • 시작 및 종료 시간
  • 완료된 각 단계별 소요 시간
  • 로그인한 사용자
  • 역명
  • 비고
  • 앱 버전
  • 실행 ID
  • 취소됨 (앱이 취소되었는지 여부)

전자 서명 위젯의 서명 데이터도 완료 기록에 저장됩니다. 변수를 사용하고 이를 저장하도록 트리거를 구성하여 추가 정보를 저장할 수 있습니다.

완료 기록을 사용할 때

완료 기록에는 변수, 앱 단계, 타임스탬프, 사용자 정보, 전자 서명 등의 값이 저장됩니다. 테이블을 사용하여 데이터를 저장할 수도 있지만, 다음과 같이 완료 기록을 사용하는 것이 더 적합한 특정 시나리오가 있습니다.

  • 사진, 중요한 공정 매개변수에 대한 기록 결과, 센서 측정값 등을 포함하여 사용자 또는 기계가 캡처한 값
  • 캡처된 값과 쌍을 이루는 측정 단위. 측정 변수와 별도로 측정 단위(UoM) 변수를 분리하는 것이 모범 사례입니다.
  • 이력 기록을 사람이 쉽게 읽을 수 있도록 하는 맥락 정보. 예를 들어, 각 앱 사이클 시작 시 캡처된 단계 이름이나 고유 ID를 통해 간편한 검색이 가능하도록 하는 경우
  • 프로세스 앱의 사이클 시간을 앱 내 각 단계 수준까지 상세히 캡처하기 위해

완료 데이터 저장

NOTE

Completion data only saves when you run an app. Testing an app in development mode will not save completion records, however it will show a simulated completion record.

앱 완료

사용자가 앱을 완료하면 완료 데이터는 자동으로 저장되지만, 앱을 완료하기 위해서는 ‘전환(Transition)’이 포함된 트리거가 반드시 있어야 합니다.

Complete%20App%20Trigger

앱을 완료하면…

  • 앱의 모든 메타데이터 필드를 저장합니다
  • 모든 앱 변수의 현재 값을 저장합니다
  • 로드된 모든 테이블 레코드의 현재 필드 값을 하나의 타임스탬프와 함께 저장합니다
  • 모든 변수를 기본값으로 재설정합니다(완료 시 지우지 않도록 설정된 변수는 제외).
  • 모든 테이블 레코드 자리 표시자를 지웁니다
  • 앱의 가장 최근 게시된 버전을 불러옵니다*

*스테이션이 가장 최근 게시된 버전을 실행하도록 구성된 경우

앱 취소

'앱 취소' 전환은 '앱 완료'와 동일한 작업을 수행하며, 여기에 앱 내 모든 변수를 기본값으로 재설정하는 기능이 추가됩니다.

Cancel%20App%20Trigger

모든 앱 데이터 저장

이 작업은 메타데이터 필드, 변수의 현재 값, 그리고 앱에서 불러온 테이블 레코드의 필드 값을 저장합니다. ‘앱 완료’ 전환과 달리, ‘모든 앱 데이터 저장’은 변수를 기본값으로 재설정하지 않으며 테이블 레코드 자리 표시자도 지우지 않습니다.

Save%20All%20App%20Data%20Trigger

기술적 동작

완료 레코드 저장은 다음 트리거에 의해 시작됩니다: 1. ‘모든 앱 데이터 저장’ 작업 2. ‘앱 취소’ 또는 ‘앱 완료’ 작업.

또한 다음과 같은 상황에서도 완료 처리가 시작될 수 있습니다: 1. 사용자가 로그아웃하고 인스턴스에서 '검증 모드'가 활성화된 경우 2. 플레이어 계정 설정 중 '운영자가 로그아웃할 때 실행 중인 앱 취소'가 활성화된 경우

완료 저장 과정에서 Tulip은 앱 데이터의 스냅샷을 생성하여 서버로 전송하고 데이터베이스에 기록합니다. 이후 다른 Tulip 서비스에서 스냅샷에 대한 추가 정보가 기록됩니다.

테이블 레코드의 경우, 완료 처리는 완료 프로세스가 시작될 당시의 레코드 ID만 스냅샷으로 캡처합니다. 완료 처리 내의 레코드 ID는 전체 레코드 데이터를 요청하는 데 사용됩니다. 따라서 완료 처리는 테이블 레코드의 전체 필드 값 세트를 즉시 캡처하지 않습니다. 이러한 동작은 데이터 전송량과 시스템 로딩 시간을 최소화합니다.

Table record discrepancy warning

Because of this behavior, it is possible for a completion save action to initiate, and then a table record update action occurs before the completion save has been processed. This scenario may result in the completion record capturing the updated table record value, instead of the original record value at the time the completion save action was initiated.

완료 기록에서 테이블 레코드 데이터 불일치가 발생할 가능성을 방지하려면 다음 방법을 고려하십시오. * ‘모든 앱 데이터 저장’ 작업과 ‘테이블 레코드 업데이트’ 작업에 별도의 트리거를 사용하십시오. * 완료 저장 작업을 시작하기 전에 주요 레코드 필드를 변수에 저장하십시오.

제한 사항 및 모범 사례

완료 레코드를 사용하면 변경 불가능한 데이터 레코드를 쉽게 저장할 수 있지만, 저장된 데이터는 비즈니스 인텔리전스(BI) 플랫폼과 같은 타사 시스템으로 오프라인 전송할 수 없습니다. 또한 완료 레코드는 다른 변수나 트리거 액션의 입력으로 사용할 수 없습니다.

운영/프로세스 앱에서는 프로세스 종료 시 완료 레코드를 저장해야 합니다. 특히 GxP 산업의 경우, 프로세스 단계를 종료할 때마다 ‘모든 앱 데이터 저장’을 사용하는 것이 권장됩니다.

비운영 프로세스 사용 사례(예: 작업 지시서 관리 앱)에서는 앱 사용에 대한 간단한 감사 추적을 확보하기 위해 프로세스 종료 시(예: 작업 지시서 생성 완료 시) 완료 레코드를 생성해야 합니다. 이러한 완료 레코드는 다음과 같은 질문에 즉각적인 답변을 제공합니다.

  • 앱은 언제, 누가 마지막으로 사용했는가?
  • 앱은 얼마나 자주 사용되나요?
  • 앱이 취소되고 있는가, 그리고 어떤 단계에서 취소되는가?

앱에서 단일 프로세스가 완료되면 변수에 저장된 데이터를 지우는 것이 모범 사례입니다. 또한, 특히 ‘기록 내역(Record History)’ 위젯을 통해 데이터를 확인할 계획이라면 각 변수는 적절한 명명 규칙을 따라야 합니다.

앱에서 완료 기록 보기

앱에서 완료 기록의 데이터를 사용하는 방법에는 두 가지가 있습니다: * Analysis에서 * 기록 내역 위젯에서

완료 기록의 데이터는 Tulip Table API를 통해 액세스할 수 없다는 점에 유의하십시오.

분석에서 완료 기록 사용하기

테이블 또는 기계 데이터로 분석을 생성하는 것과 마찬가지로, 앱 데이터를 사용하여 분석을 생성할 수도 있습니다. 앱에 분석을 삽입하여 사이클 시간, 교대 근무 시간 또는 완료된 단위 수에 대한 정보를 표시할 수 있습니다.

하나 또는 여러 앱에서새로운 분석을 생성할 수 있습니다. 분석을 생성한 후, 앱에서 분석 위젯을 사용하여 삽입할 분석을 선택하세요.

Completion%20Analysis%20in%20App

기록 이력 위젯

Digital Record History 위젯은 각 완료 기록과 관련된 공정 데이터를 표시합니다. 이 위젯은 스크롤이 가능하며, 필터를 적용하여 기록을 정렬할 수도 있습니다. 또한 전자 서명 데이터도 확인할 수 있습니다. 이 위젯을 구성하는 방법을 알아보려면 ‘기록 이력 위젯을 사용하여 테이블 기록의 변경 사항 확인’을 참조하십시오.

NOTE

The record history widget is available only for Enterprise customers.

Record%20History%20Widget%20Ex

추가 정보

{{snippet.원하는 정보를 찾으셨나요?}}