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

ワシントンDC API リファレンス

Release

washingtondc

ft:locale

ja-JP

ft:publication_title

ワシントンDC API リファレンス

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

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

リリースバージョン: Washingtondc

更新日 2024年02月01日

読む48読むのに数分

PDF ドキュメントに追加する Table オブジェクトを作成します。各セルで使用するデータを定義し、スタイル、マージン、配置を設定します。

この API は PDF Generation Utilities プラグイン (com.snc.apppdfgenerator) の一部 ServiceNow であり、 sn_pdfgeneratorutils 名前空間内で提供されます。このプラグインはデフォルトでは有効になっています。

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

このクラスのメソッドを使用して Table オブジェクトを構築します。次の追加クラスを使用して、セル、パラグラフ、およびスタイルをテーブルに追加できます。

Cell API

Cell API を使用してセルを作成します。次に、以下のいずれかのメソッドを使用してセルをテーブルに追加します。

Table.addCell()
Table.addCellWithStyle()
Table.addHeaderCell()
Table.addImageCell()
Table.addParagraphCell()
Table.addTextCell()

Paragraph API

Paragraph API を使用してパラグラフを作成します。 Cell.addParagraph() を使用して、テーブル内のセルにパラグラフを追加します。

Style API

Style API を使用してスタイル、色、および境界線を設定します。以下のいずれかのメソッドを使用してスタイルをテーブルに追加します。

Table.setDefaultStyle()
Table.setHeaderStyle()

その後、次のクラスとメソッドを使用して、PDF ドキュメントに Table オブジェクトを適用できます。

Document API: Document.addTable() メソッドを使用して、テーブルを PDF ドキュメントに追加します。Document.saveAsAttachment() メソッドを使用すると、ドキュメントをレコードに添付できます。

Table - Table(ブーリアン ltr, アレイ columnWidths, ブーリアン largeTable)

テキストの方向、列幅、およびレイアウト設定を使用して、新しい Table オブジェクトをインスタンス化します。

表 : 1. パラメーター
名前	タイプ	説明
ltr	ブーリアン	テーブル内の言語のテキストの向きを示すフラグ。詳細については、「W3C：スクリプトの向きと言語 (W3C: Script direction and languages)」を参照してください。有効な値： true：テキストの向きは左から右である。 false：テキストの向きは右から左である。
columnWidths	アレイ	テーブルの各列の幅を指定する数値。サイズは比例配分されます。例えば、`var columnWidths = [2, 1, 1];` は 3 列のテーブルで、1 列目が他の 2 列の 2 倍のサイズです。デフォルト：各列が同じ幅です。
largeTable	ブーリアン	100％幅と固定レイアウトが暗黙的に設定されているかどうかを示すフラグ。有効な値： true：テーブルが固定レイアウトで 100％幅を使用する。true の場合、すべてのコンテンツが追加されたときに complete() メソッドを使用して、テーブルが完成したことを示します。 false：自動テーブルサイズ。デフォルト値：false

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

var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);

Table – addCell(セル cell)

セル要素をテーブルに追加します。

表 : 2. パラメーター
名前	タイプ	説明
cell	セル	テーブルに追加するセル要素。

表 : 3. 返される内容
タイプ	説明
なし

この例では、インシデントテーブルから Table オブジェクトを作成し、各行に [番号] と [簡単な説明] のセルを追加する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);
 
var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);
 
var nParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var sParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(nParagraph);
hdrCell2.addParagraph(sParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);
 
var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCell(numCell);
   table.addCell(sdCell);
 
   row = row + 1;
 
}
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – addCellWithStyle(セル cell, スタイル style)

スタイルを適用したセル要素をテーブルに追加します。

表 : 4. パラメーター
名前	タイプ	説明
cell	セル	テーブルに追加する Cell オブジェクト。
style	スタイル	セルに適用するスタイル。

表 : 5. 返される内容
タイプ	説明
なし

この例では、指定されたセルにスタイルを適用し、そのドキュメントをレコードに添付する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var cellBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);
 
