|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface DiscoverableTaxonomySet
While a taxonomy defines reporting concepts, it does not contain the actual values of facts based on the defined concepts. The fact values are contained in XBRL instances and are referred to as “facts”. Besides the actual value of a fact, such as “cash is 500,000”, the XBRL instance provides contextual information necessary for interpreting the fact values. For numeric facts, the XBRL instance also documents measurement accuracy and measurement units.
An instance document can be supported by more than one taxonomy. Also, taxonomies can be interconnected, extending and modifying each other in various ways. Generally, it is necessary to consider multiple related taxonomies together when interpreting an XBRL instance. The set of related taxonomies supporting an XBRL instance is called a Discoverable Taxonomy SetImpl (DTS). A DTS is a collection of taxonomy schemas and linkbases.
The bounds of a DTS are determined by starting from some set of documents (instance, taxonomy schema, or linkbase) and following DTS discovery rules. Although an instance document can be the starting point for DTS discovery, the instance document itself is not part of the DTS. Taxonomy schemas and linkbases that are used as starting points for DTS discovery are part of the DTS that they discover. DTS rules of discovery:
Taxonomy schemas in the DTS are those:
1. referenced directly from an instance document using the schemaRef, roleRef or arcroleRef element. The xlink:href attribute on the schemaRef, roleRef or arcroleRef element contains the URL of the taxonomy schema that is discovered. Every taxonomy schema that is referenced by the schemaRef, roleRef or arcroleRef element MUST be discovered.
2. referenced from a discovered taxonomy schema via an XML Schema import or include element. Every taxonomy schema that is referenced by an import or include element in a discovered taxonomy schema MUST be discovered.
3. referenced from a discovered linkbase document via a loc element. Every taxonomy schema that is referenced by an xlink:href attribute on a loc element in a discovered linkbase MUST be discovered.
4. referenced from a discovered linkbase document via a roleRef element. Every taxonomy schema that is referenced by an xlink:href attribute on a roleRef element in a discovered linkbase MUST be discovered.
5. referenced from a discovered linkbase document via an arcroleRef element. Every taxonomy schema that is referenced by an xlink:href attribute on an arcroleRef element in a discovered linkbase MUST be discovered.
Linkbase documents in the DTS are those:
1. referenced directly from an XBRL instance via the linkbaseRef element. The xlink:href attribute contains the URL of the linkbase document being discovered. Every linkbase that is referenced by the linkbaseRef element MUST be discovered.
2. referenced from a discovered taxonomy schema via the linkbaseRef element. The xlink:href attribute contains the URL of the linkbase being discovered. Every linkbase that is referenced by the linkbaseRef element MUST be discovered.
3. that occur at the XPath "schema/annotation/appinfo/*" in a discovered taxonomy schema (Throughout this specification, schema, annotation and appinfo are all elements defined in the XML Schema namespace).
4. referenced from a discovered linkbase document via a loc element. Every linkbase that contains a resource that is referenced by an xlink:href attribute on a loc element in a discovered linkbase MUST be discovered.
Copyright 2006 J2R BV, The Netherlands.
Part of Licensed Materials.
www.batavia-xbrl.com
| Method Summary | |
|---|---|
void |
addBaseDTS(DiscoverableTaxonomySet baseDTS,
java.lang.String urlMainSchema)
|
void |
addLinkbase(java.lang.String parentUrl,
java.lang.String URL,
LinkbaseContainer aPart)
Add the linkbaseContainer to this DTS. |
void |
addTaxonomySchema(java.lang.String parentUrl,
java.lang.String URL,
Root aPart)
Add the schema to this DTS. |
void |
clear()
|
void |
completeInstance(Xbrl xbrlElement)
complete xbrlElement with the content of the DTS for PTVI. |
InstanceDocument |
createEmptyInstanceDocument()
Create an empty instancedocument with the mainTaxonomySchema as default namespace |
InstanceDocument |
createPopulatedInstanceDocument(boolean includeDefaultValues)
Create an populated instancedocument without data with the mainTaxonomySchema as default namespace all possible Facts are created and added. |
void |
discoverDocument(java.lang.String referringSchemaNamespaceUri,
java.lang.String parentURL,
TaxonomyDocument parent)
|
void |
discoverDocument(java.lang.String parentURL,
TaxonomyDocument parent)
Use the parent to discover the whole DTS Taxonomy schemas in the DTS are those: 1. referenced directly from an instance document using the schemaRef, roleRef or arcroleRef element. |
void |
discoverDocumentRoot(java.lang.String parentURL,
Xbrl root)
Discover this DTS based on the given xbrl element and the parentURL that identified the document the xbrl root is contained by. |
void |
discoverLinkbase(java.lang.String parentUrl,
java.lang.String href,
LinkbaseDocument linkbaseDoc)
Discover the given linkbase document that was found through the given href which was located in the document found at the location of parentUrl. |
void |
discoverNetworks()
Discover the networks of nodes/concepts that are connected by the arcs in this DTS: check the networks with the cycles allowed attribute on the arcRoleType elements The concepts that are related do not know they are! |
TaxonomyDocument |
discoverUrl(java.lang.String targetNamespaceUri,
java.lang.String parentUrl,
java.lang.String URL)
Discover the TaxonomyDocument found at the URL relative to the parentURL for this DTS. |
java.util.List |
findNetworks(java.lang.String linkLocalName)
|
java.util.List |
findNetworks(java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
Find the networks constructed with the given arguments, arc local name and namespace, arcRole, link local name and namespace, linkRole. |
java.util.List |
findNetworksFromTo(IdHolder source,
IdHolder target,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
|
java.util.List |
findNetworksUsingConcept(Concept concept,
java.lang.String linkLocalName)
Find the networks in which the given concept is used for the given link local name. return a list with the found networks |
java.util.List |
findNetworksUsingConcept(Concept concept,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
Find the networks in which the given concept is used for the given arguments, arc local name and namespace, arcRole, link local name and namespace, linkRole. |
java.util.List |
findNetworksUsingConceptWithFilters(Concept concept,
java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
Find the networks in which the given concept is used for the given link local name and filters with sub uris. return a list with the found networks |
java.util.List |
findNetworksUsingConceptWithFilters(Concept concept,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole,
java.util.List requiredExtendedLinkSubRoleUris)
Find the networks in which the given concept is used for the given arguments, arc local name and namespace, arcRole, link local name and namespace, linkRole and filters with sub uris. |
java.util.List |
findNetworksWithFilters(java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
|
java.util.List |
findNetworksWithFilters(java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole,
java.util.List requiredExtendedLinkSubRoleUris)
Find the networks constructed with the given arguments, arc local name and namespace, arcRole, link local name and namespace, linkRole and filters with sub uris. |
java.util.List |
findRolesUsingConcept(Concept concept,
java.lang.String linkLocalName)
Find the role uris in whose networks the given concept is used for the given link local name. return a list with the found uris |
java.util.List |
findRolesUsingConceptWithFilters(Concept concept,
java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
Find the role uris in whose networks the given concept is used for the given link local name and filters with sub uris. return a list with the found uris |
XbrlType |
findWrapper(com.sun.msv.datatype.xsd.XSDatatype wrappedXmlSchemaDatatype)
Get the XbrlConceptType that uses the given XSDatatype |
java.util.Map |
getAllDiscoveredNetworks()
|
ArcroleType |
getArcRoleType(java.lang.String uri)
|
java.util.Map |
getCalculationMaps(Concept aConcept)
Get a Map with the calculation related concepts(contributing concepts) for the given summation concept. |
Concept |
getConcept(FullyQualifiedName qName)
Get the required Concept from the knowConcepts map. |
Declaration |
getDeclaration(FullyQualifiedName qName)
|
java.util.List |
getDiscoveredNetworks(NetworkIndicator id)
Get the collection of discovered notworks in this DTS that can be identified by the given NetworkIndicator |
java.lang.String |
getDtsKey()
|
ValidationDocument |
getDtsMessages()
|
java.util.List |
getDtsUrls()
|
java.util.Map |
getEssenceAliasDefinition(Concept aConcept)
Get a Map with the essence-alias definitions for the given concept. |
java.util.Map |
getGeneralSpecialDefinition(Concept aConcept)
Get a Map with the general-special definitions for the given concept. |
Group |
getGroup(FullyQualifiedName qName)
|
IdHolder |
getIdHolder(java.lang.String baseUrl,
java.lang.String xlinkHref,
InstanceDocument instance)
use the xlinkHref to find the documentroot and the id-ed fragment |
java.util.Map |
getIndicators()
|
java.util.Map |
getKnownArcroleTypes()
|
java.util.Map |
getKnownAttributeGroups()
|
java.util.Map |
getKnownAttributes()
|
java.util.Map |
getKnownConcepts()
|
Set |
getKnownConceptsInTupleConceptsQnames()
|
java.util.Map |
getKnownDeclarations()
|
java.util.Map |
getKnownGroups()
|
java.util.Map |
getKnownItemTupleConcepts()
|
java.util.Map |
getKnownRoleTypes()
|
java.util.Map |
getKnownTypes()
|
java.util.Map |
getKnownXbrlTypes()
|
java.util.List |
getLabels(Concept aConcept)
Get the collection of Label resources in the DTS that apply to the given concept. |
LinkbaseContainer |
getLinkBase(java.lang.String parentUrl,
java.lang.String URL)
get the LinkbaseContainer that was found at the URL location relative to the parentUrl. |
java.util.Map |
getLinkbases()
Get the linkbases that are contained by this DTS mapped to their document href |
TaxonomySchema |
getMainTaxonomySchema()
|
java.util.Map |
getNetworkBaseSets()
|
java.util.Map |
getNetworks()
|
java.util.List |
getOrderedRoles()
|
java.util.List |
getReferences(Concept aConcept)
Get the collection of reference resources in the DTS that apply to the given concept. |
java.util.Map |
getRequiresElementDefinition(Concept aConcept)
Get a Map with the requires-element definitions for the given concept. |
RoleType |
getRoleType(java.lang.String uri)
get the roletype from this DTS that has the given uri |
java.util.Map |
getSimilarTuplesDefinition(Concept aConcept)
Get a Map with the similar tuple definitions for the given concept. |
java.util.Map |
getSubstitutions()
|
java.util.List |
getSubstitutions(Declaration declaration)
gets a list with ALL substitutions for the given declaration |
java.util.List |
getSupportedLanguageCodes()
|
java.util.Map |
getTaxonomySchemas()
Get the schemas that are contained by this DTS mapped to their document href |
java.util.List |
getTuplesWithRefTo(Concept aConcept)
Get a list of tuples that contains the given Concept |
XbrlType |
getType(FullyQualifiedName qName)
Get the required type from the knowTypes map. |
com.sun.msv.datatype.xsd.XSDatatype |
getXSDatatypeByName(java.lang.String name,
XmlParticle parent)
Get the XSDatatype that has the given name. |
java.util.Map |
getXSDatatypes()
|
java.util.Map |
getXSDatatypesToConceptTypes()
|
boolean |
isValid()
Return true when the DTS is valid |
boolean |
isXbrlInstanceSchemaImported()
|
void |
putXSDatatypeByName(FullyQualifiedName qName,
com.sun.msv.datatype.xsd.XSDatatype wrappedXmlSchemaDatatype,
XbrlType wrappingXbrlConceptType)
Make sure the wrappingXbrlConceptType can be retreived for later use based on the name for the target namespace Make sure the wrappedXmlSchemaDatatype can be retreived for later use based on the given qName. |
void |
removeLinkbase(java.lang.String URI)
Remove the linkbase from this DTS that was found at the absolute location URI. |
void |
removeTaxonomySchema(java.lang.String URI)
Remove the schema from this DTS that was found at the absolute location URI. |
void |
setDtsKey(java.lang.String dtsKey)
|
void |
setKnownConceptsInTupleConcepts(Set knownConceptsInTupleConcepts)
|
void |
setMainTaxonomySchema(TaxonomySchema mainTaxonomySchema)
|
void |
setValid(boolean valid)
|
void |
setXbrlInstanceSchemaImported(boolean xbrlInstanceSchemaImported)
|
void |
setXSDatatypes(java.util.Map datatypes)
|
void |
setXSDatatypesToConceptTypes(java.util.Map datatypesToConceptTypes)
|
boolean |
validate()
Validate this xbrl part (of the instance and/or its supporting discoverable taxonomy set) and add messages on any problem to the given XbrlValidationMessages collection. |
boolean |
validateInstance(Xbrl xbrlElement,
ValidationDocument msgs)
validate xbrlElement with the content of the DTS. |
| Method Detail |
|---|
java.util.List getSubstitutions(Declaration declaration)
java.lang.String getDtsKey()
void setDtsKey(java.lang.String dtsKey)
dtsKey - The dtsKey to set.ValidationDocument getDtsMessages()
void discoverDocumentRoot(java.lang.String parentURL,
Xbrl root)
parentURL - root - java.util.Map getEssenceAliasDefinition(Concept aConcept)
aConcept -
java.util.Map getSimilarTuplesDefinition(Concept aConcept)
aConcept -
java.util.Map getRequiresElementDefinition(Concept aConcept)
aConcept -
java.util.Map getGeneralSpecialDefinition(Concept aConcept)
aConcept -
TaxonomyDocument discoverUrl(java.lang.String targetNamespaceUri,
java.lang.String parentUrl,
java.lang.String URL)
parentUrl - URL -
java.util.List getReferences(Concept aConcept)
aConcept -
java.util.List getLabels(Concept aConcept)
aConcept -
java.util.Map getCalculationMaps(Concept aConcept)
aConcept -
XbrlType getType(FullyQualifiedName qName)
qName -
java.util.List getTuplesWithRefTo(Concept aConcept)
aConcept -
Concept getConcept(FullyQualifiedName qName)
qName -
IdHolder getIdHolder(java.lang.String baseUrl,
java.lang.String xlinkHref,
InstanceDocument instance)
xlinkHref -
void discoverNetworks()
InstanceDocument createEmptyInstanceDocument()
InstanceDocument createPopulatedInstanceDocument(boolean includeDefaultValues)
void discoverDocument(java.lang.String parentURL,
TaxonomyDocument parent)
parent -
void discoverDocument(java.lang.String referringSchemaNamespaceUri,
java.lang.String parentURL,
TaxonomyDocument parent)
void discoverLinkbase(java.lang.String parentUrl,
java.lang.String href,
LinkbaseDocument linkbaseDoc)
parentUrl - href - linkbaseDoc - boolean validate()
boolean isValid()
void setValid(boolean valid)
valid - The valid to set.
boolean validateInstance(Xbrl xbrlElement,
ValidationDocument msgs)
void completeInstance(Xbrl xbrlElement)
java.util.Map getLinkbases()
void addLinkbase(java.lang.String parentUrl,
java.lang.String URL,
LinkbaseContainer aPart)
parentUrl - URL - aPart - Group getGroup(FullyQualifiedName qName)
LinkbaseContainer getLinkBase(java.lang.String parentUrl,
java.lang.String URL)
parentUrl - URL -
void removeLinkbase(java.lang.String URI)
URI - java.util.Map getTaxonomySchemas()
void addTaxonomySchema(java.lang.String parentUrl,
java.lang.String URL,
Root aPart)
parentUrl - URL - aPart - void removeTaxonomySchema(java.lang.String URI)
URI - RoleType getRoleType(java.lang.String uri)
uri -
TaxonomySchema getMainTaxonomySchema()
void setMainTaxonomySchema(TaxonomySchema mainTaxonomySchema)
mainTaxonomySchema - The mainTaxonomySchema to set.java.util.Map getAllDiscoveredNetworks()
java.util.List getDiscoveredNetworks(NetworkIndicator id)
id -
java.util.Map getKnownTypes()
java.util.Map getKnownXbrlTypes()
java.util.Map getKnownConcepts()
java.util.Map getKnownItemTupleConcepts()
java.util.Map getKnownArcroleTypes()
void putXSDatatypeByName(FullyQualifiedName qName,
com.sun.msv.datatype.xsd.XSDatatype wrappedXmlSchemaDatatype,
XbrlType wrappingXbrlConceptType)
qName - wrappedXmlSchemaDatatype - wrappingXbrlConceptType - XbrlType findWrapper(com.sun.msv.datatype.xsd.XSDatatype wrappedXmlSchemaDatatype)
wrappedXmlSchemaDatatype -
com.sun.msv.datatype.xsd.XSDatatype getXSDatatypeByName(java.lang.String name,
XmlParticle parent)
name - parent -
java.util.Map getNetworks()
java.util.Map getNetworkBaseSets()
java.util.Map getIndicators()
java.util.Map getKnownRoleTypes()
boolean isXbrlInstanceSchemaImported()
void setXbrlInstanceSchemaImported(boolean xbrlInstanceSchemaImported)
xbrlInstanceSchemaImported - The xbrlInstanceSchemaImported to set.Set getKnownConceptsInTupleConceptsQnames()
void setKnownConceptsInTupleConcepts(Set knownConceptsInTupleConcepts)
knownConceptsInTupleConcepts - The knownConceptsInTupleConcepts to set.java.util.Map getXSDatatypes()
void setXSDatatypes(java.util.Map datatypes)
datatypes - The xSDatatypes to set.java.util.Map getXSDatatypesToConceptTypes()
void setXSDatatypesToConceptTypes(java.util.Map datatypesToConceptTypes)
datatypesToConceptTypes - The xSDatatypesToConceptTypes to set.java.util.List getSupportedLanguageCodes()
java.util.List findNetworks(java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
arcLocalName - String, local name of arc element used to construct searched networks , may be nullarcNamespace - String, namespace uri of name of arc element used to construct searched networks , may be nullarcRole - String, role uri of arcrole on arc element used to construct searched networks, may be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nulllinkNamespace - String, namespace uri of name of link element used to construct searched networks , may be nulllinkRole - String, role uri of linkrole of link element used to construct searched networks, may be null
java.util.List findNetworksUsingConcept(Concept concept,
java.lang.String linkLocalName)
concept - Concept, may not be nulllinkLocalName - String, local name of link element used to construct searched networks , may be null
java.util.List findNetworksUsingConcept(Concept concept,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
concept - Concept, may not be nullarcLocalName - String, local name of arc element used to construct searched networks , may be nullarcNamespace - String, namespace uri of name of arc element used to construct searched networks , may be nullarcRole - String, role uri of arcrole on arc element used to construct searched networks, may be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nulllinkNamespace - String, namespace uri of name of link element used to construct searched networks , may be nulllinkRole - String, role uri of linkrole of link element used to construct searched networks, may be null
java.util.List findRolesUsingConcept(Concept concept,
java.lang.String linkLocalName)
concept - Concept, may not be nulllinkLocalName - String, local name of link element used to construct searched networks , may be null
java.util.List findNetworksWithFilters(java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole,
java.util.List requiredExtendedLinkSubRoleUris)
arcLocalName - String, local name of arc element used to construct searched networks , may be nullarcNamespace - String, namespace uri of name of arc element used to construct searched networks , may be nullarcRole - String, role uri of arcrole on arc element used to construct searched networks, may be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nulllinkNamespace - String, namespace uri of name of link element used to construct searched networks , may be nulllinkRole - String, role uri of linkrole of link element used to construct searched networks, may be nullrequiredExtendedLinkSubRoleUris - List with sub uris on which the extended link roles must be filtered., may not be null
java.util.List findNetworksUsingConceptWithFilters(Concept concept,
java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
concept - Concept, may not be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nullrequiredExtendedLinkSubRoleUris - List with sub uris on which the extended link roles must be filtered., may not be null
java.util.List findNetworksUsingConceptWithFilters(Concept concept,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole,
java.util.List requiredExtendedLinkSubRoleUris)
concept - Concept, may not be nullarcLocalName - String, local name of arc element used to construct searched networks , may be nullarcNamespace - String, namespace uri of name of arc element used to construct searched networks , may be nullarcRole - String, role uri of arcrole on arc element used to construct searched networks, may be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nulllinkNamespace - String, namespace uri of name of link element used to construct searched networks , may be nulllinkRole - String, role uri of linkrole of link element used to construct searched networks, may be nullrequiredExtendedLinkSubRoleUris - List with sub uris on which the extended link roles must be filtered., may not be null
java.util.List findRolesUsingConceptWithFilters(Concept concept,
java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
concept - Concept, may not be nulllinkLocalName - String, local name of link element used to construct searched networks , may be nullrequiredExtendedLinkSubRoleUris - List with sub uris on which the extended link roles must be filtered., may not be null
java.util.List findNetworksWithFilters(java.lang.String linkLocalName,
java.util.List requiredExtendedLinkSubRoleUris)
java.util.List findNetworks(java.lang.String linkLocalName)
Declaration getDeclaration(FullyQualifiedName qName)
java.util.Map getKnownDeclarations()
java.util.Map getKnownAttributeGroups()
java.util.Map getKnownAttributes()
java.util.Map getSubstitutions()
java.util.Map getKnownGroups()
java.util.List findNetworksFromTo(IdHolder source,
IdHolder target,
java.lang.String arcLocalName,
java.lang.String arcNamespace,
java.lang.String arcRole,
java.lang.String linkLocalName,
java.lang.String linkNamespace,
java.lang.String linkRole)
ArcroleType getArcRoleType(java.lang.String uri)
void addBaseDTS(DiscoverableTaxonomySet baseDTS,
java.lang.String urlMainSchema)
void clear()
java.util.List getDtsUrls()
java.util.List getOrderedRoles()
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||