XBRL：複雑さについて-第6章XBRLへのダイビング-パート1.はじめに

6. XBRLに飛び込む

前の章では、XBRLが何であり、それで何ができるかを見つけるために、 指で水に触れました。 この豊富な知識により、最終章でこのXBRLに完全に浸ることができます。 分類法とレポートを作成する基本的な手順を説明し、XBRLが実際にどのように見えるかを示します。

この章では、企業の人口統計について既に持っている例を使用して、分類法とそれに関連するレポートを作成するプロセスを示します。 実生活と同様に、私たちは最初からすべてを正しく行うことはできないので、その形成のプロセスはいくつかの異なるバージョンに分割されます。 ほとんどの実際の分類法の開発には、数週間から数ヶ月（さらには数年）かかります。

注：定義リンクベースまたは参照リンクベースは作成しません。 実際には、少なくとも1つを作成して概念を詳細に説明できますが、この章の目的には必要ありません。 ラベルリンクベースデータベースとプレゼンテーションリンクベースデータベースをマスターしたら、定義データベースとリソースデータベースを理解するのに問題はないはずです。

6.1。 降りる

この例の簡単な分類から始めましょう。

6.1.1。 分類スキーマ

まず、分類法を含むドキュメントが必要です。

ドキュメント名に分類法の作成日を使用して、異なる時間に作成された分類法のバージョンを簡単に区別することをお勧めします。

2006年の初日に小さなプロジェクトを開始すると想像してみましょう（ 翻訳者のメモ：このパンフレットは10年以上前です ）。次に、「sample-2006-01-01.xsd」のように分類法を使用してドキュメントの最初のバージョンに名前を付けます。 少しずつ分類して、段階的に分類法を作成します。 この章の各セクションには1日かかることに同意します（バージョン管理の便宜上）。

6.1.1.1。 スキーマルート

他のXMLスキーマと同様に、ルートschema要素から始めschema 。

 <schema targetNamespace="http://www.sample.com/2006-01-01" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:xbrli="http://www.xbrl.org/2003/instance" xmlns:link="http://www.xbrl.org/2003/linkbase" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:sample="http://www.sample.com/2006-01-01"> ... </schema> 

ルート要素内の属性に注意してください。

• targetNameSpace
  スキーマ要素の名前空間を定義します。 分類法または関連レポートの処理に使用されるスキーマサポートソフトウェアは、この名前空間を使用して、スキーマまたはその一部を参照する必要があります。

残りの属性は、回路要素のプレフィックスを定義します。 接頭辞は、要素を定義する名前空間を示します。

• xmlns
  XML Schema名前空間-プレフィックスなしのすべての要素のデフォルト値です。
• xmlns:xbrli
  XBRLレポート名前空間（インスタンス）;
• xmlns:link
  XBRL Link名前空間。
• xmlns:xlink
  XML Schema XLink名前空間。
• xmlns:sample
  最後に、ターゲット名前空間にある定義済みの要素には、接頭辞sampleが付きsample 。

以下のすべてのドキュメントは、ルート要素に同じ名前空間定義属性を持っています。 新しいタイプの要素ごとに個別に説明しません。

XBRL仕様には、いくつかのスキームが含まれています。

• XBRLインスタンス
  事実と概念の宣言に必要な定義（タイプ、属性、要素）が含まれています。
• XBRLリンクベース
  分類法の一部（またはリンクのデータベース）から別の部分へのリンクを宣言するために必要な定義が含まれています。
• XBRL XLink
  リンクベース自体を宣言するために使用され、独自のXBRL仕様拡張を作成するときにこの名前空間が必要になります。
• W3C XLink
  XMLリンクの名前空間。 W3Cはこのスキーマを提供しないが、XBRL仕様には必要であるため、仕様のこの部分のスキーマはxbrl.orgにあることに注意してください。

6.1.1.2。 レポートスキーマのインポート

次の手順では、XBRLレポートスキーマをインポートして、その定義を要素定義で使用できるようにします。

 <import namespace="http://www.xbrl.org/2003/instance" schemaLocation="http://www.xbrl.org/2003/xbrl-instance-2003-12-31.xsd" /> 

import要素は、名前空間によって識別されるスキーマを正確に識別する必要があります。 schemaLocation属性のURIによって参照されるスキーマドキュメントは、実際に存在する必要があります。

XBRLレポートスキーマはXBRL Linkbaseスキーマをインポートし、次にXBRL XLinkおよびW3C XLinkスキーマをインポートします。 これは、これらのスキームを自分でインポートする必要がないことを意味します。

