page no.
| Showpageid |
|---|
기능 설명
- 개요
- 휴지통 관리는 시스템에서 삭제된 보고서를 조회하고조회하고, 필요 시 원래 위치 또는 다른 폴더로 복원하거나 영구 삭제할 삭제할 수 있는 관리 화면입니다.
- 일반 사용자가 폴더/파일 관리 화면에서 보고서를 삭제하면 완전 삭제되지 않고 휴지통으로 이동됩니다이동됩니다. 관리자는 본 화면을 통해 아래 작업을 수행할 수 있습니다. 주요 기능
구분 기능 설명 조회 목록 표시 삭제된 보고서 목록을 그리드로 표시 검색 보고서명 기반의 키워드 검색
새로고침 최신 삭제 항목 반영을 위한 재조회
복원 원래 위치로 복원 원본 폴더가 존재하는 경우 그대로 복원
복원 폴더 변경 원본 폴더가 소실되었거나 다른 위치로 복원하고 싶을 때 사용 삭제 영구 삭제 휴지통에서 완전히 제거 (복원 불가)
기타 다운로드 삭제된 보고서의 스냅샷 파일(zip) 다운로드
원본 폴더 소실 대응 대응
휴지통 관리는 시스템에서 삭제된 보고서를 조회하고, 필요 시 원래 위치 또는 다른 폴더로 복원하거나 영구 삭제할 수 있는 관리 화면입니다.
- 삭제된 보고서의 원본 폴더가 이미 삭제되어 존재하지 않는 경우, 그 상태로는 복원할 위치가 없기 때문에 시스템이 자동으로 이를 감지하여 화면에 이를 인지하여 화면에서 별도로 복원 폴더를 지정하도록 표시합니다.
사용자는 [폴더 변경] 기능을 통해 다른 폴더를 복원 위치로 지정한 후 복원을 진행할 수 있습니다
일반 사용자가 폴더/파일 관리 화면에서 보고서를 삭제하면 완전 삭제되지 않고 휴지통으로 이동됩니다. 관리자는 본 화면을 통해 아래 작업을 수행할 수 있습니다..
- 개요
선행 시나리오
다음과 같은 작업이 선행되어야 합니다 보고서 삭제 작업이 선행되었다 가정하고 진행합니다.
- i-AUD /파일 다이얼로그
- i-MATRIX 파일 다이얼로그
- Admin 폴더/파일 관리
※ MTX_REPORT_TRASH 테이블이 제품 Repository 내에 존재하지 않으면 기존 삭제 기능과 동일하게 동작합니다.
해당 테이블이 존재하지 않는 경우 다음과 같은 방법을 통해 휴지통 관리 테이블 생성합니다.
1. Admin의 [시스템 운영 관리] > [Repository 테이블 점검] 화면에 접속합니다.
2. [Repository Script 내려받기] 버튼을 클릭하여 스크립트 파일 다운로드합니다.
3. 다운로드한 파일에서 MTX_REPORT_TRASH의 DDL문을 확인하여 DB에 실행하여 해당 테이블을 생성합니다.
사용 방법 및 상세 설정
화면 구성
- 상단 검색 영역: 검색어 입력창과 [조회] 버튼검색하고자 하는 키워드를 사용자가 입력할 수 있는 입력 창으로 구성되어있습니다.
- 버튼 영역: [ 복원], [영구삭제], [폴더 변경], [새로고침]
- 그리드 영역: 삭제된 보고서 목록, 영구 삭제 관련 설정이 가능한 버튼으로 구성되어있습니다.
- 폴더 변경: 체크된 보고서들의 복원 폴더를 일괄로 지정/변경합니다.
- 복원: 체크된 항목을 원위치 또는 지정된 복원 폴더로 되돌립니다.
- 영구 삭제: 체크된 보고서를 휴지통에서 완전히 제거합니다. (복원 불가)
- 조회: 검색 조건을 유지한 채 서버에서 삭제 보고서 목록을 다시 불러옵니다.
- 그리드 영역: 삭제되어 휴지통에 적재된 보고서 목록을 출력합니다.
그리드 컬럼 설명
컬럼명 설명 보고서명 삭제된 시점의 보고서 이름명을 표시합니다. 원본 폴더명 보고서가 삭제되기 직전 원래 위치했던 폴더의 이름이름을 표시합니다.
원본 폴더 자체가 이미 삭제된 경우 " 원본 폴더가 소실되었습니다."폴더명 문구를 회색 이탤릭체로 표시합니다.
복원 폴더명 이 보고서가 실제로 복원될 위치의 폴더명 폴더 명입니다.
기본 상태는 원본 폴더와 동일한 이름 표시합니다. (원본이 살아있을 경우 그대로 복원되므로)
원본 폴더가 소실되어 복원 위치가 불명확한 경우 "[폴더 변경]으로 복원 폴더를 지정해주세요." 안내를 회색 이탤릭체로 표시합니다.삭제자 이 보고서를 삭제한 사용자 이름이름을 표시합니다. 삭제 일자 보고서가 휴지통으로 이동된 일시이동 된 일시를 표시합니다. - 검색
검색어 입력 규칙
- 최대 50자까지 입력 가능가능합니다.
- 파이프 문자(|)는 사용할 수 없습니다. (내부적으로 이스케이프 문자로 사용)
-%,_는 자동으로 이스케이프 처리되어 실제 문자로 검색됩니다
1 상단 검색창에 보고서명 일부를 입력합니다.
2 검색 범위 대상 컬럼은 [보고서명] [원본 폴더명] [삭제자] 입니다.
1. 검색창에 검색하고자 하는 키워드를 입력합니다.
2. Enter 키 또는 [조회] 버튼 클릭 시 그리드가 갱신됩니다.
원본 폴더
- 복원 실행
1. 복원할 항목을 선택합니다. (또는 단일 편집으로 자동 체크된 상태 활용)
2. [복원] 버튼을 클릭합니다.
3. "선택한 보고서를 복원 하시겠습니까?" [예] 클릭 시 순차 복원을 진행합니다.
4. 완료 후 결과 요약 안내
- 전체 성공: [N건]이 복원되었습니다.
- 부분 실패: 총 [N건] 요청 중 [K건] 복원 완료, [M건] 실패. + 실패 상세 목록
실행 전 자동 검증
- 선택된 항목이 없으면 선택된 항목이 없다는 안내 메세지를 표시합니다.
- 원본 소실 + 복원 폴더 미지정 항목이 섞여 있으면 진행 중단 후 메세지로 해당 사항에 대해서 안내합니다. (해당 항목을 먼저 [폴더 변경]으로 지정 필요)
- 원본 폴더 소실 표시
원본 폴더가 이미 삭제된 항목은 그리드에서 아래와 같이 시각적으로 구분됩니다.
원본 폴더가 소실된 경우 해당 복원 폴더명을 지정하기 전까지 해당 보고서는 복원이 불가합니다.
- 원본 폴더명 셀: 소실된 기존 보고서 폴더명 문구를 회색 이탤릭체로 표시표시합니다.
- 복원 폴더명 셀: "[폴더 변경]에서 복원 폴더를 지정해주세요." 안내를 동일 스타일로 표시표시합니다.
- 복원 폴더 지정 (2가지 방식)
1) 단일 지정 (셀 더블클릭)
그리드에서 복원 폴더명 셀 또는 폴더 아이콘 셀을 더블클릭합니다.
-체크 여부와 무관하게 그 행 하나만 처리됩니다.
- 폴더 선택 팝업이 열리면 트리에서 위치를 선택 → [확인]
- 지정된 행은 자동으로 체크됩니다 (별도 체크 없이 바로 [복원] 클릭 가능)
2) 일괄 지정 ([폴더 변경] 버튼)
여러 항목의 복원 폴더를 동일한 위치로 한 번에 바꾸고자 할 때 사용합니다.
- 그리드에서 대상 행들의 체크박스를 선택
- [폴더 변경] 버튼 클릭
- 폴더 선택 팝업에서 위치 선택 → [확인]
- 복원 폴더가 일괄 변경됨을 확인
폴더 선택 팝업 상세
팝업은 상단 폴더 트리와 하단 설정 팝업 상세
복원 폴더 설정 팝업은 [복원 폴더명], [폴더 아이콘] 셀을 더블 클릭하거나 [폴더 변경] 버튼을 클릭하여 설정이 가능합니다.
※ 자세한 지정 방식은 바로 아래 g.복원 폴더 지정 (2가지 방식) 참조
- 팝업은 상단 폴더 트리와 하단 선택 경로 표시 영역으로 구성됩니다.
- 폴더 트리: 최상위 폴더는 자동 확장. 하위 폴더는 클릭 시 확장
폴더 트리는 [공용 폴더]와 사용자 별 [내 폴더] 목록을 자동으로 펼쳐 표시합니다.
- 경로 표시: 선택한 폴더의 전체 경로가 상위 > 중간 > 선택폴더선택폴더 형식으로 표시표시합니다.
- 대상 안내 라벨: 팝업 하단에 편집 대상 표시 (선택 항목)
단일 선택: 판매 보고서
다중 선택: 판매 보고서 외 2건
[확인]: 버튼 클릭 시 폴더를 선택하지 않거나 기존과 동일한 폴더를 선택하는 경우 안내 메세지를 출력합니다.
- 폴더를 폴더를 선택하지 않으면 "폴더 경로를 지정해 주세요폴더를 선택해주십시오." 메세지 안내
- 선택한 선택한 폴더가 현재 값과 현재와 같으면 "기존 경로와 동일한 경로입니다." 안내 안내합니다. (팝업 유지)
- 변경 변경 완료 시 팝업 자동 종료 + 안내 노출:
복원 실행
1. 복원할 항목 체크 (또는 단일 편집으로 자동 체크된 상태 활용)
2. [복원] 버튼 클릭
3. "선택한 보고서를 복원 하시겠습니까?" 확인
4. [예] 클릭 시 순차 복원 진행 (진행률은 프로그레스 바로 표시)
5. 완료 후 결과 요약 안내
- 전체 성공: [N건]이 복원되었습니다.
- 부분 실패: 총 [N건] 요청 중 [K건] 복원 완료, [M건] 실패. + 실패 상세 목록
실행 전 자동 검증
- 체크된 항목이 없으면 안내
- 원본 소실 + 복원 폴더 미지정 항목이 섞여 있으면 진행 중단 후 안내 (해당 항목을 먼저 [폴더 변경]으로 지정 필요)
종료되고 변경이 완료되었다는 메세지를 출력합니다.
- 복원 폴더 지정 (2가지 방식)
1) 단일 지정 (셀 더블 클릭)
그리드에서 복원 폴더 명 셀 또는 폴더 아이콘 셀을 더블 클릭합니다.
- 체크 여부와 무관하게 그 행 하나만 처리됩니다.
- 복원 폴더 설정 팝업이 열리면 트리에서 복원 폴더를 선택하고 [확인] 버튼을 클릭합니다.
- 복원 폴더가 지정된 행은 자동으로 체크됩니다 (별도 체크 없이 바로 [복원] 클릭 가능)
2) 일괄 지정 ([폴더 변경] 버튼)
여러 항목의 복원 폴더를 동일한 위치로 한 번에 바꾸고자 할 때 사용합니다.
- 그리드에서 대상 행들의 체크박스를 선택합니다.
- [폴더 변경] 버튼 클릭합니다.
- 복원 폴더 설정 팝업이 열리면 트리에서 위치를 선택하고 [확인] 버튼을 클릭합니다.
- 복원 폴더가 일괄 변경됨을 확인합니다.
3) 복원 진행
복원 폴더의 변경 사항을 확인하고 [복원] 버튼을 클릭하여 변경한 폴더로 보고서를 복원 합니다.
※ 복원 폴더 변경 후 [복원] 버튼을 누르지 않으면 설정한 내용이 초기화될 수 있습니다.
영구 삭제
1. 삭제할 항목 체크선택합니다.
2. [영구삭제영구 삭제] 버튼 클릭클릭합니다.
3. "선택한 보고서를 영구 삭제하시겠습니까?" 확인
4. [예] 클릭 시 순차 삭제 진행
5삭제를 진행합니다.
4. 완료 후 결과 요약 안내
- 전체 성공: [N건]이 삭제되었습니다.
- 부분 실패: 총 [N건] 요청 중 [K건] 삭제 완료, [M건] 실패. + 실패 상세 목록
※ 영구 삭제된 항목은 복원 불가합니다.- 다운로드
다운로드 컬럼을 더블클릭하면 더블 클릭하면 해당 보고서의 스냅샷 파일({REPORT_CODE}.zip)을 다운로드합니다.파일을 다운로드합니다.
- 확인 확인 안내: "[보고서명] 해당 보고서를 다운로드 받으시겠습니까?"
- 파일명 파일명: 보고서명 기반으로 저장 (특수문자는 브라우저 정책에 따라 자동 정제됨
- 조회 (새로고침)
새로고침
[새로고침조회] 버튼 클릭 시 서버에서 최신 목록을 다시 조회합니다조회합니다. - ㄴㅇㄹ
서버 로직
- ㅇㄹㄴㅇㄹ
- ㅇㄹㄴㄹㅇ
- ㄴㅇㄹㅇㄴㄹ
- 백업 스케줄 관리 화면
DB의 로그 데이터(MTX_AGENT_LOG)를 주기적으로 백업하는 스케줄을 설정하고, 지금까지 실행된 백업 이력을 확인하는 화면입니다.
1. 백업 스케줄 설정
백업 작업을 언제, 어떻게 실행할지 설정하는 기능
- 활성화: 백업 스케줄 활성화 여부를 설정합니다.
- 백업 유지 일수: DB에 로그 데이터를 유지할 기간을 일 단위로 설정합니다.
백업 유지일수만큼의 최근 데이터만 DB에 유지되고, 그 이전 데이터는 파일로 백업 후 삭제됩니다.
ex) 예를 들어 백업 유지일수를 4일로 설정하면 DB에는 오늘 포함 최근 4일치 데이터만 남고, 그 이전 데이터는 파일로 백업 후 DB에서 삭제됩니다.
오늘이 2026-04-06이면 2026-04-03 ~ 2026-04-06 데이터만 DB에 유지되며,
다음날(2026-04-07)이 되면 2026-04-03 데이터가 백업 후 삭제되어 DB에는 2026-04-04 ~ 2026-04-07이 남게됩니다.
- 실행 주기 및 실행 시간: 백업 실행 주기 선택 (일별 / 주별 / 월별) 합니다.
- 일별: 매일 지정한 시각(ex: 매일 10시 59분)에 실행
- 주별: 지정한 요일과 시각(ex: 매주 월요일 0시 0분)에 실행
- 월별
날짜별: 매월 특정 일(ex: 매월 1일 0시 0분)에 실행
주차별: 매월 특정 주의 특정 요일(ex: 매월 첫째 주 월요일 0시 0분)에 실행
※ 백업 스케줄 설정은 반드시 [확인] 버튼을 클릭해야 저장됩니다.
2. 백업 실행 이력
지금까지 실행된 로그 데이터 백업 작업의 이력 결과를 조회합니다.
조회 조건
조회 기간: 백업 대상 데이터의 기간을 기준으로 조회할 시작일 ~ 종료일을 지정합니다.
상태:
: 실행 중
: 에러
: 완료
: 사용자 취소
컬럼 정보
- 상태: 백업 작업의 현재 상태 (실행 중 / 완료 / 오류 / 사용자 취소)
- 백업 대상 기간: 백업이 수행된 로그 데이터의 시작일 ~ 종료일
- 백업 주기: 백업이 실행된 주기 (일별 / 주별 / 월별)
- 백업 레코드 수: 백업된 로그 데이터의 총 Row 건수
- 백업 시작 시간: 백업 작업이 시작된 일시
- 백업 종료 시간: 백업 작업이 종료된 일시
- 소요 시간: 백업 작업에 소요된 총 시간
- 서버IP: 백업 작업을 수행한 서버의 IP 주소
- 등록자: 백업 작업을 실행한 사용자
- 상태 메세지: 백업 작업의 상세 정보 - STOP(백업 스케줄 중지)
- 실행 중인 백업 작업을 중단하는 버튼입니다.
- 실행 중인 경우에만 백업 중단 버튼이 활성화 됩니다.
: 중단 비활성화
: 중단 활성화
백업 데이터 조회 화면
백업된 로그 데이터를 조회하고 백업 파일을 다운로드할 수 있는 기능을 제공하는 화면입니다.
1. 백업 데이터 조회 날짜 트리
- 백업 주기 제목 아래 트리 구조로 백업 파일 날짜가 표시됩니다.
- 연도 → 월 → 일 형태로 계층적으로 펼쳐집니다.
- 특정 날짜를 선택하면 우측에 해당 날짜의 로그 데이터가 표시됩니다.
2. 로그 백업 데이터
좌측 트리에서 선택한 날짜의 백업된 로그 데이터를 목록으로 표시합니다.
- SQL은 내용이 길어 클릭 시 별도의 팝업창에서 내용 확인이 가능합니다.
3. 다운로드 기능
상단의 다운로드 버튼을 클릭하면 다운로드 할 백업 대상 기간을 설정하여 파일을 다운로드 할 수 있는 팝업창이 열립니다.
- 백업 대상 기간: 로그 데이터의 백업 일자를 기준으로 다운로드할 시작일 ~ 종료일을 지정합니다.
- 다운로드: 지정한 기간의 로그 데이터를 ZIP 파일로 생성하여 다운로드 할 수 있습니다.
- 복원 후 보고서 권한 설정
휴지통에서 복원된 보고서는 삭제되기 전의 권한 정보가 함께 복원되지 않습니다.
따라서 복원 이후 해당 보고서를 실제 사용자가 다시 조회·실행할 수 있도록, [Admin 폴더/파일 관리] 화면에서 별도로 권한을 추가 설정해 주셔야 합니다.
- 백업 스케줄 관리 화면
서버 동작
공통
1. 휴지통 전용 신규 Rule 파일을 기준으로 백업 및 복원 동작 수행
- Rule 파일 경로: reports/cm/tableinfo/report_trash.json
2. 보고서 삭제 시 동일한 보고서 코드가 휴지통에 존재하는 경우, 가장 최근 삭제 건으로 덮어쓰기한다.주요 기능
1. 보고서 삭제 (휴지통 이동)
(Admin 휴지통 관리 보고서/파일 다이얼로그 → 서비스 호출)
1) 백업 ZIP 생성 (기존 백업 서비스 재사용)
2) MTX_REPORT_TRASH (보고서 휴지통 정보) 테이블 등록
3) 원본 데이터/파일 삭제
※ MTX_REPORT_TRASH 테이블이 존재하지 않으면 기존 삭제 기능과 동일하게 동작합니다.
해당 테이블이 존재하지 않는 경우 다음과 같은 방법을 통해 휴지통 관리 테이블 생성합니다.
1. Admin의 [시스템 운영 관리] > [Repository 테이블 점검] 화면에 접속합니다.
2. [Repository Script 내려받기] 버튼을 클릭하여 스크립트 파일 다운로드합니다.
3. 다운로드한 파일에서 MTX_REPORT_TRASH의 DDL문을 확인하여 DB에 실행하여 해당 테이블을 생성합니다.※ 백업 ZIP 포함 대상
1. 보고서 파일 및 리소스
- reports/{REPORT_PATH}
- reports/iGRID_DESIGN/{REPORT_CODE}
- reports/SERVER_SCRIPT/{REPORT_CODE}
2. Conflux 보고서의 경우, 아래 경로도 포함
- reports/_AUD_CONFLUX_/_REPORT_DATA_/{REPORT_CODE}/reportInfo.json
- reports/_AUD_CONFLUX_/_REPORT_DATA_/{REPORT_CODE}/resource/R2026xxx
※ 백업 ZIP 생성 경로
- reports/cm/report_trash/{REPORT_CODE}.zip
2. 휴지통 복원
(Admin 휴지통 관리 보고서 → 서비스 호출)
1) 백업 ZIP 기준 복원 (기존 복원 서비스 재사용)
2) MTX_REPORT_TRASH (보고서 휴지통 정보) 테이블에서 삭제
3) 백업 ZIP 삭제
3. 휴지통 영구 삭제
(Admin 휴지통 관리 보고서 내 실행)
1) MTX_REPORT_TRASH (보고서 휴지통 정보) 테이블에서 삭제
2) 백업 ZIP 삭제
| 기능 정보 |
|
|
|
|
|
|
|
|---|---|---|---|---|---|---|---|
| 시작 버전 정보 |
| ||||||
| 페이지 속성 | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
page no.
| Showpageid |
|---|
|