public interface XBRLInstanceItem
extends XBRLInstanceElement

public XBRLTaxonomyItem getTaxonomyItem()

XBRLのバージョン：

2.0および2.1

説明：

アイテムの要素宣言を取得します。

戻り値：

このアイテムの要素宣言を表すXBRLTaxonomyItemオブジェクトを返します。

public int getItemType()

XBRLのバージョン：

2.0および2.1

説明：

アイテムのデータ型を表すコードを取得します。

このメソッドが返す値は，XBRLのバージョンによって異なります。利用できるデータ型の詳細については，XBRLTaxonomyItemインターフェースの「6.8.17(1)　getItemType」を参照してください。

戻り値：

このアイテムの型を表すコードを返します。

public int getBaseItemType()

XBRLのバージョン：

2.1

説明：

アイテムのベースデータ型を表すコードを取得します。

ベースデータ型は，ユーザーデータ型の派生元となっているデータ型のことです。アイテムがユーザーデータ型である場合（getItemType()メソッドがOTHER_ITEMを返す場合）は，getBaseItemType()メソッドを呼び出すことによって，派生元となっているデータ型を調べることができます。派生元のデータ型が不明な場合は，getBaseItemType()メソッドはOTHER_ITEMを返します。

このアイテムがユーザーデータ型でない場合（getItemType()メソッドがOTHER_ITEM以外を返す場合）は，このメソッドはgetItemType()メソッドが返す値と同じ値を返します。

戻り値：

このアイテムのベースデータ型を表すコードを返します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］

public boolean isNumeric()

XBRLのバージョン：

2.0および2.1

説明：

アイテムが数値または非数値のどちらであるかを調べます。

このアイテムが数値か非数値のどちらかは，このアイテムのデータ型によって異なります。アイテムのデータ型とisNumeric()メソッドの戻り値との対応関係については，XBRLTaxonomyItemインターフェースの「6.8.17(3)　isNumeric」を参照してください。

戻り値：

このアイテムが数値である場合はtrue，非数値である場合はfalseを返します。

public XBRLContext getContext()

XBRLのバージョン：

2.0および2.1

説明：

アイテムが参照するコンテキスト要素を取得します。

戻り値：

コンテキスト要素を表すXBRLContextオブジェクトを返します。

• XBRL2.0の場合：このメソッドが返したオブジェクトは，XBRLNumericContextまたはXBRLNonNumericContextのどちらか一方にキャストできます。XBRLNumericContextとXBRLNonNumericContextのどちらにキャストできるかは，isNumeric()を呼び出すことで判定できます。
• XBRL2.1の場合：このメソッドが返したオブジェクトは，XBRLContext2にキャストできます。

public void setContext(XBRLContext context)

XBRLのバージョン：

2.0および2.1

説明：

アイテムが参照するコンテキスト要素を設定します。

このアイテムがアクティブで，かつ引数contextで指定したコンテキスト要素がインスタンス文書にない場合は，コンテキスト要素はインスタンス文書に自動的に追加されます。このとき，インスタンス文書へ自動的に追加されるコンテキスト要素のid属性と同じ値のid属性を持つ別のコンテキスト要素が，すでにインスタンス文書に存在する場合は，XBRLDOMRuntimeExceptionがスローされます。

引数：

context - このアイテムが参照するコンテキスト要素を指定します。

• XBRL2.0の場合：この引数に指定するオブジェクトは，XBRLNumericContextかXBRLNonNumericContextのどちらかでなければなりません。XBRLNumericContextとXBRLNonNumericContextのどちらを指定する必要があるかは，このアイテムのデータ型に依存します。
• XBRL2.1の場合：この引数に指定するオブジェクトは，XBRLContext2である必要があります。

例外：

XBRLDOMRuntimeException -

• 引数contextにnullを指定した場合にスローされます。［エラーコード：20002］
• 引数contextに指定したXBRLContextオブジェクトを所有しているXBRLInstanceDocumentオブジェクトが，このXBRLInstanceItemオブジェクトを所有しているXBRLInstanceDocumentオブジェクトと異なる場合にスローされます。［エラーコード：20004］
• XBRL2.0の場合：引数contextが表すコンテキスト要素が，このアイテムのデータ型に適合しない場合にスローされます。［エラーコード：20032］
• XBRL2.1の場合：引数contextに指定したコンテキスト要素の時期要素の内容が，このアイテムの要素宣言でのxbrli:periodType属性の指定と矛盾している場合にスローされます。xbrli:periodType属性の値が"instant"の場合は，時期要素の内容はXBRLPeriod.INSTANTである必要があります。また，xbrli:periodType属性の値が"duration"の場合は，時期要素の内容はXBRLPeriod.FOREVERかXBRLPeriod.STARTDATE_ENDDATEである必要があります。［エラーコード：20140］

public XBRLUnit2 getUnit()

XBRLのバージョン：

2.1

説明：

アイテムが参照する単位要素を取得します。

単位要素を参照するのは数値アイテムだけであり，非数値アイテムは単位要素を参照しません。よって，数値アイテムに対してだけ，このメソッドを呼び出せます。非数値アイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。アイテムが数値か非数値かについては，XBRLInstanceItem.isNumeric()メソッドで調べることができます。

戻り値：

単位要素を表すXBRLUnit2オブジェクトを返します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値の場合にスローされます。［エラーコード：20137］

public void setUnit(XBRLUnit2 unit)

XBRLのバージョン：

2.1

説明：

アイテムが参照する単位要素を設定します。

このアイテムがアクティブで，かつ，引数unitで指定された単位要素がインスタンス文書に存在しない場合は，単位要素はインスタンス文書に自動的に追加されます。このとき，インスタンス文書へ自動的に追加される単位要素のid属性と同じ値のid属性を持つ別の要素がすでにインスタンス文書に存在する場合は，XBRLDOMRuntimeException例外がスローされます。

単位要素を設定できるのは，数値アイテムに対してだけです。非数値アイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。アイテムが数値か非数値かについては，XBRLInstanceItem.isNumeric()メソッドで調べることができます。

アイテムが参照する単位要素には，アイテムのベースデータ型によって次に示す制約があります。これらの制約に違反する単位要素を設定しようとした場合は，XBRLDOMRuntimeExceptionがスローされます。

表6-34　アイテムのベースデータ型による単位要素の制約

項番	アイテムのベースデータ型	単位要素の制約
1	MONETARY_ITEM	次の制約をすべて満たす必要があります。 単位要素の内容は，一つの基本単位によって構成されなければなりません。つまり，XBRLUnit2.getUnitType()メソッドの戻り値がXBRLUnit2.MULTIPLYで，かつ，XBRLUnit2.getMeasures()メソッドが返すリストのサイズは1である必要があります。 基本単位を表すXBRLQNameオブジェクトの名前空間URIは "http://www.xbrl.org/2003/iso4217"である必要があります。 基本単位を表すXBRLQNameオブジェクトのローカルパートは，ISO 4217通貨コードである必要があります。なお，XBRL DOMでは，この項目はチェックしません。
2	SHARES_ITEM	次の制約をすべて満たす必要があります。 単位要素の内容は，一つの基本単位によって構成されなければなりません。つまり，XBRLUnit2.getUnitType()メソッドの戻り値がXBRLUnit2.MULTIPLYで，かつ，XBRLUnit2.getMeasures()メソッドが返すリストのサイズは1である必要があります。 基本単位を表すXBRLQNameオブジェクトの名前空間URIは "http://www.xbrl.org/2003/instance" である必要があります。 基本単位を表すXBRLQNameオブジェクトのローカルパートは"shares"である必要があります。
3	PURE_ITEM	次の制約をすべて満たす必要があります。 単位要素の内容は，一つの基本単位によって構成されなければなりません。つまり，XBRLUnit2.getUnitType()メソッドの戻り値がXBRLUnit2.MULTIPLYで，かつ，XBRLUnit2.getMeasures()メソッドが返すリストのサイズは1である必要があります。 基本単位を表すXBRLQNameオブジェクトの名前空間URIは "http://www.xbrl.org/2003/instance" である必要があります。 基本単位を表すXBRLQNameオブジェクトのローカルパートは"pure"である必要があります。

このアイテムのベースデータ型が上記の表に記載されているもの以外である場合は，このアイテムに設定する単位要素についての制約はありません。

引数：