var cellStyle = new sn_pdfgeneratorutils.Style;
cellStyle.setBackgroundColor(cellBgColor);
cellStyle.setTextAlignment("text-center");
cellStyle.setBold();
cellStyle.setFontColor(whiteColor);
 
var nParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var sParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(nParagraph);
hdrCell2.addParagraph(sParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);
 
var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCellWithStyle(numCell, cellStyle);
   table.addCell(sdCell);
 
   row = row + 1;
 
}
 
document.addTable(table);
document.saveAsAttachment("incident", "sys_id", "filename.pdf");

Table – addHeaderCell(セル cell)

ヘッダーの Cell オブジェクトをテーブルに追加します。

表 : 6. パラメーター
名前	タイプ	説明
cell	セル	テーブルに追加するヘッダーセル。

表 : 7. 返される内容
タイプ	説明
なし

この例では、Paragraph オブジェクトを含むテーブルにヘッダーセルを追加する方法を示します。Paragraph オブジェクトの詳細については、「Paragraph API」を参照してください。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);
 
var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);
 
var nParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var sParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(nParagraph);
hdrCell2.addParagraph(sParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);
 
var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCell(numCell);
   table.addCell(sdCell);
 
   row = row + 1;
 
}
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – addImageCell(画像 image)

画像を含むセルをテーブルに追加します。

表 : 8. パラメーター
名前	タイプ	説明
image	画像	セルに追加する画像オブジェクト。

表 : 9. 返される内容
タイプ	説明
なし

この例では、2 つの画像セルを持つテーブルを作成し、そのドキュメントをレコードに添付する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);
 
var icon = new sn_pdfgeneratorutils.Image("<sys_id>");
var picture = new sn_pdfgeneratorutils.Image("<sys_id>");
 
table.addImageCell(icon);
table.addImageCell(picture);
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – addParagraphCell(パラグラフ p)

パラグラフを含むセルをテーブルに追加します。

表 : 10. パラメーター
名前	タイプ	説明
p	パラグラフ	セルに追加する Paragraph オブジェクト。

表 : 11. 返される内容
タイプ	説明
なし

この例では、パラグラフの内容を含む単一のセルでテーブルを作成する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
var paragraph = new sn_pdfgeneratorutils.Paragraph("Content to add to the cell");
 
table.addParagraphCell(paragraph);
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – addTextCell(文字列 text)

文字列を含むセルをテーブルに追加します。

表 : 12. パラメーター
名前	タイプ	説明
text	文字列	セルに追加するテキスト。

表 : 13. 返される内容
タイプ	説明
なし

この例では、文字列を含む単一のセルでテーブルを作成する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
 
document.addTable(table);
document.saveAsAttachment("incident", "record_sys_id", "filename.pdf");

Table – complete()

意図した内容がすべて 1 つの大きなテーブルに追加されたことを示します。

すでにドキュメントに追加されているテーブルに他の内容を追加するには、Table.flush() メソッドと一緒に使用します。このメソッドは、コンストラクターの largeTable パラメーターが true に設定されている場合にのみ適用されます。

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

表 : 15. 返される内容
タイプ	説明
なし

この例では、すでにドキュメントに追加されているテーブルへの内容の追加が完了したことを示す方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1,2,1,1], true);
 
var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);
 
var numberParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var descParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
var stateParagraph = new sn_pdfgeneratorutils.Paragraph("State");
var assignedParagraph = new sn_pdfgeneratorutils.Paragraph("Assigned to");

 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
var hdrCell3 = new sn_pdfgeneratorutils.Cell;
var hdrCell4 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(numberParagraph);
hdrCell2.addParagraph(descParagraph);
hdrCell3.addParagraph(stateParagraph);
hdrCell4.addParagraph(assignedParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);
table.addHeaderCell(hdrCell3);
table.addHeaderCell(hdrCell4);

var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
   var stateCell = new sn_pdfgeneratorutils.Cell;
   var assignedCell = new sn_pdfgeneratorutils.Cell;

 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
   var stateParagraph = new sn_pdfgeneratorutils.Paragraph(gr.state);
   var assignedParagraph = new sn_pdfgeneratorutils.Paragraph(gr.assigned_to);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
   stateCell.addParagraph(stateParagraph);
   assignedCell.addParagraph(assignedParagraph);

 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCell(numCell);
   table.addCell(sdCell);
   table.addCell(stateCell);
   table.addCell(assignedCell);
 
   row = row + 1;
 
}

