라인 - 범위 지정, 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분
  • PDF에 선을 그리는 메서드를 사용하여 Line 객체를 만듭니다.

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

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

    라인 - 라인()

    Line 개체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함

    다음 예제에서는 Line 개체를 만드는 방법을 보여 줍니다.

    var line = new sn_pdfgeneratorutils.Line();

    Line – drawLine(Document document, Number pageNo, Number xPos, Number yPos, Number width, Number lineWidth)

    문서 페이지에 선을 놓습니다.

    표 2. 매개변수
    이름 유형 설명
    문서 문서 문서 객체의 이름입니다.
    pageNo 번호 선을 배치할 페이지 번호입니다.
    xPos 번호 선을 배치할 페이지의 X 좌표 영역입니다.
    yPos 번호 선을 배치할 페이지의 Y 좌표 영역입니다.
    width 번호 선을 그릴 페이지의 너비 영역입니다. 값은 포인트입니다.
    lineWidth 번호 옵션입니다. 포인트 단위의 선 두께 값입니다.

    기본값: 1

    표 3. 반환
    유형 설명
    안 함

    다음 예제에서는 문서 페이지의 아래쪽 여백에 선을 만드는 방법을 보여 줍니다. 문서 사용 예제는 문서 API를 참조하세요.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
    
    var num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;
    
    document.addNewPage();
    
    var line = new sn_pdfgeneratorutils.Line();
    
    line.drawLine(document, num, xpos, ypos, width, linewidth);
    
    document.saveAsAttachment("incident", "<sys_id>", "line.pdf");

    Line – setColor(Color color)

    선의 색을 설정합니다.

    표 4. 매개변수
    이름 유형 설명
    색상 색상 선 색입니다.
    표 5. 반환
    유형 설명
    안 함

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

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
    
    var num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;
    
    var color = new sn_pdfgeneratorutils.Color([0.5,0.5,0.8]);   //given as array of RGB values;
    
    document.addNewPage();
    
    var line = new sn_pdfgeneratorutils.Line();
    
    line.setColor(color);
    
    line.drawLine(document, num, xpos, ypos, width, linewidth);
    
    document.saveAsAttachment("incident", "<sys_id>", "lineWithColor.pdf");