---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 단락 - 범위 지정, 전역

# 단락 - 범위 지정, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 15분

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

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

이 API는 PDF를 생성하기 위해 [문서 API](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 와 함께 사용되는 구성요소입니다.

## 단락 - 단락(문자열 텍스트) {#ariaid-title2}

문자열을 포함하는 새 Paragraph 객체를 인스턴스화합니다.
{#Paragraph-Paragraph_S__table_twm_hjk_34b__entry__3}

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

{#Paragraph-Paragraph_S__table_twm_hjk_34b}  
다음 예제에서는 Paragraph 객체를 만드는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") API를 참조하십시오.

    var para = new Paragraph("hello");

## 단락 -- addNewLine() {#ariaid-title3}

문서의 단락 뒤에 빈 줄을 추가합니다.
{#Paragraph-addNewLine__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 2. 매개변수]

{#Paragraph-addNewLine__table_vv5_52h_44b} {#Paragraph-addNewLine__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#Paragraph-addNewLine__table_wv5_52h_44b}  
다음 예는 문서에서 단락 뒤에 새 줄을 추가하는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(단락 단락) {#ariaid-title4}

단락을 추가합니다. 이 방법을 사용하여 자동 줄 바꿈이 있는 단락 블록을 만들 수 있습니다.
{#Paragraph-addParagraph_O__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 단락 | [단락](https://servicenow-prod.fluidtopics.net/~Nf6odnZBi4gMa9bHzMwxA#Paragraph-Paragraph_S "문자열을 포함하는 새 Paragraph 객체를 인스턴스화합니다.") | 단락 객체. |
[표 4. 매개변수]

{#Paragraph-addParagraph_O__table_vv5_52h_44b} {#Paragraph-addParagraph_O__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#Paragraph-addParagraph_O__table_wv5_52h_44b}  
다음 예는 문서에 단락 섹션을 추가하는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(문자열 콘텐츠) {#ariaid-title5}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| 컨텐츠 | 문자열 | 단락에 포함할 정보입니다. |
[표 6. 매개변수]

{#Paragraph-addString_S__table_vv5_52h_44b} {#Paragraph-addString_S__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 7. 반환]

{#Paragraph-addString_S__table_wv5_52h_44b}  
다음 예는 단락에 새 문장을 추가하는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(스타일 스타일) {#ariaid-title6}

단락 텍스트에 미리 정의된 스타일을 적용합니다.
{#Paragraph-addStyle_O__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스타일 | [스타일](https://servicenow-prod.fluidtopics.net/tvtYCLE4x8HFpkXedW07ng#StyleBothAPI "글꼴 크기, 테두리 및 정렬과 같은 속성을 정의하기 위한 스타일을 만듭니다. 여러 개체에 동일한 스타일을 동시에 적용할 수 있습니다.") | 이 요소에 적용할 스타일입니다. |
[표 8. 매개변수]

{#Paragraph-addStyle_O__table_vv5_52h_44b} {#Paragraph-addStyle_O__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 9. 반환]

{#Paragraph-addStyle_O__table_wv5_52h_44b}  
다음 예에서는 단락에 스타일을 적용하는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(번호 왼쪽, 번호 하단, 번호 너비) {#ariaid-title7}

단락 요소를 페이지의 고정 위치로 설정합니다.
{#Paragraph-setFixedPosition_N_N_N__table_vv5_52h_44b__entry__3}

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

{#Paragraph-setFixedPosition_N_N_N__table_vv5_52h_44b} {#Paragraph-setFixedPosition_N_N_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 11. 반환]

{#Paragraph-setFixedPosition_N_N_N__table_wv5_52h_44b}  
다음 예시는 페이지에서 고정 위치를 설정하는 방법을 보여줍니다. 문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(숫자 여백) {#ariaid-title8}

각 단락 여백을 설정합니다.
하나 이상의 고유한 값으로 네 개의 여백을 모두 설정하려면 [setMargins()](https://servicenow-prod.fluidtopics.net/~Nf6odnZBi4gMa9bHzMwxA#Paragraph-setMargins_N_N_N_N "각 단락 여백의 크기를 설정합니다.")를 사용합니다.
{#Paragraph-setMargin_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 마진 | 번호 | 위쪽, 오른쪽, 아래쪽 및 왼쪽 여백의 값(포인트)입니다. |
[표 12. 매개변수]

{#Paragraph-setMargin_N__table_vv5_52h_44b} {#Paragraph-setMargin_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 13. 반환]

{#Paragraph-setMargin_N__table_wv5_52h_44b}  
다음 예제에서는 단락의 모든 여백을 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(숫자 여백) {#ariaid-title9}

단락의 아래쪽 여백을 설정합니다.
{#Paragraph-setMarginBottom_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 마진 | 번호 | 하단 여백의 높이(포인트)입니다. |
[표 14. 매개변수]

{#Paragraph-setMarginBottom_N__table_vv5_52h_44b} {#Paragraph-setMarginBottom_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 15. 반환]

{#Paragraph-setMarginBottom_N__table_wv5_52h_44b}  
다음 예제에서는 단락의 아래쪽 여백을 한 포인트로 설정하는 방법을 보여줍니다.

    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(숫자 여백) {#ariaid-title10}

단락의 왼쪽 여백을 설정합니다.
{#Paragraph-setMarginLeft_N__table_vv5_52h_44b__entry__3}{#Paragraph-setMarginLeft_N__docviewer-api-parm-leftM-des}

| 이름 | 유형 | 설명 |
|-|-|-|
| 왼쪽 여백 | 번호 | 왼쪽 여백의 너비(포인트)입니다. |
[표 16. 매개변수]

{#Paragraph-setMarginLeft_N__table_vv5_52h_44b} {#Paragraph-setMarginLeft_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 17. 반환]

{#Paragraph-setMarginLeft_N__table_wv5_52h_44b}  
다음 예에서는 단락의 왼쪽 여백을 한 포인트로 설정하는 방법을 보여줍니다.

    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(숫자 여백) {#ariaid-title11}

단락의 오른쪽 여백을 설정합니다.
{#Paragraph-setMarginRight_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 마진 | 번호 | 오른쪽 여백의 너비(포인트)입니다. |
[표 18. 매개변수]

{#Paragraph-setMarginRight_N__table_vv5_52h_44b} {#Paragraph-setMarginRight_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 19. 반환]

{#Paragraph-setMarginRight_N__table_wv5_52h_44b}  
다음 예는 단락의 오른쪽 여백을 한 포인트로 설정하는 방법을 보여줍니다.

    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) {#ariaid-title12}

각 단락 여백의 크기를 설정합니다.
각 여백을 동일한 값으로 설정하려면 [setMargin()](https://servicenow-prod.fluidtopics.net/~Nf6odnZBi4gMa9bHzMwxA#Paragraph-setMargin_N "각 단락 여백을 설정합니다.")을 사용합니다.
{#Paragraph-setMargins_N_N_N_N__table_vv5_52h_44b__entry__3}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-topM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-rightM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-bottomM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-leftM-des}

| 이름 | 유형 | 설명 |
|-|-|-|
| topMargin | 번호 | 상단 여백의 높이(포인트)입니다. |
| 오른쪽 여백 | 번호 | 오른쪽 여백의 너비(포인트)입니다. |
| 하단 여백 | 번호 | 하단 여백의 높이(포인트)입니다. |
| 왼쪽 여백 | 번호 | 왼쪽 여백의 너비(포인트)입니다. |
[표 20. 매개변수]

{#Paragraph-setMargins_N_N_N_N__table_vv5_52h_44b} {#Paragraph-setMargins_N_N_N_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 21. 반환]

{#Paragraph-setMargins_N_N_N_N__table_wv5_52h_44b}  
다음 예는 단락 여백을 설정하는 방법을 보여줍니다.문서 사용 예제는 [문서](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 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(숫자 여백) {#ariaid-title13}

단락의 위 여백을 설정합니다.
{#Paragraph-setMarginTop_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 마진 | 번호 | 상단 여백의 높이(포인트)입니다. |
[표 22. 매개변수]

{#Paragraph-setMarginTop_N__table_vv5_52h_44b} {#Paragraph-setMarginTop_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 23. 반환]

{#Paragraph-setMarginTop_N__table_wv5_52h_44b}  
다음 예에서는 단락의 위쪽 여백을 한 포인트로 설정하는 방법을 보여줍니다.

    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(문자열 정렬) {#ariaid-title14}

이 단락의 텍스트 정렬을 설정합니다.
{#Paragraph-setTextAlignment_S__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 정렬 | 문자열 | 텍스트 정렬 위치입니다. 유효한 값은 다음과 같습니다. * text-center: 텍스트를 가운데에 맞춥니다. * text-justified: 왼쪽과 오른쪽 사이의 텍스트를 완전히 채울 수 있도록 문자 사이의 공간을 수정합니다. 마지막 줄은 왼쪽 정렬입니다. * text-justified-all: 마지막 줄을 포함하여 텍스트 정렬을 정당화합니다. * text-left: 텍스트를 왼쪽으로 정렬합니다. * text-right: 텍스트를 오른쪽에 정렬합니다. {#Paragraph-setTextAlignment_S__ul_sgj_44p_p4b} |
[표 24. 매개변수]

{#Paragraph-setTextAlignment_S__table_vv5_52h_44b} {#Paragraph-setTextAlignment_S__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 25. 반환]

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

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