Remove the link between an OpenWay Riva water module and a service point

In Itron Analytics, this action removes all historical meter data from the service point until the endpoint is relinked to a valid configuration.

Caution: This scenario is only to be used with Itron Analytics. Do not use this scenario for OWCM.

This should only be done to correct data problems. Do not use this method for valid endpoint removal in the field when you want to keep the historical data associated with the service point.

In the XML file, the endpoint/service point and the endpoint/meter channel relationships are ended. All the historical data for the endpoint is removed from the service point and the meter channel.

Source of the MDI file

Caution: This scenario is only to be used with Itron Analytics. Do not use this scenario for OWCM.

This should only be done to correct data problems. Do not use this method for valid endpoint removal in the field when you want to keep the historical data associated with the service point.

  • 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.

Caution: This scenario is only to be used with Itron Analytics. Do not use this scenario for OWCM.

This should only be done to correct data problems. Do not use this method for valid endpoint removal in the field when you want to keep the historical data associated with the service point.

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

Itron Analytics

Operations Optimizer

SetServicePoint

 

 

Required

Required

ServicePointId

Required

Required

EquipmentType

Optional

Optional

CommodityType

Required

Required

TimeZone

Recommended

Recommended

ServicePointStatus

Required

Required

PremiseId

Required

Required

PrimaryCollectionSystem

Required

Required

SetMeter

 

 

Required

Required

MeterId

Required

Required

MeterNumber

Recommended

Recommended

SetChannel

 

 

Required

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, 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.

HasIntervalData

Required

Required

RemoveDeviceLink

 

 

Required

Required

DeviceId

Required

Required

DeviceType

Required

Required

RemoveServicePointGroup

 

 

Required

Required

GroupId

Required

Required

GroupType

Required

Required

XML sample

Caution: This scenario is only to be used with Itron Analytics. Do not use this scenario for OWCM.

This should only be done to correct data problems. Do not use this method for valid endpoint removal in the field when you want to keep the historical data associated with the service point.

<?xml version="1.0" encoding="utf-8"?>  
<MasterDataImport
	xmlns="http://www.itron.com/masterdata/2013/03"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<SetServicePoint
		ServicePointId="SP_1"
		EquipmentType="Endpoint"
		CommodityType="Water"
		TimeZone="EasternUS"
		ServicePointStatus="Inactive"
		PremiseId="Premise_1"
		PrimaryCollectionSystem="OpenWayRiva">
		<SetMeter
			MeterId="413121"
			MeterNumber="413ROFL121">
			<SetChannel
				ChannelNumber="1"
				HasIntervalData="true">
				<RemoveDeviceLink
					DeviceId="2.16.840.1.114416.17.20000171"
					DeviceType="27"/>
			</SetChannel>
		</SetMeter>
		<RemoveServicePointGroup
			GroupId="01000039"
		       GroupName="01000039"
			GroupType="Route"/>
	</SetServicePoint>  
</MasterDataImport>