unit - このアイテムが参照する単位要素を指定します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値の場合にスローされます。［エラーコード：20137］
• 引数unitにnullを指定した場合にスローされます。［エラーコード：20002］
• 引数unitに指定されたXBRLUnit2オブジェクトを所有しているXBRLInstanceDocumentオブジェクトが，このXBRLInstanceItemオブジェクトを所有しているXBRLInstanceDocumentオブジェクトと異なる場合にスローされます。［エラーコード：20004］
• 引数unitに指定されたXBRLUnit2オブジェクトが，上記の表の制約に違反している場合にスローされます。［エラーコード：20127］

public XBRLPrecision getPrecision()

XBRLのバージョン：

2.1

説明：

アイテムのprecision属性値を取得します。

このメソッドは，アイテムが数値で，かつ，アイテムのベースデータ型がFRACTION_ITEM以外である場合に呼び出せます。このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

戻り値：

このアイテムのprecision属性の値を返します。precision属性がない場合はnullを返します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20136］

public void setPrecision(XBRLPrecision precision)

XBRLのバージョン：

2.1

説明：

アイテムのprecision属性値を設定します。

precision属性とdecimals属性はどちらか一方だけを設定できます。decimals属性が設定されているアイテムに対してこのメソッドを呼び出した場合は，decimals属性は自動的に削除されます。

このメソッドは，アイテムが数値で，かつ，アイテムのベースデータ型がFRACTION_ITEM以外である場合に呼び出せます。このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

このアイテムのxsi:nil属性に "true" が指定されている場合は，precision属性を設定できません。xsi:nil属性に "true" が指定されている場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

引数：

precision - このアイテムのprecision属性に設定する値を指定します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20136］
• このアイテムのxsi:nil属性に "true" が指定されている場合にスローされます。［エラーコード：20130］
• 引数precisionにnullを指定した場合にスローされます。［エラーコード：20002］

public XBRLDecimals getDecimals()

XBRLのバージョン：

2.1

説明：

アイテムのdecimals属性値を取得します。

このメソッドは，アイテムが数値で，かつ，アイテムのベースデータ型がFRACTION_ITEM以外である場合に呼び出せます。このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

戻り値：

このアイテムのdecimals属性の値を返します。decimals属性がない場合はnullを返します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20136］

public void setDecimals(XBRLDecimals decimals)

XBRLのバージョン：

2.1

説明：

アイテムのdecimals属性値を設定します。

precision属性とdecimals属性はどちらか一方だけを設定できます。precision属性が設定されているアイテムに対してこのメソッドを呼び出した場合は，precision属性は自動的に削除されます。

このメソッドは，アイテムが数値で，かつ，アイテムのベースデータ型がFRACTION_ITEM以外である場合に呼び出せます。このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

このアイテムのxsi:nil属性に"true"が指定されている場合は，decimals属性を設定できません。xsi:nil属性に"true"が指定されている場合にこのメソッドを呼び出すと，XBRLDOMRuntimeExceptionがスローされます。

引数：

decimals - このアイテムのdecimals属性に設定する値を指定します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• このアイテムが非数値か，または，ベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20136］
• このアイテムのxsi:nil属性に "true" が指定されている場合にスローされます。［エラーコード：20130］
• 引数decimalsにnullを指定した場合にスローされます。［エラーコード：20002］

public boolean hasValue()

XBRLのバージョン：

2.0および2.1

説明：

アイテムに値が設定されているかどうかを調べます。

XBRLInstanceDocumentのcreateItem()で生成された直後のXBRLInstanceItemオブジェクトには値は設定されていません。つまり，hasValue()はfalseを返します。

戻り値：

このアイテムに値が設定されている場合はtrue，設定されていない場合はfalseを返します。

public java.lang.Object getValue()

XBRLのバージョン：

2.0および2.1

説明：

アイテムの値を取得します。

このメソッドが返すオブジェクトは，アイテムのデータ型によって異なります。このアイテムに値が設定されていない場合，このメソッドはXBRLDOMRuntimeExceptionをスローします。

getValue()メソッドが返すオブジェクトを次の表に示します。

表6-35　getValue()メソッドが返すオブジェクト

項番	アイテムのデータ型	getValue()メソッドが返すオブジェクト
1	MONETARY_ITEM	java.math.BigDecimal
2	SHARES_ITEM	java.math.BigDecimal
3	PURE_ITEM	java.math.BigDecimal
4	FRACTION_ITEM	XBRLFraction
5	DECIMAL_ITEM	java.math.BigDecimal
6	FLOAT_ITEM	java.lang.Float
7	DOUBLE_ITEM	java.lang.Double
8	INTEGER_ITEM	java.math.BigInteger
9	NONPOSITIVEINTEGER_ITEM	java.math.BigInteger
10	NEGATIVEINTEGER_ITEM	java.math.BigInteger
11	LONG_ITEM	java.lang.Long
12	INT_ITEM	java.lang.Integer
13	SHORT_ITEM	java.lang.Short
14	BYTE_ITEM	java.lang.Byte
15	NONNEGATIVEINTEGER_ITEM	java.math.BigInteger
16	UNSIGNEDLONG_ITEM	java.math.BigInteger
17	UNSIGNEDINT_ITEM	java.math.BigInteger
18	UNSIGNEDSHORT_ITEM	java.math.BigInteger
19	UNSIGNEDBYTE_ITEM	java.math.BigInteger
20	POSITIVEINTEGER_ITEM	java.math.BigInteger
21	STRING_ITEM	java.lang.String
22	BOOLEAN_ITEM	java.lang.Boolean
23	HEXBINARY_ITEM	XBRLHexBinary
24	BASE64BINARY_ITEM	XBRLBase64Binary
25	ANYURI_ITEM	java.lang.String
26	QNAME_ITEM	XBRLQName
27	NOTATION_ITEM	XBRLQName
28	DURATION_ITEM	XBRLDuration
29	DATETIME_ITEM	XBRLDateUnion
30	TIME_ITEM	XBRLTime
31	DATE_ITEM	XBRLDate
32	GYEARMONTH_ITEM	XBRLGYearMonth
33	GYEAR_ITEM	XBRLGYear
34	GMONTHDAY_ITEM	XBRLGMonthDay
35	GDAY_ITEM	XBRLGDay
36	GMONTH_ITEM	XBRLGMonth
37	NORMALIZEDSTRING_ITEM	java.lang.String
38	TOKEN_ITEM	java.lang.String
39	LANGUAGE_ITEM	java.lang.String
40	NAME_ITEM	java.lang.String
41	NCNAME_ITEM	java.lang.String
42	OTHER_ITEM	java.lang.String

XBRL2.1の場合：このアイテムがユーザーデータ型（OTHER_ITEM）で，かつ，ベースデータ型がFRACTION_ITEMである場合，このメソッドは，XBRLFraction.toString()メソッドが返す文字列と同じ形式の文字列を表すjava.lang.Stringオブジェクトを返します。ユーザーデータ型で，かつ，ベースデータ型がFRACTION_ITEMであるアイテムの値を表すXBRLFractionオブジェクトを使用したい場合は，このメソッドが返した文字列をそのままXBRLFractionクラスのコンストラクタに渡します。

戻り値：

アイテムの値を返します。

例外：

XBRLDOMRuntimeException -

• このアイテムに値が設定されていない場合にスローされます。［エラーコード：20026］

public void setValue(java.lang.Object value)

XBRLのバージョン：

2.0および2.1

説明：

アイテムの値を設定します。

このメソッドの引数に指定できるオブジェクトは，アイテムのデータ型によって異なります。setValue()メソッドの引数に指定できるオブジェクトを次の表に示します。

表6-36　setValue()メソッドの引数に指定できるオブジェクト

項番	アイテムのデータ型	setValue()メソッドの引数に指定できるオブジェクト
1	MONETARY_ITEM	java.math.BigDecimal
2	SHARES_ITEM	java.math.BigDecimal
3	PURE_ITEM	java.math.BigDecimal
4	FRACTION_ITEM	XBRLFraction
5	DECIMAL_ITEM	java.math.BigDecimal
6	FLOAT_ITEM	java.lang.Float
7	DOUBLE_ITEM	java.lang.Double
8	INTEGER_ITEM	java.math.BigInteger
9	NONPOSITIVEINTEGER_ITEM	java.math.BigInteger
10	NEGATIVEINTEGER_ITEM	java.math.BigInteger
11	LONG_ITEM	java.lang.Long
12	INT_ITEM	java.lang.Integer
13	SHORT_ITEM	java.lang.Short
14	BYTE_ITEM	java.lang.Byte
15	NONNEGATIVEINTEGER_ITEM	java.math.BigInteger
16	UNSIGNEDLONG_ITEM	java.math.BigInteger
17	UNSIGNEDINT_ITEM	java.math.BigInteger
18	UNSIGNEDSHORT_ITEM	java.math.BigInteger
19	UNSIGNEDBYTE_ITEM	java.math.BigInteger
20	POSITIVEINTEGER_ITEM	java.math.BigInteger
21	STRING_ITEM	java.lang.String
22	BOOLEAN_ITEM	java.lang.Boolean
23	HEXBINARY_ITEM	XBRLHexBinary
24	BASE64BINARY_ITEM	XBRLBase64Binary
25	ANYURI_ITEM	java.lang.String
26	QNAME_ITEM	XBRLQName
27	NOTATION_ITEM	XBRLQName
28	DURATION_ITEM	XBRLDuration
29	DATETIME_ITEM	XBRLDateUnion
30	TIME_ITEM	XBRLTime
31	DATE_ITEM	XBRLDate
32	GYEARMONTH_ITEM	XBRLGYearMonth
33	GYEAR_ITEM	XBRLGYear
34	GMONTHDAY_ITEM	XBRLGMonthDay
35	GDAY_ITEM	XBRLGDay
36	GMONTH_ITEM	XBRLGMonth
37	NORMALIZEDSTRING_ITEM	java.lang.String
38	TOKEN_ITEM	java.lang.String
39	LANGUAGE_ITEM	java.lang.String
40	NAME_ITEM	java.lang.String
41	NCNAME_ITEM	java.lang.String
42	OTHER_ITEM	java.lang.String

インスタンス文書には，このアイテムの値として，引数valueに指定したオブジェクトのtoString()が返す文字列が設定されます。ただし，このアイテムがxsd:QName型またはxsd:NOTATION型の場合は，toString()が返す文字列「{namespaceURI}localPart」ではなく，「prefix:localPart」という形式の文字列が設定されます。

「prefix」の部分に該当する名前空間接頭辞は，XBRLInstanceDocumentオブジェクトに登録されている名前空間宣言から取得されます。名前空間宣言は，XBRLInstanceDocumentのaddNamespaceDeclaration()を使用してあらかじめ登録しておきます。引数valueに指定したXBRLQNameオブジェクトの名前空間URIに対応する名前空間宣言が登録されていない場合は，例外がスローされます。

このアイテムの値としてインスタンス文書に設定される文字列表現を厳密に指定したい場合は，このメソッドの代わりにsetString()を使用します。

XBRL2.1の場合：このアイテムがユーザーデータ型（OTHER_ITEM）で，かつ，ベースデータ型がFRACTION_ITEMである場合，このメソッドに指定する文字列の形式はXBRLFractionクラスのコンストラクタへ指定する文字列と同じ形式である必要があります。XBRLFractionクラスのコンストラクタへ指定できない文字列をこのメソッドに指定した場合は，XBRLDOMRuntimeExceptionがスローされます。ユーザーデータ型で，かつ，ベースデータ型がFRACTION_ITEMであるアイテムに対して，XBRLFractionオブジェクトから値を設定したい場合は，XBRLFraction.toString()メソッドが返す文字列をそのままsetValue()メソッドの引数に指定します。

XBRL2.1の場合：xsi:nil属性に"true"が指定されている場合は，アイテムの値は設定できないため，このメソッドを呼び出してはいけません。xsi:nil属性に"true"が指定されているアイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。

引数：

value - アイテムの値を指定します。

例外：

XBRLDOMRuntimeException -

• XBRL2.1の場合：このアイテムのxsi:nil属性に"true"が指定されている場合にスローされます。［エラーコード：20130］
• 引数valueにnullを指定した場合にスローされます。［エラーコード：20002］
• 引数valueの型が，このアイテムのデータ型に合わない場合にスローされます。［エラーコード：20033］
• このアイテムがxsd:QName型またはxsd:NOTATION型で，かつ，引数valueに指定したXBRLQNameオブジェクトの名前空間URIに対応する名前空間宣言が，XBRLInstanceDocumentオブジェクトに登録されていない場合にスローされます。［エラーコード：20023］
• このアイテムがxsd:QName型またはxsd:NOTATION型で，かつ引数valueに指定したXBRLQNameオブジェクトが名前空間に属さず，かつXBRLInstanceDocumentオブジェクトにデフォルトの名前空間の宣言が登録されている場合にスローされます。［エラーコード：20069］
• XBRL2.1の場合：このアイテムがユーザーデータ型（OTHER_ITEM）で，かつ，ベースデータ型がFRACTION_ITEMである場合に，XBRLFractionクラスのコンストラクタへ指定できない文字列を引数valueに指定した場合にスローされます。［エラーコード：20138］
• XBRL2.1の場合：このアイテムのデータ型が次のどれかで，かつ，引数valueに指定された整数値がこのアイテムのデータ型の範囲外である場合にスローされます。［エラーコード：20014］
  ・NONPOSITIVEINTEGER_ITEM
  ・NEGATIVEINTEGER_ITEM
  ・NONNEGATIVEINTEGER_ITEM
  ・UNSIGNEDLONG_ITEM
  ・UNSIGNEDINT_ITEM
  ・UNSIGNEDSHORT_ITEM
  ・UNSIGNEDBYTE_ITEM
  ・POSITIVEINTEGER_ITEM
  
