# Activity Instance Search 사용자 가이드

## 개요

Activity Instance Search 페이지는 특정 활동(Activity) 유형에 속하는 모든 작업 인스턴스를 검색하고 조회할 수 있는 화면입니다. 이 페이지에서는 활동별로 정의된 검색 키를 사용하여 작업 인스턴스를 필터링하고, 상세 내용을 확인할 수 있습니다.

## 화면 구성

Activity Instance Search

1. **상단 필터 영역**: 다양한 조건으로 작업 인스턴스를 필터링할 수 있는 폼이 제공됩니다.
2. **작업 목록 영역**: 검색 조건에 맞는 작업 인스턴스 목록을 표시합니다.
3. **작업 도구 영역**: 선택한 작업에 대한 작업을 수행할 수 있는 버튼들이 위치합니다.

## 주요 기능

### 작업 인스턴스 검색

선택한 활동 유형에 속하는 모든 작업 인스턴스가 목록에 표시됩니다. 목록은 다음과 같은 정보를 포함합니다:

- **이름**: 작업 인스턴스의 이름
- **설명**: 작업 인스턴스에 대한 설명
- **상태**: 작업 인스턴스의 현재 상태
- **검색 키**: 활동별로 정의된 사용자 지정 검색 필드(최대 5개)
- **수정자**: 작업을 마지막으로 수정한 사용자
- **수정 시간**: 작업이 마지막으로 수정된 시간

### 사용자 정의 검색 키

각 활동 유형마다 최대 5개까지의 사용자 정의 검색 키가 설정될 수 있습니다. 이 검색 키는 활동 설정에서 정의되며, 다음과 같은 속성을 갖습니다:

- **이름**: 검색 키의 이름
- **설명**: 검색 키에 대한 설명
- **입력 키**: 작업 인스턴스의 입력 데이터 중 참조할 필드 경로
- **번역 키**: 화면에 표시될 때 사용될 다국어 지원 키

이 검색 키들은 목록에 별도의 열로 표시되어 해당 필드로 검색하거나 정렬할 수 있습니다.

### 보기 모드

화면은 다음 세 가지 보기 모드를 지원합니다:

- **GRID**: 표 형태로 모든 정보를 상세하게 표시합니다(데스크톱 기본 모드).
- **CARD**: 카드 형태로 작업을 표시합니다(모바일 기본 모드).
- **LIST**: 간소화된 목록 형태로 표시합니다.

### 작업 인스턴스 상세 보기

목록에서 작업을 클릭하거나 보기 버튼을 클릭하면 해당 작업 인스턴스의 상세 정보를 볼 수 있는 팝업이 표시됩니다. 이 팝업에서는 다음과 같은 정보를 확인할 수 있습니다:

1. 작업의 기본 정보(이름, 설명, 상태 등)
2. 작업의 입력 데이터
3. 작업의 출력 데이터(결과물)
4. 작업의 진행 이력

## 추가 기능

### 필터링 및 검색

상단의 필터 폼을 사용하여 다양한 조건으로 작업 인스턴스를 필터링할 수 있습니다:

1. **일반 검색**: 이름, 설명 등의 일반 텍스트 필드 검색
2. **상태 필터**: 특정 상태의 작업만 표시
3. **검색 키 필터**: 활동별로 정의된 사용자 지정 검색 키를 사용한 필터링

### 데이터 정렬

각 열의 헤더를 클릭하여 해당 열을 기준으로 오름차순 또는 내림차순으로 정렬할 수 있습니다. 기본적으로 목록은 '생성 시간'을 기준으로 내림차순 정렬되어, 가장 최근에 생성된 작업이 상위에 표시됩니다.

### 데이터 내보내기

목록의 데이터는 다양한 형식(Excel, CSV 등)으로 내보낼 수 있습니다. 내보내기 시 다음과 같은 옵션을 설정할 수 있습니다:

1. **선택한 항목만 내보내기**: 목록에서 선택한 작업 인스턴스만 내보내기
2. **전체 항목 내보내기**: 현재 필터링된 모든 작업 인스턴스 내보내기
3. **열 선택**: 내보낼 열(필드) 선택

### 다중 선택 처리

목록에서 여러 작업 인스턴스를 선택하여 일괄 처리할 수 있습니다. 체크박스를 통해 여러 항목을 선택한 후, 상단의 작업 버튼을 사용하여 다음과 같은 일괄 처리가 가능합니다:

1. **일괄 내보내기**: 선택한 작업 인스턴스만 내보내기
2. **일괄 상태 변경**: 선택한 작업 인스턴스의 상태 일괄 변경(관리자 권한 필요)