document.addTable(table);
table.addTextCell("A cell added later");
table.flush();
table.complete();
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – donotSplitRowOnPageBreak(ブーリアン value)

行が 2 ページに分割されないようにします (可能な場合)。

表 : 16. パラメーター
名前	タイプ	説明
value	ブーリアン	行を 2 ページに分割するか、行全体を 2 ページ目に移動するかを示すフラグ。ただし、行が複数のページにまたがる場合、このプロパティは適用されません。有効な値： true：ページの残りの部分が行に対して十分な大きさでない場合、行全体を新しいページに追加します。 false：ページの残りの部分が行に対して十分な大きさでない場合、行を 2 ページに分割します。デフォルト値：false

表 : 17. 返される内容
タイプ	説明
なし

この例では、行が 2 ページに分割されないようにする方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [25,25,25,75,400], false);
 
table.addTextCell("Text to add to the cell");
table.addTextCell("More text to add to the cell");
table.addTextCell("Even more text to add to the cell");
table.addTextCell("Even more text to add to the cell");
table.addTextCell("Even more text to add to the cell");

table.donotSplitRowOnPageBreak(true);
 
document.addTable(table);
document.saveAsAttachment("incident", "record_sys_id", "filename.pdf");

Table –flush()

すでにドキュメントに追加されているテーブルに他の内容を追加します。

Table.complete() メソッドと一緒に使用して、他の内容がすべてテーブルに追加されたことを示します。このメソッドは、コンストラクターの largeTable パラメーターが true に設定されている場合にのみ適用されます。

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

表 : 19. 返される内容
タイプ	説明
なし

この例では、すでにドキュメントに追加されているテーブルにテキストセルを追加する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1,2,1,1], true);
 
var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);
 
var numberParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var descParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
var stateParagraph = new sn_pdfgeneratorutils.Paragraph("State");
var assignedParagraph = new sn_pdfgeneratorutils.Paragraph("Assigned to");

 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
var hdrCell3 = new sn_pdfgeneratorutils.Cell;
var hdrCell4 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(numberParagraph);
hdrCell2.addParagraph(descParagraph);
hdrCell3.addParagraph(stateParagraph);
hdrCell4.addParagraph(assignedParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);
table.addHeaderCell(hdrCell3);
table.addHeaderCell(hdrCell4);

var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
   var stateCell = new sn_pdfgeneratorutils.Cell;
   var assignedCell = new sn_pdfgeneratorutils.Cell;

 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
   var stateParagraph = new sn_pdfgeneratorutils.Paragraph(gr.state);
   var assignedParagraph = new sn_pdfgeneratorutils.Paragraph(gr.assigned_to);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
   stateCell.addParagraph(stateParagraph);
   assignedCell.addParagraph(assignedParagraph);

 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCell(numCell);
   table.addCell(sdCell);
   table.addCell(stateCell);
   table.addCell(assignedCell);
 
   row = row + 1;
 
}

document.addTable(table);
table.addTextCell("A cell added later");
table.flush();
table.complete();
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – getDefaultStyle()

デフォルトのスタイルを返します。

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

表 : 21. 返される内容
タイプ	説明
スタイル	デフォルトのスタイル。

この例では、デフォルトのスタイルを設定して返す方法を示します。

var table = new sn_pdfgeneratorutils.Table(true, [1], false);

var style = new sn_pdfgeneratorutils.Style();

style.setItalic();

table.setDefaultStyle(style);
 
table.addTextCell("Text to add to the cell");

var defaultStyle = table.getDefaultStyle();

gs.info(defaultStyle);

Table – getHeaderStyle()

テーブルのヘッダーに適用されているスタイルを返します。

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

表 : 23. 返される内容
タイプ	説明
スタイル	テーブルのヘッダーに適用されているスタイル。

