셀 - 범위 지정, 전역

Cell 개체를 테이블의 셀로 만듭니다. 이 API를 사용하여 셀의 서식을 지정하고 단락 및 이미지와 같은 추가 블록을 포함할 수 있습니다.

이 API는 PDF Generation Utilities 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에 제공됩니다. 플러그인은 기본적으로 활성화되어 있습니다.

이 API는 PDF를 생성하기 위해 문서 API 와 함께 사용되는 구성 요소입니다.

셀 - 셀(숫자 rowspan, 숫자 colspan)

새 Cell 개체를 인스턴스화합니다. 테이블에서 사용자 지정 양의 셀 공간을 사용하는 셀을 작성합니다.

주:

두 매개 변수 중 하나에 음수를 제공하면 값이 1로 설정됩니다.

표 1. 매개변수

이름	유형	설명
Rowspan	번호	이 셀이 차지할 행의 수입니다. 기본값: 0
Colspan	번호	이 셀이 차지할 열의 수입니다. 기본값: 0

다음 예제에서는 단일 행과 단일 열에 걸쳐 있는 Cell 개체를 만드는 방법을 보여 줍니다.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

셀 – addImage(이미지 이미지)

테이블 셀에 이미지를 추가합니다.

표 2. 매개변수

이름	유형	설명
이미지	이미지	테이블 셀에 추가할 이미지입니다.

표 3. 반환

유형	설명
없음

다음 예제에서는 기존 이미지 첨부 파일을 인스턴스화하여 테이블의 셀에 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var image = new Image("<attachment_sys_id>");

cell.addImage(image);

셀 – addParagraph(단락 단락)

테이블 셀에 텍스트를 추가합니다.

표 4. 매개변수

이름	유형	설명
단락	단락	테이블 셀에 추가할 텍스트입니다.

표 5. 반환

유형	설명
없음

다음 예제에서는 단락 개체를 인스턴스화하고 표에 내용 셀을 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var para = new sn_pdfgeneratorutils.Paragraph("Paragraph text.");
cell.addParagraph(para);

셀 – addStyle(스타일 스타일)

미리 정의된 스타일을 테이블 셀에 적용합니다.

표 6. 매개변수

이름	유형	설명
스타일	스타일	이 요소에 적용할 스타일입니다.

표 7. 반환

유형	설명
없음

다음 예제에서는 테이블 셀에 스타일을 적용하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var style = new sn_pdfgeneratorutils.Style();
style.setBold();
     
cell.addStyle(style);

셀 – addTable(테이블 테이블)

셀에 테이블을 추가합니다.

표 8. 매개변수

이름	유형	설명
테이블	테이블	셀에 추가할 테이블입니다.

표 9. 반환

유형	설명
없음

다음 예제에서는 테이블 개체를 인스턴스화하고 셀에 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new Table(columnWidths, false);

cell.addTable(table);

셀 – getColumn()

셀이 있는 열의 번호를 가져옵니다.

표 10. 매개변수

이름	유형	설명
없음

표 11. 반환

유형	설명
번호	셀의 열 위치 번호입니다.

다음 예제에서는 셀의 열 위치 수를 가져오는 방법을 보여 줍니다.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, columnWidths, false);

table.addCell(cell);

var colNum = cell.getColumn();

gs.info("The column position for cell is " + colNum);

출력:

The column position for cell is 1

셀 – getRow()

셀이 있는 행의 수를 가져옵니다.

표 12. 매개변수

이름	유형	설명
없음

표 13. 반환

유형	설명
번호	셀의 행 위치 번호입니다.

다음 예제에서는 셀의 행 위치 수를 가져오는 방법을 보여 줍니다.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var rowWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, rowWidths, false);

table.addCell(cell);

var rowNum = cell.getRow();

gs.info("The row position for cell is " + rowNum);

출력:

The row position for cell is 4927

셀 – setBackGroundColor(색상 색상)

셀의 배경색을 지정합니다.

표 14. 매개변수

이름	유형	설명
색상	색상	배경색.

표 15. 반환

유형	설명
없음

다음 예제에서는 셀 배경색을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var color = new sn_pdfgeneratorutils.Color([1, 0.9, 0.9]); // provided as array of RGB float values

cell.setBackGroundColor(color);

셀 – setBorder(width 숫자)

셀의 네 가장자리 모두에 테두리를 설정합니다.

표 16. 매개변수

이름	유형	설명
width	번호	셀 테두리 너비(포인트)입니다.

표 17. 반환

유형	설명
없음

다음 예제에서는 한 지점의 셀 테두리를 셀의 네 가장자리 모두에 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

셀 – setBorderBottom(width 숫자)

셀의 하한에 대한 테두리를 설정합니다.

표 18. 매개변수

이름	유형	설명
width	번호	셀 테두리 너비(포인트)입니다.

표 19. 반환

유형	설명
없음

다음 예제에서는 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

셀 – setBorderLeft(width 숫자)

셀의 왼쪽 한계에 대한 테두리를 설정합니다.

표 20. 매개변수

이름	유형	설명
width	번호	셀 테두리 너비(포인트)입니다.

