Property - 新聞協会NewsMLレベル1.2解説書

5.6 NewsManagement

5.6.11 Property

Property 要素はContentItem、Topic、NewsComponent、NewsItemのいくつかのプロパティの値を表すのに使われる。そのプロパティには形式名が付いていなければならず、複雑なプロパティを扱うための下位プロパティを含んでもよい。

Propertyは名称を持ち、単純な値または、さらに入り組んだプロパティのセットでなる複雑な値のどちらかである。Value属性はPropertyの値を表す文字列である。ValueRef属性はPropertyの値へのポインタを与えている。これはTopicSetにあるTopicかもしれないし、何か他のデータの一部であるかもしれない。

もしValue属性とValueRef属性の両方が与えられたなら、ValueRefはPropertyの実際の値を表し、Value は文字列の表現か記憶を与えるだけのものである。AllowedSheme属性がもしあれば、propertyのValue 属性の内容に結びついたSchemeを表している。AllowedValues属性がある場合、それは一連のプロパティの値を定めたcontrolled vocabularyへのポインタである。この場合http URLかNewsML URN、または#文字の後に現在の文章中にある要素のDuidが続くfragment identifierであろう。ポインタは外部の controlled vocabularyを示すResource要素か、それ自体がcontrolled vocabularyである TopicSet要素のどちらかを必ず参照しなければならない。

以下の例は、Characteristics要素配下にあるPropertyの形式名のためのdefault vocabularyがCharacteristicsであることを、Catalogが宣言しているもので、ボキャブラリは www.mydomain.com の vocabs というサブディレクトリの中で見つけることができる。Context属性の値は２つの // 文字を含むXPath 文法の形式で、Characteristics内にあるPropertyの入れ子の度合いを任意に示すものである。Width（幅）Propertyは、Quantity（量）Property と Unit（単位）Propertyを含んでいる。３つの名前（Width、Quantity、Unit）は上記で宣言したcontrolled vocabulary によってすべて管理される。 Quantity の値は 7.5 で、 Unit の値は URN が urn:newsml:mydomain.com:20010101:Units:1 のリソース内にある要素である。このURN文字列の後ろに続く#cm は、cmという値であるDuid属性を持つ要素を結び付けるfragment identifierである。DuidはNewsML DTDでID属性となるように宣言されており、これはどのようにfragment identifierがXML文書内で解析するかということである。この例では、URNがTopicSetを識別するだろう。また、fragment identifierは、“センチメートル(centimeter)”

単位であることを示すDescription下位要素を持つTopicへ行き着くだろう。例えば、Topicはまた、メートル単位の長さのISO標準記述を指すHref属性を持つかもしれない。

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

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

</Resource>

</Catalog>

...

</Property>

</Characteristics>

<!ELEMENT Property (Property*)>

<!ATTLIST Property %localid;

% f o r m a l n a m e ; % a s s i g n m e n t ;

Value CDATA #IMPLIED ValueRef CDATA #IMPLIED AllowedScheme CDATA #IMPLIED AllowedValues CDATA #IMPLIED >

［ツリー図］

[NSK解説]

Property要素はNewsMLに規定されている要素では表現できない情報を記述する。基本的な使い方と

してはFormalName属性で種別を表し、Value属性にその値を記述する。AllowedScheme属性を使って、

Value属性の内容に結びつくSchemeを指定できる。AllowedScheme属性はNskNewsML レベル1.2から追加された属性で、他の属性と同様Propertyそのものが使用停止の個所は、下位の AllowedScheme も使用停止とする。

Property要素の中にProperty要素を入れ子構造で記述する場合は、親のProperty要素はFormalName 属性だけを記述する。その値は、子のPropertyに記述する。Value属性値は原則として自由形式である。

AllowedValues属性には、Value属性値の候補の入っているTopicSetファイルへのポインタを記述する。

（例）入れ子構造のない場合

(例) 入れ子構造がある場合

</Property>

[NewsML 仕様の変更点：NewsML v1.1]

AllowedScheme属性が追加された。

[NskNewsML:1記述形式]

Metadata/Property要素・・・ ○ Characteristics/Property要素 △ その他のPropertyは・・・・・・ ×

* Property

コラム：独自Metadataの追加について

以下、Propertyを使ったメタデータの拡張方法について記述する。

Property要素は入れ子にすることで階層表現が可能であるが、構造を定義できないため、複雑な構造にすることは避けるべきである。

Property要素はFormalName属性で種別、Value属性でその値を記述する。

Value属性のとり得る値は自由記述形式、または Catalog/Resourceでボキャブラリを宣言することによりcontrolled vocabularyとして使用できる。

階層構造をとった場合は最下層のProperty要素のみValueをもつこととする。

１階層の場合も含めて、最下層のProperty要素にValueがない場合はエラーとする。

例）

・１階層並列表記の場合

・２階層表記の場合

</Property>

各社独自にMetadataを使用する場合は、独自のMetadataTypeのボキャブラリを用意できる。 MetadataType要素のFormalName属性の値により拡張されたメタデータのタイプを記述する。NSK、

IPTCのボキャブラリを拡張することによりNSK、IPTCで定義するFormalName（メタデータタイプ）

を同時に使用することもできる。

Propertyのボキャブラリについての規定は無い。IPTC、NSK、その他独自のものが使用できる。

例）独自Metadataで写真の値段を入れた場合

１．Valueが自由記述形式の場合

<!—MetadataType のボキャブラリを宣言（MyMetadataType中では、MediaPriceが定義されている） -->

<Urn>urn:newsml:Mycompany.or.jp:20010602:MyMetadataType:1</Urn>

</Resource>

<!—Property のボキャブラリを宣言（MyMediaPrice中では、PhotoPriceが定義されている）

-->

<Urn>urn:newsml:Mycompany.or.jp:20010602:MyMediaPrice:1</Urn>

</Resource>

</Catalog>

</Metadata>

２．Valueにcontrolled vocaburalyの値を使用する場合。

<!—MetadataType のボキャブラリを宣言（MyMetadataType中では、MediaPriceが定義されている） -->

<Urn>urn:newsml:Mycompany.or.jp:20010602:MyMetadataType:1</Urn>

</Resource>

<Urn>urn:newsml:Mycompany.or.jp:20010602:MyMediaPrice:1</Urn>

</Resource>

<Urn>urn:newsml:Mycompany.or.jp:20010602:MyPhotoPrice:1</Urn>

</Resource>

</Catalog>

</Metadata>

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