BasisForChoice - NewsComponent の構造 - 新聞協会NewsMLレベル1.2解説書

5.7 NewsComponent の構造

5.7.3 BasisForChoice

BasisForChoiceの構成要素は、NewsComponentまたはContentItemにある情報を識別するXPathパターンあるいは要素タイプ名であり、同等のNewsComponentまたはContentItemを選択する際の基礎として用いられる。XPathパターンが「．」（ピリオド）で始まっている場合には、XPathの「ルート（root）」

を表し、NewsComponentあるいはContentItem自体に相当する。XPathパターンを等価の組み合わせの中で順番に個々のNewsComponentやContentItemに適用することにより、システムは項目間の選択を行う基礎となるデータを抽出することができる。XPathパターンに適合するものが、「root」で始まるサブツリーに多数存在する場合には、文書の順番で最初に適合したもののみが重要である。オプションのRank 属性により、配信社が異なったBasisForChoiceを付加した場合には、数値により重要度に優先順位を付けることができる。この場合、数値が小さいほど重要度が高くなる。

次の例では、内部NewsComponent（この場合は円グラフまたは棒グラフ）の役割（Role）を示している。それらは、NewsComponent間の選択の基礎として示されている。BasisForChoice内の「./」（ピリオド＋スラッシュ）は、

そのパス（path）のルート（root）の下位要素を示すXPathシンタックスであり、選択肢となる個々のNewsComponent を示す。

</NewsComponent>

</NewsComponent>

次の例では、PixelWidthという値のFormalName属性を持つProperty要素のValue属性が、ContentItem間の選択の基礎となることを示すために、さらに複雑なXPath表現を用いる。

<Urn>urn:newsml:mydomain.com:20010101:Characteristics:3</Urn>

<Url>www.mydomain.com/vocabs/characteristics.xml</Url>

</Resource>

</Catalog>

...

<BasisForChoice>.//Property[@FormalName="PixelWidth"]/@Value</BasisForChoice>

</Characteristics>

</ContentItem>

<!ELEMENT BasisForChoice (#PCDATA)>

<!ATTLIST BasisForChoice %localid;

Rank CDATA #IMPLIED >

</Characteristics>

</ContentItem>

</NewsComponent>

Example 2:

以下のNewsComponentについて見てみよう：

…

</NewsComponent>

…

</NewsComponent>

上の例で、外側のNewsComponentは、互いに等価である２つの子NewsComponentを持ち、BasisForChoiceは xml:lang属性である。

このBasisForChoiceは、xml:lang属性を探す際に、それぞれの子NewsComponentの“子”の軸（axis）を利用しなければならないことを示している。このことより、xml:langがそれぞれの子NewsComponent直下の子として存在するため、この例は正しい例だといえる。

上記のBasisForChoiceの構造は次のものと等しいことに注意せよ：

両方のケースにおいて子NewsComponentの子軸が探されることを示している。

Example 3:

…

</NewsComponent>

…

</NewsComponent>

上記では、BasisForChoiceはBasisForChoice要素を含むNewsComponentのそれぞれの子NewsComponentの”子”

の軸（axis）を使うべきであることを示している。しかし、この例では、それぞれの子NewsComponentは、その直下の子として、xml:lang属性を持っていない。これではBasisForChoice要素は正しく構成されない。この例では xml:lang属性は子NewsComponentの子孫として現れている。したがってBasisForChoiceは次のように構成されなければならない。

”.//”は子NewsComponentの子孫軸を探さなければいけないことを示す。

[NSK解説]

BasisForChoice要素は、同等のNewsComponent要素またはContentItem要素を識別する際に、識別すべき情報のXPathパターンあるいは要素タイプ名を示す。

NewsComponent要素の EquivalmentsList 属性が yes に設定されている場合、その子要素の NewsComponent要素またはContentItem要素の意味は同等であることを示し、これを識別するための XPathパターンあるいは要素タイプ名をBasisForChoice要素の内容として記述する。

BasisForChoice要素は属性値としてlocalidエンティティ、すなわちDuid属性とEuid属性とRank属性を持つことができる。

Rank属性はBasisForChoiceが複数あった場合の優先順位を指定するために使用する。

例）複数のBasisForChoiceを使用して対象の絞り込みを行う場合

以下の例では、BasisForChoiceを２つ記述することにより、Rank属性の値に従って、対象の絞り込みが可能になっている。Rank="1"では、Roleの値を対象としており、Main画像とThumbnail画像を区別できる。Main 画像が必要な場合は、ここで処理を終了すれば良い。Tumbnail 画像が必要な場合は、対象が二つあるので、さらに、Rank="2"のFormatの値を利用して区別する。

<BasisForChoice Rank="1">./Role/@FormalName</BasisForChoice>

<BasisForChoice Rank="2">.//Format/@FormalName</BasisForChoice>

</ContentItem>

</NewsComponent>

</ContentItem>

</NewsComponent>

</Con tentItem>

</NewsComponent>

</NewsItem>

ドキュメント内新聞協会NewsMLレベル1.2解説書 (ページ 103-106)