---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# cabrillo.attachments - 클라이언트

# cabrillo.attachments - 클라이언트 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

첨부 파일 기능의 네임스페이스입니다 카브릴로 JS . 이를 통해 첨부 파일을 추가하고 볼 수 있습니다.

## cabrillo.attachments - addFile(문자열 tableName, 문자열 sysId, 객체 매개변수, 문자열 옵션) {#ariaid-title2}

문서 선택기를 표시하고 선택한 파일을 업로드합니다.
중요사항:  
이 방법은 더 이상 사용되지 않습니다. 대신 [addFiles()](https://servicenow-prod.fluidtopics.net/G3WMCHcR4MKL8l7Qv3sHPg#CA-addFiles_S_S_O_S "파일을 선택하고 업로드할 수 있는 문서 선택기를 제공합니다.") 메서드를 사용하십시오.
{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 첨부 파일을 첨부할 기록의 테이블 이름입니다. |
| sysID | 문자열 | 첨부 파일을 첨부할 기록의 sys_id입니다. |
| 매개변수 | 객체 | 사용되지 않음. null로 설정합니다. |
| 옵션 | 문자열 | 사용되지 않음. null로 설정합니다. |
[표 1. 매개변수]

{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFile_S_S_O_S__table_zt5_3qw_2bb__entry__2}

| 유형 | 설명 |
|-|-|
| 약속 | 성공하면 Cabrillo.Attachment 객체입니다. 작업이 실패하면 오류가 발생합니다. |
[표 2. 반환]

{#CA-addFile_S_S_O_S__table_zt5_3qw_2bb}  

    var table = 'incident';
    var sysID = 'a9e30c7dc61122760116894de7bcc7bd';

    cabrillo.attachments.addFile(table,
        sysID, 
        null,
        null
    ).then(function(attachment) {
        if (attachment) {
            console.log('Added a new file.', attachment);
        } else {
            console.log('User cancelled adding an attachment.');
        }
    }, function(error) {
        console.log('Failed to attach new file.', error);
    });

## cabrillo.attachments - addFiles(문자열 tableName, 문자열 sysId, 객체 매개변수, 객체 옵션) {#ariaid-title3}

파일을 선택하고 업로드할 수 있는 문서 선택기를 제공합니다.
{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 파일을 첨부할 기록이 들어 있는 테이블의 이름입니다. |
| sysID | 문자열 | 파일을 첨부할 기록의 Sys_id입니다. |
| 매개변수 | 객체 | 옵션입니다. 나중에 사용하기 위해 예약되어 있습니다. null로 설정합니다. |
| 옵션 | 객체 | 옵션입니다. 파일 업로드를 위한 추가 설정입니다. { "isSingleSelection": Boolean } |
| options.isSingleSelection | 부울 | 옵션입니다. 파일 업로드용 문서 선택기가 다중 선택을 허용하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 업로드할 파일을 한 번에 하나만 선택할 수 있습니다. * false: 업로드할 파일을 한 번에 여러 개 선택할 수 있습니다. {#CA-addFiles_S_S_O_S__ul_nkl_n4f_xwb} 기본값: false |
[표 3. 매개변수]

{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb__entry__2}

| 유형 | 설명 |
|-|-|
| 약속 | 성공적으로 생성된 첨부 파일 및 오류를 포함합니다. 여러 파일을 선택하면 성공적으로 업로드된 각 파일에 대해 Cabrillo.Attachment가 생성되고 업로드에 실패할 때마다 오류 메시지가 생성됩니다. 데이터 유형: 객체 { "attachments": [Array], "errors": [Array] } |
| 약속.첨부 파일 | 성공적으로 만들어진 첨부 파일을 포함합니다. 데이터 유형: 배열 "attachments": [Cabrillo.Attachment] |
| 약속.오류 | 모든 오류가 포함됩니다. 데이터 유형: 배열 "errors": ["String"] |
[표 4. 반환]

{#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb}  
이 예에서는 인시던트 기록에 여러 첨부 파일을 추가하는 버튼을 만들고 업로드 오류를 확인합니다.

    this.attachMultipleFilesButton = function() {
       c.log("Attempting to add multiple attachments to INC0010453");
       var table = 'incident';
       var sysID = 'fc74aefa1bfb2c10181499f1b24bcb3c';

       cabrillo.attachments.addFiles(table, sysID).then(function(result) {
          if (result) {
             handleMultipleResult(result)
          } else {
             c.log('User cancelled adding an attachment.');
          }
       }, function(error) {
          c.log('Failed to attach new files.', error);
       });
    }

    // A helper function to handle addFiles results 
    function handleMultipleResult(result) {
       c.log('Added multiple attachments.', result);
       if (result.attachments) {
          c.log('Number of new attachments', result.attachments.length);
       }
       if (result.errors) {
          c.log('Number of errors during upload', result.errors.length);
       }
    }

## cabrillo.attachments -viewFile(Cabrillo.Attachment attachment, Cabrillo.Rect sourceRect, String sourceBase64Image) {#ariaid-title4}

문서 선택기를 표시하고 선택한 파일을 업로드합니다.
주:  
sourceBase64 이미지와 함께 sourceRect 매개 변수를 사용하여 크기를 조정하는 것은 iOS에서만 지원됩니다. Android는 이러한 매개변수를 무시하고 크기 조정 애니메이션 없이 이미지를 엽니다.
{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 첨부 파일 | Cabrillo.첨부 파일 | 볼 첨부 파일에 대해 설명합니다. |
| 소스 렉트 | Cabrillo.Rect | 옵션입니다. 확대할 이미지의 소스 사각형을 설명합니다. |
| sourceBase64이미지 | 문자열 | 옵션입니다. 확대할 소스 이미지의 base64 표현입니다. |
[표 5. 매개변수]

{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb} {#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb__entry__2}

| 유형 | 설명 |
|-|-|
| 약속 | 성공하면 해결되지 않은 객체이고, 그렇지 않으면 오류가 표시됩니다. |
[표 6. 반환]

{#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb}  

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    };

    cabrillo.attachments.viewFile(attachment,
        null,
        null
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });

네이티브 이미지 뷰어에 탭된 이미지의 크기를 조정하기 위해 viewFile() 메서드는 페이지의 이미지 사각형과 이미지의 base64 인코딩 썸네일에 대한 선택적 인수를 허용합니다. 썸네일은 애니메이션과 함께 전체 크기 이미지로 크기가 조정됩니다.

    // Grab image metadata from an image that was tapped
    var imageMetadata = imageMetadataFromEvent(event);

    // Optional rect of image on page
    var imageRect = imageMetadata.rect;

    // Optional base64 encoded image to scale up into native viewer
    var base64EncodedImage = imageMetadata.base64;

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    }

    cabrillo.attachments.viewFile(attachment,
        imageRect,
        base64EncodedImage
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });