メインコンテンツへスキップ

仕様ナビゲーションインデックス

ポーター(移植担当者)とレビュアー向けのクロスリファレンス表です。各行は言語/評価モデルの各セクションを、それを定義する ADR と、それを検証する適合性フィクスチャに対応付けています。「X に関する規範的な記述はどこにあるか?」を grep を使わずに引きたいときに利用してください。

フィクスチャ列には最も若い番号のフィクスチャを掲載しています。ADR ↔ フィクスチャの完全な対応表は coverage.md を参照してください。

対象領域仕様セクション関連 ADRサンプルフィクスチャ
テンプレートブロック {{ ... }}language.md "Template Blocks"001
ソース列 [Col]language.md "Source Columns"001, 002
ソース接頭辞付きブラケット Source[Col]language.md "Source Columns"; evaluation.md "External Data Sources"ADR-0012069, 070, 071
リテラル(文字列 / 数値 / 真偽値)language.md "Literals"011, 012
演算子 (=, !=, >, <, >=, <=, +, -, *, /, &)language.md "Operators"ADR-0009058, 059, 061
比較アルゴリズムlanguage.md "Comparison Algorithm"ADR-0009, ADR-0017059–064, 087, 088
正規文字列形式language.md "Canonical String Form"ADR-0009, ADR-0017061–063, 087
IF()language.md "IF"ADR-0008055–058
IFEMPTY()language.md "IFEMPTY"ADR-0007050, 051
XLOOKUP()language.md "XLOOKUP"ADR-0013074–078
集計関数 (SUM/COUNT/AVERAGE/MIN/MAX)language.md "Aggregates"ADR-0007, ADR-0012052, 070, 091
ROUND() / ABS()language.md "Numeric Functions"005, 016
TEXT()language.md "Text Formatting"011, 012, 016
ROW()language.md "Row and Date Functions"037
TODAY()language.md "Row and Date Functions"ADR-0001023
@filterlanguage.md "Filter"ADR-0007(メンバーシップ), ADR-0009(比較)003, 035, 054
@sortlanguage.md "Sort"ADR-0009, ADR-0016036, 083, 084
@toplanguage.md "Top"036
@repeat rightlanguage.md "Repeat Right"004
@sourcelanguage.md "Source"; evaluation.md "External Data Sources"ADR-0012071, 072
@joinlanguage.md "Join"; evaluation.md "External Data Sources"ADR-0014079–082
グループキーlanguage.md "Group Keys"ADR-0016015, 085, 086
空値evaluation.md "Empty Values"ADR-0007050–054
truthiness(真偽性)evaluation.md (cross-ref)ADR-0008055–058
予約シート(dunder)evaluation.md "Reserved Sheets"ADR-0011094
__config__evaluation.md "Template Configuration"ADR-0011ほぼ全て
__inputs__evaluation.md "Inputs"ADR-0010, ADR-0011065–068
__sources__evaluation.md "External Data Sources"ADR-0011, ADR-0012069–073
__lists__evaluation.md "List Sheets"ADR-0007, ADR-0011053, 054
ソース値モデルevaluation.md "Source Value Model"ADR-0017087–090
ソースデータモデル(ゼロ行、ヘッダー読み込み)evaluation.md "Source Data Model"028–031
セルテキスト抽出evaluation.md "Cell Text Extraction"013, 014
単一式セル / numFmt による型変換evaluation.md "Single-Expression Cells"ADR-0003008–010
出力ファイル名evaluation.md "Output Filenames"ADR-0002006, 007, 019, 020
エラー(カタログ)evaluation.md "Errors"ADR-0015017–022, 067, 072–082, 091
リソース制限evaluation.md "Resource Limits"(実装定義;フィクスチャなし)
レンダリングフェーズevaluation.md "Render Phases"002
順序付けevaluation.md "Ordering"ADR-0016083–086
Stage 2 OOXML 正規化conformance/runner-protocol.md "Stage 2"ADR-0006024–027, 093
動的適合性アサーションconformance/runner-protocol.md "Dynamic"ADR-0005023
Excel バージョン互換性(情報提供)ADR-0022(フィクスチャなし;オーサリングガイダンス)
演算子による型強制 + Excel デフォルト原則language.md "Arithmetic"ADR-0023100, 101
関数のアリティ(規範的な表)language.md "Functions" arity tableADR-0024102, 103
ゼロ除算 → #DIV/0! エラーセルlanguage.md "Arithmetic"ADR-0025106
複数の @filter は AND で合成language.md "Filter"(ADR なし;仕様行)104
{{ }} 内の空白は意味を持たないlanguage.md "Template Blocks"(ADR なし;仕様行)105
空値のライフサイクル(セル + グループキー)evaluation.md "Source Data Model" + "Output Filenames"ADR-0026107, 108
予約列名 + ディレクティブの検証evaluation.md "Source Data Model" + "Directives"ADR-0027109, 110, 111
リテラル構文の制約(文字列 + 数値)language.md "Literals"ADR-0028112, 113
ディレクティブ合成 + ソースエッジセマンティクスevaluation.md "External Data Sources" + "Source Data Model"ADR-0029114, 115, 116, 117
Unicode 正規化(適用しない)language.md "Comparison Algorithm"ADR-0030118
出力ファイル名の衝突はエラーevaluation.md "Output Filenames"ADR-0031119
細部の上限とワークブックのパススルーevaluation.md "Source Data Model" + "Cell Evaluation"ADR-0032120

実装定義の境界

XTL 0.1 では以下の領域を意図的に実装に委ねています。2 つのポート間でこれらの選択が異なっていても、どちらも非適合(non-conformant)にはなりません。完全なカタログは ADR-0021 を参照してください。

領域XTL 0.1 のスタンス
メモリ/ストリーミングモデル実装定義
同期 vs. 非同期 API の形状実装定義
ソース中のネイティブ Excel 数式必須:キャッシュ済みの結果を読む。欠落していればエラー
テンプレート中のネイティブ Excel 数式実装定義(典型的にはパススルー)
コア表外の TEXT() 書式実装定義の拡張
行展開時の結合セル保存必須(データブロックの上下);データブロック内部は実装定義
__config__ 作成者定義キー必須:{{ __config__[key] }} 経由でアクセス可能
空ソース(行数ゼロ)実装定義の出力、エラーにはしない
サニタイズ後のシート名衝突実装定義
空のテンプレートブロック {{ }}エラー
入力中の非テンプレート・非予約シート実装定義(典型的にはパススルー)

延期された対象領域

以下は 1.0 には含まれません。延期 ADR がその理由と、将来の仕様で当該領域を追加するために規範的に取り組まなければならない(MUST)事項を説明しています。

対象領域状態延期 ADR
日付演算(EOMONTH, EDATE, DATEDIF, …)延期ADR-0019
ロケール対応の照合(collation)延期ADR-0020
複数 @join、left-join、複数行マッチ延期ADR-0014(out-of-scope セクション)
XLOOKUP のワイルドカード / 近似 / 逆方向検索延期ADR-0013(out-of-scope セクション)
クロスライター Stage 2 のギャップ(デフォルト属性、色 hex の大小文字、namespace prefix)延期ADR-0006 amendment