W3C XML Schema名前空間は標準化されており、スキーマサポートソフトウェアによって自動的に認識されます。

6.1.1.3。 コンセプト

分類法の概念は、スキーマの要素として定義されます。 この例から、以前に次の概念を受け取りました。

従業員の総数を反映する概念は、次のように定義されます。

 <element id="sample_nr_employees_total" name="nr_employees_total" xbrli:periodType="instant" type="xbrli:nonNegativeIntegerItemType" substitutionGroup="xbrli:item" nillable="true" /> 

コンセプトの属性を分析しましょう：

• id
  この識別子は、リンクベースなどの他のドキュメントの概念を参照するために使用されます。 回路内で一意でなければなりません。 コンセプトIDには、プレフィックス 'sample_'を使用してグローバルに一意にしました。
• name
  この属性で指定された名前は、分類法およびレポート内の概念を識別します。 分類内で一意である必要があります。
• xbrli:periodType
  各コンセプトには、期間タイプが関連付けられている必要があります。 この例では、従業員数は期間の開始時と終了時、つまり日付に示されています 。 このような概念の場合、 instant値instantます。
• type
  従業員数は整数です。 パートタイムの従業員も、割合ではなく単位と見なされます。 負の数の従業員は存在できないため、XBRLレポートスキーマで定義されたnonNegativeIntegerItemTypeタイプを使用します。
• substitutionGroup
  これは単純な概念であり、タプルではないため、ここではXBRLレポートスキーマで定義されたitemの値を指定します。
• nillable
  概念を常にnillableとして示すことをお勧めします。これにより、空の事実を伝えることができます。

他の概念も同様に定義されていますが、それぞれに独自のidおよびname属性値があります。

また、レポートのプレゼンテーション階層のルートとして機能する抽象概念も必要です。 （任意に）タイプxbrli:stringItemTypeます。 アブストラクトは事実を伝えるために使用されないため、XBRL仕様の要件を満たす任意のタイプを指定できます。

 <element id="sample_presentation_root" name="presentation_root" xbrli:periodType="instant" type="xbrli:stringItemType" substitutionGroup="xbrli:item" abstract="true" nillable="true" /> 

抽象概念には、値true abstract属性が必要true 。

6.1.1.4。 リンクデータベースへのリンク

完全な分類またはレポートを表示する場合は、リンクデータベースの形式で概念に関する追加情報を提供する必要があります。 ラベルのベースとプレゼンテーションのベースの2つから始めましょう。

リンクベースとの接続は、 annotation要素内にあるappinfo要素で示されます。

 <annotation> <appinfo> <link:linkbaseRef xlink:type="simple" xlink:href="sample-2006-01-01-label.xml" xlink:role="http://www.xbrl.org/2003/role/labelLinkbaseRef" xlink:arcrole="http://www.w3.org/1999/xlink/properties/linkbase" /> <link:linkbaseRef xlink:type="simple" xlink:href="sample-2006-01-01-presentation.xml" xlink:role="http://www.xbrl.org/2003/role/presentationLinkbaseRef" xlink:arcrole="http://www.w3.org/1999/xlink/properties/linkbase" /> </appinfo> </annotation> 

リンクデータベースには次の属性があります。

• xlink:type
  ここでsimple常にsimple示されます。
• xlink:href
  この属性は、データベース自体へのリンクを示します。 この例では、ラベルとプレゼンテーションのデータベースを参照しますが、これについては後で説明します。
• xlink:role
  ロール属性は、リンクベースのタイプを定義します。 XBRL Linkingスキーマで定義されたlabelLinkbaseRefおよびpresentationLinkbaseRef値を使用します。
• xlink:arcrole
  リンクデータベースに対するアークの役割は、XLinkで定義されたlinkbase値によって常に示されます。

6.1.2。 ショートカットリンクベース

ショートカットデータベースには、3種類の要素が含まれています。

• ラベル付けされた分類概念を定義するためのロケーター
• ラベル自体を含むリソース
• （ロケーターを介して）コンセプトをラベルに接続するラベルアーク。

これらの要素はlabelLink要素内に配置されます。

 <?xml version="1.0" encoding="UTF-8"?> <linkbase xmlns="http://www.xbrl.org/2003/linkbase" xmlns:xbrli="http://www.xbrl.org/2003/instance" xsi:schemaLocation="http://www.xbrl.org/2003/instance http://www.xbrl.org/2003/xbrl-instance-2003-12-31.xsd" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sample="http://www.sample.com/2006-01-01"> <labelLink xlink:type="extended" xlink:role="http://www.xbrl.org/2003/role/link"> ... </labelLink> </linkbase> 

