단락 - 범위 지정, 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기15분

    • PDF의 텍스트 블록을 나타내는 Paragraph 객체를 만듭니다.

    이 API는 PDF 생성 유틸리티 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화됩니다.

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

    단락 - 단락(문자열 텍스트)

    문자열이 포함된 새 Paragraph 개체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    텍스트 문자열 텍스트의 단락 블록입니다.

    다음 예제에서는 Paragraph 개체를 만드는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var para = new Paragraph("hello");

    단락 – addNewLine()

    문서의 단락 뒤에 빈 줄을 추가합니다.

    표 2. 매개변수
    이름 유형 설명
    없음
    표 3. 반환
    유형 설명
    안 함

    다음 예제에서는 문서의 단락 뒤에 새 줄을 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
        
var myPara = new sn_pdfgeneratorutils.Paragraph("This is a paragraph.");
myPara.addNewLine();

document.addParagraph(myPara);       
// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "addText.pdf");

    단락 – addParagraph(Paragraph paragraph)

    단락을 추가합니다. 이 메서드를 사용하여 자동 줄 바꿈이 있는 단락 블록을 만들 수 있습니다.

    표 4. 매개변수
    이름 유형 설명
    단락 단락 단락 개체.
    표 5. 반환
    유형 설명
    안 함

    다음 예제에서는 문서에 단락 섹션을 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var sectionPara = new sn_pdfgeneratorutils.Paragraph("This is the first paragraph.");
var subPara1 = new sn_pdfgeneratorutils.Paragraph("Pellentesque nec neque interdum turpis ultricies tristique at ut lacus. Nam eget sollicitudin.");
var subPara2 = new sn_pdfgeneratorutils.Paragraph("Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vel ultrices erat.");
var subPara3 = new sn_pdfgeneratorutils.Paragraph("Aenean fermentum lorem congue metus faucibus, vitae viverra quam eleifend. Donec sed risus quis eros suscipit efficitur.");

sectionPara.addParagraph(subPara1);
sectionPara.addParagraph(subPara2);
sectionPara.addParagraph(subPara3);

document.addParagraph(sectionPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

    단락 – addString(String content)

    단락에 텍스트 문자열을 추가합니다. 이 메서드는 콘텐츠 앞에 공백을 자동으로 삽입하지 않습니다.

    표 6. 매개변수
    이름 유형 설명
    컨텐츠 문자열 단락에 포함할 정보입니다.
    표 7. 반환
    유형 설명
    안 함

    다음 예제에서는 단락에 새 문장을 추가하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var myPara = new sn_pdfgeneratorutils.Paragraph("This is the first sentence.");

myPara.addString(" This is the second sentence in the same paragraph. Spaces are not inserted automatically.")

document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

    단락 – addStyle(스타일 스타일)

    단락 텍스트에 미리 정의된 스타일을 적용합니다.

    표 8. 매개변수
    이름 유형 설명
    스타일 스타일 이 요소에 적용할 스타일입니다.
    표 9. 반환
    유형 설명
    안 함

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

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

// Create a font color (result is purple)
var fontColor = new sn_pdfgeneratorutils.Color([0.5,0.0,0.5]);

// Create a style for your paragraph
var paraStyle = new sn_pdfgeneratorutils.Style();
paraStyle.setFontColor(fontColor);
paraStyle.setFontSize(10);

var myPara = new sn_pdfgeneratorutils.Paragraph("This paragraph has style.");

myPara.addStyle(paraStyle);


document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "addStyle.pdf");

    단락 – setFixedPosition(왼쪽 번호, 맨 아래 번호, 너비 번호)

    단락 요소를 페이지의 고정 위치로 설정합니다.

    표 10. 매개변수
    이름 유형 설명
    왼쪽 번호 PDF 페이지의 왼쪽에서 들여쓰기(포인트)입니다.
    하단 번호 PDF 페이지 하단으로부터의 위치(포인트)입니다.
    width 번호 단락 요소의 너비(포인트)입니다. 이 값은 줄 바꿈의 길이를 결정합니다.
    표 11. 반환
    유형 설명
    안 함

    다음 예제에서는 페이지에서 고정 위치를 설정하는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

// Create a style
var paraStyle = new sn_pdfgeneratorutils.Style();
paraStyle.setFontSize(48);
paraStyle.setBold();

// my paragraph
var para = new sn_pdfgeneratorutils.Paragraph("Document Title");

para.setFixedPosition(204,400,240);

para.setTextAlignment("text-center");
para.addStyle(paraStyle);


