Designer：要件の汲み取り方

期待する出力結果から判断する。

xoBlos で開発を行う際、要件が専門的で何を行えば良いか困惑することがあります。要件を提示する側とて、表現が困難な場合もあります。そのような時は一つの手段として、先ず期待する出力結果（帳票）から要件を汲み取ることをお勧めします。入力データにしろ出力データにしろ、「開発側の観点」「要件を提示する側の観点」は必ず分かれるものですが、お互いの認識一致への近道には、成り得る筈です。

例えば上図 2つの入力データ――「主データを基に副データに対する直積情報を出力して欲しい」と挙げられた際に、困惑するパターンはどういうものがあるでしょうか。「直積は分かるけれど、xoBlos でどう組めば良いのだろう‥‥」「直積って何！？」等が挙げられるのではないでしょうか。

前述の 2パターンは、有識者に事前確認しても何ら差し障りは無いかもしれませんが‥‥。期待する出力結果があって xoBlos の機能も理解していれば、たとえ「直積」を知らずとも、たとえ要件に「直積」が挙げられていなかったとしても、開発に取り掛かることができるのです。

複数の入力データがあり、一方が「基」となるデータであるとすると、大抵もう一方は『追加入力』或いは『変換入力』の活用を思い付く方もいらっしゃることでしょう。しかし 2つの入力ファイルは、お互いにマッチさせる要素（キー値）が何もありません。

出力結果から、それぞれのデータがどういう状況（出力単位）であるのか注意深く見ていくと‥‥。主データの 1 情報は副データの全件分、"繰り返し" と "固定" で情報を紐付けています。いずれも、xoBlos に存在する機能やキーワードになりますね。

繰り返すとは言え、一度生成した結果シートに連結して、次のデータを生成することはできません。ここではそれぞれの結果をシート分けすることにします。（このような手段もありますが‥‥）

ここまで来れば後は簡単ですね。中間データとして生成したブックに対し、全シートを抽出しましょう。中間処理にはもう慣れましたか？複数シート抽出の注意点も、復習しておきましょう！

Designer：生成時の「Sheet1」

参照されることが多い記事だったので、次の記事にタイトルを変えて再掲しました。 Designer：既存ブック、シートに生成する https://xoblos.hatenablog.jp/entry/2020/09/20/182747

---

「Sheet1」って？

上図は、単純な新規生成処理で取り扱われるシート達です。制御シートの設定内容と、雛形シートの最低限のレイアウトを基に、結果シートが作成されます。通常、新規生成要件の場合はこの三つのシートの内、「制御シート」と「雛形シート」を同一のブックに用意します。そして「結果シート」は、業務ファイル（.xob）の『出力設定』に新しいブックのシートとして設定しますね。

xoBlos に新しいブックを作成させるのは、上図のように普段、私達が手動で空白のブックを新規作成するのと同じことになります。Excel の設定によって変わりますが、新規作成時には必ず「Sheet～」のシートがいくつか用意されます。Excel の仕様上、シートが一枚も存在しないブックという形態は、作ることができないのです。その為 xoBlos では、結果シートに最低一枚の「Sheet1」が作成される仕様になっています。

既存ブック生成という手段

新規ブック生成と既存ブック生成は、上図のように設定が変わってきます。後者は、生成キーワード『区分』に分類や見出しで設定した入力項目の値と、ブック上の値をマッチングさせる時に使いますね。

さて、よく考えてみましょう。既存のブックは帳票や資料、つまり元々は私達が手動で作成したものであり、空の「Sheet1」等も無く、必要なシートしか存在しないことが殆ど。‥‥ということは、新規ブック生成の際にも、必要最低限のシートしか持たない既存ブックに対し、既存ブック生成の設定方法で生成させれば、「Sheet1」が残る問題は解消されることになるのです！

業務ファイル（.xob）の在り方
手順１：予め雛形シートしか無いブックを用意し、出力先へコピーしておく。
手順２：既存ブック生成の方法で、コピーしたブックを雛形として生成を行う。

なお、「雛形シートと既存ブックのシートが同じ名前で、業務ファイルの『c.ひな形シート名』項に設定したら、どちらのブックが優先されるの？」という疑問にお答えしますと、前者の雛形シート（制御シートも持ったブック）の方が優先されます。

corabo＋Designer：外から渡すパラメータの限界文字数って？

限界文字数は取り扱い先で決まる。

