Swap a Gen5 Riva Singlephase/Polyphase electricity meter

This section explains how to create an MDI file when replacing an electric meter with a new one in an Itron Gen5 Riva solution.

In this scenario, an existing meter is removed from a service point and a 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 Start attribute and the relationship between the new meter and the service point is started at the same time.

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

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.

Element	Attribute/child element	App Platform
SetServicePoint		Required
	ServicePointId	Required
	EquipmentType	Required
	CommodityType	Required
	TimeZone	Required
	UtilityId	Required
	ServicePointStatus	Required
	PrimaryCollectionSystem	Optional
Address		Required
	StreetAddress	Optional
	City	Optional
	State	Optional
	Zip	Optional
	Country	Optional
	Latitude	Required
	Longitude	Required
SetMeter		Required
	MeterId	Required
	IsDistrictMeter	Required
	MeterNumber	Required
	PhaseCount	Required
	MeterInstallationDate	Optional
	MeterSerialNumber	Optional
SetChannel		Required
	ChannelNumber	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, seeAuto-channel creation.
	PowerFlowDirection	Required
	Unit	Required
	HasIntervalData	Required
SetDevice		Required
	DeviceId	Required
	DeviceType	Required
	Active	Required
DeviceLinkRange		Required
	Start	Required
	End	Required
MeterLinkRange		Required
	Start	Required
	End	Required
SetServicePointGroup		Optional
	GroupId	Optional
	GroupType	Optional
	GroupName	Optional

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 = "Gen5HW42SP1">		
		<Address
			StreetAddress="3040 Excelsior Blvd"
			City ="Minneapolis"
			State="MN"
			Zip="55416"
			Country="US"
			Latitude="44.9476"
			Longitude="-93.321" />
		<SetMeter
			MeterId = "EI0155209919"
			MeterNumber = "3155209922"
			MeterSerialNumber = "3155209922"
			MeterInstallationDate = "2018-06-01T00:00:00Z"
			MeterType = "Gen5 Riva Singlephase Electricity Meter">			
			<SetChannel
				ChannelNumber = "1"
				HasIntervalData = "True"
				PowerFlowDirection = "Delivered"
				Unit = "WH">
				<SetDevice
					DeviceId = "2.16.840.1.114416.34.3155209922"
					DeviceType = "315"
					Active = "True">
					<DeviceLinkRange
						Start = "2018-06-01T00:00:00Z"
						End = "EOT"/>
				</SetDevice>
			</SetChannel>
			<MeterLinkRange
				Start = "2018-06-01T00:00:00Z"
				End = "EOT"/>
		</SetMeter>
		<SetServicePointGroup
			GroupId = "Group1"
			GroupType = "Region"
			GroupName = "Group1"/>
	</SetServicePoint>
</MasterDataImport>