표 21. 반환

유형	설명
없음

다음 예제에서는 왼쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setLeftBorder(width);

셀 – setBorderRight(width 숫자)

셀의 오른쪽 한계에 대한 테두리를 설정합니다.

표 22. 매개변수

이름	유형	설명
width	번호	셀 테두리 너비(포인트)입니다.

표 23. 반환

유형	설명
없음

다음 예제에서는 오른쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setRightBorder(width);

셀 – setBorderTop(width 숫자)

셀의 상한에 대한 테두리를 설정합니다.

표 24. 매개변수

이름	유형	설명
width	번호	셀 테두리 너비(포인트)입니다.

표 25. 반환

유형	설명
없음

다음 예제에서는 최상위 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorderTop(width);

셀 – setColoredBorder(색상 색상, 숫자 너비)

셀의 네 가장자리 모두에 대해 색상 테두리를 설정합니다.

표 26. 매개변수

이름	유형	설명
색상	색상	셀 테두리 색입니다.
width	번호	셀 테두리 너비(포인트)입니다.

표 27. 반환

유형	설명
없음

다음 예제에서는 색이 지정된 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorder(borderColor, width);

셀 – setColoredBorderBottom(색상 색상, 숫자 너비)

셀의 하한에 대해 색상 테두리를 설정합니다.

표 28. 매개변수

이름	유형	설명
색상	색상	셀 테두리 색입니다.
width	번호	셀 테두리 너비(포인트)입니다.

표 29. 반환

유형	설명
없음

다음 예제에서는 색이 지정된 아래쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderBottom(borderColor, width);

셀 – setColoredBorderLeft(색상 색상, 숫자 너비)

셀의 왼쪽 한계에 대해 색상이 지정된 테두리를 설정합니다.

표 30. 매개변수

이름	유형	설명
색상	색상	셀 테두리 색입니다.
width	번호	셀 테두리 너비(포인트)입니다.

표 31. 반환

유형	설명
없음

다음 예제에서는 색이 지정된 왼쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderLeft(borderColor, width);

셀 – setColoredBorderRight(색상 색상, 숫자 너비)

셀의 오른쪽 한계에 대해 색상 테두리를 설정합니다.

표 32. 매개변수

이름	유형	설명
색상	색상	셀 테두리 색입니다.
width	번호	셀 테두리 너비(포인트)입니다.

표 33. 반환

유형	설명
없음

다음 예제에서는 색이 지정된 오른쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderRight(borderColor, width);

셀 – setColoredBorderTop(색상 색상, 숫자 너비)

셀의 상한에 대해 색상 테두리를 설정합니다.

표 34. 매개변수

이름	유형	설명
색상	색상	셀 테두리 색입니다.
width	번호	셀 테두리 너비(포인트)입니다.

표 35. 반환

유형	설명
없음

다음 예제에서는 색이 지정된 위쪽 셀 테두리를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderTop(borderColor, width);

셀 – setHeight(숫자 height)

셀의 높이를 설정합니다.

표 36. 매개변수

이름	유형	설명
값	번호	셀 높이(포인트)입니다.

표 37. 반환

유형	설명
없음

다음 예제에서는 셀 높이를 10포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 10;

cell.setHeight(height);

셀 – setHorizontalAlignment(문자열 정렬)

이 셀의 가로 맞춤을 설정합니다.

표 38. 매개변수

이름	유형	설명
정렬	문자열	수평 맞춤 설정. 유효한 값은 다음과 같습니다. center: 콘텐츠를 중앙에 맞춥니다. 왼쪽: 콘텐츠를 왼쪽에 맞춥니다. 오른쪽: 콘텐츠를 오른쪽에 정렬합니다.

표 39. 반환

유형	설명
없음

다음 예제에서는 셀에 가로 맞춤을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "center";

cell.setHorizontalAlignment(alignment);

셀 – setMaxHeight(숫자 값)

셀의 최대 높이를 설정합니다.

표 40. 매개변수

이름	유형	설명
값	번호	최대 셀 높이(포인트)입니다.

표 41. 반환

유형	설명
없음

다음 예제에서는 최대 셀 높이를 409포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 409;

cell.setMaxHeight(height);

셀 – setMaxWidth(부동 소수점 값)

셀의 최대 너비를 설정합니다.

표 42. 매개변수

이름	유형	설명
값	번호	최대 셀 너비(포인트)입니다.

표 43. 반환

유형	설명
없음

다음 예제에서는 최대 셀 너비를 1530포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1530;

cell.setMaxWidth(width);

셀 – setMinHeight(숫자 값)

셀의 최소 높이를 설정합니다.

표 44. 매개변수

이름	유형	설명
값	번호	최소 셀 높이(포인트)입니다.

표 45. 반환

유형	설명
없음

다음 예제에서는 최소 셀 높이를 12.75포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 12.75;

cell.setMinHeight(height);

셀 – setMinWidth(숫자 값)

셀의 최소 너비를 설정합니다.

표 46. 매개변수

이름	유형	설명
값	번호	최소 셀 너비(포인트)입니다.

표 47. 반환

유형	설명
없음

