system.mes.meter.exportMeterConfigurationsAsCsv

Description

No Parameter:

Exports all Meter Configurations as raw CSV bytes (UTF-8 encoded).

With a Parameter:

Exports selected Meter Configurations as raw CSV bytes (UTF-8 encoded). Each entry in the list is either a Meter Configuration ID or an equipment path; an equipment path exports every configuration in that equipment's subtree, including disabled (soft-deleted) ones.

Permissions

This method requires the METERING.READ.GET permission.

Syntax

system.mes.meter.exportMeterConfigurationsAsCsv()
system.mes.meter.exportMeterConfigurationsAsCsv(ids)

Parameters

No Parameter:

Parameter	Type	Nullable	Description
None	-	-	This method does not take any parameters.

With a Parameter:

Parameter	Type	Nullable	Description
ids	List<String>	True	List of selectors. Each entry is either a Meter Configuration ID or an equipment path; an equipment path exports every configuration in that equipment's subtree, including disabled (soft-deleted) ones.

Returns

A byte array (byte[]) containing the raw byte data of the CSV export.

Code Examples

Perspective

csvBytes = system.mes.meter.exportMeterConfigurationsAsCsv()
system.perspective.download("meter-configurations.csv", csvBytes)

Script Console

csvBytes = system.mes.meter.exportMeterConfigurationsAsCsv()
path = system.file.saveFile("meter-configurations.csv")
if path is not None:
    system.file.writeFile(path, csvBytes)

Export by equipment path

# Mix Meter Configuration IDs and equipment paths. The path exports every configuration
# under that equipment's subtree, including disabled (soft-deleted) ones.
csvBytes = system.mes.meter.exportMeterConfigurationsAsCsv(['Enterprise/Site/Line1', '01J9YP3JBR-WQ8GWRR2-8Y879V2D'])