## On this page

  

 

 # DataHistory

 Last update: 16.07.2025 

public class [DataHistory](index.md) : [PHXCOMObject](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/index.md)

This is the wrapper class that handles the native COM calls to a Data History. The class is used by Java plug-ins to ModelCenter.

## Constructors

[DataHistory](-data-history.md)constructor(pstrm: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
Connects this Java object to the specified session of ModelCenter  
constructor(pstrm: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), addRef: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
Internal use only## Functions

NameSummary[addVariable](add-variable.md)public [addVariable](add-variable.md)(var: [DHVariable](../-d-h-variable/index.md))  
adds variable var to DataHistory[addVariableStructs](add-variable-structs.md)public [addVariableStructs](add-variable-structs.md)(dhVarStructs: [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[DataHistoryVariableStruct](../-data-history-variable-struct/index.md)>, run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
Sets the results for a run.[createVariable](create-variable.md)public [createVariable](create-variable.md)(): [DHVariable](../-d-h-variable/index.md)  
creates a variable[deleteRun](delete-run.md)public [deleteRun](delete-run.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
deletes a run[deleteVariable](delete-variable.md)public [deleteVariable](delete-variable.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html))  
public [deleteVariable](delete-variable.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
deletes a variable at the given index[disableGC](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/disable-g-c.md)public [disableGC](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/disable-g-c.md)(gc: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
If true, prevents releaseObjects from doing anything.[endRuns](end-runs.md)public [endRuns](end-runs.md)()  
ends the runs[fromXML](from-x-m-l.md)public [fromXML](from-x-m-l.md)(xmlStr: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), root: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
from XML[fromXMLFile](from-x-m-l-file.md)public [fromXMLFile](from-x-m-l-file.md)(fileName: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), root: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
from XML file[getCenterLinkJobConnector](get-center-link-job-connector.md)public [getCenterLinkJobConnector](get-center-link-job-connector.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
CenterLink is not supported by this version of ModelCenter.[getCenterLinkQueue](get-center-link-queue.md)public [getCenterLinkQueue](get-center-link-queue.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
CenterLink is not supported by this version of ModelCenter.[getCenterLinkRunMatrixID](get-center-link-run-matrix-i-d.md)public [getCenterLinkRunMatrixID](get-center-link-run-matrix-i-d.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
CenterLink is not supported by this version of ModelCenter.[getCenterLinkServer](get-center-link-server.md)public [getCenterLinkServer](get-center-link-server.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
CenterLink is not supported by this version of ModelCenter.[getCompletedRunData](get-completed-run-data.md)public [getCompletedRunData](get-completed-run-data.md)(startSequenceNumber: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), maxLength: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), allVariables: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [CompletedRunData](../-completed-run-data/index.md)  
Gets information about the completed run data, including the runIDs, error IDs, error messages, and variable values.[getDataExplorer](get-data-explorer.md)public [getDataExplorer](get-data-explorer.md)(): [DataExplorer](../-data-explorer/index.md)  
gets the DataExplorer --was IDispatch in COM[getDataHistoryToModel](get-data-history-to-model.md)public [getDataHistoryToModel](get-data-history-to-model.md)(): [IDataHistoryToModel](../-i-data-history-to-model/index.md)  
Gets the dataHistoryToModel.[getErrorID](get-error-i-d.md)public [getErrorID](get-error-i-d.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
returns the ID of the Error that occured in the DataHistory[getErrorMessage](get-error-message.md)public [getErrorMessage](get-error-message.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
returns a string containing the error message for a given run[getFormattedValue](get-formatted-value.md)public [getFormattedValue](get-formatted-value.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
public [getFormattedValue](get-formatted-value.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
gets a value at the given index for a given run[getHighlightedRuns](get-highlighted-runs.md)public [getHighlightedRuns](get-highlighted-runs.md)(): [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)>  
Retrieve the set of currently highlighted run indices[getNumCustomVars](get-num-custom-vars.md)public [getNumCustomVars](get-num-custom-vars.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number of custom variables[getNumDesignVariables](get-num-design-variables.md)public [getNumDesignVariables](get-num-design-variables.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number of design variables[getNumExpectedRuns](get-num-expected-runs.md)public [getNumExpectedRuns](get-num-expected-runs.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number of expected runs[getNumFailedRuns](get-num-failed-runs.md)public [getNumFailedRuns](get-num-failed-runs.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number of failed runs[getNumNonEmptyRuns](get-num-non-empty-runs.md)public [getNumNonEmptyRuns](get-num-non-empty-runs.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
check to see if the menu item is enabled (t/f)[getNumRuns](get-num-runs.md)public [getNumRuns](get-num-runs.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number of runs for the DataHistory[getNumVariables](get-num-variables.md)public [getNumVariables](get-num-variables.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the number for variables[getRunName](get-run-name.md)public [getRunName](get-run-name.md)(runNum: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
gets the name of the given run in the DataHistory[getSettingRun](get-setting-run.md)public [getSettingRun](get-setting-run.md)(): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
gets the Setting Run[getSuggestedCountFrom](get-suggested-count-from.md)public [getSuggestedCountFrom](get-suggested-count-from.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the Suggested Count[getSuggestedDependentVars](get-suggested-dependent-vars.md)public [getSuggestedDependentVars](get-suggested-dependent-vars.md)(): [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)  
gets the Suggested Dependent Variables()[getSuggestedIndependantVar](get-suggested-independant-var.md)public [getSuggestedIndependantVar](get-suggested-independant-var.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
gets the Suggested Independent Variable[getSuggestedIndependentVar](get-suggested-independent-var.md)public [getSuggestedIndependentVar](get-suggested-independent-var.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
gets the Suggested Independent Variable[getUniqueID](get-unique-i-d.md)public [getUniqueID](get-unique-i-d.md)(): [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)  
gets the unique ID of the DataHistory[getValue](get-value.md)public [getValue](get-value.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)  
public [getValue](get-value.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)  
gets the value[getVariable](get-variable.md)public [getVariable](get-variable.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [DHVariable](../-d-h-variable/index.md)  
public [getVariable](get-variable.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)): [DHVariable](../-d-h-variable/index.md)  
gets a variable[getVariableValues](get-variable-values.md)public [getVariableValues](get-variable-values.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)>  
public [getVariableValues](get-variable-values.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)): [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)>  
gets values of a variable for all runs[highlight](highlight.md)public [highlight](highlight.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), highlight: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), handleEvent: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
highlight or unhighlight a run[insertRun](insert-run.md)public [insertRun](insert-run.md)(insertBefore: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
inserts a new run before a given index[isHighlighted](is-highlighted.md)public [isHighlighted](is-highlighted.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
check highlight state[isModified](is-modified.md)public [isModified](is-modified.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
public [isModified](is-modified.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
checks to see if the given object is midified[isRunning](is-running.md)public [isRunning](is-running.md)(): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
looks to see if the DataHistory is running[isValid](is-valid.md)public [isValid](is-valid.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
public [isValid](is-valid.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)  
checks for valididty of an object given an index and run[newInstance](new-instance.md)public [newInstance](new-instance.md)(): [DataHistory](index.md)  
creates a new DataCollector object (that is connected to the same ModelCenter session) that is not currently attached to any thread.[release](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/release.md)public [release](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/release.md)()  
Releases the COM reference to ModelCenter for this object.[releaseObjects](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/release-objects.md)public [releaseObjects](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/release-objects.md)()  
This function attempts to release any COM resources left behind from objects which have been finalized but release() was never called on them.[setDataHistoryToModel](set-data-history-to-model.md)public [setDataHistoryToModel](set-data-history-to-model.md)(dhtm: [IDataHistoryToModel](../-i-data-history-to-model/index.md))  
Sets the Data History to Model object.[setError](set-error.md)public [setError](set-error.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), errorID: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), message: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
sets an error for the given run, ID and message[setFormattedResult](set-formatted-result.md)public [setFormattedResult](set-formatted-result.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), value: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
public [setFormattedResult](set-formatted-result.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), value: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
sets a formatted result[setHighlightedRuns](set-highlighted-runs.md)public [setHighlightedRuns](set-highlighted-runs.md)(selectedRunIndices: [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)>)  
Specify the set of currently highlighted run indices.[setNumExpectedRuns](set-num-expected-runs.md)public [setNumExpectedRuns](set-num-expected-runs.md)(numRuns: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
sets the number of expected runs[setReferenceDebugMode](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/set-reference-debug-mode.md)public [setReferenceDebugMode](../../com.phoenix_int.ModelCenter.util/-p-h-x-c-o-m-object/set-reference-debug-mode.md)(on: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
When set to true, the system will keep a list of active COM objects that are allocated but not yet released since this method was invoked.[setResult](set-result.md)public [setResult](set-result.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), value: [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html), valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
public [setResult](set-result.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), value: [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html), valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
sets the Result[setRunName](set-run-name.md)public [setRunName](set-run-name.md)(runNum: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), name: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
sets the run name for a given run number[setRunValues](set-run-values.md)public [setRunValues](set-run-values.md)(run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), values: [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)>, valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
sets all values of a run as a single chunk.[setSettingRun](set-setting-run.md)public [setSettingRun](set-setting-run.md)(running: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
sets the Setting Run[setSuggestedCountFrom](set-suggested-count-from.md)public [setSuggestedCountFrom](set-suggested-count-from.md)(count: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html))  
sets the Suggested Count[setSuggestedDependentVars](set-suggested-dependent-vars.md)public [setSuggestedDependentVars](set-suggested-dependent-vars.md)(var: [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html))  
sets the Suggested Dependent Varianble[setSuggestedIndependantVar](set-suggested-independant-var.md)public [setSuggestedIndependantVar](set-suggested-independant-var.md)(var: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
sets the Suggested Independent Variable[setSuggestedIndependentVar](set-suggested-independent-var.md)public [setSuggestedIndependentVar](set-suggested-independent-var.md)(var: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
sets the Suggested Independent Variable[setVariableValues](set-variable-values.md)public [setVariableValues](set-variable-values.md)(index: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), values: [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)>, valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
public [setVariableValues](set-variable-values.md)(index: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), run: [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html), values: [Array](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/index.html)<[Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)>, valid: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), modified: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
sets all values of a variable as a chunk[startRuns](start-runs.md)public [startRuns](start-runs.md)()  
starts the runs[toCSV](to-c-s-v.md)public [toCSV](to-c-s-v.md)(variablesInRows: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), includeFailed: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
to CSV[toCSVFile](to-c-s-v-file.md)public [toCSVFile](to-c-s-v-file.md)(fileName: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), variablesInRows: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), includeFailed: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
to CSV File[toXML](to-x-m-l.md)public [toXML](to-x-m-l.md)(): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
public [toXML](to-x-m-l.md)(includeRunData: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html)  
to XML[toXMLFile](to-x-m-l-file.md)public [toXMLFile](to-x-m-l-file.md)(fileName: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html))  
public [toXMLFile](to-x-m-l-file.md)(fileName: [String](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html), includeRunData: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))  
save data history data as an XML file