com.highqsoft.moma.rules.mearules

Class MdfFileValuesToComponents

java.lang.Object

com.highqsoft.xsd.AbstractImplementation

com.highqsoft.xsd.AbstractRule

com.highqsoft.moma.rules.mearules.AbstractMeasurementRule

com.highqsoft.moma.rules.mearules.MdfFileValuesToComponents

All Implemented Interfaces:

ExecutableIF, ImplementationIF, RuleIF

public class MdfFileValuesToComponents
extends AbstractMeasurementRule

\page MeasurementRules \section rules_com_highqsoft_moma_rules_mearules_MdfFileValuesToComponents MdfFileValuesToComponents \addindex MdfFileValuesToComponents This rule is used to convert values from MDF4 file to binary component files (btf). Sometimes very big measurements or testruns with many measurements must be exported to ATFX files. If the values are written using the ODS API they must be kept im memory by athos until the file is closed. This methods uses a lot of memory. \e MdfFileValuesToComponents loops over all external components and read the attributes (e.g. start offset, length, data type, ...) which references the corresponding MDF4 file. The referenced data are read from the MDF4 file and written into a binary component file. The attributes of the external component entry are updated and linked to the binary component file. There is one file for each measurement in the MeasurementHolder. The name of the file is MEA.BTF. During the transfer of the data, all data are stored LittleEndianFormat and if possible as signed data types. Additional all bit fields also converted to corresponding ODS datatype with complete bytes. When the external component contains an attribute with name: '_invalid_value', then all the copied values are checked against this value. If there is a value found for the corresponding LocalColumn, then the flags will be created and written into the file MEA_FLAGS.BTF. Also the corresponding gloabl flag is set to invalid. This rule also uncompress, compressed data blocks and VLSD (variable long data). This values are stored in a seperate block in the mdf file and also transfered to the btf file. When a local columns references multiple external components, only the first referenced external component is used to link to btf file(s). All other external components are deleted. \subsection MdfFileValuesToComponentsProperties Properties \addindex ValuesToComponents Properties The MdfFileValuesToComponents is initzialized with the following properties: \li \b MeasurementHolderRef (required)
The name of the reference in the context where the MeasurementHolder instance that is used as input for the rule is stored. \li \b ResultRef (optional, MeasurementHolderRef)
The name of the reference in the context where the resulting MeasurementHolder instance is stored. If it is omitted the resulting MeasurementHolder instance replaces the input instance. \li \b ComponentFilePath (mandatory, no default)
The path where the external component files are created. \li \b OdsCacheRef (optional)
The name of the reference in the context that holds the target cache. \li \b ComponentFilePath (required)
The director without symbols for writing the btf file. \li \b OdsCacheRef (required)
The reference to the ODSCache.. \li \b MdfFileName (required)
The file name of the MDF file, to read the data, which should be copied to btf file.

Field Summary

Fields inherited from class com.highqsoft.moma.rules.mearules.AbstractMeasurementRule

dumpFilePath, ignoreMissingValues, measurementHolderRef, resultRef

Fields inherited from class com.highqsoft.xsd.AbstractRule

loggerName, postMethods, preMethods, sessionRef

Fields inherited from class com.highqsoft.xsd.AbstractImplementation

arguments, ctx, descriptor, NEW_LINE

Constructor Summary

Constructors

Constructor and Description
MdfFileValuesToComponents()

Method Summary

Methods

Modifier and Type	Method and Description
void	execute() Loop over all External Components and copy the data from MDF file into btf file.
void	init() Initialize the work.
void	terminate() Terminate the execution.

Methods inherited from class com.highqsoft.moma.rules.mearules.AbstractMeasurementRule

getDumpFilePath, getMeasurementHolder, getValue, setValue, storeResult

Methods inherited from class com.highqsoft.xsd.AbstractRule

execute, executePostMethods, executePreMethods, getAoSessionFromContextWithSessionRef, getId, getOdsCache, getPointTo, getSessionRef, getType, isPedantic, setGathermode, setId, setPointTo, setPostMethods, setPreMethods, setSessionRef, setType, toString, toString, toString

Methods inherited from class com.highqsoft.xsd.AbstractImplementation

addAttributesToNameValueUnitArray, addAttributeToNameValueUnitArray, addStringValueToNameValueUnitArray, checkDirectoy, checkDirectoy, checkDirectoy, checkFile, checkFile, checkFile, checkIntValue, checkStringValue, compressNvuArray, createMessageFromPropertyFile, createMessageFromPropertyFile, createMessageFromPropertyFile, createTsUnionFromObject, deleteRowWithAttributes, getArguments, getContext, getDescriptor, getListFromProperty, getMandatoryProperty, getMandatoryProperty, getMandatoryPropertyAsInt, getMandatoryPropertyAsList, getMandatoryPropertyWithRuleException, getNvuArrayFromMap, getNvuArrayFromMap, getNvuObjectWithName, getNvuObjectWithName, getNvuObjectWithName, getOdsCacheFromProperty, getOptioanlPropertyAsInt, getOptionalProperty, getOptionalProperty, getOptionalProperty, getOptionalProperty, getOptionalPropertyAsBoolean, getOptionalPropertyAsBoolean, getOptionalPropertyAsBoolean, getOptionalPropertyAsList, makeUpperCaseKeyword, removeAttributeFromNameValueUnitArray, removeAttributeFromNameValueUnitArray, setArguments, setContext, setDescriptor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.highqsoft.xsd.ImplementationIF

getContext, getDescriptor, setArguments, setContext, setDescriptor

Constructor Detail

MdfFileValuesToComponents

public MdfFileValuesToComponents()

Method Detail

init

public void init()
          throws InitializationFailedException

Description copied from class: AbstractImplementation

Initialize the work.

Specified by:

init in interface ImplementationIF

Overrides:

init in class AbstractMeasurementRule

Throws:

InitializationFailedException - if the initialization fails.

execute

public void execute()
             throws ExecutableException

Loop over all External Components and copy the data from MDF file into btf file.

Specified by:

execute in interface ExecutableIF

Overrides:

execute in class AbstractMeasurementRule

Throws:

ExecutableException - if execution fails.

terminate

public void terminate()
               throws TerminationException

Description copied from class: AbstractRule

Terminate the execution. This implementation does nothing by default. Can be overridden.

Specified by:

terminate in interface ExecutableIF

Overrides:

terminate in class AbstractRule

Throws:

TerminationException - if termination fails.