The <importBase> element allows for incorporating an entity base (represented by <connectorBase>, <regionBase>, <descriptorBase>, <ruleBase> or <transitionBase> elementsdefined in an external document) to another already-defined base. ItsdocumentURIattribute refers to a URI corresponding to the NCL document containing the base to be imported. The alias attribute specifies a name to be used as prefix when referring to elements of this imported base. The reference must have the format: alias#element_id.
The import operation is transitive, that is, if baseA imports baseB that imports baseC, then baseA imports baseC. However, the alias defined for baseC inside baseB is not considered by baseA.
The following constraints must be satisfied:
Element | Attributes | Content | Parent |
---|---|---|---|
<importBase> | alias, documentURI, region, baseId | – | <ruleBase> or <transitionBase> or <regionBase> or <descriptorBase> or <connectorBase> |
Name | Value | Description |
---|---|---|
alias | It may receive any string value that begins with a letter or an underscore and that only contains letters, digits, “.”, and “_”. | The alias attribute specifies a name to be used as prefix when referring to elements of the imported base. The alias value must be unique in a document ands its scope is constrained to the document that has defined the alias attribute. |
documentURI | URI. | The documentURI attribute is the locator for the NCL document from where the base or document will be imported. |
region | IDREF. | The region attribute may be used when importing a <regionBase>. It identifies a <region> element of the importing document that will nest (will be the parent region) all imported <region> elements. |
baseId | IDREF. | The baseId attribute may be used when importing a <regionBase>. It defines the <regionBase> element to be imported through its id value. |