xoBlos の業務に於いて、参照元も参照先も、足りない情報があればユーザ自らが xoBlos を通して伝えなければなりません。その為に、業務実行時のユーザ定義変数（パラメータ）というものが用意されています。

さてこの変数ですが、結局の所何文字まで入力することができるのでしょうか。‥‥無限、は正確な答えではありません。具体数値も決定できません。何故なら‥‥何文字入力できても、取り扱い先で取り扱えなければ不正でしかない為です。

Excel のセル内に出力させる：32767 文字（Excel   の仕様）
Excel のシート名にあて込む：   31 文字（Excel   の仕様）
参照パス／ファイル名に使う：  234 文字（Windows の仕様）

xobQuery＋Excel：異なるバイト文字の存在をチェックする

全体の文字／バイト数を比較する。

値のチェックは、前回記事のように中間処理を設けるのが適当です。必要な情報は、対象となる値の文字列数とバイト数の 2つ。――そこに差があれば、全角と半角の入り交じりは確定し‥‥その比較結果を保持する為に、1列だけ変数項目（お皿）を用意しなければなりませんね。

制御シート（生成～抽出）

雛形シート上に 1列（上図の列「B」）、そのお皿なる列を設けておきましょう。Excel 関数「LEN」は、対象（上図の列「A」）の文字の桁数を得ます。逆に Excel 関数「LENB」は、対象の文字のバイト数を得ます。Excel 上で、半角文字（半角カナを含む）は 1バイト、全角文字は 2バイトで数えます。これで列「B」も抽出に含めれば、条件付けすることができますね。

‥‥しかし残念なことに、バイト数を取り扱う関数（「LENB」「MIDB」「FINDB」「SEARCHB」等）は、現在の抽出高速エンジンには対応していません。（生成高速エンジンで出力することはできますが、それを正しく抽出できません。）処理速度が遅くなっても良い場合は、お勧めする方法です。

xobQuery

SQL に慣れている方には、上図方法をお勧めします。xobQuery は XML to XML なので、中間処理としましても 1手順で済みます。

構文「HEX」は、括弧内の文字列の文字コードを 16進数で返します。半角文字（半角カナを除く）は、一文字につき 16進数コードで 2桁を表します。その為、「2」で除算しています。半角のみなら文字列数とマッチしますし、全角が混在していればマッチしません。

Designer：累計／累積データの取り扱い

前回データと今回データを連結させる。

上図のように、今回生成するデータを常に前回生成した最終データの直後に追加出力するという要件は、結構挙げられます。xoBlos は、こういった累計／累積を成す帳票要件に対し、①前回出力結果の抽出、②今回入力データの抽出、③①と②を連結して基本入力データとして 1から生成――の工程を基本としていますので、覚えておきましょう。③部分は、前回記事にて復習してください。

前回データ抽出の懸念

さて、前節までの基本事項を意識すると「それでは前回までに出力されたデータが膨大な量であったら、処理時間に影響が及ぶのではないか。」というご意見が挙げられることでしょう。‥‥もっともではありますが、xoBlos の生成で、データの繰り返しがある場合に設定が必須になるキーワード『行（列）ひな形の左上』の仕様上、どうあっても今回実行分の付け足しのみ――という作りは、通常のやり方では実現不可能なのです。

生成結果に沿って、上図のような雛形シートを用意するのは適当ですが、次回実行も考慮すると他に何が必要でしょうか。‥‥ 業務を実行して、参照されるデータ件数が常に変動する場合、xoBlos が大事にしている左上～右下を特定するのに、前回の最終データが出力された場所を判断できる印を用意しなければなりません。その場合、常に参照先が固定になる Excel の標準機能『名前定義』が活躍することになりますが‥‥

前節までに用意した雛形シートの、どの位置へ定義したとしても、ひな形行／列が消える以上、必ず使い続けられない問題に直面します。

‥‥しかし上図、名前定義をひな形行より下にしている後半 2つのケースをじっくり見ていると、共通の何かが言えることになります。それは‥‥「名前定義を置いた行の直前行さえ、毎回残っていれば良いのに！」

上図、内容だけ素直に注目すると何事かと思われるでしょう。‥‥前節から、今必要としているのは空白一行です。‥‥では、入力データ（.xml）に空のデータが一つあれば、空の行が出せるのではないでしょうか。ダミーの意味で空のブックを制御シートと同じところにセットし、抽出対象としてしまいましょう。列項目は制御シートの設定から「ID」「Desc」と揃えられ、抽出対象のブックは空っぽなので値は Null がどちらとも入ります。

