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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# cabrillo.attachments - 클라이언트

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

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

첨부 함수의 카브리요 JS 네임스페이스입니다. 이렇게 하면 첨부 파일을 추가하고 볼 수 있습니다.

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

문서 선택기를 표시하고 선택한 파일을 업로드합니다.
중요사항:  
이 메서드는 더 이상 사용되지 않습니다. [대신 addFiles()](https://servicenow-prod.fluidtopics.net/deUg0MoqpLYwwDHfv88g1Q#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(String tableName, String sysId, 객체 매개변수, 객체 옵션) {#ariaid-title3}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 파일을 첨부할 기록이 들어 있는 테이블의 이름입니다. |
| sysID | 문자열 | 파일을 첨부할 기록의 Sys_id입니다. |
| 매개변수 | 객체 | 옵션입니다. 나중에 사용하기 위해 예약되어 있습니다. null로 설정합니다. |
| 옵션 | 객체 | 옵션입니다. 파일 업로드를 위한 추가 설정입니다. { "isSingleSelection": Boolean } |
| options.isSingleSelection (옵션.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 첨부 파일, Cabrillo.Rect sourceRect, 문자열 sourceBase64Image) {#ariaid-title4}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 첨부 파일 | Cabrillo.Attachment | 보려는 첨부 파일에 대해 설명합니다. |
| 소스 사각형 | 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);
    });