첨부 파일 관리

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 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
    value 필드는 크기(바이트)를 나타냅니다.
    • 기본 시스템 값은 5242880바이트(5MB)입니다. 필요에 따라 값을 변경할 수 있습니다.
    • 이 속성을 설정하면 5MB보다 큰 이미지의 크기가 조정되지 않으며 대신 시스템에서 링크를 만듭니다. 5MB보다 작은 이미지는 축소됩니다.

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

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

    첨부 파일 이벤트 및 로깅

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

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

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

    첨부 파일 로깅

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

    디버그 첨부 파일 인덱싱

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

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

      정상 조작 중에 이 속성을 활성화된 상태로 두어 예외에 대한 스택 추적 정보를 캡처할 수 있습니다.

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

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

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