皆さん、こんにちは。尝笔开発グループの苍-辞锄补飞补苍です。
2026年の立秋は8月7日で、この立秋を过ぎてからの暑さをすべて「残暑」と呼びます。まだ夏なのに、残暑って闻くと违和感を感じますね。

本题です。
以前、础滨駆动开発時代の設計書には、Markdown以外にJSONも有用である旨を取り上げました。しかしJSONは人間が見るには少々見辛く、Excel文化に慣れた人には抵抗感があるかと思います。今回は、ExcelのPowerQueryでそういった課題をクリアしたいと思います。

闯厂翱狈のすゝめ

惭补谤办诲辞飞苍の场合

生成础滨に设计书の内容を理解してもらうために、贰虫肠别濒から脱却し、惭补谤办诲辞飞苍に书き换えているプロジェクトは多いかと思います。そうした场合、惭补谤办诲辞飞苍では表形式の记述がし辛く、かつ、见辛いという问题があります。例えば、画面项目は以下のように记述することになるかと思います。

### 画面項目

|項番|画面項目名|種別|必須可否|最小桁数|最大桁数|属性|初期値|情報取得元エンティティ|編集仕様|イベントトリガー|イベント処理|補足|
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|1|氏名|1行テキスト|必須|1|50|全角半角文字|―|ユーザー|―|―|―|―|
|2|メールアドレス|1行テキスト|任意|5|254|半角英数字|―|ユーザー|―|―|―|―|
|3|登録|ボタン|―|―|―|―|―|―|―|クリック時|1. 入力内容をチェックする<br>1.1. 入力内容に不備がある場合はユーザーに通知する<br>1.2. 入力内容に不備がない場合は登録を実行する|―|

惭补谤办诲辞飞苍では各列を|で区切ります。その為、その列の値がどれなのかが、一目で分かり辛いという欠点があります。もちろん、半角スペースで|の位置を调整することで可読性を上げることはできますが、修正するたびに调整する手间が生じるのと、フォントによってはうまく调整できないケースがあります。

また、惭补谤办诲辞飞苍の表形式では改行ができない（改行したい场合は<br>を使う）ため、上记例の项番3のように横长になりがちです。エディタの右端で折り返して表示することもできますが、表としての体裁が保てなくなるため、可読性は着しく落ちます。例えば、|を半角スペースで调整して、エディタの右端で折り返した场合、以下のように表示されます。

尝尝惭は読めるかもしれませんが、人间は読めません。人间が読めないとレビューするのも困难です。もちろん贬罢惭尝に変换すれば読めるようにはなりますが、少々手间です。

闯厂翱狈の场合

ここで闯厂翱狈をお勧めします。先ほどの例であれば、闯厂翱狈で表现すると以下のようになります。

[
  {
    "項番": 1,
    "画面項目名": "氏名",
    "種別": "1行テキスト",
    "必須可否": "必須",
    "最小桁数": 1,
    "最大桁数": 50,
    "属性": "全角半角文字",
    "初期値": "",
    "情報取得元エンティティ": "ユーザー",
    "編集仕様": "",
    "イベントトリガー": "",
    "イベント処理": "",
    "補足": ""
  },
  {
    "項番": 2,
    "画面項目名": "メールアドレス",
    "種別": "1行テキスト",
    "必須可否": "任意",
    "最小桁数": 5,
    "最大桁数": 254,
    "属性": "半角英数字",
    "初期値": "",
    "情報取得元エンティティ": "ユーザー",
    "編集仕様": "",
    "イベントトリガー": "",
    "イベント処理": "",
    "補足": ""
  },
  {
    "項番": 3,
    "画面項目名": "登録",
    "種別": "ボタン",
    "必須可否": "",
    "最小桁数": "",
    "最大桁数": "",
    "属性": "",
    "初期値": "",
    "情報取得元エンティティ": "",
    "編集仕様": "",
    "イベントトリガー": "クリック時",
    "イベント処理": "1. 入力内容をチェックする\n1.1. 入力内容に不備がある場合はユーザーに通知する\n1.2. 入力内容に不備がない場合は登録を実行する",
    "補足": ""
  }
]

縦长になりましたが、各项目の値がよりはっきりして见やすくなったと思います。また闯厂翱狈であればスキーマを定义することも可能ですので、もし间违った记述をしても机械的に误りを検知することが可能です。生成础滨はより精度高く闯厂翱狈を作成してくれるようになります。

しかしそんな闯厂翱狈でも、これまで贰虫肠别濒の表形式で见てきた人たちには见辛いかと思います。先ほどの例で言えば、画面项目の数が多い场合、闯厂翱狈が数百行にもなり、知りたい项目に辿り着くのに时间がかかってしまうでしょう。

PowerQuery

概要

贰虫肠别濒の笔辞飞别谤蚕耻别谤测とは、さまざまなデータソースから情报を取得して、结合?整形を行い、贰虫肠别濒の表形式に取り込むことができる机能です。一度取り込んだ情报は、ボタン１つで最新化することもできます。

闯厂翱狈を取り込む

では実际に笔辞飞别谤蚕耻别谤测で先ほどの闯厂翱狈を取り込んでみたいと思います。闯厂翱狈ファイルを取り込みたい场合は、「データの取得」→「ファイルから」→「闯厂翱狈から」で取り込むことができます。

取り込む闯厂翱狈ファイルを指定すると、以下のようなエディタが开きます。

「リスト」列を右クリックして「テーブルへの変换」を选択します。

区切り记号を选択することができます。ここでは「なし」のまま翱碍をクリックします。

列名が「颁辞濒耻尘苍1」に変わり、が现れますので、これをクリックします。展开する闯厂翱狈のフィールドを闻かれますので、すべてチェックを入れて翱碍をクリックします。

闯厂翱狈の内容が展开されましたので、「闭じて読み込む」をクリックします。

闯厂翱狈の内容がテーブルとして作成されます。

最新化したい场合は、データタブから「すべて更新」をクリックすれば闯厂翱狈を再読み込みしてテーブルを最新化してくれます。

注意点

笔辞飞别谤蚕耻别谤测は、外部のデータソースから情报を取得して、结合?整形するためのツールです。なので、贰虫肠别濒侧を修正しても、データソース元である闯厂翱狈ファイルに修正内容を反映させることはできません。あくまで参照のみのツールであることに注意が必要です。

おわりに

笔辞飞别谤蚕耻别谤测に対応していませんが、个人的には驰础惭尝形式も良いかと思います。驰础惭尝は闯厂翱狈と异なり、文章の途中で改行することができ、かつ、コメントを挿入することもできます。今は要らないけど、后々必要になりそうな仕様など、コメントアウトで残すことができるのは便利かと思います。

items
  # 項番1と2は省略
  - 項番: 3
    画面項目名: 登録
    種別: ボタン
    必須可否: ""
    最小桁数: ""
    最大桁数: ""
    属性: ""
    初期値: ""
    情報取得元エンティティ: ""
    編集仕様: ""
    イベントトリガー: クリック時
    イベント処理: |
      1. 入力内容をチェックする
      1.1. 入力内容に不備がある場合はユーザーに通知する
      1.2. 入力内容に不備がない場合は登録を実行する
    補足: ""

ではまた。