document.addParagraph(para);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "fileName.pdf");

    단락 – setMargin(Number margin)

    각 단락 여백을 설정합니다.

    네 개의 여백을 모두 하나 이상의 고유한 값으로 설정하려면 setMargins()를 사용합니다.

    표 12. 매개변수
    이름 유형 설명
    마진 번호 상단, 오른쪽, 하단, 왼쪽 여백의 값(포인트)입니다.
    표 13. 반환
    유형 설명
    안 함

    다음 예제에서는 단락의 모든 여백을 48포인트로 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var margins = 48.0;

var myPara = new sn_pdfgeneratorutils.Paragraph("Paragraph text with all margins set to the same value.");
myPara.setMargin(margins);

document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    단락 – setMarginBottom(Number margin)

    단락의 아래쪽 여백을 설정합니다.

    표 14. 매개변수
    이름 유형 설명
    마진 번호 하단 여백의 높이(포인트)입니다.
    표 15. 반환
    유형 설명
    안 함

    다음 예제에서는 단락의 아래쪽 여백을 1포인트로 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginBottom = new sn_pdfgeneratorutils.Paragraph("Paragraph text with bottom margin set.");
paraMarginBottom.setMarginBottom(marginVal);

document.addParagraph(paraMarginBottom);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    단락 – setMarginLeft(Number margin)

    단락의 왼쪽 여백을 설정합니다.

    표 16. 매개변수
    이름 유형 설명
    왼쪽 여백 번호 왼쪽 여백의 너비(포인트)입니다.
    표 17. 반환
    유형 설명
    안 함

    다음 예제에서는 단락의 왼쪽 여백을 1포인트로 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginLeft = new sn_pdfgeneratorutils.Paragraph("Paragraph text with left margin set.");
paraMarginLeft.setMarginLeft(marginVal);

document.addParagraph(paraMarginLeft);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    단락 – setMarginRight(Number margin)

    단락의 오른쪽 여백을 설정합니다.

    표 18. 매개변수
    이름 유형 설명
    마진 번호 오른쪽 여백의 너비(포인트)입니다.
    표 19. 반환
    유형 설명
    안 함

    다음 예제에서는 단락의 오른쪽 여백을 1포인트로 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginRight = new sn_pdfgeneratorutils.Paragraph("Paragraph text with right margin set.");
paraMarginRight.setMarginRight(marginVal);

document.addParagraph(paraMarginRight);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    단락 – setMargins(Number marginTop, Number marginRight, Number marginBottom, Number marginLeft)

    각 단락 여백의 크기를 설정합니다.

    각 여백을 동일한 값으로 설정하려면 setMargin()을 사용합니다.

    표 20. 매개변수
    이름 유형 설명
    topMargin 번호 위쪽 여백의 높이(포인트)입니다.
    오른쪽 여백 번호 오른쪽 여백의 너비(포인트)입니다.
    하단 여백 번호 하단 여백의 높이(포인트)입니다.
    왼쪽 여백 번호 왼쪽 여백의 너비(포인트)입니다.
    표 21. 반환
    유형 설명
    안 함

    다음 예제에서는 단락 여백을 설정하는 방법을 보여 줍니다.문서 사용 예제는 문서 API를 참조하세요.

    var para = new sn_pdfgeneratorutils.Paragraph("Paragraph text.");

var topMargin = 1.0;
var rightMargin = 1.0;
var bottomMargin = 1.0;
var leftMargin = 1.5;

para.setMargins(marginTop, marginRight, marginBottom, marginLeft);

    단락 – setMarginTop(Number margin)

    단락의 위쪽 여백을 설정합니다.

    표 22. 매개변수
    이름 유형 설명
    마진 번호 위쪽 여백의 높이(포인트)입니다.
    표 23. 반환
    유형 설명
    안 함

    다음 예제에서는 단락의 위쪽 여백을 1포인트로 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginTop = new sn_pdfgeneratorutils.Paragraph("Paragraph text with top margin set.");
paraMarginTop.setMarginTop(marginVal);

document.addParagraph(paraMarginTop);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    단락 – setTextAlignment(String alignment)

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

    표 24. 매개변수
    이름 유형 설명
    정렬 문자열 텍스트 정렬 위치입니다.
    유효한 값은 다음과 같습니다.
    • text-center: 텍스트를 중앙에 정렬합니다.
    • text-justified: 문자 사이의 공백을 수정하여 왼쪽과 오른쪽 사이의 텍스트를 완전히 채웁니다. 마지막 줄은 왼쪽 맞춤됩니다.
    • text-justified-all: 마지막 줄을 포함하여 텍스트 정렬을 정당화합니다.
    • text-left: 텍스트를 왼쪽으로 정렬합니다.
    • text-right: 텍스트를 오른쪽으로 정렬합니다.
    표 25. 반환
    유형 설명
    안 함

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

    var paragraph = new sn_pdfgeneratorutils.Paragraph("This paragraph text is centered.");
        
var alignment = "text-center";
       
paragraph.setTextAlignment(alignment);