[Brazil調査] Excel出力のシート行数：glide.export.xlsx.max.rows.per.sheet の動き

一覧を Excel に出力したら、データが途中から別のシートに分かれていた。そんな経験はないでしょうか。Brazil のリリースノートには、この1シートあたりの行数を2つのプロパティで調整できると書かれています。

ところがアップグレード済みの PDI を調べると、そのプロパティのレコードが存在しません。自分で作って100を入れたところ、345行の一覧が100行ずつ4枚のシートに分かれて出力されました。

押さえておくこと

• 対象は glide.export.xlsx.max.rows.per.sheet（XLSX 用）と glide.export.xls.max.rows.per.sheet（XLS 用）です

• 公式の説明では、本文は「1シート32,000行」、表の数値は XLS 64,000 と XLSX 1,000,000 で、食い違っています

• 実機にはどちらもレコードがなく、作成して5秒後の出力で反映されていました。再起動は要りませんでした

• 値がちょうど出力行数と同じだと、見出し行だけの空シートが1枚増えます

Excel出力のシート分割

一覧画面の右クリックメニューや、一覧のURLに XLSX や EXCEL を付けると、表示中の条件に合うレコードを Excel ファイルとして取り出せます。取り出せる件数や形式ごとの上限は、システムプロパティで決まっています。

Excel 出力では、ServiceNow が一定の行数でシートを分けて出力します。その行数を調整できるのが、今回のプロパティです。

位置づけは、出力件数の上限（glide.ui.export.limit など）とは別の設定です。出力件数の上限は「何件まで取り出せるか」を決め、今回のプロパティは「取り出した行を何枚のシートに分けるか」を決めます。

公式の説明

Australia から Brazil への差分ノート（ServiceNow AI Platform core feature）に、次の項目があります。

（訳：Excel出力の行数のしきい値を設定する。2つのプロパティで、Excel出力の行数上限を設定できる）

引用元：Combined ServiceNow AI Platform core feature release notes for upgrades from Australia to Brazil

同じ項目は、Brazil の製品リリースノートにも載っています。引用元：ServiceNow AI Platform core feature release notes

製品ドキュメントの「Export limits」には、設定の説明があります。

• 本文：「The export puts the information into the Excel document with 32,000 rows per spreadsheet.」（Excel文書には1シートあたり32,000行で出力される）

• 表：XLS は64,000、XLSX は1,000,000（列の見出しは Maximum export limits）

• 同じページに、Excel出力は50万セルを超えると停止し、「Use CSV for a complete export」と表示される、という説明もあります

引用元：Export limits

本文の32,000と、表の64,000／1,000,000は一致していません。表の列名どおり「設定できる最大値」と読むと筋が通りますが、既定値がいくつなのかは、ページからは判断できません。

Australia の場合

差分ノートは、この項目を「新しく設定できるようになった」ものとして載せています。Australia までは、この行数を調整する手段がドキュメント上に見当たらず、固定の行数でシートが分かれていたと読めます。ただし、Australia の環境で実際に出力して確かめてはいません。

PDI のプロパティ

Brazil にアップグレードした PDI で、システムプロパティを名前で検索しました。

①が絞り込み条件で、②が結果です。0件でした。glide.export で始まるプロパティも、escape_formulas・excel.force_xlsx・query.enforce_field_acl の3件だけです。

レコードがなくても、機能そのものは既定値で動いています。公式の表にある glide.xlsx.max_cells や glide.ui.export.limit も、この PDI にレコードは見つかりませんでした。公式のプロパティを使うには、まず自分で作る必要があります。

アップグレードしたインスタンスでも、新規インスタンスでも、同じ状態かどうかは分かりません。この PDI は Australia からのメジャーアップグレード版なので、新規に作った Brazil の環境ではレコードが最初から入っている可能性があります。

100行の設定での出力

試験は次の手順で行いました。

1. 対象の一覧を決める。sys_choice で name が sys_e で始まる345行

2. プロパティが無い状態で、XLSX と XLS に出力する

3. xlsx.max.rows.per.sheet を100で作成し、XLSX に出力する

4. xls.max.rows.per.sheet を100で作成し、XLS に出力する

5. 2つのプロパティを削除し、もう一度出力して元に戻ったことを確かめる

出力は、一覧のURLに XLSX または EXCEL を付けて取得しました。この方法は、公式の「Export directly from a URL」に書かれたものです。引用元：Export directly from a URL

ダウンロードしたファイルは、この PC に保存しただけです。PDI から外部へ何かを送ることはしていません。

起点は345行の一覧で、灰色は設定前、青は XLSX、橙は XLS の結果です。

• プロパティなし：XLSX も XLS も Page 1 の1シートで、見出しを含めて346行

• 100を設定：XLSX も XLS も Page 1〜Page 4 の4シートに分かれ、データ行は100・100・100・45

• 各シートの先頭に見出し行が繰り返され、1シートは見出し込みで101行

• シート名は Page 1、Page 2 と連番

• 設定を作成して5秒待っただけで反映された。再起動やキャッシュの手動クリアは行っていない

• 2つを削除すると、どちらも1シート346行に戻った

