첨부 파일 관리

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기3분

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

    첨부 파일 테이블

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

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

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

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

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

    활동 스트림에 이미지를 첨부할 때 시스템은 이미지의 최대 크기를 제어합니다. 이 com.glide.attachment.max_get_size 속성을 사용하여 최대 이미지 배율 크기를 제어합니다.

    첨부 파일 이벤트 및 로깅

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

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

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

    첨부 파일 로깅

    첨부 파일이 다운로드되면 이벤트 레코드가 attachment.read 기록되고 이 이벤트로 작업을 수행할 수 있습니다. 예를 들어 특정 첨부 파일을 다운로드한 시기와 사용자를 기록할 수 있습니다. 이 기능의 경우 current 는 sys_attachment 레코드이며 이벤트 레코드는 다음 매개 변수를 사용합니다.
    • parm1 : 파일 이름
    • parm2 크랙: 테이블 이름

    첨부 파일 인덱싱 디버깅

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

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

      정상 조작 중에 이 특성을 사용 가능한 상태로 두어 예외에 대한 스택 추적 정보를 캡처할 수 있습니다.

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

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

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