Uninstall an OpenWay Riva electric meter

This section explains how to create an MDI file to uninstall an electric meter in an Itron OpenWay Riva solution. The example and details that follow are for installing an OpenWay Riva CENTRON SinglePhase meter. To create an MDI file for the CENTRON PolyPhase or the OpenWay Riva IEC SinglePhase or PolyPhase, you only have to change the DeviceType value. This scenario is also applicable to an uninstall of an EDMI Electric Meter as the only change to the XML is the device type for the EDMI m

In this scenario, an existing meter is removed from a service point and is not replaced with a new meter.

In the XML file, the relationship between the meter and the service point is ended at the time set in the MeterLinkRange element's End attribute.

In the field, the meter is uninstalled from the service point location.

The following table shows the DeviceType values to use for each type of electric meter. This device type information can also be found in Device types.

Device

DeviceType

Example ESN

OpenWay Riva CENTRON Single-phase

283

2.16.840.1.114416.14.317224090

OpenWay Riva CENTRON Poly-phase

284

2.16.840.1.114416.14.318836349

OpenWay Riva IEC Single-phase

270

2.16.840.1.114416.14.315466859

OpenWay Riva IEC Poly-phase

281

2.16.840.1.114416.14.317447732

OpenWay Riva EDMI

311

2.16.840.1.114416.14.319447831

Source of the MDI file

  • Customer work order system or FDM work orders
  • CIS
  • MDM
  • For Itron Analytics, the MDI file should always come from OpenWay Operations Center - Collection Manager.

Elements and attributes

For information about the use of special characters, see Special characters.

The following table shows the elements and attributes included in the XML sample.

  • Required = This element/attribute is required for this specific scenario. It may not be required in other scenarios.
  • Recommended = Itron recommends that you use this element/attribute in this particular scenario.
  • Optional = This element/attribute is optional for this scenario and is only required if you want a specific outcome described in the element/attribute definition. To see the element/attribute description, click on the element/attribute in the table or in the XML sample.
  • Blank = The application does not use this element and any value in it will be ignored.

Element

Attribute/child element

Collection Manager

Performance Manager

Itron Analytics

Operations Optimizer

SetServicePoint

 

 

 

 

 

 

 

Required

Required

Required

Required

ServicePointId

Required

Required

Required

Required

EquipmentType

 

Optional

Required

Required

CommodityType

 

Required

Required

Required

TimeZone

 

Required

Required

Required

UtilityId

 

Optional

Required

Required

ServicePointStatus

 

Optional

Required

Required

PrimaryCollectionSystem

 

Optional

Optional

Optional

Address

 

 

 

 

 

 

 

 

Recommended

Optional

Required

Required

StreetAddress

Recommended

Optional

Optional

Optional

City

Recommended

Optional

Optional

Optional

State

Recommended

Optional

Optional

Optional

Zip

Recommended

Optional

Optional

Optional

Country

 

 

Optional

Optional

Latitude

Recommended

Required

Required

Required

Longitude

Recommended

Required

Required

Required

SetMeter

 

 

 

 

Required: For Collection Manager, you must use one of the following SetMeter attributes: MeterId, MeterNumber, or MeterSerialNumber.It is not necessary to use more than one of these attributes. Whichever attribute you choose to use should be used consistently.

Required

Required

Required

MeterId

Required

Required

Required

Required

MeterSerialNumber

Optional

Optional

Optional

Optional

MeterNumber

Optional

Optional

Required

Required

MeterInstallationDate

 

Optional

Optional

Optional

IsDistrictMeter

 

Optional

Required

Required

PhaseCount

 

Optional

Required

Required

SetChannel

 

 

Required

 

Required

Required

ChannelNumber

Required

 

Required. At least one channel must be configured for auto-channel creation. Set the ChannelNumber value to 1 when creating a dummy channel. For more information, see Auto-channel creation.

Required. At least one channel must be configured for auto-channel creation. Set the ChannelNumber value to 1 when creating a dummy channel. For more information, see Auto-channel creation.

SetDevice

 

 

 

Required

Required

Required

Required

DeviceId

Required

Required

Required

Required

DeviceType

Required

Required

Required

Required

Active

 

Optional

Required

Required

DeviceLinkRange

 

 

 

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

Start

Optional

 

Optional

Optional

End

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

Required if the SetDevice element is included in the file.

MeterLinkRange

 

 

 

Required

Required

Required

Required

Start

 

Required

Required

Required

End

Required

Required

Required

Required

XML sample

<?xml version="1.0" encoding="utf-8"?>
<MasterDataImport
	xmlns:xsd = "http://www.w3.org/2001/XMLSchema"
	xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
	xmlns = "http://www.itron.com/masterdata/2013/03">
	<SetServicePoint
		ServicePointId="S10006_SP"
		EquipmentType = "Endpoint"
		CommodityType = "Electric"
		TimeZone = "CentralUSNoDst"
		ServicePointStatus = "Active"
		UtilityId = "ABC"
		PrimaryCollectionSystem = "OpenWayRiva">
		<Address
			StreetAddress="123 Sample Road"
			City ="Upstate"
			State="NY"
			Zip="00001"
			Country="US"
			Latitude="47.674702"
			Longitude="-117.091245" />
		<SetMeter
			MeterId = "111000030"
			IsDistrictMeter = "False"
			MeterNumber="318SMH836348"
			PhaseCount = "1"
			MeterSerialNumber = "318SMH836348"
			MeterInstallationDate="2015-12-01T00:00:00Z"
			MeterType="AMI OpenWay">			
			<SetChannel
				ChannelNumber = "1"
				HasIntervalData = "True"
				PowerFlowDirection = "Delivered"
				Unit = "WH">
				<SetDevice
					DeviceId = "2.16.840.1.114416.14.111000030"
					DeviceType = "283"
					Active = "True">
					<DeviceLinkRange
						End="2017-02-14T18:00:00Z"/>
				</SetDevice>
			</SetChannel>	
			<MeterLinkRange
				End="2017-02-14T18:00:00Z"/>
		</SetMeter>
	</SetServicePoint>
</MasterDataImport>