page no. 

Start Release No : 7.0.500.20260806-21 / Update Release No : 7.0.500.20260806-21

작성자 :  손성준 / 검수자 :

     기능 설명

    1. 개요
         - 휴지통 관리는 시스템에서 삭제된 보고서를 조회하고, 필요 시 원래 위치 또는 다른 폴더로 복원하거나 영구 삭제할 수 있는 관리 화면입니다.
         - 일반 사용자가 폴더/파일 관리 화면에서 보고서를 삭제하면 완전 삭제되지 않고 휴지통으로 이동됩니다. 관리자는 본 화면을 통해 아래 작업을 수행할 수 있습니다.

    2. 주요 기능

      구분기능설명
      조회

      목록 표시삭제된 보고서 목록을 그리드로 표시
      검색

      보고서명 기반의 키워드 검색

      새로고침

      최신 삭제 항목 반영을 위한 재조회

      복원원래 위치로 복원

      원본 폴더가 존재하는 경우 그대로 복원

      복원 폴더 변경원본 폴더가 소실되었거나 다른 위치로 복원하고 싶을 때 사용
      삭제영구 삭제

      휴지통에서 완전히 제거 (복원 불가)

      기타다운로드

      삭제된 보고서의 스냅샷 파일(zip) 다운로드


    3. 원본 폴더 소실 대응 
         - 삭제된 보고서의 원본 폴더가 이미 삭제되어 존재하지 않는 경우, 그 상태로는 복원할 위치가 없기 때문에 시스템이 자동으로 이를 감지하여 화면에 표시합니다.       
           사용자는 [폴더 변경] 기능을 통해 다른 폴더를 복원 위치로 지정한 후 복원을 진행할 수 있습니다.

    4. 휴지통 관리는 시스템에서 삭제된 보고서를 조회하고, 필요 시 원래 위치 또는 다른 폴더로 복원하거나 영구 삭제할 수 있는 관리 화면입니다.
    5. 일반 사용자가 폴더/파일 관리 화면에서 보고서를 삭제하면 완전 삭제되지 않고 휴지통으로 이동됩니다. 관리자는 본 화면을 통해 아래 작업을 수행할 수 있습니다.

     선행 시나리오

다음과 같은 보고서 삭제 작업이 선행되었다 가정하고 진행합니다.

   - i-AUD/i-MATRIX  파일 다이얼로그

   - Admin 폴더/파일 관리



