External Definition (2nd Root)¶
Description¶
The ExternalDefiniton element defines an alternative root element for MPFO-XML documents. It allows the definition of mission profile information that is either independent of a component or which contains reusable and/or standardized information. This element is used by the XML XInlude mechanism of MPFO-XML documents to allow the validation of externally defined MPFO-XML data (e.g., stdlib.xml or LV124.xml). The usability of MPFO-XML documents is greatly improved by the ExternalDefiniton and Include elements since standard definitions, such as standard loads or functions, can be defined in a reusable and modular fashion.
Definition of ‘ExternalDefinition’ Element¶
The ExternalDefinition element is formally defined here: ExternalDefinition
Parsing Directives and Checks on Application Level¶
By itself, MPFO-XML documents with a root element ExternalDefiniton represent valid XML documents. They can be validated with XML tools as described in section Document Validation.
The ExternalDefiniton element and its contents shall be ignored (with a warning) during the processing of MPFO-XML documents since they do not represent valid and self-contained MPFO-XML documents on their own.
Examples¶
Example 1: Excerpt from the ./include/LV124.xml MPOF-XML file which uses *ExternalDefinition* as (alternative) root element
<?xml version="1.0" encoding="UTF-8"?>
<ExternalDefinition xmlns="http://www.mpfo.org/mpfo-0.7"
Id="ID.ExternalDefinition.LV124"
MPFoVersion="0.7"
xmlns:mml="http://www.w3.org/1998/Math/MathML">
<LoadDefinition>
<Loads>
<!-- Load E-01: Long-term Overvoltage -->
<Load Id="ID.Load-LV124-E-01">
<LoadQuantity Symbol="U">
<SymbolicFunction Id="ID.SymbolicFunction-LV124-E-01">
<!-- Function: U(t) with parameters Umax (V), Umin (V), tr (s), tf (s), t1 (s) -->
<SymbolicFunctionTemplate Id="ID.SymbolicFunctionTemplate-LV124-E-01" Symbol="U">
<Unit>
<mml:math>
<mml:csymbol cd="SI_NamedDerivedUnits1">volt</mml:csymbol>
</mml:math>
</Unit>
<Arguments>
<ArgumentWithUnit Symbol="t">
<Unit>
<mml:math>
<mml:csymbol cd="SI_BaseUnits1">second</mml:csymbol>
</mml:math>
</Unit>
</ArgumentWithUnit>
</Arguments>
...
</SymbolicFunctionTemplate>
</SymbolicFunction>
</LoadQuantity>
</Load>
</Loads>
</LoadDefinition>
</ExternalDefinition>
Example 2: Include of externally defined MPFO-XML data in a mission profile document
<MPFo xmlns:m="http://www.w3.org/1998/Math/MathML"
xmlns="http://www.mpfo.org/mpfo-0.7"
xmlns:mml="http://www.w3.org/1998/Math/MathML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.mpfo.org/mpfo-0.7 http://www.mpfo.org/mpfo-0.7/mpfo.xsd"
Id="ID.Component.R1"
MPFoVersion="0.7"
ShortDescription="Example: Simple two-port electrical resistor R1 that is operated with a DC current for 55h at 298K (25C) and 350h at 423K (150C)">
<!-- Include external definitions -->
<Include>
<!-- Include external MPFO standard definitions -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="./include/stdlib.xml"/>
<!-- Include external load definitions from LV124 -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="./include/LV124.xml"/>
</Include>
...
</MPFo>
Example 3: MPFO-XML document with encrypted contents
Attention
To be added!