cabrillo.attachments - 클라이언트

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

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

문서 선택기를 표시하고 선택한 파일을 업로드합니다.

중요사항:

이 메서드는 더 이상 사용되지 않습니다. 대신 addFiles() 메서드를 사용하십시오.

표 1. 매개변수

이름	유형	설명
tableName	문자열	첨부 파일을 첨부할 기록의 테이블 이름입니다.
sysID	문자열	첨부 파일을 첨부할 기록의 sys_id입니다.
매개변수	객체	하지 않는. null로 설정합니다.
옵션	문자열	하지 않는. null로 설정합니다.

표 2. 반환

유형	설명
약속	성공하면 Cabrillo.Attachment 개체입니다. 작업이 실패하면 오류가 발생합니다.

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, 객체 매개변수, 객체 옵션)

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

표 3. 매개변수

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

표 4. 반환

유형	설명
약속	성공적으로 생성된 첨부 파일과 오류를 포함합니다. 여러 파일을 선택한 경우 성공적으로 업로드된 각 파일에 대해 Cabrillo.Attachment가 만들어지고 실패한 각 업로드에 대해 오류 메시지가 생성됩니다. 데이터 유형: 객체 { “attachments”: [Array], “errors”: [Array] }
약속.첨부 파일	성공적으로 만든 첨부 파일을 포함합니다. 데이터 유형: 배열 “attachments”: [Cabrillo.Attachment]
약속.오류	모든 오류가 포함되어 있습니다. 데이터 유형: 배열 “errors”: ["String"]

이 예에서는 인시던트 기록에 여러 첨부 파일을 추가하고 업로드 오류가 있는지 확인하기 위한 버튼을 만듭니다.

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)

문서 선택기를 표시하고 선택한 파일을 업로드합니다.

주:

sourceBase64 이미지와 함께 sourceRect 매개 변수를 사용한 크기 조정은 iOS에서만 지원됩니다. Android는 이러한 매개변수를 무시하고 스케일링 애니메이션 없이 이미지를 엽니다.

표 5. 매개변수

이름	유형	설명
첨부 파일	Cabrillo.Attachment	보려는 첨부 파일에 대해 설명합니다.
소스 사각형	Cabrillo.Rect	옵션입니다. 확대할 이미지의 원본 사각형을 설명합니다.
sourceBase64이미지	문자열	옵션입니다. 확장할 소스 이미지의 base64 표현입니다.

표 6. 반환

유형	설명
약속	성공하면 해결되지 않은 개체이고, 그렇지 않으면 오류입니다.

// 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);
});