labelLink要素には次の属性があります。

• xlink:type
extended常にここに示されます。
• xlink:role
  リンクの場合、 linkロールがデフォルトで使用されます。

6.1.2.1。 ロケーター

ロケーターはloc要素に配置されます。 それらは、関連する分類法の概念を示しています。

 <loc xlink:type="locator" xlink:href="sample-2006-01-01.xsd#sample_nr_employees_total" xlink:label="concept_nr_employees_total" /> 

• xlink:type
locatorタイプは、常にloc要素タイプによって指定されます。つまり、ロケーター（概念の）として使用されます。
• xlink:href
  コンセプトの実際の場所を示します。 ここではidを使用していることに注意してください。
• xlink:label
  ロケーターには、リンクデータベース内でアクセスするためのショートカットが割り当てられます。 ラベル値として、接頭辞「concept_」が付いたコンセプトIDを使用します。

6.1.2.2。 ショートカット

ラベルを定義するには、 label要素を使用します。

 <label xlink:type="resource" xlink:label="label_nr_employees_total" xlink:role="http://www.xbrl.org/2003/role/label" xml:lang="en">Total number employees</label> <label xlink:type="resource" xlink:label="label_nr_employees_total" xlink:role="http://www.xbrl.org/2003/role/terseLabel" xml:lang="en">Total</label> <label xlink:type="resource" xlink:label="label_nr_employees_total" xlink:role="http://www.xbrl.org/2003/role/verboseLabel" xml:lang="en">Total number of employees</label> 

• xlink:type
  タイプは常に値 'resource'であり、ショートカットがローカルリンクベースリソースであることを示します。
• xlink:label
  ロケーターと同様に、 label属性の値により、リンクデータベース内のラベルにアクセスできます。 上記の各ラベルは同じ概念に関連付けられており、すべてのラベルが同じ属性値を使用していることに注意してください。 これにより、概念からそのショートカットへの1対多の関係を使用できます。 この例では、これらは「nr_employees_total」の概念に対する3種類のラベルです。
• xlink:role
  役割は、使用されるラベルのタイプを決定します。 XBRL仕様は、多数の事前定義されたロールを提供します。 例では、通常のショートカット、拡張されたショートカットの3つのタイプを使用します。 分類法またはXBRLレポートを操作するアプリケーションを使用すると、最も適切なタイプのラベルを選択できます。 プレゼンテーションリンクデータベースは、好みのショートカットビューを示すこともできます。
• xml:lang
  この属性は、ラベルの言語を示します。 この例では、英語のみを使用していますが、リンクデータベースの任意の言語のショートカットを含めることができます。

6.1.2.3。 ショートカットアーク

最後に、概念とショートカットリソースのロケーターを定義した後、ショートカットアークを使用してそれらをリンクできます。

 <labelArc xlink:type="arc" xlink:arcrole="http://www.xbrl.org/2003/arcrole/concept-label" xlink:from="concept_nr_employees_total" xlink:to="label_nr_employees_total" /> 

• xlink:type
  タイプは常に「arc」、つまりアーク（ だれが考えたでしょうか ）を示します。
• xlink:arcrole
  アークの役割により、接続のタイプが決まります。 ラベルの場合、「概念ラベル」が指定されます。これは、概念とラベルの間の弧です。
• xlink:from
  アークの側面の1つ、この場合は概念を示します。 この属性の値としてロケーターlabelを使用します。
• xlink:to
  ラベルリソースを使用して、アークの2番目の側面であるラベルリソースを示します。

3つの異なるラベルに同じlabelを使用したため、アークはコンセプトとそのラベルの間に1対多の関係を形成します。

6.1.3。 プレゼンテーションリンクベース

プレゼンテーションには2種類の要素が含まれます。

• プレゼンテーション階層で使用される分類概念のロケーター。
• ロケーターを介して概念を相互に接続する表現の弧。

それらはすべてpresentationLink要素内にあります。

 <?xml version="1.0" encoding="utf-8"?> <linkbase xmlns="http://www.xbrl.org/2003/linkbase" xmlns:link="http://www.xbrl.org/2003/linkbase" xmlns:xbrli="http://www.xbrl.org/2003/instance" xsi:schemaLocation="http://www.xbrl.org/2003/instance http://www.xbrl.org/2003/xbrl-instance-2003-12-31.xsd" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" > <presentationLink xlink:type="extended" xlink:role="http://www.xbrl.org/2003/role/link" > ... </presentationLink> </linkbase> 

6.1.3.1。 ロケーター

ここでは、すべてがショートカットリンクのデータベースに似ているため、繰り返しません。

6.1.3.2。 プレゼンテーションアーク

プレゼンテーションアークは、概念を親子階層（ ツリー ）にリンクします。

 <presentationArc xlink:type="arc" xlink:arcrole="http://www.xbrl.org/2003/arcrole/parent-child" xlink:from="concept_presentation_root" xlink:to="concept_nr_employees_total" order="1" priority="0" use="optional" preferredLabel="http://www.xbrl.org/2003/role/label" /> <presentationArc xlink:type="arc" xlink:arcrole="http://www.xbrl.org/2003/arcrole/parent-child" xlink:from="concept_presentation_root" xlink:to="concept_nr_employees_male" order="2" priority="0" use="optional" preferredLabel="http://www.xbrl.org/2003/role/terseLabel" /> <presentationArc xlink:type="arc" xlink:arcrole="http://www.xbrl.org/2003/arcrole/parent-child" xlink:from="concept_presentation_root" xlink:to="concept_nr_employees_female" order="3" priority="0" use="optional" preferredLabel="http://www.xbrl.org/2003/role/terseLabel" /> ... 

• xlink:type
  前と同じように、「アーク」。
• xlink:arcrole
  プレゼンテーションアークの役割は「親子」であり、プレゼンテーションリンクベースが階層構造であることを示します。
• xlink:from
  ロケーターを介して親階層の概念を指します。 この例では、適切な概念がなかったため、階層のルートには「presentation_root」という抽象概念を使用します。
• xlink:to
  ロケーターを介して子階層の概念を指します。 この例では、すべての概念は「presentation_root」のルート概念の下にあります。
• order
  この属性は、共通の親の下にある子の順序を設定します。
• priority
  リンクベースの再定義に使用されます。 この例では、（今のところ）これを行っていません。
• use
optionalを指定することoptional 、概念がプレゼンテーションネットワークの一部になることができることを意味します。 この値を示すことは一般的な習慣ですが、属性がない場合はデフォルトで使用されます。
• preferredLabel
  前に、ショートカットリンクデータベースにいくつかの種類のショートカットを作成しました。 ここでは、子（to）アークコンセプトの優先ショートカットタイプがプレゼンテーションリンクデータベースでどのように示されるかを確認します。

注： preferredLabel属性は子概念に対してのみ指定できるため、プレゼンテーション階層のルート要素に優先ラベルビューを含めることはできません。

6.1.4。 XBRLレポート

分類法を作成したら、それを使用してレポートを作成できます。

XBRLレポートドキュメントには、次のタイプの要素が含まれます。

• 分類法への参照。
• 事実のコンテキスト。
• 数値的事実の単位。
• 事実自体の意味。

これらの要素はすべて、 xbrl要素内に配置されます。

 <?xml version="1.0" encoding="utf-8"?> <xbrl xmlns="http://www.xbrl.org/2003/instance" xmlns:link="http://www.xbrl.org/2003/linkbase" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:iso4217="http://www.xbrl.org/2003/iso4217" xmlns:s="http://www.sample.com/2006-01-01"> ... </xbrl> 

6.1.4.1。 分類法スキーマへのリンク

スキーマへの参照は、 schemaRef要素で示されます。

 <link:schemaRef xlink:type="simple" xlink:href="http://www.sample.com/2006-01-01/sample-2006-01-01.xsd" /> 

• xlink:type
  接続のタイプ「単純」を指定します。
• xlink:href
  リンクはhref属性として指定されます。 作成者のサイトでの分類スキーマの場所を示します。

6.1.4.2。 コンテキスト

この例では、レポート期間の開始とレポート期間の終了という2つのコンテキストがあります。

 <context id="c_start"> <entity> <identifier scheme="http://www.statistics.org">12-34567</identifier> </entity> <period> <instant>2016-01-01</instant> </period> </context> <context id="c_end"> <entity> <identifier scheme="http://www.statistics.org">12-34567</identifier> </entity> <period> <instant>2016-12-31</instant> </period> </context> 

• id
  事実をコンテキストに関連付けるために使用されます。 この値は、レポート内で一意である必要があります。
