品目 - スコープ対象、グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:3分
  • PDF に線を描画するメソッドを使用して Line オブジェクトを作成します。

    この API は ServiceNow PDF 生成ユーティリティプラグイン (com.snc.apppdfgenerator) の一部であり、 sn_pdfgeneratorutils 名前空間内で提供されます。このプラグインはデフォルトでアクティブ化されています。

    この API は、PDF を生成するために ドキュメント API で使用されるコンポーネントです。

    line:line()

    新しい Line オブジェクトをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    次の例は、 Line オブジェクトの作成方法を示しています。

    var line = new sn_pdfgeneratorutils.Line();

    行 – drawLine(ドキュメントドキュメント、番号 pageNo、番号 xPos、番号 yPos、番号の幅、番号 lineWidth)

    ドキュメントページに線を配置します。

    表 : 2. パラメーター
    名前 タイプ 説明
    ドキュメント ドキュメント ドキュメントオブジェクトの名前。
    pageNo 番号 行を配置するページ番号。
    xPos 番号 線を配置するページの X 座標領域。
    yPos 番号 線を配置するページの Y 座標領域。
    番号 線を描画するページの幅領域。値はポイント単位です。
    行幅 番号 オプション。線の太さの値 (ポイント単位)。

    デフォルト値: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(色の色)

    線の色を設定します。

    表 : 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");