Swap an OpenWay Riva electric meter

This section explains how to create an MDI file when replacing an electric meter with a new one in an Itron OpenWay Riva solution. This scenario is also applicable to a swap of an EDMI Electric Meter as the only change to the XML is the device type for the EDMI meter.

In this scenario, an existing meter is removed from a service point and new one is installed.

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

In the field, the old meter is uninstalled from the service point and the new meter is installed.

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 Singlephase	283	2.16.840.1.114416.14.317224090
OpenWay Riva CENTRON Polyphase	284	2.16.840.1.114416.14.318836349
OpenWay Riva IEC Singlephase	270	2.16.840.1.114416.14.315466859
OpenWay Riva IEC Polyphase	281	2.16.840.1.114416.14.317447732
OpenWay Riva EDMI Meter	311	2.16.840.1.114416.14.319447831

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
	PrimaryCollectionSystem		Optional	Optional	Optional
	BillingCycleName	Optional	Optional	Optional	Optional
	EquipmentType		Optional	Required	Required
	CommodityType		Required	Required	Required
	TimeZone		Required	Required	Required
	ServicePointStatus		Optional	Required	Required
	UtilityId		Optional	Required	Required
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
	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	Required
	ChannelNumber	Required	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.
	PowerFlowDirection		Optional	Required	Required
	Unit	Required. Must be set to WH.	Optional	Required	Required
	HasIntervalData on page 1		Optional	Required	Required
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.
ApplicationGroups		Optional	Not used	Optional	Optional
ApplicationGroup		Required when the ApplicationGroups element is included in the MDI file.	Not used	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.
ApplicationGroup	Name	Required when the ApplicationGroups element is included in the MDI file.	Not used	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.
MeterLinkRange		Required	Required	Required	Required
	Start	Required	Required	Required	Required
	End	Required	Required	Required	Required
SetServicePointGroup		Recommended	Not used	Optional	Optional
	GroupId	Required	Not used	Required	Required
	GroupType	Required	Not used	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 = "SPElectricMeter1"
		EquipmentType = "Endpoint"
		CommodityType = "Electric"
		TimeZone = "CentralUSNoDst"
		ServicePointStatus = "Active"
		UtilityId = "ABC"
		PrimaryCollectionSystem = "OpenWayRiva"
		BillingCycleName = "15Sept2020">
		<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
						Start = "2018-06-01T00:00:00Z"
						End = "EOT"/>
					<ApplicationGroups>
						<ApplicationGroup 
							Name = "Group1"/>
					</ApplicationGroups>
				</SetDevice>
			</SetChannel>
			<MeterLinkRange
				Start = "2018-06-01T00:00:00Z"
				End = "EOT"/>
		</SetMeter>
		<SetServicePointGroup
			GroupId = "MDISector99"
			GroupName = "MDISector99"
			GroupType = "Sector"/>
	</SetServicePoint>
</MasterDataImport>