Network Adapter - Configuration File

Most of the Network Adapter-DMS configuration is done in the NetworkAdapter.exe.config file. You will also need to assign some model names in the geodatabase to specify the classes and attributes to be exported.

Open NetworkAdapter.exe.config. This file is installed in the Program Files (x86)\ArcFM Solution\Bin directory.

Set Export Database

The Default attribute in the NetworkAdapterSection tag determines the database from which data is exported. You add connection information for multiple databases in this configuration file. The Default value indicates the connection to be used. Follow steps 3-6 for each database to configure.
```
        <NetworkAdapterSection Default="ConfigName">
```

Use the <add> tag to specify a geodatabase. Provide information for the following attributes of the <add> tag:

Name: Use this attribute to specify a name for the connection. You can name the connection anything you’d like.
GeometricNetworkName: The name of the electric geometric network in the geodatabase. Be sure to include the prefix (e.g., SDE.ElecGeomNetwork).
GlobalIDs: Use this attribute to enable the export of GlobalIDs. By default, this value is set to False (GlobalIDs not exported). Set this value to True to include GlobalID values in your export. If this attribute doesn't exist, it defaults to false. Add it and set it to true to enable support for GlobalIDs. This setting MUST match the GlobalIDs setting in Miner.Responder.DataServices.exe.config.

   <add name="ConfigName" GeometricNetworkName="ARCFM.ElecGeomNetwork" GlobalIDs="false">

GlobalIDs: Any time the GlobalIDs value changes, you will need to repopulate the mapping tables. First truncate the tables owned by the SMARTGRID owner, then export with Network Adapter with the appropriate pipeline rules enabled.

GlobalIDs and Data: If the GlobalIDs value is enabled, then every feature class in the network must have a populated GlobalID field. If this field doesn't exist on each feature class or is not populated, you will experience data errors when exporting.

Under the <add> tag is the <SdeElement> tag. Use the attributes in this tag to set the geodatabase connection information.
- Server: Enter the name of the server.
- Instance: Enter the instance.
- Database: This attribute is necessary only for SQLServer connections or Access databases. For SQLServer, enter the database. For Access, enter the path to the geodatabase. You can enter a file geodatabase (.gdb) or a personal geodatabase (.mdb)
- Version: Enter the version to export feeders.
- User: Enter the user name to be used to log in.
- Password: Enter the password that corresponds with the user name.
```
        <SdeElement Server="hispania" Instance="5152" Version="SDE.DEFAULT" User="arcfm" Password="*#Kk%(RJcJBiLokdw=">
```

Change the WorkspaceFactory element only if you are using an Access database. The QualifiedTypeName attribute specifies the type of workspace. For Oracle and SQLServer this value should be as shown in the example below.

Oracle and SQL Server:

        <WorkspaceFactory QualifiedTypeName="Esri.ArcGIS.DataSourcesGDB.SdeWorkspaceFactoryClass, 
                Esri.ArcGIS.DataSourcesGDB, Version=10.1.0.0, Culture=neutral, PublicKeyToken=8fc3cc631e44ad86" />

Access Geodatabases:

  <WorkspaceFactory QualifiedTypeName="Esri.ArcGIS.DataSourcesGDB.AccessWorkspaceFactoryClass, 
                Esri.ArcGIS.DataSourcesGDB, Version=10.1.0.0, Culture=neutral, PublicKeyToken=8fc3cc631e44ad86" />

The ModelNames section allows you to set the model names and the classes or fields to which they should be assigned. When exporting, Network Adapter will export the classes, attributes and relationships to which the specified model names are assigned. The ReverseRelationshipModelNames section holds model names assigned to unusual relationship situations. For example, a switching facility is the origin of a 1-M relationship class, while normally a network device would be the origin.

The example XML below depicts the NetworkAdapter.exe.config default settings.

The FeatureIDFieldModelName value determines which field is used to display feature information in the NetworkAdapter.exe results window. If this value is not set, the feature's ObjectID is used. By default, this value is set to FACILITYID.

	Copy Code
