Altova XMLSpy 2024 Enterprise Edition

Relationships and Linkroles

Home Prev Top Next

When a set of relationships is created these relationships are created within a containing element. For example, when definition relationships are created, the elements defining the definition relationships (the locators and definition arcs) are all created within a definitionLink element, which looks something like this:


<link:definitionLink xlink:type="extended"



The value of the xlink:role attribute in the definition link (as in the definition link listed above) must be the value of the roleURI attribute of one of the linkroles set to be used on definition relationships (see listing below). A linkrole (as in the listing below) is contained in the appinfo element of the taxonomy.



  <link:roleType id="SegmentRevenueAndOperatingIncome"


     <link:definition>006091 - Disclosure - Segment Revenue and Operating Income</link:definition>







A linkrole can be used in the containing elements of other relationship kinds besides in definitionLink elements (for example, in calculationLink and presentationLink elements). In the listing above, notice that there are usedOn elements that specify in which kind of relationships this linkrole may be used.


To create linkroles in a concept definitions file (main taxonomy file), in XBRL View, click the menu command XBRL | Linkroles. This pops up the Link Roles dialog (screenshot below).

Click to expand/collapse

In the Taxonomies tab, select the taxonomy file from the dropdown list in the File combo box and click Add to add a linkrole. Then specify the linkrole's URI and ID (refer to listing above). Now specify for which kinds of relationships this linkrole should be available; do this by checking the check boxes of the required relationship kinds (see screenshot above).


Example file: Step 6

Create two linkroles via the Link Roles dialog (XBRL | Linkroles) as described above and shown in the screenshot above:"SegmentRevenueAndOperatingIncome" URI="" (to be used on definition, calculation, and presentation relationships)"FinancialStatements" URI="" (to be used on calculation and presentation relationships)


In the next step we will create relationships for the new taxonomy.


© 2018-2024 Altova GmbH