MultiSpeak Supported Attributes

MultiSpeak supports certain settings for each network feature loaded to an analysis study. The following tables show the tables and attributes that can be imported by the MultiSpeak API if they are included in the XML document.

If you change the spelling of any of the Attribute Names listed below, you must also modify field names in NetAdapterMspEAExportFields.dtd (the default path is C:\Program Files (x86)\Miner and Miner\ArcFM Solution\Bin\Style Sheets). Class names are defined in NetAdapterMspEAExport.dtd.

If the attribute is not exported from the geodatabase or provided by the Implementation, the MultiSpeak API will use the default values shown in the Supported Attributes table. However, the attributes with names in bold must be included in the XML for the MultiSpeak API to correctly load data.

Defaults: The Default column in some of the tables below indicates whether a default may be set for the attribute. Yes=Default value may be set; No=Value must be exported and no default is allowed.

Domains

The MultiSpeak API supports the following domain values for the attributes in the tables listed below.
Connection Code	ShuntWye=Shunt-Wye; ShuntDelta=Shunt-Delta; ShuntSameAsParent=Shunt-Same as Parent; Series=Series;
Connection Configuration	D=Delta; Y=Wye
*Electric Line Voltage	10=120v; 20=120/208v; 30=120/240v; 40=240/480v; 50=277/480v; 60=480v; 80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
*Electric Device Operating Voltage	80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
Normal Position	0=Normally Open; 1=Normally Closed; 2=Not Applicable
Over Current Prot Dev Max Continuous Current	50 = 50A, 100 = 100A, 200 = 200A, 280 = 280A, 560 = 560A, 600 = 600A, 800 = 800A, 900 = 900A, 1200 = 1200A, 2000 = 2000A
Phase Designation	1 = C; 2 = B; 3 = BC, 4 = A, 5 = AC, 6 = AB, 7 = ABC
Regulated Indicator	R=Regulated; U=Unregulated
*Secondary Nominal Voltage	10=120v; 20=120/208v; 30=120/240v; 50=277/480v; 60=480v
Secondary Type	SVC=Service; SEC=Secondary; UB=Underbuild
Service Current Rating	1=100 amps; 2=200 amps; 4=400 amps; 6=600 amps; 12=1200 amps
*Switch Nominal Voltage	100=4.16 kV; 250=13.8 kV; 330=24.9 kV; 370=34.5 kV
Switch Status	0=Off; 1=On; 2=Discnct
Transformer Bank Nominal Voltage	80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
Transformer Unit kVA	150=150kVA; 167=167kVA; 225=225kVA; 250=250kVA; 300=300kVA; 333=333kVA; 500=500kVA; 750=750kVA; 1000=1000kVA; 1500=1500kVA; 2000=2000kVA; 2500=2500kVA
Transformer Unit Manufacturer	ABB=ABB/Westinghouse; CM=Central Maloney; CPR=Cooper/McGraw Edison; D=Delta; GE=General Electric; HKP=H.K. Potter; OTH=Other
Winding Code	Open Y-D, D-D, Y-Y Grounded Imp, Y-Y 3ph Core Type, D-D one, Y-Y-D Ground, Y-D one, D-Y open

Subtype Codes

This table lists the valid values for the Subtype field on the specified feature class.
Dynamic Protective Device Bank	1 = Breaker; 2 = Recloser; 3 = Sectionalizer
Switch	1 = Overhead; 2 = Underground
Fuse	1 = Overhead; 2 = Underground
Generators and Motors	1 = Steady State; 2 = Subtransient; 3 = Transient

Capacitor Bank (CapacitorBank)

Attribute	MultiSpeak Element	Domain/Data Type	Default	Notes
PhasingCode	phaseCode	Phase Designation	No
SwType	swType	text	Yes
SwStatus	swStatus	Switch Status	Yes
SwOn	swOn	double	Yes
SwOff	swOff	double	Yes
ConnectionCD	connectionCD	Connection Code	Yes
*OperatingVoltage	volts	Electric Device Operating Voltage	Yes
BankKvar	BankKvar	double	Yes	If field is unpopulated, the sum of the capacitor unit Kvar is used. If neither are available the default value is used.
FeederID	<null>	string	No
The ElectricTraceWeight attribute is required but does not have corresponding fields in the exported XML.
ElectricTraceWeight	<null>	long	No

Capacitor Unit (CapacitorUnit)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	phase	Phase Designation	No
kVAR	kvar	double	No