※ MTX_REPORT_TRASH 테이블이 제품 Repository 내에 존재하지 않으면 기존 삭제 기능과 동일하게 동작합니다.



  1. 사용 방법 및 상세 설정

    1. 화면 구성 
         - 상단 검색 영역: 검색어 입력창, [조회] 버튼으로 구성되어있습니다.
         - 버튼 영역: [폴더 변경], [복원], [영구 삭제], [조회]
         - 그리드 영역: 삭제된 보고서 목록을 출력합니다.



    2. 그리드 컬럼 설명

      컬럼명설명
      보고서명삭제된 시점의 보고서 이름
      원본 폴더명

      보고서가 삭제되기 직전 원래 위치했던 폴더의 이름

      원본 폴더 자체가 이미 삭제된 경우 "원본 폴더가 소실되었습니다." 문구를 회색 이탤릭체로 표시

      복원 폴더명이 보고서가 실제로 복원될 위치의 폴더명 기본 상태는 원본 폴더와 동일한 이름 표시 (원본이 살아있을 경우 그대로 복원되므로) 원본 폴더가 소실되어 복원 위치가 불명확한 경우 "[폴더 변경]으로 복원 폴더를 지정해주세요." 안내를 회색 이탤릭체로 표시
      삭제자이 보고서를 삭제한 사용자 이름
      삭제 일자보고서가 휴지통으로 이동된 일시


    3. 검색
      검색어 입력 규칙
         - 최대 50자까지 입력 가능합니다.


         - 파이프 문자(|)는 사용할 수 없습니다. (내부적으로 이스케이프 문자로 사용)


         - 검색 범위 대상 컬럼은 [보고서명] [원본 폴더명] [삭제자] 입니다.

      1 상단 검색창에 검색하고자 하는 키워드를 입력합니다.



      2 Enter 키 또는 [조회] 버튼 클릭 시 그리드가 갱신됩니다.



    4. 원본 폴더 소실 표시
      원본 폴더가 이미 삭제된 항목은 그리드에서 아래와 같이 시각적으로 구분됩니다.
         - 원본 폴더명 셀: 기존 보고서 폴더명 문구를 회색 이탤릭체로 표시합니다.
         - 복원 폴더명 셀: "[폴더 변경]에서 복원 폴더를 지정해주세요." 안내를 동일 스타일로 표시합니다.



    5. 폴더 선택 팝업 상세
      팝업은 상단 폴더 트리와 하단 선택 경로 표시 영역으로 구성됩니다.


         - 폴더 트리: 폴더 트리는 [공용 폴더]와 사용자 별 [내 폴더] 목록을 자동으로 펼쳐 표시합니다.


         - 경로 표시: 선택한 폴더의 전체 경로가 상위 > 중간 > 선택폴더 형식으로 표시합니다.


         - 대상 안내 라벨: 팝업 하단에 편집 대상 표시 (선택 항목)

               단일 선택: 판매 보고서
               다중 선택: 판매 보고서 외 2건

      [확인]: 버튼 클릭 시 폴더를 선택하지 않거나 기존과 동일한 폴더를 선택하는 경우 안내 메세지를 출력합니다.
         - 폴더를 선택하지 않으면 "폴더를 선택해주십시오." 메세지 안내


         - 선택한 폴더가 현재 값과 같으면 "기존 경로와 동일한 경로입니다." 안내합니다. (팝업 유지)


         - 변경 완료 시 팝업 자동 종료되고 변경이 완료되었다는 메세지를 출력합니다.



    6. 복원 폴더 지정 (2가지 방식)
      1) 단일 지정 (셀 더블 클릭)
      그리드에서 복원 폴더 명 셀 또는 폴더 아이콘 셀을 더블 클릭합니다.
         - 체크 여부와 무관하게 그 행 하나만 처리됩니다.
         - 복원 폴더 설정 팝업이 열리면 트리에서 위치를 선택하고 [확인] 버튼을 클릭합니다.


         - 복원 폴더가 지정된 행은 자동으로 체크됩니다 (별도 체크 없이 바로 [복원] 클릭 가능)


      2) 일괄 지정 ([폴더 변경] 버튼)
      여러 항목의 복원 폴더를 동일한 위치로 한 번에 바꾸고자 할 때 사용합니다.
         - 그리드에서 대상 행들의 체크박스를 선택합니다.
         - [폴더 변경] 버튼 클릭합니다.
         - 복원 폴더 설정 팝업이 열리면 트리에서 위치를 선택하고 [확인] 버튼을 클릭합니다.


         - 복원 폴더가 일괄 변경됨을 확인합니다.



    7. 복원 실행
      1. 복원할 항목을 선택합니다. (또는 단일 편집으로 자동 체크된 상태 활용)
      2. [복원] 버튼을 클릭합니다.
      3. "선택한 보고서를 복원 하시겠습니까?" [예] 클릭 시 순차 복원을 진행합니다. 


      4. 완료 후 결과 요약 안내
         - 전체 성공: [N건]이 복원되었습니다.


         - 부분 실패: 총 [N건] 요청 중 [K건] 복원 완료, [M건] 실패. + 실패 상세 목록


      실행 전 자동 검증
         - 선택된 항목이 없으면 선택된 항목이 없다는 안내 메세지를 표시합니다.


         - 원본 소실 + 복원 폴더 미지정 항목이 섞여 있으면 진행 중단 후 메세지로 해당 사항에 대해서 안내합니다. (해당 항목을 먼저 [폴더 변경]으로 지정 필요)


    8. 영구 삭제

      1. 삭제할 항목 선택합니다.
      2. [영구 삭제] 버튼 클릭합니다.
      3. "선택한 보고서를 영구 삭제하시겠습니까?" [예] 클릭 시 순차 삭제를 진행합니다.


      4. 완료 후 결과 요약 안내
         - 전체 성공: [N건]이 삭제되었습니다.


         - 부분 실패: 총 [N건] 요청 중 [K건] 삭제 완료, [M건] 실패. + 실패 상세 목록


      ※ 영구 삭제된 항목은 복원 불가합니다.

    9. 다운로드
      다운로드 컬럼을 더블 클릭하면 해당 보고서의 스냅샷 파일을 다운로드합니다.
         - 확인 안내: "[보고서명] 해당 보고서를 다운로드 받으시겠습니까?"
         - 파일명: 보고서명 기반으로 저장



    10. 조회 (새로고침)
      [조회] 버튼 클릭 시 서버에서 최신 목록을 다시 조회합니다.


    11. 복원 후 보고서 권한 설정안내
      휴지통에서 복원된 보고서는 삭제되기 전의 권한 정보가 함께 복원되지 않습니다.
      따라서 복원 이후 해당 보고서를 실제 사용자가 다시 조회·실행할 수 있도록 하려면, [Admin 폴더/파일 관리] 화면에서 별도로 권한을 추가 설정해 주셔야 합니다.




  1. 서버 동작

    1. 공통
      1. 휴지통 전용 신규 Rule 파일을 기준으로 백업 및 복원 동작 수행
         - Rule 파일 경로: reports/cm/tableinfo/report_trash.json
      2. 보고서 삭제 시 동일한 보고서 코드가 휴지통에 존재하는 경우, 가장 최근 삭제 건으로 덮어쓰기한다.

    2. 주요 기능
      1. 보고서 삭제 (휴지통 이동)
         (Admin 휴지통 관리 보고서/파일 다이얼로그 → 서비스 호출)
            1) 백업 ZIP 생성 (기존 백업 서비스 재사용)
            2) MTX_REPORT_TRASH (보고서 휴지통 정보) 테이블 등록
            3) 원본 데이터/파일 삭제

      ※ MTX_REPORT_TRASH 테이블이 존재하지 않으면 기존 삭제 기능과 동일하게 동작합니다.
      ※ 백업 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 삭제

    3. 테이블 정보 (MTX_REPORT_TRASH)

      컬럼명설명데이터 타입길이PK
      REPORT_CODE보고서 코드VARCHAR2501
      REPORT_NAME보고서명VARCHAR2256
      FOLDER_CODE폴더 코드VARCHAR250
      FOLDER_NAME폴더명VARCHAR2256
      MODULE_CODE모듈 코드VARCHAR22
      DELETE_CODE삭제 사용자 코드VARCHAR250
      DELETE_NAME삭제 사용자명VARCHAR2100
      DELETE_DATE삭제 일시TIMESTAMP








기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보
  • Admin : 7.0.500.20260415




(BCRM#G0701) [Admin]로그 테이블 백업 관리 보고서 개발







page no. 

Start Release No : 7.0.500.20260806-21 / Update Release No : 7.0.500.20260806-21

작성자 :  손성준 / 검수자 :