この例では、テーブルのヘッダーのスタイルを設定して返す方法を示します。

var table = new sn_pdfgeneratorutils.Table(true, [1,1], false);

var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);

var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);

var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);

var styleObject = table.getHeaderStyle();

gs.info(styleObject);

Table – setBorder(数字 width)

テーブルの外縁に、指定された幅の境界線を設定します。

表 : 24. パラメーター
名前	タイプ	説明
width	数字	境界線の幅。単位：ポイント

表 : 25. 返される内容
タイプ	説明
なし

この例では、2 ピクセルの境界線を持つテーブルを作成し、そのテーブルをレコードに添付する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setBorder(2);
 
document.addTable(table);
"document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setDefaultbackGroundColor(色 color)

テーブルのデフォルトの背景色を設定します。

表 : 26. パラメーター
名前	タイプ	説明
color	色	テーブルのデフォルトの背景色として使用される色オブジェクト。

表 : 27. 返される内容
タイプ	説明
なし

この例では、テーブルのデフォルトの背景色を設定する方法を示します。

// declare table by providing width array with automatic table size
var table = new sn_pdfgeneratorutils.Table(true, [1], false);

var color = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);

table.setDefaultbackGroundColor(color);
 
table.addTextCell("Text to add to the cell");

Table – setDefaultStyle(スタイル defaultStyle)

テーブルに適用するデフォルトのスタイルを設定します。

表 : 28. パラメーター
名前	タイプ	説明
defaultStyle	スタイル	テーブルに適用するデフォルトのスタイル。

表 : 29. 返される内容
タイプ	説明
なし

次の例では、テーブルにデフォルトのスタイルを適用する方法を示します。

var table = new sn_pdfgeneratorutils.Table(true, [1], false);

var style = new sn_pdfgeneratorutils.Style();

style.setItalic();

table.setDefaultStyle(style);
 
table.addTextCell("Text to add to the cell");

var defaultStyle = table.getDefaultStyle();

gs.info(defaultStyle);

Table – setFixedPosition(数字 pageNumber, 数字 left, 数字 bottom, 数字 width)

テーブルをページ上の固定位置に設定します。

表 : 30. パラメーター
名前	タイプ	説明
pageNumber	数字	テーブルを追加するページの番号。
left	数字	テーブルを追加する左マージンからのピクセル数。単位：ポイント
bottom	数字	テーブルを追加する下マージンからのピクセル数。単位：ポイント
width	数字	テーブルの幅。単位：ポイント

表 : 31. 返される内容
タイプ	説明
なし

この例では、テーブルをページの左下隅に再配置する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setFixedPosition(1,36,36,500);
 
document.addTable(table);
"document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setHeaderStyle(スタイル headerStyle)

テーブルのヘッダーに適用するスタイルオブジェクトを設定します。

表 : 32. パラメーター
名前	タイプ	説明
headerStyle	スタイル	テーブルのヘッダーに適用するスタイルオブジェクト。

表 : 33. 返される内容
タイプ	説明
なし

この例では、テーブルのヘッダーのスタイルを設定して返す方法を示します。

var table = new sn_pdfgeneratorutils.Table(true, [1,1], false);

var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);

var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);

var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);

var styleObject = table.getHeaderStyle();

gs.info(styleObject);

Table – setHorizontalAlignment(文字列 alignment)

テーブルの水平配置を設定します。

表 : 34. パラメーター
名前	タイプ	説明
alignment	文字列	テーブルの配置。有効な値： center：コンテンツを中央に配置します。 left：コンテンツを左に配置します。 right：コンテンツを右に配置します。

表 : 35. 返される内容
タイプ	説明
なし

この例は、ページの中央に配置された小さなテーブルを作成する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setWidth(90);
table.setHorizontalAlignment("center");
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setMargin(数字 margin)

テーブル周囲のすべてのマージンを同じ幅に設定します。

表 : 36. パラメーター
名前	タイプ	説明
margin	数値	上、右、下、左のマージンの値 (ポイント)。

表 : 37. 返される内容
タイプ	説明
なし

この例では、テーブル全体のマージンを設定する方法を示します。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setMargin(3);
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setMarginBottom(数字 margin)

