Creates a PdfPage object representing a PDF page and its attributes; such as size, width, and color.

This API is part of the ServiceNow PDF Generation Utilities plugin (com.snc.apppdfgenerator) and is provided within the sn_pdfgeneratorutils namespace. The plugin is activated by default.

This API is a component used with the Document API to generate a PDF.

PdfPage - PdfPage(String pageSize, String orientation)

Instantiates a new PdfPage object.

Table 1. Parameters
Name Type Description
pageSize String PDF page size.
Valid values:
  • A4 – 595 x 842 points
  • EXECUTIVE – 522 x 756 points
  • LETTER – 612 x 792 points
  • LEDGER – 792 x 1224 points
orientation String Optional. PDF page orientation.
Valid values:
  • LANDSCAPE
  • PORTRAIT

Default: PORTRAIT

Example

The following example shows how to create a PdfPage object.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");

PdfPage – getBottom()

Gets the Y-coordinate of the lower edge of a PDF page.

Table 2. Parameters
Name Type Description
None
Table 3. Returns
Type Description
Number Decimal value of the Y-coordinate at the lower edge of the PDF page.

Example

The following example shows how to get the Y-coordinate of the lower edge of a PDF page.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
 var bottom = pdfpage.getBottom();

PdfPage – getLeft()

Gets the X-coordinate of the left edge of a PDF page.

Table 4. Parameters
Name Type Description
None
Table 5. Returns
Type Description
Number Decimal value of the X-coordinate on the left edge of the page.

Example

The following example shows how to get the X-coordinate of the left edge of a PDF page.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
 var left = pdfpage.getLeft();

PdfPage – getPdfPageSize()

Gets the size of a PDF page

Table 6. Parameters
Name Type Description
None
Table 7. Returns
Type Description
None

Example

The following example shows how to get the PDF page size.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
var size = pdfpage.getPdfPageSize();

PdfPage – getRight()

Gets the X-coordinate of the right edge of a PDF page.

Table 8. Parameters
Name Type Description
None
Table 9. Returns
Type Description
Number Decimal value of the X-coordinate on the right edge of the page.

Example

The following example shows how to get the X-coordinate of the right edge of a PDF page.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
 var right = pdfpage.getRight();

PdfPage – getTop()

Gets the Y-coordinate of the upper edge of a PDF page.

Table 10. Parameters
Name Type Description
None
Table 11. Returns
Type Description
Number Decimal value of the Y-coordinate at the upper edge of the PDF page.

Example

The following example shows how to get the Y-coordinate of the upper edge of a PDF page.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
 var top  = pdfpage.getTop();

PdfPage – getWidth()

Gets the width of a PDF page.

Table 12. Parameters
Name Type Description
None
Table 13. Returns
Type Description
Number Size of the page width in points.

Example

The following example shows how to retrieve the width of a PDF page.

var pdfpage = new sn_pdfgeneratorutils.PdfPage("A4", "LANDSCAPE");
var width = PdfPage.getWidth();