4.4.3 数値コンテキスト要素の追加

XBRL2.0に準拠したインスタンス文書に,数値コンテキストを追加するサンプルコードについて説明します。

ここでは,「4.4.2 非数値コンテキスト要素の追加」で非数値コンテキストを追加したXBRL DOMに,さらに数値コンテキストを追加します。数値コンテキスト要素を追加する場合,非数値コンテキストで追加した要素に加えて,さらに単位要素,precision属性,cwa属性が必要になります。

ここで説明するサンプルコードでは,次の内容の数値コンテキストを追加します。表中の「名称」欄のインデントは,コーディング結果のインデントを示しています。

表4-8 数値コンテキストの値

項番名称要素/属性
1コンテキストID属性NC01
2precision属性9
3cwa属性false
4時期要素2003-03-31
5エンティティ(組織)要素
6  識別子要素SAMP
7  スキーム属性指定しない
8  セグメント要素
9    prefecture※1要素Tokyo
10単位要素
11  計量要素iso4217:JPY※2

(凡例)-:値を持つことができません。

注※1 "prefecture"の名前空間URIは"http://www.hitachi.com/2003/XBRL"とします。

注※2 値の単位を「円」とすることを示します。


<この項の構成>
(1) 使用するクラスおよびインターフェース
(2) サンプルコード
(3) コーディング結果

(1) 使用するクラスおよびインターフェース

数値コンテキスト要素の追加で使用するクラスおよびインターフェースを次の表に示します。

表4-9 数値コンテキスト要素の追加で使用するクラスおよびインターフェース

項番使用するクラスおよびインターフェース説明
1com.hitachi.xbrl.types.XBRLQNameXML Schemaのデータ型QNameを表します。
2com.hitachi.xbrl.instance.XBRLMeasure計量要素を表します。
3com.hitachi.xbrl.instance.XBRLUnit単位要素を表します。
4com.hitachi.xbrl.instance.XBRLMeasureOrOperator計量要素または演算子要素を表します。
5com.hitachi.xbrl.types.XBRLDateUnionXBRLのデータ型dateUnionを表します。
6com.hitachi.xbrl.instance.XBRLPeriod時期要素を表します。
7com.hitachi.xbrl.instance.XBRLIdentifier識別子要素を表します。
8com.hitachi.xbrl.instance.XBRLSegmentセグメント要素を表します。
9com.hitachi.xbrl.instance.XBRLEntityエンティティ要素を表します。
10com.hitachi.xbrl.instance.XBRLNumericContext数値コンテキストを表します。
11com.hitachi.xbrl.instance.XBRLInstanceDocumentインスタンス文書全体を表します。

(2) サンプルコード

数値コンテキストをXBRL DOMに追加するコードは次のとおりです。

// measure要素の作成
XBRLQName currency =
   new XBRLQName("http://www.xbrl.org/2003/iso4217", "JPY");
XBRLMeasure measure = idoc.createMeasure(currency);
// unit要素の作成
XBRLUnit unit = idoc.createUnit((XBRLMeasureOrOperator) measure);
// period要素の作成
XBRLDateUnion date2 = new XBRLDateUnion("2003-03-31");
XBRLPeriod period2 =
   idoc.createPeriod(XBRLPeriod.INSTANT, date2, null, null, null);
// identifier要素の作成
XBRLIdentifier identifier2 = idoc.createIdentifier("", "SAMP");
// segment要素の作成
XBRLSegment segment2 = idoc.createSegment(null);
// prefecture要素を作成
Node container2 = segment2.getContainerNode();
// prefecture要素は複製で作成
Node prefecture2 = prefecture1.cloneNode(true);
container2.appendChild(prefecture2);
// entity要素の作成
XBRLEntity entity2 = idoc.createEntity(identifier2, segment2);

// 数値コンテキストの作成
XBRLNumericContext numericContext =
   idoc.createNumericContext(
       entity2,
       period2,
       unit,
       null,   // scenario要素なし
       9,      // precision属性 : precision='9'
       false); // cwa属性 : cwa='false'
// インスタンス文書に数値コンテキストを追加
idoc.addContext(numericContext);

(3) コーディング結果

コーディング結果として,生成されるインスタンス文書は次のとおりです。

<xbrli:numericContext cwa="false" id="NC01" precision="9">
   <xbrli:entity>
       <xbrli:identifier scheme="">SAMP</xbrli:identifier>
       <xbrli:segment>
           <prefecture xmlns="http://www.hitachi.com/2003/XBRL">Tokyo</prefecture>
       </xbrli:segment>
   </xbrli:entity>
   <xbrli:period>
       <xbrli:instant>2003-03-31</xbrli:instant>
   </xbrli:period>
   <xbrli:unit>
       <xbrli:measure>iso4217:JPY</xbrli:measure>
   </xbrli:unit>
</xbrli:numericContext>