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 }
옵션.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.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);
});