XLSX と XLS の分かれ方

2つのプロパティは形式ごとに別々ですが、100を入れたときの分かれ方は同じでした。XLSX のプロパティが XLSX だけに効くかどうかまでは確かめていません。形式を使い分けている環境では、必要な形式のプロパティを両方作ります。

値の境界と空のシート

値を50、344、345、346と変えて XLSX を出力しました。

• 50：データ50行ずつ6シートと、45行の1シートで、計7シート

• 344：344行のシートと、1行だけのシート

• 345：345行のシートと、見出し行だけの空シート。今回の345行・値345では起きました

• 346：1シートにすべて入る

• 0、-5、abc：どれも設定が無視され、1シートに345行が入る

分かれ方の基準は、データ行の数です。見出し行は、各シートに必ず付きます。値を境界の近くに置くときは、実際の運用で件数がどの程度動くかを先に把握し、件数が増減する一覧で空のシートが出ないかを、事前に複数回の出力で確かめておくと安心です。

ちょうど値と同じ行数のときに空のシートが付くのは、次の行があるかを確かめる前にシートを切り替えているためだと推測できます。ただし、ソースを読んだわけではなく、挙動からの推測です。設定する値は、実際の出力件数と同じにならないよう注意します。

他の出力形式と、件数の指定との関係

プロパティを100にしたまま、CSV で同じ一覧を出力しました。分割は行われず、見出しを含めて346行のファイル1つでした。このプロパティは Excel 形式だけに効きます。

出力件数を sysparm_record_count で120件に絞り、プロパティが100のまま XLSX で出力すると、Page 1 が100行、Page 2 が20行になりました。件数の指定とシート分割は、両方が効きます。

実務での値の決め方

シートを小さく分けたい場面と、大きな出力をまとめたい場面で、考え方が変わります。

シートを分けたい場合

Excel の見やすさや、読み込み先ツールの行数制限に合わせて、値を下げます。見出し行が各シートに付くので、後から結合しやすい形です。ピボットテーブルや Power Query で複数シートを読み込む運用なら、値を揃えておくと取り込みが安定します。

1シートにまとめたい場合

値を上げる前に、出力件数の上限（glide.ui.export.limit など、既定10,000）と、50万セルの上限（glide.xlsx.max_cells）を確認します。これらの上限で止まる場合は、行数の設定を変えても効果がありません。

大量データの場合

公式も CSV を勧めています。Excel は小さな出力向けの機能です。10,000件を超える一覧は、公式の手順どおり、並び順を固定して範囲を分けて取り出す方法もあります。引用元：Break up a large export

設定を作るときの決まり

型は integer にします。説明欄には目的と変更した日、試験用か本番用かを書いておくと、後任が経緯をたどれ、削除の判断もしやすくなります。

値は、よく出力する一覧の件数と同じ数にならないよう選びます。作成後は、件数の違う一覧でも同じ値で出力し、分かれ方を比べておくと後で迷いません。値の変更を更新セットで運ぶのか、本番で直接変えるのかは、先に決めておきます。

出力時のヘッダーや表示値の扱いは、別のプロパティで決まります。引用元：System properties for display value and header

自分の環境で試すときの手順

同じ確認は、管理者権限があればすぐに再現できます。設定は元に戻せる形で行い、試験用のプロパティには「記事検証」のような目印を説明欄に入れておくと、消し忘れを防げます。

1. システムプロパティの一覧を開き、名前に rows.per.sheet を含む条件で検索する。レコードがあるかを確かめる

2. 無ければ、新規作成で glide.export.xlsx.max.rows.per.sheet を作る。型は integer、値は小さな数（例：100）にする

3. 数百行ある一覧を選び、URL の末尾に XLSX を付けて出力する。出力後、Excel でシート名と各シートの行数を数える

4. 試験が終わったら、作ったレコードを削除する。削除後にもう一度出力し、1シートに戻ったことを確かめる

XLS で確かめるときは、プロパティ名の xlsx を xls に変え、URL には EXCEL を付けます。出力に使う一覧は、件数が数百行あれば足ります。sys_choice や sys_properties のように、どの環境にも件数があるテーブルが使いやすいです。

何件ならシートはいくつになるか

値を決めるときは、出力する件数とシート数の関係を先に計算しておくと便利です。計算は「データ件数 ÷ 設定値」を切り上げた数が、シートの数になります。ただし、前の章のとおり、件数が設定値でちょうど割り切れる場合は、空のシートが1枚増えることがあります。

• 345件・値100：4シート（100・100・100・45）。実機の結果と一致

• 345件・値50：7シート（50が6枚と45）。実機の結果と一致

• 345件・値344：2シート（344と1）。実機の結果と一致

• 345件・値345：計算上は1シートだが、実機では2シート（2枚目は空）

• 345件・値346：1シート

割り切れる場合の空シートは、件数が毎回変わる一覧では起きたり起きなかったりします。レポートの取り込みを自動化している場合は、見出し行だけのシートを読み飛ばす処理を入れておくと安全です。

列数との組み合わせ

公式の説明によると、Excel出力は50万セルを超えると停止します。セル数は「行数×列数」です。列が多い一覧では、行数の上限より先にセル数の上限に当たります。

