첨부 파일 관리

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분

    • 관리자는 파일을 업로드하고 기록에 첨부하는 방법에 대한 시스템 속성을 구성할 수 있습니다. 첨부 파일을 업로드하고 보고 삭제하면 알림 또는 스크립트에 사용할 수 있는 단일 이벤트가 트리거됩니다.

    첨부 파일 테이블

    테이블에 첨부 파일을 저장하면 첨부 파일 메타데이터를 포함하는 첨부 파일 [sys_attachment] 테이블에 기록이 생성됩니다. 파일 데이터는 첨부 문서 [sys_attachment_doc] 테이블에 4k 청크로 저장됩니다. 예를 들어, My_attachment.pdf라는 12k 파일을 첨부하면 세 개의 관련 첨부 문서 항목이 있는 첨부 파일 항목이 있습니다.

    첨부 파일을 기록에 업로드하는 방법에 대한 자세한 내용은 첨부 파일 추가 및 관리를 참조하십시오.

    활동 스트림 썸네일 크기 조정

    이 glide.ui.activity_stream.scale_images 속성은 큰 이미지의 크기를 줄이고 이미지의 활동 스트림 뷰에 대한 축소판을 만듭니다. 이 속성은 기본적으로 활성화됩니다. 이는 이미지에 소급 적용되므로 과거의 활동 스트림에 포함된 모든 첨부 파일에도 효과가 나타납니다.
    • 이 속성을 사용하는 썸네일의 최대 크기는 너비 525픽셀, 높이 350픽셀입니다. 시스템에서는 픽셀 높이를 먼저 선호하므로 525픽셀보다 넓은 이미지가 생성될 수 있습니다.
    • 5MB를 초과하는 이미지 파일을 첨부하면 메모리 부족 오류가 발생하고 인스턴스가 다시 시작될 수 있습니다. 새 이미지를 첨부할 때 시스템에서 썸네일을 생성할 때 메모리 부족 오류 및 재시작이 발생합니다. 오류 및 다시 시작은 기록에 기존 이미지를 처음 로드할 때도 발생할 수 있습니다.
    • 관리자는 시스템 속성을 추가하여 com.glide.attachment.max_get_size 최대 이미지 배율 크기를 제어할 수 있습니다.
    다음 정보를 [sys_properties.list] 테이블에 입력합니다.
    필드 설명
    이름 com.glide.attachment.max_get_크기
    유형 정수
    값 5242880
    값 필드는 크기(바이트)를 나타냅니다.
    • 기본 시스템 값은 5242880바이트(5MB)입니다. 필요에 따라 값을 변경할 수 있습니다.
    • 이 속성을 설정하면 5MB보다 큰 이미지의 크기가 조정되지 않고 시스템이 대신 링크를 생성합니다. 5MB보다 작은 이미지는 축소됩니다.

    활동 스트림에 대한 최대 이미지 크기 속성 구성

    활동 스트림에 이미지를 첨부하면 시스템에서 이미지의 최대 크기를 제어합니다. 이 com.glide.attachment.max_get_size 속성을 사용하여 최대 이미지 크기 조정 차원을 제어합니다.

    첨부 파일 이벤트 및 로깅

    스크립트 작업 또는 알림은 첨부 파일 이벤트를 처리할 수 있습니다. 기록에 여러 첨부 파일이 있더라도 첨부 파일이 있는 기록에 대해 작업을 수행하면 하나의 이벤트만 생성됩니다. 다음과 같은 이벤트가 제공됩니다.

    기록에 여러 첨부 파일이 있더라도 첨부 파일이 있는 기록에 대해 작업을 수행하면 하나의 이벤트만 생성됩니다. 다음과 같은 이벤트가 제공됩니다.

    표 1. 첨부 파일 이벤트
    이벤트 설명
    attachment.read 첨부 파일을 읽거나 다운로드했습니다.
    attachment.uploaded 첨부 파일이 업로드되었습니다. 여러 첨부 파일이 한 번에 기록에 업로드되면 하나의 이벤트만 생성됩니다.
    첨부 파일.삭제됨 첨부 파일이 삭제되었습니다. 이 이벤트는 첨부 파일이 포함된 기록이 삭제될 때도 트리거됩니다. 첨부 파일이 여러 개 포함된 기록이 삭제되면 삭제된 기록의 각 첨부 파일에 대해 별도의 이벤트가 트리거됩니다.
    첨부 파일.이름 변경됨 첨부 파일의 이름이 바뀌었습니다.

    첨부 파일 로깅

    첨부 파일이 다운로드되면 attachment.read 이벤트 기록이 기록되고 이 이벤트로 작업을 수행할 수 있습니다. 예를 들어 특정 첨부 파일을 다운로드한 시기와 대상을 기록할 수 있습니다. 이 기능의 경우 current 는 sys_attachment 기록이고, 이벤트 기록은 다음 매개변수를 사용합니다.
    • 매개변수1: 파일 이름
    • 매개변수2: 테이블 이름

    첨부 파일 인덱싱 디버그

    첨부 파일 인덱싱에 대한 디버깅 옵션을 변경하려면 이러한 시스템 속성을 추가합니다.

    • glide.ts.index.attachment.debug: 값을 예로 설정하면 첨부 파일을 인덱싱할 때 발생하는 예외에 대한 로그 메시지를 사용할 수 있습니다(기본값은 아니오).

      일반 작업 중에 이 속성을 사용하도록 설정하여 예외에 대한 스택 추적 정보를 캡처할 수 있습니다.

    • glide.ts.index.attachment.list_terms.debug: 값이 예로 설정되면 첨부 파일이 인덱싱될 때 인덱싱된 모든 용어를 로깅합니다(기본값은 아니오).

      [권장] 최적의 성능을 위해 정상 작업 중에 이 속성을 false 로 설정하십시오. 문제를 적극적으로 디버깅하는 경우에만 이 속성을 활성화합니다.

    주:
    첨부 파일 처리에 영향을 미치는 속성에 대한 자세한 내용은 인스턴스 보안 강화 설정의 첨부 파일(인스턴스 보안 강화) 을 참조하십시오.