다음 예제에서는 최소 셀 너비를 50.58포인트로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 50.58;

cell.setMinWidth(width);

셀 – setOpacity(숫자 불투명도)

셀 내용, 테두리 및 배경의 불투명도를 설정합니다.

주:

이 설정은 셀의 모든 자식 요소에 영향을 줍니다.

표 48. 매개변수

이름	유형	설명
불투명도	번호	0에서 1 사이의 부동 소수점 값으로, 0은 투명하고 1은 완전히 불투명합니다. 기본값: 0

표 49. 반환

유형	설명
없음

다음 예제에서는 셀의 불투명도를 설정하는 방법을 보여 줍니다.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var opacity = 0.5;

cell.setOpacity(opacity);

셀 – setPadding(숫자 패딩)

셀의 네 면의 안쪽 여백을 모두 같은 너비로 설정합니다.

참고 항목:

• setPaddingBottom()을 호출합니다.
• setPaddingLeft()를 호출합니다.
• setPaddingRight()를 호출합니다.
• setPaddingTop()

표 50. 매개변수

이름	유형	설명
패딩	번호	포인트 너비를 10진수 값으로 채웁니다.

표 51. 반환

유형	설명
없음

다음 예제에서는 아래쪽 셀을 한 지점으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPadding(padding);

셀 – setPaddingBottom(숫자 패딩)

셀의 하단 안쪽 여백 너비 값을 설정합니다.

참고 항목:

• setPadding()을 호출합니다.
• setPaddingLeft()를 호출합니다.
• setPaddingRight()를 호출합니다.
• setPaddingTop()

표 52. 매개변수

이름	유형	설명
패딩	번호	포인트 너비를 10진수 값으로 채웁니다.

표 53. 반환

유형	설명
없음

다음 예제에서는 아래쪽 셀 안쪽 여백을 한 지점으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingBottom(padding);

셀 – setPaddingLeft(숫자 패딩)

셀의 왼쪽 안쪽 여백 너비 값을 설정합니다.

참고 항목:

• setPadding()을 호출합니다.
• setPaddingBottom()을 호출합니다.
• setPaddingRight()를 호출합니다.
• setPaddingTop()

표 54. 매개변수

이름	유형	설명
패딩	번호	포인트 너비를 10진수 값으로 채웁니다.

표 55. 반환

유형	설명
없음

다음 예제에서는 왼쪽 셀 안쪽 여백을 한 지점으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingLeft(padding);

셀 – setPaddingRight(숫자 패딩)

셀의 오른쪽 안쪽 여백 너비 값을 설정합니다.

참고 항목:

• setPadding()을 호출합니다.
• setPaddingBottom()을 호출합니다.
• setPaddingLeft()를 호출합니다.
• setPaddingTop()

표 56. 매개변수

이름	유형	설명
패딩	번호	포인트 너비를 10진수 값으로 채웁니다.

표 57. 반환

유형	설명
없음

다음 예제에서는 오른쪽 셀 안쪽 여백을 한 지점으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingRight(padding);

셀 – setPaddingTop(숫자 패딩)

셀의 위쪽 패딩 너비 값을 설정합니다.

참고 항목:

• setPadding()을 호출합니다.
• setPaddingBottom()을 호출합니다.
• setPaddingLeft()를 호출합니다.
• setPaddingRight()를 호출합니다.

표 58. 매개변수

이름	유형	설명
패딩	번호	포인트 너비를 10진수 값으로 채웁니다.

표 59. 반환

유형	설명
없음

다음 예제에서는 최상위 셀 패딩을 한 지점으로 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingTop(padding);

셀 – setTextAlignment(문자열 정렬)

이 셀의 텍스트 정렬을 설정합니다.

표 60. 매개변수

이름	유형	설명
정렬	문자열	텍스트 정렬 위치입니다. 유효한 값은 다음과 같습니다. text-center: 텍스트를 가운데에 정렬합니다. text-justified: 문자 사이의 공백을 수정하여 왼쪽과 오른쪽 사이의 텍스트를 완전히 채웁니다. 마지막 줄은 왼쪽에 맞춰집니다. text-justified-all: 마지막 줄을 포함한 텍스트 정렬을 정당화합니다. text-left: 텍스트를 왼쪽으로 정렬합니다. text-right: 텍스트를 오른쪽에 맞춥니다.

표 61. 반환

유형	설명
없음

다음 예제에서는 셀 텍스트를 왼쪽 맞춤으로 설정하는 방법을 보여 줍니다.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "text-left";

cell.setTextAlignment(alignment);

셀 – setVerticalAlignment(문자열 정렬)

이 셀의 세로 맞춤을 설정합니다.

표 62. 매개변수

이름	유형	설명
정렬	문자열	세로 맞춤 설정. 유효한 값은 다음과 같습니다. bottom: 컨텐츠를 아래쪽에 정렬합니다. mid: 콘텐츠를 중앙에 정렬합니다. top: 내용을 맨 위에 정렬합니다.

표 63. 반환

유형	설명
없음

다음 예제에서는 셀에 세로 맞춤을 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "mid";

cell.setVerticalAlignment(alignment);