<ModelNames FeatureIDFieldModelName="FACILITYID"> <ClassModelNames> <add name="MULTISPEAKCLASS"></add> </ClassModelNames> <FieldModelNames> <add name="MULTISPEAKFIELD"></add> <add name="MULTISPEAKEXTENSION"></add> <add name="MULTISPEAKEQUIPMENT"></add> <add name="HIGHSIDECONFIGURATION"></add> <add name="LOWSIDECONFIGURATION"></add> <add name="FEEDERID"></add> <add name="SUBSTATIONID"></add> <add name="LOWSIDEVOLTAGE"></add> <add name="OPERATINGVOLTAGE"></add> <add name="SCADACONTROLID"></add> <add name="FACILITYID"></add> <add name="MEASUREDLENGTH"></add> <add name="FAULTINDICATORDIRECTION"></add> <add name="TAPCHANGEREQUIPMENT"></add> <add name="TAPCHANGEREQUIPMENT1"></add> <add name="TAPCHANGEREQUIPMENT2"></add> <add name="TAPCHANGEREQUIPMENT3"></add> <add name="TAPCHANGEREQUIPMENT4"></add> </FieldModelNames> <RelationshipModelNames> <add name="MULTISPEAKCLASS"></add> </RelationshipModelNames> <ReverseRelationshipModelNames> <add name="RELATEDSUBSTATION"></add> </ReverseRelationshipModelNames> <ElectricModelNames LowSideVoltageFieldModelName="LOWSIDEVOLTAGE" OperatingVoltageFieldModelName="OPERATINGVOLTAGE" PhaseDesignationFieldModelName="PHASEDESIGNATION"> </ElectricModelNames> </ModelNames>

Copy Code

<ModelNames FeatureIDFieldModelName="FACILITYID">
  <ClassModelNames>
    <add name="MULTISPEAKCLASS"></add>
  </ClassModelNames>
  <FieldModelNames>
    <add name="MULTISPEAKFIELD"></add>
    <add name="MULTISPEAKEXTENSION"></add>
    <add name="MULTISPEAKEQUIPMENT"></add>
    <add name="HIGHSIDECONFIGURATION"></add>
    <add name="LOWSIDECONFIGURATION"></add>
    <add name="FEEDERID"></add>
    <add name="SUBSTATIONID"></add>
    <add name="LOWSIDEVOLTAGE"></add>
    <add name="OPERATINGVOLTAGE"></add>
    <add name="SCADACONTROLID"></add>
    <add name="FACILITYID"></add>
    <add name="MEASUREDLENGTH"></add>
    <add name="FAULTINDICATORDIRECTION"></add>
    <add name="TAPCHANGEREQUIPMENT"></add>
    <add name="TAPCHANGEREQUIPMENT1"></add>
    <add name="TAPCHANGEREQUIPMENT2"></add>
    <add name="TAPCHANGEREQUIPMENT3"></add>
    <add name="TAPCHANGEREQUIPMENT4"></add>
  </FieldModelNames>
  <RelationshipModelNames>
    <add name="MULTISPEAKCLASS"></add>
  </RelationshipModelNames>
  <ReverseRelationshipModelNames>
    <add name="RELATEDSUBSTATION"></add>
  </ReverseRelationshipModelNames>
  <ElectricModelNames
    LowSideVoltageFieldModelName="LOWSIDEVOLTAGE"
    OperatingVoltageFieldModelName="OPERATINGVOLTAGE"
    PhaseDesignationFieldModelName="PHASEDESIGNATION">
  </ElectricModelNames>
</ModelNames>

Using the example above, Network Adapter will export all classes that have the MULTISPEAKCLASS model name assigned. For each exported class, Network Adapter will export the fields with the model names specified by the Field Model Names section. The MULTISPEAKCLASS model name should be assigned to all classes on the Supported Attributes table.

Assign the MULTISPEAKFIELD model name to any field you wish to include in the export. This model name should be assigned to all fields in the Supported Attributes table.

The MULTISPEAKEXTENSION model name can be used to export a field that doesn’t appear in the MultiSpeak data model. Assign the MULTISPEAKEQUIPMENT model name to the field that represents the EquipmentID. The LOWSIDEVOLTAGE and OPERATINGVOLTAGE model names are necessary for the Voltage Validation rule. If you don’t wish to validate voltage, then these fields do not need to be included in the export.

The following field model names are necessary in order for the XML transformation to occur properly: MULTISPEAKEXTENSION, MULTISPEAKEQUIPMENT, HIGHSIDECONFIGURATION, LOWSIDECONFIGURATION.

The model names in the ElectricModelNames section are used by phase and voltage validation. Do not modify these model names.

Point to DMS Machine

Set the IP address for the DMS machine. Look for the following bit of code and set the IP address to that of the DMS machine:

<endpoint address="http://172.18.226.196:8080/StaticDataService" binding="basicHttpBinding"
bindingConfiguration="BasicHttpBinding_IStaticDataService"
contract="IStaticDataService" name="BasicHttpBinding_IStaticDataService" />

Save NetworkAdapter.exe.config. The next step also requires edits to this configuration file. You may wish to keep it open.