---
sourceDocument: 요코하마 ServiceNow AI 플랫폼 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - ko-KR

ft:publication_title :

    - 요코하마 ServiceNow AI 플랫폼 관리

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# 첨부 파일 관리

# 첨부 파일 관리 {#ariaid-title1}

* 릴리스 버전: Yokohama
* 
* 업데이트 날짜 2025년 01월 30일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

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

## 첨부 파일 테이블 {#r_AdministeringAttachments__section_sn5_rnw_t1b}

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

첨부 파일을 기록에 업로드하는 방법에 대한 자세한 내용은 [첨부 파일 추가 및 관리를](https://www.servicenow.com/docs/access?context=t_AddingAnAttachment&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US) 참조하십시오.

## 활동 스트림 썸네일 크기 조정 {#r_AdministeringAttachments__section_zdr_n2x_t1b}

이 속성은 glide.ui.activity_stream.scale_images 큰 이미지를 축소하고 이미지의 활동 스트림 보기에 대한 썸네일을 만듭니다. 이 속성은 기본적으로 활성화됩니다. 이미지에 소급하여 적용되므로 과거에 활동 스트림에 포함된 모든 첨부 파일도 효과를 볼 수 있습니다.

* 이 속성을 사용하는 썸네일의 최대 크기는 너비 525픽셀 x 높이 350픽셀입니다. 시스템은 픽셀 높이를 먼저 선호하므로 525픽셀보다 넓은 이미지를 얻을 수 있습니다.
* 5MB가 넘는 이미지 파일을 첨부하면 메모리 부족 오류가 발생하여 인스턴스가 다시 시작될 수 있습니다. 새 이미지를 첨부할 때 시스템에서 썸네일을 생성할 때 메모리 부족 오류 및 재시작이 발생합니다. 기록에 기존 이미지를 처음 로드할 때도 오류 및 다시 시작이 발생할 수 있습니다.
* 관리자는 시스템 속성을 추가 com.glide.attachment.max_get_size 하여 최대 이미지 배율 크기를 제어할 수 있습니다.
{#r_AdministeringAttachments__ul_u4p_rrm_rkb}  
\[sys_properties.list\] 테이블에 다음 정보를 입력합니다.{#r_AdministeringAttachments__table_tg1_mnt_51b__entry__2}

| 필드 | 설명 |
|-|-|
| 이름 | com.glide.attachment.max_get_size |
| 유형 | 정수 |
| 값 | 5242880 |
[ ]

{#r_AdministeringAttachments__table_tg1_mnt_51b}  
값 필드는 크기(바이트)로 표시됩니다.

* 기본 시스템 값은 5242880바이트(5MB)입니다. 필요에 따라 값을 변경할 수 있습니다.
* 이 속성을 설정하면 5MB보다 큰 이미지의 크기가 조정되지 않으며 시스템이 대신 링크를 생성합니다. 5MB보다 작은 이미지는 축소됩니다.
{#r_AdministeringAttachments__ul_pvd_wrm_rkb}

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

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

## 첨부 파일 이벤트 및 로깅 {#r_AdministeringAttachments__section_ojh_wnw_t1b}

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

기록에 첨부 파일이 여러 개 있는 경우에도 첨부 파일이 있는 기록에 대해 작업이 수행될 때 하나의 이벤트만 생성됩니다. 다음 이벤트가 제공됩니다.
{#r_AdministeringAttachments__table_yrk_h4w_p4__entry__2}

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

{#r_AdministeringAttachments__table_yrk_h4w_p4}

## 첨부 파일 로깅 {#r_AdministeringAttachments__section_akw_2nw_t1b}

첨부 파일이 다운로드 attachment.read 되면 이벤트 기록이 기록되고 이 이벤트로 작업을 수행할 수 있습니다. 예를 들어 특정 첨부 파일을 다운로드하는 시기와 사용자를 기록할 수 있습니다. 이 기능의 경우 current 는 sys_attachment 기록이고 이벤트 기록은 다음 매개변수를 사용합니다.

* 매개변수1: 파일 이름
* 매개변수2: 테이블 이름
{#r_AdministeringAttachments__ul_s1t_3yg_xw}

## 첨부 파일 인덱싱 디버그 {#r_AdministeringAttachments__section_blr_z2x_t1b}

첨부 파일 인덱싱에 대한 디버깅 옵션을 변경하려면 다음 시스템 속성을 추가합니다.  
* glide.ts.index.attachment.debug: 값을 true로 설정하면 첨부 파일을 인덱싱할 때 발생하는 예외에 대한 로그 메시지를 사용할 수 있습니다(기본값은 false입니다).

  일반 작업 중에 이 속성을 사용하도록 설정하여 예외에 대한 스택 추적 정보를 캡처할 수 있습니다.
* glide.ts.index.attachment.list_terms.debug: 값을 예로 설정하면 첨부 파일이 인덱싱될 때 인덱싱된 모든 용어를 로그합니다(기본값은 아니오).

  \[권장\] 최적의 성능을 얻으려면 정상 작업 중에 이 속성을 false 로 설정합니다. 문제를 활발하게 디버깅하는 경우에만 이 속성을 활성화합니다.

{#r_AdministeringAttachments__ul_ljk_npr_np}  
주:  
첨부 파일 처리에 영향을 주는 속성에 대한 자세한 내용은 인스턴스 보안 강화 설정의 첨부 파일(인스턴스 보안 강화) 을 참조하십시오.
* **[첨부 파일 시스템 속성 구성](https://servicenow-prod.fluidtopics.net/xNtq7Sj3EVi3P9jbiHm4RQ#t_DisablingTheDragAndDropFeature)**   
  끌어서 놓기 기능을 사용하지 않도록 설정할 수 있습니다. (사용자는 여전히 파일을 찾아 첨부 파일을 업로드할 수 있습니다.) 첨부 파일 크기를 제한하고, 첨부 파일을 업로드할 수 있는 사용자를 제한하고, 업로드할 수 있는 파일 확장명을 제한할 수도 있습니다.
* **[테이블에서 첨부 파일 비활성화](https://servicenow-prod.fluidtopics.net/qYR348BRVTGkytMTTTIamQ)**   
  사용자가 특정 테이블의 기록에 첨부 파일을 추가하지 못하도록 할 수 있습니다.
* **[테이블의 첨부 파일 인덱싱](https://servicenow-prod.fluidtopics.net/DCqkI_gpJvaTAKiK8doijA)**   
  테이블에 대한 첨부 파일 인덱싱을 활성화하면 텍스트 검색에서 기록과 해당 파일 첨부 파일에서 일치하는 항목을 반환할 수 있습니다.
* **[첨부 파일 \[보기\] 링크 숨기기](Vi6E0GTY5dgHwv1ltaHkIg)**   
  사용자는 파일 이름이나 \[보기\] 링크를 클릭하여 첨부 파일을 열 수 있습니다. \[보기\] 링크를 클릭하면 브라우저 내에서 파일이 열리며, 첨부 파일의 일부로 JavaScript 코드가 실행됩니다. \[보기\] 링크를 숨길 수 있습니다. 사용자는 여전히 파일 이름을 클릭하여 첨부 파일을 볼 수 있습니다.
* **[첨부 파일 아이콘 구성](https://servicenow-prod.fluidtopics.net/k7ctIUSFZszZHSnoHU26AA)**   
  특정 파일 형식의 첨부 파일 옆에 나타나는 아이콘을 구성합니다.