Google Apps Scriptはスプレッドシートだけでなく、ドライブ、ドキュメントなどほかのG Suiteでも使える。スプレッドシートにまとめた情報をもとに、ドキュメントで報告書を自動生成することも可能だ。
これまで手作業で作成していた報告書をGASで作成するにあたって、2つ手の込んだことを求められた。ひとつには、セルを結合して少々複雑な形をした表をつくることだった。ふたつには、単なるテキストではなく、上付きや下付き、斜体といった書式設定を伴う形で表に文書を書き込むことだった。
ひとつ目の「セルを結合した表」は少々厄介であった。GASのリファレンス を読んでみても、セルの結合に相当するMethodがないのだ。試しにドキュメントでセルの結合をした表を作ってGASで読み込んでみると、セルを結合してできたセルは、TableCell.getColSpan()の値が1より大きい値になっていた。しかし、setColSpan()というMethodは存在しない。merge()も期待したような動作をしない 。ドキュメントではなくHTMLファイルとして出力することはできそう だが、いまはドキュメントを書き換えたいので不適当だ。TableRow のレベルで挿入していけば、下の図のような2行を単位とした繰り返し構造の表がつくれる。
GASでセル結合した表を挿入する例 ふたつ目の書式を維持した文書を挿入するのは簡単である。上で挿入した表のセルに対して、転写したい文書のParagraphをappendしてやればよい。
次に示す例では、元になるドキュメントファイルの1行目 (getCHild(0) またはpp[0] )から5行目(getCHild(4)またはpp[4])に書式をいじった文書が入っている。これを段落ごとに読みだしている。また、7行目( getCHild(6))にはテンプレートにしたい表がある。
function tryTable(){
var doc_from = DocumentApp.openById('元になるドキュメントファイルのID'),
doc_to = DocumentApp.openById('書き込み先になるドキュメントファイルのID'),
pp = doc_from.getBody().getParagraphs();
var body = doc_to.getBody();
//表をつくる
var table0 = body.appendTable(doc_from.getBody().getChild(6).copy());
table0.getRow(0).getCell(0).clear().appendParagraph(pp[0].copy()).merge();
table0.getRow(0).getCell(1).clear().appendParagraph(pp[1].copy()).merge();
table0.getRow(0).getCell(2).clear().appendParagraph(pp[2].copy()).merge();
table0.getRow(0).getCell(3).clear().appendParagraph(pp[3].copy()).merge();
table0.getRow(1).getCell(0).clear().appendParagraph(pp[4].copy()).merge();
//表のテンプレートを下に伸ばす。例として10回繰り返し。
for (var i = 0; i < 10; i++) {
table0.appendTableRow(table0.getRow(0).copy());
table0.appendTableRow(table0.getRow(1).copy());
}
}
参考【Microsoft Office 英語】日本語/英語の対照表（Excel, Word）
さらに複雑な表を扱う方法を考える。異なるRowのセルを結合したセルではどのようになるだろうか？次の図に2行5列の表のセルを結合した表と、各セルにアクセスする際に使うRowやCellの番地を示した。複雑な形状に結合した表であっても、結合したセルの左上に位置するセルの値が表示されると見なせるようだ。
行(Row)が異なるセルを結合した表の例 自分で作成した表の各セルにアクセスする番地を確認したければ、getChild(index)で各セルの値を読み出すのが簡単だろう。BODY>TABLE>TABLE ROW>TABLE CELL>PARAGRAPH>TEXTという順序で各オブジェクトがぶら下がっている。TABLE CELLまで行けばgetText()でセルの中のテキストを表示できる。また、各要素にぶら下がっている要素の数はgetNumChildren()で取得できるので、あとはforループで読みだせばよい。
ところで、セルを結合すると表示されないセルが出てくるが、ファイルから消えているわけではないようだ。BODYに対してgetParagraphs() をすると、上の図で表示されていないTABLE CELL (R1C0やR1C2~4)に対応するはずのParagraphも取得される。
