Column Order

You may modify the order in which columns appear in a grid in Responder Explorer and Archive Explorer. This customization is done in Miner.Responder.Explorer.exe.layout or Miner.Archive.Explorer.exe.layout. Both files are installed here by default: C:\Documents and Settings\<user>\Application Data\Miner and Miner\Responder.

The layout files control the grid information for all grids that appear in Responder Explorer and Archive Explorer. This sample modifies the main Incidents grid. This is the <IncidentsForm.datasetGrid.ultraGrid1> element in the Miner.Responder.Explorer.exe.layout file.

Open Miner.Responder.Explorer.exe.layout (or Miner.Archive.Explorer.exe.layout).
Look for the <IncidentsForm.datasetGrid.ultraGrid1> element (or the element you wish to modify).

XML Snippet	Copy Code
<Control name="IncidentsForm.datasetGrid.ultraGrid1"> <PersistedData> <Item name="Band0ColKeys" type="System.String" value="ID,STATUS,REGION,CRITICAL,HAZARD,CAUSE,WEATHER,CUSTOMER_COUNT,CRITICAL_CUSTOMER_COUNT,FEEDER_ID,SUBSTATION,TIME_CREATED,TIME_OUTAGE,TIME_RESTORED_EST,TIME_RESTORED,REMARKS_DISPATCH,REMARKS_FIELD,USER_CREATED,USER_UPDATED,CONFIRMED,ORIGINATION,OWNER,DURATION,CALLBACK_COUNT,Incidents_IncidentCallbacks,Incidents_IncidentDevices,Incidents_IncidentFeatures,Incidents_SwitchingOrders,Incidents_CrewAssignments" /> <Item name="Band0ColPositions" type="System.String" value="0,1,2,4,9,16,17,5,6,7,8,12,13,14,15,22,18,20,21,10,19,3,23,11,24,25,26,27,28" /> <!-- ...Not all Item elements shown in this example... --> </PersistedData> </Control>

XML Snippet

Copy Code

<Control name="IncidentsForm.datasetGrid.ultraGrid1"> 
  <PersistedData>
    <Item name="Band0ColKeys" type="System.String" value="ID,STATUS,REGION,CRITICAL,HAZARD,CAUSE,WEATHER,CUSTOMER_COUNT,CRITICAL_CUSTOMER_COUNT,FEEDER_ID,SUBSTATION,TIME_CREATED,TIME_OUTAGE,TIME_RESTORED_EST,TIME_RESTORED,REMARKS_DISPATCH,REMARKS_FIELD,USER_CREATED,USER_UPDATED,CONFIRMED,ORIGINATION,OWNER,DURATION,CALLBACK_COUNT,Incidents_IncidentCallbacks,Incidents_IncidentDevices,Incidents_IncidentFeatures,Incidents_SwitchingOrders,Incidents_CrewAssignments" />
     <Item name="Band0ColPositions" type="System.String" value="0,1,2,4,9,16,17,5,6,7,8,12,13,14,15,22,18,20,21,10,19,3,23,11,24,25,26,27,28" />

<!-- ...Not all Item elements shown in this example... -->
  </PersistedData>
</Control>

Under the IncidentsForm.datasetGrid.ultraGrid1 element, you will notice a large number of Item elements with names that start with "Band". "Band" refers to a row in Explorer. For example, there is a band for the incident row, a band for the incident features row, a band for the location features row, a band for crew assignments, etc.
Each band has five elements: ColPositions, ColSortOrders, ColWidths, ColKeys, and ColSortDesc. To modify column order, you'll need to look at ColPositions and ColKeys.
In this example, we're looking at the Incidents grid, which is Band0. The ColKeys element for Band0 (see XML Snippet above) lists the field names. These are numbered from 0-28 in the order show. (i.e., ID=0, STATUS=1, REGION=2, CRITICAL=3, HAZARD=4, etc.).
The ColPositions key takes the number assigned to the field names in the ColKeys element and places those numbers in the order in which they appear in the grid. For example, if the number sequence begins 4, 2, 1, 3, 0, then using the ColKeys element the column titles would appear in this order: HAZARD, REGION, STATUS, CRITICAL, ID. Modify the numbers listed in the ColPositions element to determine the order in which you want the columns to appear.

It's always best to start with the ColKeys and ColPositions elements in numerical order (0, 1, 2, 3, 4...) before making modifications. This may mean changing the default before setting the columns in your desired order.