• このアイテムのデータ型がANYURI_ITEMで，かつ，引数valueに指定された値がxsd:anyURI型でない場合にスローされます。［エラーコード：20108］
• このアイテムのデータ型がQNAME_ITEMまたはNOTATION_ITEMで，かつ，引数valueに指定されたXBRLQNameオブジェクトのローカルパートがxsd:NCName型でない場合にスローされます。［エラーコード：20108］
• XBRL2.1の場合：このアイテムのデータ型がNAME_ITEMで，かつ，引数valueに指定された値がxsd:Name型でない場合にスローされます。［エラーコード：20108］
• XBRL2.1の場合：このアイテムのデータ型がNCNAME_ITEMで，かつ，引数valueに指定された値がxsd:NCName型でない場合にスローされます。［エラーコード：20108］

public java.lang.String getString()

XBRLのバージョン：

2.0および2.1

説明：

アイテムの値の文字列表現を取得します。

このメソッドが返す文字列は，インスタンス文書にこのアイテムの値として記述されている文字列です。このメソッドが返す文字列は，getValue().toString()が返す文字列と異なる場合があります。例えば，このアイテムがxsd:QName型またはxsd:NOTATION型である場合，getString()は「prefix:localPart」という形式の文字列を返しますが，getValue().toString() は「{namespaceURI}localPart」という形式の文字列を返します。また，このアイテムが xsd:float型で，かつインスタンス文書にこのアイテムの値として「1.0e2」と記述されていた場合，getString()は「1.0e2」という文字列を返しますが，getValue().toString() は「100.0」という文字列を返します。

このアイテムに値が設定されていない場合，このメソッドはXBRLDOMRuntimeExceptionをスローします。

XBRL2.1の場合：アイテムのベースデータ型がFRACTION_ITEMである場合，インスタンス文書に記述される値は文字列ではないため，このメソッドで文字列表現を取得できません。ベースデータ型がFRACTION_ITEMであるアイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。

戻り値：

このアイテムの値の文字列表現を返します。

アイテムの型がxsd:QNameまたはxsd:NOTATIONの場合，名前空間を正規化すると，正規化の前後でQNameの接頭辞が異なります。正規化前は，既存の文書で指定された接頭辞を返します。正規化後は，正規化によって変更された接頭辞を返します。

例外：

XBRLDOMRuntimeException -

• このアイテムに値が設定されていない場合にスローされます。［エラーコード：20026］
• XBRL2.1の場合：このアイテムのベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20139］
• このアイテムの内容に子要素が含まれている場合にスローされます。［エラーコード：20061］

public void setString(java.lang.String value)

XBRLのバージョン：

2.0および2.1

説明：

アイテムの値の文字列表現を設定します。

setValue()では，引数に指定したオブジェクトのtoString()の戻り値が，このアイテムの値としてインスタンス文書に書き込まれます。一方，setString()では，引数valueに指定した文字列がそのまま，このアイテムの値としてインスタンス文書に書き込まれます。このアイテムの値としてインスタンス文書に書き込まれる文字列表現を厳密に指定したい場合は，setValue()ではなくsetString()を使用します。

• XBRL2.1の場合：
  アイテムのベースデータ型がFRACTION_ITEMである場合，インスタンス文書に記述される値は文字列ではないため，このメソッドで文字列表現を設定できません。ベースデータ型がFRACTION_ITEMであるアイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。
  
