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(문자열 tableName, 문자열 sysId, 객체 매개변수, 객체 옵션)

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

표 3. 매개변수

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

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

주:

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

표 5. 매개변수

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