RoleMap（ロールマップ）

RoleMapは、PDF文書内の辞書であり、カスタムまたは非標準の構造タイプをPDF仕様で定義された標準構造タイプにマッピングします ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。このマッピング機構により、文書作成者はアプリケーション固有またはドメイン固有のタグ名を使用しながら、標準構造タイプを期待する支援技術やPDFリーダーとの互換性を維持できます ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 。RoleMapは、カスタムタグを使用する場合でもTagged PDFのアクセシビリティを確保するために不可欠です。

RoleMapは、文書の構造ツリールート辞書内のオプションエントリであり、カスタム構造要素タイプとPDF仕様で定義された標準構造タイプとの間の対応関係を確立します。すべての文書に対して段落を表す<P>や見出しを表す<H1>のような定義済みタグ名のみの使用を強制するのではなく、RoleMapによってコンテンツ作成者は<ProductName>や<LegalDisclaimer>のような意味的に有意なカスタムタグを定義し、それらを標準タイプにマッピングすることで明示的にどのように解釈されるべきかを宣言できます ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。

これは、構造要素をCSSライクなスタイルクラスにマッピングするClassMapや、コンテンツの実際の階層構造を定義する構造ツリー自体とは異なります。RoleMapは特に意味的タイプの等価性に対処し、カスタム語彙と支援技術が理解する標準化された構造タイプとの間に変換レイヤーを作成します。

PDF生成システムやアクセシビリティツールを構築する開発者にとって、RoleMapは意味的豊かさと相互運用性のバランスをとるために重要です。Tagged PDFを作成する際、開発者はタグ名にドメイン固有の意味を保持する必要がよくあります。たとえば、文書内での機能に基づいて異なるタイプの段落や見出しを区別する場合などです。RoleMapのサポートがなければ、開発者は汎用的な標準タグを使用する（意味情報を失う）か、カスタムタグを使用する（アクセシビリティを損なう）かのどちらかを選択せざるを得なくなります。

RoleMapは、スクリーンリーダーなどの支援技術が未知のタグ名に遭遇した場合でも文書構造を適切に解釈できることを保証します ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) 。これは特にPDF/UA準拠において重要であり、適切な構造マッピングは障害のあるユーザーが文書コンテンツをナビゲートし理解できるかどうかに直接影響します。PDFアクセシビリティ機能を実装する開発者は、カスタム構造タイプを導入する際に必ずRoleMapを正しく設定する必要があります。マッピングが欠落していたり不正確だったりすると、支援技術が構造要素を誤って解釈したり無視したりする原因となります。

RoleMap辞書は構造ツリールート（文書カタログの/StructTreeRootエントリを通じてアクセス）に配置されます。RoleMap内の各エントリはキーと値のペアで構成され、キーはカスタム構造タイプ名、値は対応する標準構造タイプ名です ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。

たとえば、文書が<CompanyLogo>というカスタムタグを使用していて、それを<Figure>要素として扱うべき場合、RoleMapには次のように記述します：

/RoleMap << /CompanyLogo /Figure >>

PDFリーダーまたは支援技術がタイプ/CompanyLogoの構造要素に遭遇すると、RoleMapを参照して/Figure>要素として処理すべきであると判断します。マッピングは連鎖可能です。つまり、カスタムタイプが別のカスタムタイプにマップされ、それがさらに標準タイプにマップされることもできますが、連鎖は最終的にPDF仕様で定義された標準構造タイプに解決される必要があります。

標準構造タイプには、Div、P、H1からH6、L（リスト）、Table、Figureなど、一般的な文書要素が含まれます ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 。各標準タイプには、支援技術が適切な文書解釈のために依存する定義された意味があります。開発者は、カスタムから標準へのマッピングが要素の意図された意味的意味と構造的役割を保持することを確保する必要があります。

• Structure Tree（構造ツリー） – PDF文書内のタグ付けされたコンテンツ要素の階層構造
• Standard Structure Types（標準構造タイプ） – 一般的な文書コンポーネント向けにPDF仕様で定義された構造要素タイプの定義済みセット
• Structure Element（構造要素） – 文書コンテンツの論理的コンポーネントを表す構造ツリー内の個別ノード
• PDF/UA – 適切な構造タグ付けとマッピングを要求するアクセシブルなPDF文書のためのISO標準
• ClassMap – 構造要素をスタイルクラスにマッピングする辞書で、RoleMapによって提供される意味的マッピングを補完する