• entity
  レポートがコンパイルされる組織を示します。
  
  • identifier
    この要素は、 schemeを使用して、どの組織が報告しているかを判断します。 この例では、架空のサイトで存在しないスキームを使用しています。
• period
  コンテキストの期間または日付がここに示されます。
  
  • instant
    この例では、レポート期間の開始日と終了日に対して、それぞれ2つのインスタントコンテキストがあります。

identifier要素で提供されるリンクは、レポート組織の識別子を公開する存在しない統計組織を指します。 架空の会社の識別子は「12 -34567」です。 現実の世界では、たとえば国税当局で株式市場のティッカーや組織識別子を使用します。

6.1.4.3。 単位

すべての数値的事実について、測定単位を示す必要があります。

 <unit id="u_person"> <measure>Person</measure> </unit> 

• id
  ファクトを測定単位に関連付けるために使用されます。 この値は、レポート内で一意である必要があります。
• measure
  測定単位を識別します。 この例では、独自の測定単位「Person」を定義しました。

6.1.4.4。 事実

これで、演習全体の最終目標である事実の転送にようやく到達しました。

 <s:nr_employees_total contextRef="c_start" unitRef="u_person" decimals="0">35</s:nr_employees_total> <s:nr_employees_total contextRef="c_end" unitRef="u_person" decimals="0">41</s:nr_employees_total> <!--  --> <s:nr_employees_male contextRef="c_start" unitRef="u_person" decimals="0">23</s:nr_employees_male> <s:nr_employees_male contextRef="c_end" unitRef="u_person" decimals="0">27</s:nr_employees_male> <s:nr_employees_female contextRef="c_start" unitRef="u_person" decimals="0">12</s:nr_employees_female> <s:nr_employees_female contextRef="c_end" unitRef="u_person" decimals="0">15</s:nr_employees_female> <!--   --> <s:nr_employees_age_up_to_20 contextRef="c_start" unitRef="u_person" decimals="0">5</s:nr_employees_age_up_to_20> <s:nr_employees_age_up_to_20 contextRef="c_end" unitRef="u_person" decimals="0">9</s:nr_employees_age_up_to_20> <s:nr_employees_age_21_to_40 contextRef="c_start" unitRef="u_person" decimals="0">23</s:nr_employees_age_21_to_40> <s:nr_employees_age_21_to_40 contextRef="c_end" unitRef="u_person" decimals="0">21</s:nr_employees_age_21_to_40> <s:nr_employees_age_41_and_up contextRef="c_start" unitRef="u_person" decimals="0">7</s:nr_employees_age_41_and_up> <s:nr_employees_age_41_and_up contextRef="c_end" unitRef="u_person" decimals="0">11</s:nr_employees_age_41_and_up> 

各ファクトは、概念に関連する個別の要素です。 要素の値は、ファクトの値です。

• contextRef
  各ファクトは、コンテキストidを通じてそのコンテキストを参照します。 この例には、各コンテキストの各コンセプトのファクトが含まれています。
• unitRef
  すべての数値的事実について測定単位を指定する必要があるため、この例では「u_person」をここに入力します。
• decimals
  数値ファクトの場合、属性の1つ（ decimals （小数位）またはprecision （精度））を指定する必要があります。 この例では、すべてのファクトは整数であるため、「0」の値でdecimalsを指定します。

6.1.5。 誇りを持ってサービスを提供-XBRLレポート

すべての作業が完了した後、分類法、特にプレゼンテーションとラベルのリンクベースに関連してレポートがどのように形成されるかを確認したいと思います。

これを行うために、レポート用のWebページを作成し、表形式で事実を表示するシンプルなツールを使用します。 テーブルの列にコンテキストを配置し、その左側にあるラベルリンクデータベースのコンセプトラベルを配置します。 プレゼンテーションリンクベースで定義された概念階層は、ファクトの順序とインデントを設定します。

結果は次のようになります。

さて、今日は良い仕事をしました！

章のナビゲーション

• 翻訳者からのコメント
• 第1章はじめに
• 第2章XBRLとは何ですか？
• 第3章分類の解剖学
• 第4章XBRLレポート
• 第5章新しい次元の発見
• 第6章XBRLへのダイビング
  
  • パート1.はじめに
  • パート2.結果の改善
  • パート3.計算と検証
  • パート4.生活を楽にする方法
  • パート5.新しい次元
  • パート6.多次元性
• 翻訳者からのPS