冒頭とは変わり‥‥今回データと前節の空のデータを連結して、基本入力データとして生成してみましょう。期待する結果は満たせていません（空白行が常に出力されて見栄えが悪くなっています）が、抽出も生成も同じ制御シートで、前回データを一度も取り扱うことなく、累計／累積表を出力することができるようになります！

出力する順序どおりに基本入力ファイルを設定すれば、連結する必要はありません。

Designer＋Windows：項目数が不揃いなCSVレコードの合成

EDI（電子データ交換）などではよく見かける、ヘッダーレコード、ボディ（本体）レコード、トレーラーレコードの3部構成仕様のCSVレコード（テキスト＋カンマ区切りレコード）があったとします。

0,5
1,apple,リンゴ
1,banana,バナナ
1,cat,ネコ
1,dog,イヌ
1,egg,タマゴ
2

上記の例だと、第1項目がレコード区分で、"0" のときヘッダーレコード。"1" がボディレコード、"2" がトレーラーレコードです。ヘッダーレコードの第2項目には、ボディレコードの件数が記載されています。

このような項目数が不揃いな（カンマの個数が不揃いな）CSVレコードの合成には、外部アプリでtypeコマンドを実行させる方法が簡便です。

 

mix.bat の内容

type header.csv > all.csv
type body.csv >> all.csv
type trailer.csv >> all.csv

[bat] フォルダにmix.batというバッチファイルを用意しておき、その前手順で、3種類のCSVレコードを [bat] フォルダに名前を変えてコピーしておきます。

header.csv　… レコード区分 "0" のヘッダーレコード

body.csv　… レコード区分 "1" のボディレコード

trailer.csv　… レコード区分 "2" のトレーラーレコード

外部アプリとしてmix.batを実行すると、合成されたall.csvが出力されますので、次手順で出力したい場所に名前を付けてファイルコピーします。

typeコマンドのコツは、1種類目を > でそのままリダイレクト出力し、2種類目以降を >> で追記（アペンド）モードでリダイレクト出力する点です。

corabo：ネットワークドライブ指定の注意点_二の太刀

管理者権限設定の壁。

前回記事で、管理者としてネットワークドライブの割り当てを行うことで、ファイルやフォルダのパス指定にネットワークドライブが設定できるようになるお話をしました。ところが下図のように――

‥‥マシン本体を再起動すると、利用不可になってしまいます。

管理者以外で設定したネットワークドライブは、暫く待てば接続を行ってくれますが‥‥。管理者として設定したそれは、起動の都度設定を行う必要があるようですね。

しかし、わざわざコマンドプロンプトを管理者として実行し、コマンドをカタカタ入力するのは非常に手間です。共通のコマンド処理というのは、本件に限らず「バッチ処理化」することが望ましいもの。そう聞くと、何やら難しそうなイメージを持つ方もいらっしゃるかもしれませんが‥‥何ということはありません、入力する内容を予めテキストファイルに記載しておき、それを実行ファイルとしてしまうだけです。

メモ帳などで作成するにしても、保存の際にはファイル拡張子を「.bat」にすること、忘れないようにしましょう。

さて、上図が基本的な「バッチ処理化」の作成方法ですが‥‥今回の場合は、"管理者として" というキーワードがもう一工夫を求めてきます。何故なら、上図はあくまで管理者以外で設定したバッチファイル――つまり、コマンドプロンプトを通常の方法で起動し、コマンドをカタカタ入力して実行させていることと、全く同じであるからなのです。

"管理者として" バッチ処理を行わせるには上図の設定が要ります。先ず青枠のように、前述までで作成した .bat ファイルのショートカットを作成し、プロパティを起動します。続いて赤枠のように、プロパティ内の「詳細設定(D)...」ボタンを押下し、「詳細プロパティ」を起動します。最後に緑枠のように、「管理者として実行(R)」をチェックオンにします。これで、作成したバッチ処理内容を管理者として実行する前提が、付加できました。このショートカットは、ダブルクリックするだけで一連の設定を行ってくれます。ショートカットその物を、タスクスケジューラでスケジューリングしてしまえば、それこそ自動起動も実現しますね。

残念ながら、マシン起動時のネットワークドライブの接続は、グループポリシーの設定で「コンピュータの起動及びログオンで常にネットワークを待つ」を有効にしたとしても、効果は無いようです。マシン起動から接続の待ち時間を設けたとしても、ステータスが「利用不可」となったドライブは、いつまでも接続が行われることは‥‥決して無いでしょう。