• XBRL2.1の場合：
  xsi:nil属性に "true" が指定されている場合は，アイテムの値は設定できないため，このメソッドを呼び出さないでください。xsi:nil属性に "true" が指定されているアイテムに対してこのメソッドを呼び出した場合は，XBRLDOMRuntimeExceptionがスローされます。
  

引数：

value - このアイテムの値の文字列表現を指定します。

例外：

XBRLDOMRuntimeException -

• XBRL2.1の場合：このアイテムのベースデータ型がFRACTION_ITEMである場合にスローされます。［エラーコード：20139］
• XBRL2.1の場合：このアイテムのxsi:nil属性に "true" が指定されている場合にスローされます。［エラーコード：20130］
• 引数valueにnullを指定した場合にスローされます。［エラーコード：20002］
• このアイテムがxsd:QName型またはxsd:NOTATION型で，かつ引数valueに指定したQNameの名前空間接頭辞に対応する名前空間宣言が，XBRLInstanceDocumentオブジェクトに登録されていない場合にスローされます。［エラーコード：20022］
• 引数valueに指定された文字列表現が不正な場合にスローされます。[エラーコード：20029]

public XBRLDimensionalRelationshipSet getDimensionalRelationshipSet()

XBRLのバージョン：

2.1

XBRL Dimensionsのバージョン：

1.0

説明：

アイテムの要素宣言に関連づいているDRSを取得します。

戻り値：

このアイテムの要素宣言に関連づいているDRSを返します。アイテムの要素宣言に関連づいているDRSがない場合は，nullを返します。

例外：

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• 操作対象のインスタンス文書が準拠しているXBRL Dimensionsのバージョンが1.0でない場合にスローされます。［エラーコード：22100］

public boolean validateDimensions()
                            throws XBRLDOMException

XBRLのバージョン：

2.1

XBRL Dimensionsのバージョン：

1.0

説明：

アイテムに対して，DRSに含まれているすべてのロールでXBRL Dimensionsの妥当性検証を実行します。

戻り値：

このアイテムに対して，DRSに含まれているすべてのロールでXBRL Dimensionsの妥当性検証を実行し，妥当である場合はtrue，妥当でない場合はfalseを返します。また，このアイテムにDRSがない場合はXBRL Dimensionsの妥当性検証を実行しないで，trueを返します。

例外：

XBRLDOMException -

• XBRL Dimensionsの妥当性検証でエラーが検出された場合にスローされます。［エラーコード：エラー要因によって異なる^※］
  注※　エラー要因については，「7.　メッセージ」の各メッセージの中で，このエラーコードをメッセージ番号とするメッセージIDを参照してください。
  

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• 操作対象のインスタンス文書が準拠しているXBRL Dimensionsのバージョンが1.0でない場合にスローされます。［エラーコード：22100］

public boolean validateDimensions(java.lang.String role)
  throws XBRLDOMException

XBRLのバージョン：

2.1

XBRL Dimensionsのバージョン：

1.0

説明：

アイテムに対して，DRSに含まれているロールのうち，引数roleに指定されたロールでXBRL Dimensionsの妥当性検証を実行します。

引数：

role - XBRL Dimensionsの妥当性検証を実行するロールを指定します。

戻り値：

このアイテムに対して，DRSに含まれているロールのうち，引数roleに指定されたロールでXBRL Dimensionsの妥当性検証を実行し，妥当である場合はtrue，妥当でない場合はfalseを返します。また，このアイテムにDRSがない場合はXBRL Dimensionsの妥当性検証を実行しないでtrueを返します。

例外：

XBRLDOMException -

• XBRL Dimensionsの妥当性検証でエラーが検出された場合にスローされます。［エラーコード：エラー要因によって異なる^※］
  注※　エラー要因については，「7.　メッセージ」の各メッセージの中で，このエラーコードをメッセージ番号とするメッセージIDを参照してください。
  

XBRLDOMRuntimeException -

• 操作対象のインスタンス文書が準拠しているXBRLのバージョンが2.1でない場合にスローされます。［エラーコード：20100］
• 操作対象のインスタンス文書が準拠しているXBRL Dimensionsのバージョンが1.0でない場合にスローされます。［エラーコード：22100］
• 引数roleにnullを指定した場合にスローされます。［エラーコード：20002］
• 引数roleに空のURI参照を指定した場合にスローされます。［エラーコード：20110］
• 引数roleにDRSに存在しないロールを指定した場合にスローされます。［エラーコード：22102］