• 列が10個の一覧：50,000行で50万セルに達する

• 列が50個の一覧：10,000行で50万セルに達する

• 列が100個の一覧：5,000行で50万セルに達する

シート分割の値を大きく上げても、セル数の上限（glide.xlsx.max_cells と glide.excel.max_cells）で止まれば、出力は途中で終わります。シートを大きくしたいときは、列数も絞るのが基本です。公式ドキュメントでは、セル数の上限はシート単位ではなくエクスポート全体に適用されると説明されています。シートを小さく分けても、全体のセル数は減らないため、列数と行数の両方を見て上限を決めます。

この記事の試験では、345行・数列の小さな一覧を使ったため、セル数の上限には当たっていません。上限に達したときの動作は、公式の説明を引用するにとどめます。列を絞った一覧を作るときは、出力先の利用者が必要とする項目から残す方針が現実的です。

Brazil へアップグレードしたあとの確認項目

Excel出力を業務で使っている環境では、アップグレード後に次を確認しておくと安心です。

• Excel出力を使う定期作業の一覧を作り、出力件数が数百行を超えるものを洗い出す

• 該当の出力を1回実行し、シートが分かれていないか、分かれ方が以前と変わっていないかを確認する

• 取り込み側のツールが、複数シートや空のシートを想定しているかを確認する

• システムプロパティに rows.per.sheet のレコードがあるかを確認し、無ければ現状の既定値のまま運用すると決める

• 値を変えたときは、変更前の状態（レコード無し）を記録し、戻し方も残す

多くの環境では、何も設定しなくても今までどおり動きます。プロパティを作るのは、シートの分かれ方を意図して変えたいときだけです。

実機で気づいたこと

プロパティの有無と機能

リリースノートを読んで、システムプロパティの一覧に新しいレコードが増えていると想像していました。実機は逆で、プロパティはレコードなしです。ドキュメントにあるプロパティが画面に見えなくても、機能が無いとは限りません。この記事の確認のように、作って値を入れてみて初めて効いているかが分かります。

一覧からの取り出し方は、画面の操作と URL の指定の2通りが公式に説明されています。引用元：Export data from a list

不正な値の扱い

0、-5、abc を入れても、エラーも警告も出ませんでした。出力は1シートのままで、設定したつもりの分割は起きません。値を入れたのに効かないときは、まず数字が正しい形か、名前に誤字がないかを疑います。

シート名は Page N で固定、見出し行は毎シートに付く

分割されたシートの名前は、設定値にかかわらず Page 1、Page 2 と連番でした。テーブル名や日付は入りません。取り込み側でシート名を条件にしている場合は、シート名ではなく並びで処理します。

見出し行が毎シートに付く作りは、集計が楽になる一方で、全シートを縦に結合するときに見出しが途中の行として混ざります。結合した後で、見出しと同じ値の行を除く処理が要ります。実際に結合まで試してはいませんが、ファイルの構造から確実に起きることです。

公式の数値の読み方

本文の32,000と表の64,000／1,000,000を、そのまま既定値と受け取ると誤解します。この PDI では32,000行を超える出力を行っていないため、既定値は確認できていません。上限を変えるなら、値を設定して、実際にシートが分かれる位置を確かめるのが確実です。

①が作成したプロパティ名、②が値の100です。

用語

• シート：Excel ファイルの中の1枚の表。ServiceNow は Page 1、Page 2 と名前を付けて出力する

• XLSX と XLS：新しい形式（XLSX）と古い形式（XLS）の Excel ファイル。プロパティは形式ごとに別々

• システムプロパティ：画面の操作で変えられる設定値。sys_properties テーブルのレコードとして保存される

• 見出し行：各シートの1行目に付く項目名の行。シートが分かれても各シートに繰り返される

確認に使った画面とURL

次の画面は、自分のインスタンスで開くと同じ確認ができます。

• システムプロパティの検索：/sys_properties_list.do?sysparm_query=nameLIKErows.per.sheet

• Excel出力（XLSX）：/sys_choice_list.do?XLSX&sysparm_query=nameSTARTSWITHsys_e^ORDERBYsys_id

• Excel出力（XLS）：/sys_choice_list.do?EXCEL&sysparm_query=nameSTARTSWITHsys_e^ORDERBYsys_id

• CSV出力：/sys_choice_list.do?CSV&sysparm_query=nameSTARTSWITHsys_e^ORDERBYsys_id

検証範囲とおことわり

• 対象は sys_choice の345行1種類です。XLSX は複数の値、XLS は100の1回だけ試しました

• 既定のシート行数（32,000か64,000か1,000,000か）は、32,000行を超える出力をしていないため確認できていません

• 空シートの原因はソースを読んでおらず、挙動からの推測です

• 新規作成の Brazil インスタンスで、プロパティが最初から存在するかは確認していません

• PDF や XML への影響は確認していません。CSV は分割されないことだけを確かめました

• 検証で作成した2つのプロパティは削除し、元の状態（レコードなし）に戻しました

関連記事：テーブルの情報をエクスポートする方法（XML / CSV / Excel / PDF）