Conductors (OHPrimaryLine, UGPrimaryLine, OHSecondaryLine, UGSecondaryLine (PrimayerOHLineSection, PrimaryUGLineSection, SecondaryOHLineSection, SecondaryUGLineSection)

Attribute	MultiSpeak Element	Domain/Data Type	Default	Notes
PhasingCode	phaseCode	Phase Designation	No
MeasuredLength	condLength	numeric	Yes	Defaults to geometric length of edge element
Constr	constr	string	Yes
*OperVolt	operVolt	Electric Line Voltage	Yes
CondPerPh	condPerPhase	numeric	Yes
LengthSrc	lengthSrc	string	Yes
NeutSize, NeutMatl	condN	string	No	Concatenation defined in NetAdapterMspEAExport_Equipment.xsl
ConductorInfo.CondSize, ConductorInfo.CondMatl	conductorList.conductor.conductorType	string	No	Concatenation defined in NetAdapterMspEAExport_Equipment.xsl. One conductor exported for each related ConductorInfo record.
ConductorInfo.PhasingCode	conductorList.conductor.phase	Phase Designation	No	NetAdapterMspEAExport_Equipment.xsl. One conductor exported for each related ConductorInfo record.
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	no

OH Primary Line (PrimaryOHLineSection)

UG Primary Line (PrimaryUGLineSection)

Attribute	MultiSpeak Element	Domain/Data Type	Default
ConduitFlg	isInConduit	Y/N	Yes
Manufacturer	manufacturer	string	Yes

OH Secondary Line (SecondaryOHLineSection)

Attribute	MultiSpeak Element	Domain/Data Type	Default
SecondaryType	secondaryType	Secondary Type	Yes
Manufacturer	manufacturer	string	Yes

UG Secondary Line (SecondaryUGLineSection)

Attribute	MultiSpeak Element	Domain/Data Type	Default
SecondaryType	uGSecType	Secondary Type	Yes
ConduitFlg	isInConduit	Y/N	Yes
Manufacturer	manufacturer	string	Yes

Motors and Generators Motor, Generator (Motor, Generator)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	phaseCode	Phase Designation	No
SteadyStateDevice	ssDesc	text	Yes
TransientDevice	transDesc	text	Yes
SubtransientDevice	stDesc	text	Yes
*RatedVoltage	rtdVolts	double	Yes
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	no

Motor (Motor)

Attribute	MultiSpeak Element	Domain/Data Type	Default
ModelNumber	model	long	Yes
Status	status	double	Yes
HP	hp	double	Yes
PF	pf	double	Yes
EFF	eff	double	Yes
*LgVolts	lgVolts	Electric Device Operating Voltage	Yes
DropOut	dropOut	double	Yes
NEMATyp	nemaTyp	long	Yes
Limit	limit	double	Yes
LimitedBy	limitedBy	long	Yes
long	sftStType	long	Yes
SftStR	sftStR	double	Yes
SftStX	sftStX	double	Yes
SftStTap	sftStTap	double	Yes
sftStWdg	SftStWdg	double	Yes
LRPF	lrPf	double	Yes
LRMult	lrMult	double	Yes

Generator (Generator)

Attribute	MultiSpeak Element	Domain/Data Type	Default
ModelNumber	model	long	Yes
HoldVoltsR	holdVoltsR	double	Yes
HoldVoltsX	holdVoltsX	double	Yes
HoldID	holdID	text	Yes
KwOut	kwOut	double	Yes
KwMax	kwMax	double	Yes
KvarLead	kvarLead	double	Yes
KvarLag	kvarLag	double	Yes
*SrcVolts	srcVolts	Electric Device Operating Voltage	Yes
ConnectionConfiguration	connected	Connection Configuration	Yes

Regulator Bank (RegulatorBank)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	phaseCode	Phase Designation	No
RegType	regType	text	Yes
CtrlPhase	ctrlPhase	Phase Designation	Yes
WdgType	wdgType	text	Yes
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	no

Regulator Unit (RegulatorUnit)

Attribute	MultiSpeak Element	Domain/Data Type	Default	Notes
PhasingCode	phase	Phase Designation	No
*OutputVoltage	vOut	double	Yes
LineDropCompResistance	ldcR	double	Yes
LineDropCompReactance	ldcX	double	Yes
FirstHousingHighProtection	fhHi	double	Yes
FirstHousingLowProtection	fhLo	double	Yes
KVA	kva	double	Yes
EquipmentID	eaEquipment	text	Yes	Defined in NetAdapterMspEAExport_Equipment.xsl.

Service Location (ServiceLocation)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	PhaseCode	Phase Designation	No
CustomerID in related ServiceAccount	custID	text	No
AccountNumber in related Service Account	accountNumber	text	No
ServiceRateCode in related Service Account	servType	Service Current Rating	Yes
BoardDist	network/boardDist	text	No
TaxDist	network/taxDist	text	No
FranchiseDist	network/franchiseDist	text	No
SchoolDist	network/schoolDist	text	No
District	network/district	text	No
PoleNo	network/poleNo	text	No
Section	network/section	text	No
Township	network/township	text	No
Range	network/range	text	No
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	no

Substation (Source)

These attributes apply to the Source table in the geodatabase. In the MultiSpeak XML, the element is called Substation.
FeederID	<null>	string	No	This attribute is required, but does not have a corresponding field in the exported XML.
SubstationFacilityID	substationCode	string	No
ConnectionConfiguratin	ldCon	Connection Configuration	Yes
MinImpedance	zMin	string	Yes
MinImpedance	zMin	string	Yes
MaxImpedance	zMax	string	Yes
PosSeqR	posSeqZ	double	Yes	This is the R attribute of the posSeqZ element.
PosSeqX	posSeqZ	double	Yes	This is the X attribute of the posSeqZ element.
ZeroSeqR	zeroSeqZ	double	Yes	This is the R attribute of the zeroSeqZ element.
ZeroSeqX	zeroSeqZ	double	Yes	This is the X attribute of the zeroSeqZ element.
NegSeqR	negSeqZ	double	Yes	This is the R attribute of the negSeqZ element.
NegSeqX	negSeqZ	double	Yes	This is the X attribute of the negSeqZ element.
*BusVolts	busVolts	double	Yes
FltGrnImpOH	ohGndZ	double	Yes
FltGrnImpUG	ugGndZ	double	Yes
*NomVolts	nomVolts	double	Yes
LdAlloc	ldAlloc	string	Yes	This attribute is supported, but not included in the Minerville sample data.
Regulated	isRegulated	Regulated Indicator	Yes
SubstationName	name	string	No
SubstationName	eaEquipment	string	No	Defined in NetworkAdapterMspEAExport_Equipment.xsl.
Units	units	Ohms, Percent, Per Unit, Total	Yes	This attribute is supported, but not included in the Minerville sample data.
Each substation has one or more feeders. The following are the supported attributes for those feeders. Their values come from the related Dynamic Protective Device that is related to the Source table.
FacilityID	facilityID	string	No
PhasingCode	phaseCode	Phase Designation	No
*OperatingVoltage	operVolt	Electric Device Operating Voltage	No
FeederID	feederNo	string	No

Switchable Device Banks SwitchDeviceBank and OvercurrentDeviceBank (FuseBank, SwitchBank, DynamicProtectiveDeviceBank)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	phaseCode	Phase Designation	No
IsGanged	isGanged	boolean	Yes
LdPoint	ldPoint	long	Yes
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID2	<null>	string	No
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	no

Switchable Device Units Switch, Fuse, Recloser, Sectionalizer, and Breaker (FuseUnit, DynamicProtectiveDeviceUnit)

Attribute	MultiSpeak Element	Domain/Data Type	Default	Notes
EquipmentID	eaEquipment	text	Yes	Default values concatentated in NetAdapterMspEAExport_Equipment.xsl.
FacilityID	facilityID	text	No
PhasingCode	phase	Phase Designation	No
PosA, PosB, PosC in related bank feature(SwitchDeviceBank, FuseBank, or DynamicProtectiveDeviceBank)	position	Normal Position	No
*RatedVolt in related bank feature	ratedVolt	Switch Nominal Voltage	Yes
*OperatingVoltage in related bank feature	operVolt	Electric Device Operating Voltage	Yes
MaxContAmp in related bank feature	maxContAmp	Over Current Prot Dev Max Continuous Current	Yes
Manufacturer	manufacturer	text	Yes
Mounting	mounting	text	Yes

Overcurrent Protective Device Units Fuse, Recloser, Sectionalizer, and Breaker (FuseUnit, DynamicProtectiveDeviceUnit)

Attribute	MultiSpeak Element	Domain/Data Type	Default
Bypass	bypassExists	Boolean	yes
LastServiceDate	lastServiceDate	date	yes

Fuse (FuseUnit)

Attribute	MultiSpeak Element	Domain/Data Type	Default
LinkRtg	linkRtg	long	yes

Transformer Bank (TransformerBank)

Attribute	MultiSpeak Element	Domain/Data Type	Default
PhasingCode	phaseCode	Phase Designation	No
WindingCode	wdgCode	Winding Code	Yes
Comments	transDescr	text	Yes
Mounting	mounting	text	Yes
*OpertingVoltage	vInput	Electric Device Operating Voltage	Yes
*SecVolt	vOut	Secondary Nominal Voltage	Yes
SourceSideConfig	sourceSideConfig	AB, AC, BC	Yes
*VOutNom	vOutNom	Electric Device Operating Voltage	Yes
SecProt	secProt	text	Yes
*RatedVolt	ratedVolt	Transformer Bank Nominal Voltage	Yes
PriProt	priProt	text	Yes
TransDescr	transDescr	none	Yes
Comments	comments	none	Yes
The following attributes are required, but do not have corresponding fields in the exported XML.
FeederID	<null>	string	No
ElectricTraceWeight	<null>	long	No

Transformer (TransformerUnit)

The MultiSpeak API supports the following domain values for the attributes in the tables listed below.
Domain	Supported Values
Connection Code	ShuntWye=Shunt-Wye; ShuntDelta=Shunt-Delta; ShuntSameAsParent=Shunt-Same as Parent; Series=Series;
Connection Configuration	D=Delta; Y=Wye
*Electric Line Voltage	10=120v; 20=120/208v; 30=120/240v; 40=240/480v; 50=277/480v; 60=480v; 80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
*Electric Device Operating Voltage	80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
Normal Position	0=Normally Open; 1=Normally Closed; 2=Not Applicable
Over Current Prot Dev Max Continuous Current	50 = 50A, 100 = 100A, 200 = 200A, 280 = 280A, 560 = 560A, 600 = 600A, 800 = 800A, 900 = 900A, 1200 = 1200A, 2000 = 2000A
Phase Designation	1 = C; 2 = B; 3 = BC, 4 = A, 5 = AC, 6 = AB, 7 = ABC
Regulated Indicator	R=Regulated; U=Unregulated
*Secondary Nominal Voltage	10=120v; 20=120/208v; 30=120/240v; 50=277/480v; 60=480v
Secondary Type	SVC=Service; SEC=Secondary; UB=Underbuild
Service Current Rating	1=100 amps; 2=200 amps; 4=400 amps; 6=600 amps; 12=1200 amps
*Switch Nominal Voltage	100=4.16 kV; 250=13.8 kV; 330=24.9 kV; 370=34.5 kV
Switch Status	0=Off; 1=On; 2=Discnct
Transformer Bank Nominal Voltage	80=2400 V Delta; 110=4160 V Delta; 120=4.16 kV Grounded Y; 150=7200 V Delta; 160=7.2 kV Grounded Y; 210=12.5 kV Grounded Y; 230=13.2 kV Grounded Y; 260=13800 V Delta; 270=13.8 kV Grounded Y; 340=24.9 kV Grounded Y; 380=34.5 kV Grounded Y
Transformer Unit kVA	150=150kVA; 167=167kVA; 225=225kVA; 250=250kVA; 300=300kVA; 333=333kVA; 500=500kVA; 750=750kVA; 1000=1000kVA; 1500=1500kVA; 2000=2000kVA; 2500=2500kVA
Transformer Unit Manufacturer	ABB=ABB/Westinghouse; CM=Central Maloney; CPR=Cooper/McGraw Edison; D=Delta; GE=General Electric; HKP=H.K. Potter; OTH=Other
Winding Code	Open Y-D, D-D, Y-Y Grounded Imp, Y-Y 3ph Core Type, D-D one, Y-Y-D Ground, Y-D one, D-Y open

This table lists the valid values for the Subtype field on the specified feature class.
Feature Class	Supported Values
Dynamic Protective Device Bank	1 = Breaker; 2 = Recloser; 3 = Sectionalizer
Switch	1 = Overhead; 2 = Underground
Fuse	1 = Overhead; 2 = Underground
Generators and Motors	1 = Steady State; 2 = Subtransient; 3 = Transient