1照合・マッピングルールの完全リファレンス

Commonwealが「EDM・業務データ辞書・物理DB・TALON機能」のあいだに繋がりを作る照合ルールの全一覧です。「この列がなぜこのデータドメインに繋がったのか(繋がらないのか)」を突き止めるときはここを見てください。

この章で使う用語

本章の用語は製品画面の欄名とそろえています。

繋がりの全体像

15種の繋がりのうち、日々の記入に直結する主要なものを1枚にまとめると次のようになります。

矢印はすべて出力のたびに製品が自動で作り直します。利用者が維持するのは各層に書いた名前と宣言だけで、対応関係そのものを手作業で更新する必要はありません。

このほかの繋がり(線は描いていません) — #6 EDM間のエンティティ統合 / #10 機能 → 機能(呼出・被呼出) / #11 機能 → メニュー階層 / #12 機能 → 業務分類 / #13 テーブル → 業務分類 / #14 検索条件の集約 / #15 プロジェクトによる絞り込み。いずれも構造や集計のための対応付けで、記入の仕方はこの章の該当する節で説明します。

共通の正規化規則(全照合に共通)

• 完全一致 — すべて大文字化+前後空白除去のうえ完全一致。部分一致・あいまい一致はしません(唯一の例外は下の候補サジェスト)
• 一本道 — 名前は1つの意味に繋がるのが原則です。ただし複数候補に一致したときの扱いは繋がりの向きで違います。解決先を1つに決める照合(#1 EDM属性 → 業務データ辞書と#9 辞書本文 → 辞書)は先頭の1件だけを採用します。逆に、辞書から使用箇所を逆引きする照合(#2 物理列 → 業務データ辞書と#3 画面項目 → 業務データ辞書)は一致したデータドメインをすべて採用し、どちらか一方に絞ることはしません。いずれの場合も重複の存在自体が警告として表出します
• 全角の正規化 — 記法ごとに受理範囲が違います。備考タグは角括弧・コロン・アットマークに加えて全角英数字も半角化(半角に直した名前で見つからないときは書いたままの表記でも照合するので、実テーブル名が全角英数字を含む場合も一致します)、修飾別名とEDM属性宣言は全角ドット(．)だけ、EDMのエンティティコメントの[トークン]は半角角括弧のみです
• あいまい一致は1か所だけ — 「未登録項目」の候補ドメイン提示のみ近似照合(全角→半角・大文字化・空白と記号・_-()[]「」を除去して比較し、完全一致→包含→編集距離で採点、上位2件)。提案するだけで繋がりは作りません

利用者が書ける記法の早見表

繋がりの一覧(何と何を・どの情報で照合するか)

#1 EDM属性 → 業務データ辞書(2段階の名前解決)

照合に使うのは属性のドメイン欄に書いたドメイン名です。属性名は照合に使いません(*ドメイン名のA5M2ユーザー定義ドメイン参照は*を外して解決し、型情報はDomainInfoから補完)。ドメイン欄が空の属性は照合対象外です。上から順に試し、最初に一致したところで確定します。

1. データドメイン名と完全一致 — ドメイン欄「顧客納期」→データドメイン「顧客納期」
2. 物理属性名と照合 — ドメイン欄「初回回答納期」が顧客納期の物理属性名なら顧客納期へ

同じデータドメインを複数エンティティに配置するときは、役割を属性名に書き(「顧客納期(予定)」等)、ドメイン欄にはどちらもデータドメイン名そのもの(「顧客納期」)を書きます。ドメイン欄の値は書いたとおりに照合されます(括弧を含む名前のデータドメインも、そのままの表記で登録・照合できます)。修飾別名(テーブル名.項目名)と照合除外はこの解決に参加しません。解決できない名前は「未登録」として宿題一覧とDomains.html(業務データ辞書索引)に出典EDM名付きで表出します。

記入例(A5:SQL Mk-2の属性欄):

#2 物理列 → 業務データ辞書

照合に使うのはER図に載る各列の物理名と論理名(DBコメントを区切り文字で分割した前半。区切り文字はTALON汎用コードTLN_GENERAL/DB_COMMENT_SEPのDSP1、例■)。

区切り文字を設定していない環境では論理名=コメント全文になり、分類タグ・説明は出ません(既定は未設定)。分類タグは任意の文字列でよく、RESOURCE/EVENT/SUMMARYだけ専用色が付きます。用途はer-diagram.html(物理データベース)の分類バッジ・行の色分け・絞り込みと、ER図ラベル、DomainMatrix.html(マトリクス)の列見出しの色ドットで、並び順やグループ分けには使いません。論理名の抽出では旧運用の末尾[物理名](半角英大文字・数字・アンダースコアのみ)も取り除きます。

1. 照合除外が最優先 — 一致した列は意味の照合宇宙の外(ER図・依存関係には残ります)。除外は接続先(0=主DB/1〜15/ALL)×テーブル(名またはALL)×項目(名またはALL)の3階層で判定します(両方ALLは無効)
2. 修飾別名 — テーブル部=物理名or論理名、項目部=物理名or論理名の全組合せ(最大4通り)で照合。一致したら無修飾は評価しません(専有)。抑制候補はDomains.html(業務データ辞書索引)のℹに参考表出
3. 無修飾の物理属性名 — 列の論理名→物理名の順(論理名でヒットしたら物理名は見ません)。ヒットした名前が複数のデータドメインに登録されていれば、先頭1件に絞らずそのすべてに繋がります。er-diagram.html(物理データベース)の列セルには一致した全データドメインのリンクが並び、画面下部に「データドメイン不整合」の警告が出ます

修飾別名の細則: ドットは1個だけ。スキーマ名.テーブル名.項目名のようにドットが2個以上あると修飾として扱われず、その文字列全体が1つの普通の物理属性名になります(=どこにも当たりません)。スキーマ名は付けないでください。全角ドットは半角に直しますが、テーブル名・項目名そのものを全角で書くと一致しません。前後の空白は除去され、大文字小文字は区別しません。修飾別名は物理列の照合専用で、画面項目・EDMの名前解決・候補サジェストには参加しません。接続先は条件に入らないため、同名テーブルが複数の接続先にあれば全てに一致します。

一致した物理列は、Domains.html(業務データ辞書索引)のカードにデータ型/桁数/主キー/外部キーと参照先が併記されます(DBのカタログから取得した実際の制約です)。

記入例(区切り文字=■の環境):

#3 画面項目 → 業務データ辞書

1. 照合除外が最優先 — 物理名OR表示名で一致すれば対象外。適用範囲は「項目のブロック接続先」×「テーブル=ALL、またはブロックが参照するテーブル」でスコープ。テーブル丸ごと除外(項目=ALL)も適用されます
2. 表示名と物理名の両方を無修飾の物理属性名と照合して和集合を取ります。表示名で当たったデータドメインと物理名で当たったデータドメインが違っても、どちらか一方を選ぶことはせず一致したデータドメインすべてに繋がります。別のデータドメインが2件以上に一致したときは、同時に「複数ドメイン一致(要確認)」として警告に出ます

修飾別名は画面項目には効きません(画面項目はテーブルを1つに確定できないため)。画面項目でも拾いたい名前は無修飾の物理属性名(表示名)を併記してください。

複数のデータドメインに一致したときの表れ方 — 1つに絞られないため、次のように両方(3件以上ならすべて)に載ります。

どちらか一方が採用されて他方が捨てられることはありません。1つに確定させたい場合は、重複している物理属性名をどちらか一方のデータドメインに寄せるか、項目の表示名を具体化してください(修飾別名テーブル名.項目名は画面項目には効かないため、この絞り込みには使えません)。

記入例:

#4 物理項目 → EDM属性(EDM属性の宣言)

この繋がりの両端は「物理項目」と「EDM属性」です。業務データ辞書は宣言を書く場所(物理属性行のEDM属性欄)であって、繋がるのは辞書とEDMではありません。その欄に「この物理項目はどのEDM属性の実装か」を書くと、名前の一致(#1〜#3)と独立に、名前が異なる実装(EDM属性「指定納期」←物理列NOKI)まで確実に繋がります。記法は属性名(無修飾=同名属性を持つ全エンティティ)/エンティティ名.属性名(限定)。

• 区切りに使えるのは半角カンマ・全角カンマ・読点の3つだけ。セミコロンやスラッシュは区切りになりません。改行も区切りではありません(空白1個に畳まれて前後がつながります)
• エンティティ部は論理名(LName)でも物理名(PName)でも一致します。分割位置は最初のドット(修飾別名がドット2個で修飾をやめるのとは規則が違います)
• 大文字小文字と空白のゆれは吸収されます。宣言欄は合計400文字まで
• 登録済みEDMに該当属性が無い宣言は「迷子宣言」警告に。メンテ画面では確定時に似た名前の候補を最大5件提示します
• 宣言先のドメイン欄は宣言元と同じデータドメインに揃えます。別のデータドメインに解決される場合も繋がりは作られますが、EDMページのガバナンス警告「宣言先が別のデータドメイン(EDM属性の宣言)」と辞書メンテの確定時警告でお知らせします(確定は止まりません)。ドメイン欄が空の場合はこの警告は出ません(「データドメイン未設定(属性)」が別に出ます)

記入例(物理属性NOKIの行のEDM属性宣言欄に書く):

宣言は4面に表れます: Domains.html(業務データ辞書索引)の索引カード / EDM.html(業務概念モデル)のレジストリ(属性の実装列) / er-diagram.html(物理データベース)の物理列セル / FuncDoc_*.html(機能設計書本体)のデータドメイン表示。

#5 エンティティ → 物理テーブル/TALON機能

物理テーブルは、エンティティの物理名(PName)が第一候補。加えてエンティティコメントの[トークン]でも紐付けられます(複数テーブル可)。トークンが出力対象環境の機能IDに一致すれば機能への紐付けになります。紐付けたテーブルは「今回の出力で参照されたテーブル+主DBカタログ」で実在確認し、確認できないものは「DB未検出」バッジ(リンク無し)になります。DB方言が判定できず確認自体ができないときは「未検出」と断定しません。

実在確認の範囲: 主DBは、出力対象の機能が参照していないテーブルも含めてスキーマ内を確認します。複数DB接続の外部接続先は、今回出力する機能のいずれかが参照しているテーブルだけが対象です — 外部接続先にしか無いテーブルは、そのテーブルを参照する機能を出力対象に含めたときだけ実在確認できます(含めずに出力すると、実際には存在していても「DB未検出」と表示されることがあります)。実在が確認できたテーブルはer-diagram.html(物理データベース)のテーブル定義へリンクし、DBのテーブルコメントがあれば論理名が併記されます。ただしリンク先に定義が載るのは今回出力した機能が参照しているテーブルだけで、どの機能も参照していないテーブルは実在確認はされますが定義ページはありません。1つも実在確認できないエンティティはガバナンス警告に計上されます。

[トークン]の細則: 角括弧は半角のみ(全角［］は認識しません。備考タグとは異なります)。1つのコメントに複数書け、文章中に埋め込んでも構いません。まず機能IDかどうかを判定し、一致しなければ物理テーブル名として扱います。テーブル名にスキーマ修飾や@接続先番号は書けません。角括弧の部分はエンティティの説明文からは取り除かれます。

記入例(A5:SQL Mk-2のエンティティ「受注」のコメント欄):

#6 複数EDM間のエンティティ統合

複数の.a5erに同じ論理名のエンティティがあればレジストリ上1つに統合されます(属性・テーブル・機能はマージ)。論理名が空なら物理名を名前として使い、比較時は連続空白を1個に詰めて前後を除去します。ここだけは大文字小文字を区別します(Orderとorderは別エンティティ)。統合先に同名の属性が複数あったときは最初に読み込まれたものが残ります。

EDM.htmlの下部にあるEDMレジストリは、上のタブで選択中のEDMのエンティティだけを表示します(属性は統合したまま)。統合されたエンティティは、登場するEDMのタブすべてに同じカードが現れ、カード内に「出現EDM:」でどのEDMに出るかが並びます。件数は「このEDM: N / 全体: M」、「全展開」「全折りたたみ」は表示中のカードにだけ効きます。図やほかのページからエンティティのリンクで飛んだときは、そのカードが載るタブへ自動で切り替わって開きます。

記入例:

#7 機能 → テーブル(依存関係の抽出)

SQL中のスキーマ名.テーブル名は最後の部分(実テーブル名)だけを採用し、"…"/`…`/[…]の引用符も外します。

備考タグの細則: モード文字R/W/WR/RWは大文字小文字不問。それ以外を書いたタグは警告なしで無視されます。テーブル名には半角英数字と_ $ # .に加えて日本語(ひらがな・カタカナ・漢字・長音・半角カナ)や日本語以外の全角文字も使えます。逆に区切り記号は使えません — 半角/全角スペース・カンマ(, ，)・読点(、)・句点(。)・中黒(・)・ハイフン(-)・和文括弧(「」【】等)を含むとタグ全体が無視されます。1タグ1テーブルで、[R:T1,T2]のようなカンマ並記は無効です([R:T1][R:T2]と並べてください)。スキーマ名は付けないでください(付けると物理DBのカタログと突合できず「DB未検出」になります)。全角は角括弧・コロン・アットマークに加えて全角英数字も半角化して受理し、設計書には半角で表示されます。実テーブル名そのものが全角英数字を含む場合は、半角に直した名前で見つからないときに書いたままの表記でも照合します(見つかればリンクが張られER図にも載ります。出典の表示は半角に直した表記のままです)。@の後は半角数字1〜2桁(@0=主DBの明示)。実在確認は帰属した接続先のDBだけで行うため、指定した接続先にそのテーブルが無ければ(接続先が未設定・接続できない場合も含めて)主DBに同名のテーブルがあっても「DB未検出」になります(「#7-2 複数DB接続(ACCESS_DB)の帰属」)。

記入例(機能説明タブの備考欄。文章の中に混ぜて書けます):

夜間バッチから呼ばれる集計処理。 プロシージャ内で以下を参照する。
[R:TLN_M_USER] [W:LOG_TBL@2] [WR:SALES_SUM] [R:受注ヘッダ]

#7-2 複数DB接続(ACCESS_DB)の帰属

TALONの接続先設定は「機能レベル(アプリケーションタブ)」と「ブロックレベル(SELECT式タブ)」の2か所にあり、機能レベルの設定はブロックへは波及しません。

• 主DBを使いたいときはDB接続先を空欄にしてください(0と入力すると「接続先0」という外部接続の指定になります)
• JavaScriptの接続切替は区間で効きます。TALON.getOtherDBConn('2')/getTalonDbConfig()(主DBへ戻す)/getDbConfig()(既定へ戻す)を書いた位置から、次の切替を書くまで(書かなければ末尾まで)がその接続先に帰属します。ifや関数の範囲は見ていません。この区間方式の制限(接続情報を変数で使い分けたときの誤帰属)については、この節の末尾の注記を参照してください
• 接続先番号は半角数字の直書きのみ認識します。変数を渡す書き方(getOtherDBConn(dbNo))では切り替わりません
• 同じ名前のテーブルが複数の接続先に実在した場合だけ、ER図・依存関係タブで接続先ごとに別のボックス・別の行になります
• 実在確認(ER図への掲載・リンク)は、帰属した接続先のカタログだけで行います。指定した接続先にそのテーブルが無いとき、および接続先が未設定・接続できないときは、主DBに同名のテーブルがあっても主DBのテーブルにはリンクせず「DB未検出」とし、依存関係タブにACCESS_DB=Nの接続先バッジを併記します(接続先の指定と食い違うリンクを張らないため)。この場合はER図(.a5er/.sqlを含む)にもそのテーブルは載りません
• 接続先が未設定・接続できないときは、そのDBの製品種別も判定できないため、全設定タブの「DB接続先」は1 (PostgreSQL)のような製品名の併記なしで接続番号だけの表示になります
• .a5er/.sqlは接続先ごとに別ファイルです(主DB=er-diagram.a5er/er-diagram.sql(ER図のA5:SQL Mk-2ファイル/DDL)、外部=er-diagram_ACCESS_DB{N}.a5er/.sql(接続先NのER図のA5:SQL Mk-2ファイル/DDL))。DDLの方言が接続先ごとに違うためです

記入例(JavaScript内の接続切替。区間で効きます)。DBアクセスはTalonDbUtilの各メソッドに接続情報を第1引数で渡すのが正式な書き方です(TalonDbUtil.select(接続情報, SQL文))。接続情報はTALON.getDbConfig()/getTalonDbConfig()/getOtherDBConn('N')で取得します。

/* ここから上は 既定の接続先(機能レベル or ブロックのDB接続先) */
var c0 = TALON.getDbConfig();                                   /* 既定の接続先 */
var rows0 = TalonDbUtil.select(c0, "SELECT * FROM T_ORDER_H");  /* → 既定の接続先 */

var c2 = TALON.getOtherDBConn('2');                             /* ここから接続先2 */
var rows2 = TalonDbUtil.select(c2, "SELECT * FROM EXT_CUST");   /* → EXT_CUSTは接続先2(読み) */
TalonDbUtil.update(c2, "UPDATE EXT_LOG SET SEND_FLG = '1'");    /* → EXT_LOGも接続先2(書き) */

var c1 = TALON.getTalonDbConfig();                              /* ここから主DBへ戻る */
var rows1 = TalonDbUtil.select(c1, "SELECT * FROM TLN_M_USER"); /* → TLN_M_USERは主DB */

#8 宿題一覧の突き合わせ

登録済みの全EDM(.a5er)から属性のドメイン欄のドメイン名+DomainInfo定義名を取り出し、#1と同じ2段階で解決した結果が状態欄になります(修飾別名は参加しません)。

出典EDM名は;連結・名前昇順(合計1000文字を超えると末尾を…で省略)。未登録のデータドメインは300件で打ち切ります。

更新のタイミング(Ver0.53〜): 2段構えです。EDMの中身のカタログ(どのEDMのどの属性にどのドメイン名が書かれているか)はEDMメンテナンスの確定時とセットアップ実行時に作り直し、辞書との突き合わせは宿題一覧を検索するたびにカタログと辞書テーブルから求めます。そのため辞書を画面以外の方法(データベースへの直接更新など)で書き換えても、次に宿題一覧を開いた時点で必ず最新になります。

記入例(状態欄がどう決まるか):

#9 辞書本文からの辞書内リンク([[ドメイン名]])

業務データ辞書の意味4欄(業務的定義/ビジネスルール/導出ルール/暗黙知・運用慣習)の本文に[[名前]]と書くと、Domains.html(業務データ辞書索引)上でそのデータドメインのカードへ飛ぶページ内リンクになります。解決は#1と同じ2段階(データドメイン名→物理属性名)で、物理属性名で書いてもそのデータドメインのカードにリンクします。解決できない名前はリンクにならずグレーで表示され、「まだ書いていないデータドメインへの参照」が目で分かります。

• 有効なのは上記4欄だけです(備考欄などに書いてもただの文字になります)
• 機能設計書のデータドメインタブの1行要約では、括弧が外れた素の文字で表示されます
• meta/Domains.md(業務データ辞書索引のMarkdown版)には[[ ]]を書いたまま出力します(AIがデータドメイン同士の関係をたどれるように)

記入例(「回答納期」の意味4欄に書く):

#10 機能 → 機能(呼び出し関係と被呼び出し)

TALONの機能設定に書かれた呼出先の機能IDを完全一致で解決し、呼出先の機能名と呼出元の項目を併記します。対象は 他画面呼出(BUTTON_NEXT) / 他機能呼出(OTHER_FUNC) / 検索子画面(SUB_SEARCH・SEARCH_FUNC_ID) / LOOKUP / SUGGEST / 選択肢リスト / 処理呼出(BUTTON_BAT) / グラフ参照 / 他ブロック機能 / マスタチェック です。

被呼び出し(逆引き)も表示します。逆引きは環境内の全機能を対象にするため、今回の出力対象に選んでいない機能からの呼び出しも見つかります。呼出先が出力対象外なら名前だけの表示になります。

記入例:

#11 機能 → メニュー階層(FunctionTree)

FunctionTree.html(機能依存ツリー)の階層は業務分類ではなくメニュー登録から作ります。メニューの階層パスを//で区切って最大2段のグループにし、表示名はメニューグループ名→権限マスタの名称の順に解決します。メニューに登録されていない機能は「メニュー未登録機能」にまとめられます。各機能の下には#10の呼び出し関係が種別ごとに展開されます(最大20段、循環は検出して停止)。なおmeta/FunctionTree.md(機能依存ツリーのMarkdown版)だけは業務分類(大→中→小)の入れ子で出力し、HTML版とは階層の作り方が異なります。

記入例:

#12 機能 → 業務分類 / #13 テーブル → 業務分類

機能のBG_L/BG_M/BG_Sのコードを、TALON汎用コードTLN_GENERAL_BG_L/_BG_M/_BG_SのKEY_CODEと突き合わせ、DSP1を分類名として表示します。汎用コードに無いコードはコードのまま素通しです。FunctionList.html(機能一覧)は「大|中|小」の組合せごとのフラットなセクションで、並びは各段のコード昇順(未設定は末尾)。

記入例(#12):

物理テーブルには業務分類の設定欄がないため、そのテーブルを書き込む機能の業務分類のうち最も多いものを割り当てます(マスタは「メンテナンスする側」に属させる方針)。書き込む機能が無ければ読む機能の最頻値、どちらも無ければ「未分類」です。er-diagram.html(物理データベース)の並び・グループ見出しとDomainMatrix.html(マトリクス)の行/列の並びに使われます(テーブル分類タグとは別物です)。

記入例(#13):

#14 検索条件の集約

TALONは複数のブロックにまたがる検索条件を実行時に1つの入力欄にまとめます。設計書もこれに合わせて集約します。集約の根拠は同じ物理項目名(別ブロックでも1つに)とJOIN設定で対にされた項目の2つ。グループの代表項目はブロック番号が最も小さく、その中で表示順が最も早い項目で、設計書にはこの代表の表示名が載ります。検索子画面(SUB)で検索条件の指定が1つも無い機能では、キー項目を検索条件とみなします。

記入例:

#15 プロジェクトによる絞り込み

プロジェクト欄には汎用コードTLN_FUNC_DOC_PROJECTのKEY_CODEが入り、複数所属はチェックボックスの区切り文字(汎用コードTLN_GENERAL/CHECKBOX_SEP、既定;)で連結されます(例PJ01;PJ02)。空欄=共通で常に出力。選択と行の値は大文字小文字を区別して照合します(前後の空白は除去)。物理属性にはプロジェクト欄が無く、親のデータドメインが絞り込みで外れると物理属性も照合・サジェスト・警告のすべてから外れます。選択したプロジェクトはindex.html(ハブ)とmeta/INDEX.md(AI向けMarkdownの目次)に記録されます。

記入例(辞書/EDMのプロジェクト欄の値と、出力時の選択):

入力中の絞り込み(EDM属性のサジェスト) — 業務データ辞書メンテナンスのEDM属性欄に出る候補も、開いているデータドメインのプロジェクトで絞られます。候補になるのはそのプロジェクトに属するEDMとプロジェクト欄が空(共通)のEDMの属性だけで、別プロジェクト専用のEDMの属性は出ません。複数のプロジェクトに所属するデータドメインでは、それぞれのプロジェクトのEDMの属性が和集合で候補になります。データドメインのプロジェクト欄が空のときは絞り込まず、登録済みの全EDMの属性が候補になります(従来どおり)。同じ属性名が複数のEDM・複数のエンティティに現れても候補は1件だけです。

補足: コード → 表示名の解決(共通ルール)

業務分類(TLN_GENERAL_BG_*)/責任部門(TLN_FUNC_DOC_DEPT)/辞書種別(TLN_FUNC_DOC_DOMAIN_KIND)/プロジェクト(TLN_FUNC_DOC_PROJECT)は、いずれも汎用コードのDSP1を表示名として使い、汎用コードに無いコードはコードのまま素通しします。英語出力でDSP2を見るのは辞書種別だけで、他は英語の設計書でもDSP1の値がそのまま出ます(英語名で出したい場合はDSP1自体を英語で登録してください)。

照合除外の登録画面

作成日時・更新者のようなシステム列は意味の照合対象にしたくないことが多いので、照合除外に登録します。除外しても設計書のER図やテーブル定義からは消えません。「意味の照合の宇宙から外す」だけです。

• 照合除外登録 — 機能を検索するとその機能群が参照するテーブル・列が一覧になり、チェックして「除外登録」で一括登録できます
• 照合除外メンテナンス — 登録済みの除外を一覧で編集します。接続先・テーブル・列それぞれにALL(串刺し)が使えます。行の追加・削除・コメントの編集とALL行の編集はこちらで行い、禁止の組合せ(テーブルと項目の両方がALL)・接続先の形式・重複は確定時に検証されます

登録画面の中身 — 設計書出力と同じ発想で、検索条件に一致するTALON機能を抽出し、その機能群が実際に参照しているテーブル・列だけを一覧します(DBやSaaSのカタログを全走査はしません)。数千テーブルある接続先でも業務で使っているテーブルだけが対象になり、これは照合が効く母集団そのものでもあります。

• 機能の検索条件を1つも指定しない検索は実行されません(全機能の走査に時間がかかるため)。絞り込みを促すメッセージが出て一覧は空のままになるので、機能ID・機能名・アプリケーション区分・業務分類・機能概要のいずれかで対象を絞ってから検索してください
• テーブル別タブ — テーブル×列の一覧です。そのテーブルを参照している機能の数(参照機能数)も出ます。チェックON→「除外登録」で登録、チェックを外して「除外登録」で解除です
• 列名別タブ — 列名の一覧(出現テーブル数つき)。チェック1つで串刺し(ALL)登録ができます。更新日時系のシステム列はここから登録すると効率的です
• 一覧は除外中の行が上に並びます。「除外中」+チェック済みはこの画面で登録した完全一致の除外(解除できます)、「除外中(パターン)」+非活性はALLパターンに覆われている行で、解除はメンテナンス画面で行います
• 一覧の物理テーブル名・物理項目名は大文字に統一して表示されます(実名が小文字のDBでも、除外の登録・照合は大文字で統一しているためです)。DBの照合順序が半角/全角や大文字小文字を同一視する設定のときは、DBが同じ名前とみなす列が1行に集約されます
• 機能が参照していてもDBに実在しないテーブル(列のメタデータが取れないもの)は一覧に出ません。テーブル丸ごとの除外はメンテナンス画面で登録してください
• 取得の上限は機能500件/テーブル300件(全接続先の合計)/表示5,000行です。超えると警告が出るので、機能の検索条件で絞り込んでください

成果物・画面別: どの照合結果がどこに出るか

ER図ダウンロードファイル(.a5er/.sql)の出力仕様

er-diagram.a5erは、A5:SQL Mk-2でそのまま開けるネイティブ形式で出力されます。

• 用紙サイズの自動選択 — テーブル配置の広がりに応じて、A4横→A3横→A2横→A1横のうち収まる最小の用紙が自動で選ばれます(テーブル数が多いER図でも用紙の外へはみ出しません)
• 索引(インデックス)の出力 — 実DBから取得した索引(主キー以外)がテーブル定義に含まれ、A5:SQL Mk-2上で確認できます。er-diagram.html(物理データベース)の各テーブル詳細にも「索引」一覧がUNIQUE表示付きで併記されます(対応DBはOracle/PostgreSQL/MySQL/SQL Server。取得できなかった場合は索引なしとして続行します)。ユニーク制約に基づく索引は通常のUNIQUE索引と区別して表示され(「UNIQUE制約」バッジ)、DDL(.sql)ではALTER TABLE ADD CONSTRAINTとして出力されます(DDLの実行時に制約として復元されます)
• 論理名と補足の分割 — DBのテーブル/列コメントが「論理名{区切り}補足説明」の形式(TALONがテーブル作成時に付ける形式)の場合、A5:SQL Mk-2の論理名には区切りより前の論理名だけが設定され、補足説明はコメントとして出力されます(論理名が長大になるのを防ぎます)

接続先ごとにファイルが分かれる規則は#7-2を参照してください。

警告リファレンス(整合性・ガバナンス警告)

業務データ辞書とEDMは「名前で意味へ遡る」仕組みのため、名前の重複・未設定・実装とのズレを警告として表出します。警告は誤りの断定ではなく「腐敗が隠れられないようにする照明」です — 保存や出力が止まることはありません。ここでは、どこにどんな警告が出るか、どう読むか、どう対処するかをまとめます。

警告の全体像(どこに出るか)

登録時の警告 — データドメイン名称の同名(✗エラー)・データドメイン名称が他のデータドメインの物理属性名と同じ(⚠警告)・物理属性のドメイン間重複(⚠警告)・別プロジェクトとの同名や同名の物理属性(ℹ参考情報)の4つは、判定条件と対処をユーザーマニュアルの4章とユーザーマニュアルの5章に書いています。名称の同名だけが確定を止め、あとの3つは保存したうえでの注意喚起です(意図的な移行中などの判断は利用者に委ねる設計です)。

「データドメイン名称が他のデータドメインの物理属性名と同じ」は、#1の2段階の名前解決と直結する警告です。名前解決は①データドメイン名称と完全一致→②物理属性名と照合の順に見るため、新しく登録する名称が既存のデータドメインの物理属性名と同じだと、これまで②でそのデータドメインに解決されていた名前を①が先に横取りします(その名前で引かれていた画面項目・EDM属性の行き先が、保存した瞬間から新しいデータドメインへ移ります)。メッセージには相手のデータドメイン(名称・コード・プロジェクト)と一致した物理属性名が出るので、①相手のデータドメインを開いて書き足す、②名称をより具体的にする、のどちらかを検討してください。別の概念であればそのまま登録して構いません(この警告は確定を止めません)。プロジェクトが重ならない相手は同じ出力に同居せず名前解決に影響しないため、ℹ参考情報に格下げされます。業務データ辞書記入・業務データ辞書メンテナンスのどちらで確定しても同じ判定が働きます。

出力時① 機能設計書のデータドメインタブ(⚠複数ドメイン一致) — 同じ名前が複数のデータドメインに登録されたまま出力すると、影響を受けた機能のデータドメインタブにサマリバナーと、該当項目への⚠マークが表示されます。⚠の数字は「この項目が一致した他のデータドメインの数」で、マウスオーバーで候補の名前が表示されます。同じ項目が複数のデータドメインのカードの下に並ぶため、「どちらの意味なのか」を読み手が判断できない状態であることが分かります。

出力時② 業務データ辞書索引の辞書整合性警告 — Domains.htmlの上部には辞書整合性警告がまとまっています。名前レベル(どの物理属性が重複しているか)と影響箇所レベル(その結果どの機能のどの項目が曖昧になっているか)の両方が出ます。「複数ドメイン一致の画面項目」は、登録時の警告を承知で保存した重複が実際にどこへ影響しているかを示します。機能名/ブロック/項目のリンクから該当箇所へ、候補のデータドメイン名のリンクから各カードへ遷移できます。根本の対処は重複の解消です。項目名が汎用的すぎることが原因の場合は、TALON設定側の表示名を具体化することも検討してください。

「同名のデータドメインが複数プロジェクトに存在」は、プロジェクトが重ならない同名(登録時に警告付きで作れるもの)が、複数のプロジェクトを同時に選んだ出力・プロジェクトで絞らない出力で同居したときに出ます。名前解決はデータドメインコード昇順の先頭1件だけを採用するため、どちらが採用されどちらが無視されたかを、それぞれのプロジェクト名とともに一覧します。出力時にプロジェクトで絞り込めば同居しません(絞り込んだ出力ではこの警告は出ません)。絞り込まずに1つの出力へまとめたい場合は、どちらかの名前を具体化してください。

出力時③ EDMのガバナンス警告 — EDM.htmlのガバナンス警告には、.a5erと辞書・実DBの突き合わせ結果が上の表のカテゴリ別に表示されます。レジストリと同じく上のタブで選択中のEDMの警告だけが表示され、カテゴリごとの件数は選択中のEDMでの件数、全体の件数は見出しに「このEDM: N / 全体: M」で並びます(複数のEDMにまたがる警告は該当するタブすべてに現れ、警告が1件もないタブにはその旨を表示します)。「同名異義の属性(注意)」は、2つ以上のエンティティで同じ属性名が異なるデータドメインに割り当てられている場合に表示されます。誤りとは限りませんが(エンティティごとに意味が違う正当な設計もあります)、読み手の誤読を防ぐには「顧客納期(予定)」「顧客納期(実績)」のような括弧修飾での区別が有効です。「宣言先が別のデータドメイン」は#4を参照してください。

出力時④ 物理データベースのデータドメイン欄と未登録警告 — er-diagram.htmlの各テーブルの列一覧にある「データドメイン」欄は、3つの状態で表示されます。

1. 辞書に一致した列 — 業務データ辞書索引の該当カードへのリンクになります(複数のデータドメインに一致した場合は⚠が付き、「データドメイン不整合」警告に計上されます)
2. 照合除外に登録済みの列 — 「照合除外」バッジが表示されます(マウスオーバーで適用された除外のパターン=接続先/テーブル/列を確認できます)
3. どちらでもない列 — 「⚠未登録」バッジが表示されます

未登録の列は、ページ下部の「データドメイン未登録の物理列(N)」に論理名(テーブル/項目)付きで一覧され、クリックで該当列の行へジャンプできます。この一覧が警告を消し込む起点になります — 業務項目なら辞書に登録(または既存のデータドメインへ物理属性を追加)、作成/更新日時などのシステム列なら照合除外に登録すると警告が消えます。「データドメイン不整合」「スキーマ整合性チェック」の警告も、同じくページ下部にまとめて表示されます。

警告との付き合い方(推奨サイクル)

1. 出力のたびに件数を見ます — 前回より増えていたら、何かの名前・構造が変わったサインです(ズレの検出)
2. 未登録項目は「次に意味を書くべきものリスト」 — 候補サジェスト(似たデータドメインの提示)を手がかりに、辞書への登録または既存のデータドメインへの物理属性の追加で消し込みます
3. 技術項目は辞書種別「その他(警告対象外)」へ — 排他制御用の列などは警告のノイズを抑える登録にします
4. 警告ゼロ=辞書と動いている実装が一致した状態 — この状態を維持することが、設計書とAIに渡すコンテキストの信頼性を支えます

2テーブル構成 (ER 図と項目説明)

セットアップの「処理実行」が作成するテーブルは7つです。バックアップ対象の把握や、他システムからの参照(読み取り)にお使いください。ワークテーブル3つは製品が自動管理するため、直接編集する必要はありません。

TLN_M_FUNC_DOMAIN — 業務データ辞書(データドメイン)

TLN_M_FUNC_DOMAIN_ATTR — 物理属性名

TLN_M_FUNC_EDM — EDMの登録台帳

TLN_M_FUNC_DOMAIN_EXCL — 照合除外の宣言

ワークテーブル(自動管理)