ページの下マージンを設定します。

表 : 38. パラメーター
名前	タイプ	説明
margin	数字	下マージンの高さ (ポイント)。

表 : 39. 返される内容
タイプ	説明
なし

この例では、ページの下マージンを 3 ポイントに設定する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
var whiteColor =  sn_pdfgeneratorutils.Color([1,1,1]);
var greyColor =  sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var headerBgColor = new sn_pdfgeneratorutils.Color([0.4,0.6,0.8]);
 
// Query Incident
var gr = new GlideRecord("incident");
gr.query();
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [70,200], false);
 
var headerStyle = new sn_pdfgeneratorutils.Style;
headerStyle.setBackgroundColor(headerBgColor);
headerStyle.setTextAlignment("text-center");
headerStyle.setBold();
headerStyle.setFontColor(whiteColor);
 
table.setHeaderStyle(headerStyle);
 
var nParagraph = new sn_pdfgeneratorutils.Paragraph("Number");
var sParagraph = new sn_pdfgeneratorutils.Paragraph("Short Description");
 
var hdrCell1 = new sn_pdfgeneratorutils.Cell;
var hdrCell2 = new sn_pdfgeneratorutils.Cell;
 
hdrCell1.addParagraph(nParagraph);
hdrCell2.addParagraph(sParagraph);
 
table.addHeaderCell(hdrCell1);
table.addHeaderCell(hdrCell2);

// set the bottom margin to three points
table.setBottomMargin(3);
 
var row = 0;
 
while(gr.next()) {
   var numCell = new sn_pdfgeneratorutils.Cell;
   var sdCell = new sn_pdfgeneratorutils.Cell;
 
   var numberParagraph = new sn_pdfgeneratorutils.Paragraph(gr.number);
   var sdParagraph = new sn_pdfgeneratorutils.Paragraph(gr.short_description);
  
   numCell.addParagraph(numberParagraph);
   sdCell.addParagraph(sdParagraph);
 
   if (row % 2 == 1) {
      table.setDefaultbackGroundColor(greyColor);
   } else {
      table.setDefaultbackGroundColor(whiteColor);
   }
 
   table.addCell(numCell);
   table.addCell(sdCell);
 
   row = row + 1;
 
}
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setMarginLeft(数字 margin)

ページの左マージンを設定します。

表 : 40. パラメーター
名前	タイプ	説明
margin	数字	左マージンの幅 (ポイント)。

表 : 41. 返される内容
タイプ	説明
なし

この例では、ページの左マージンを設定する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setMarginLeft(100);
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setMarginRight(数字 margin)

ページの右マージンを設定します。

表 : 42. パラメーター
名前	タイプ	説明
margin	数字	右マージンの幅 (ポイント)。

表 : 43. 返される内容
タイプ	説明
なし

この例では、ページの左マージンを設定する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setMarginRight(100);
 
document.addTable(table);
"document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setMarginTop(数字 margin)

ページの上マージンを設定します。

表 : 44. パラメーター
名前	タイプ	説明
margin	数字	上マージンの高さ (ポイント)。

表 : 45. 返される内容
タイプ	説明
なし

この例では、ページの上マージンを設定する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setMarginTop(100);
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – setWidth(数字 width)

テーブルの合計幅を設定します。

表 : 46. パラメーター
名前	タイプ	説明
width	数字	テーブルの幅。単位：ポイント

表 : 47. 返される内容
タイプ	説明
なし

この例では、幅が 90 ポイントのテーブルを作成し、そのドキュメントをレコードに添付する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.setWidth(90);
table.setHorizontalAlignment("center");
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

Table – useAllAvailableWidth()

ページで使用可能な幅全体を使用するようにテーブルを拡張します。

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

表 : 49. 返される内容
タイプ	説明
なし

この例は、ページの使用可能幅全体に広がるテーブルを作成する方法を示しています。

var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare table by providing width array and Boolean for large table
var table = new sn_pdfgeneratorutils.Table(true, [1], false);
 
table.addTextCell("Text to add to the cell");
table.useAllAvailableWidth();
 
document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");