Notice About Custom Code
The 10.1 release contains a number of compatibility-breaking API changes. These changes are necessary for ArcFM Server to support ArcGIS Server as a 64-bit application. In order to make the changes a painless as possible, we ensured the namespaces remained the same. In most instances you'll need to add a reference and recompile. Review the Migrate to 10.1 page before upgrading.
This page outlines what's new in the current release. If you are upgrading from more than one release prior, it is important to review all What's New pages for each release between your original release and the release to which you are upgrading. On these pages, look for required changes to custom code as well as interfaces that may have become obsolete.
This page outlines the upgrade steps for various ArcFM Solution applications. These are basic required upgrades and do not include configuration for new tools. If you are skipping release versions (e.g., upgrading from 9.3.1 to 10.0.1), note the following:
- DO NOT install each release in between. Only install the version to which you're upgrading.
- DO review the upgrade steps for each release in between the original version and the one to which you're upgrading. Perform any additional upgrade steps outlined on these pages (e.g., recommended Esri patches, Responder upgrade steps, Process Framework database upgrades, etc.).
- DO run the Create/Update ArcFM Solution System Tables tool only once. There's no need to run it multiple times.
- DO run the Upgrade ArcFM Solution Database tool only once. There's no need to run it multiple times.
- DO review the What's New page for each release in between. These pages will outline the new functionality available to you.
- DO review the Migration pages for each release in between. These pages will let you know if you need to compile custom code.
This section provides a list of API changes for 10.1 as well as information for migrating custom code. Be sure to review the API changes and perform any migration steps for releases between your original version and the one to which you are upgrading.
- Ensure that your hardware and software meet the ArcGIS system requirements. These requirements are available at http://support.esri.com/.
- Ensure that your hardware and software meet the ArcFM system requirements defined at the ArcFM Solution Supported Versions web page.
What's New in ArcFM Desktop?
- Tool tips are linked to context-sensitive help in 10.1. As before, hover over an ArcFM tool icon to pop-up its tool tip. If more help is needed, press the F1 key to access the relevent topic for that tool in the help documentation.
- You can now use ArcFM Cathodic Protection tools on water networks, in addition to gas networks.
- Enjoy other enhancements to the Cathodic Protection Systems tool including the ability to rename CP systems and zoom to individual CP system features. You can also use the new Select Features button to send test points to the attribute editor.
- Adjustable Zoom To Buffer Size units in the ArcFM Options offer greater flexibility when zooming to selected features.
- The ArcFM Locator Tool now performs up to 75% faster than before. It also now respects the Enter key for starting a search.
- Performance when opening a design has been improved.
- The CU Filter tool can now perform a search on Favorites based on description.
- The public CU Filter API has been enhanced to include Palettes, allowing developers to add, delete, and edit Palettes in their custom solutions.
- Enhanced Circuit Management provides functionality that populates new header information fields on the circuits that currently exist in your database. This header information allows circuits to automatically heal themselves when you use Connection Manager to alter any connectivity that affects circuit paths. All new circuits created in 10.1 will automatically contain and populate the header information fields that enable this automated circuit healing functionality. Additionally, once header information is added, you can manually heal circuits that were created and dirtied in previous versions of Fiber Manager.
- Use the new search bar in Circuit Manager to filter circuit names as you type. You can also adjust the Circuit Manager's window size and layout, and it will stay the same for the length of the ArcMap session. Last, you can now open the Circuit Manager outside of an edit session.
- The Connection Manager recieved a number of updates including row and connection highlighting, the ability to adjust column and window widths, and the persistance of these sizings across the life of the ArcMap session. Additionally, connections that belong to a circuit path are now highlighetd in red, as well as their squaps. Furthermore, you can now use the right-click command called Show Both Sides of the Connection on a squap. The Connection Manager automatically adjusts the fiber optic cable or device in the drop-down menus to display the relevant connection.
- You can now delete top-level objects in the Location Editor. When you need to delete large cables and patch locations, we strongly recommend using the Location Editor over all other methods.
- The OTDR and Circuit Trace Reports have an updated, more readable format.
- The OTDR workflow was streamlined to include the OTDR distance and trace selector in the same window.
- There is a new length option that ensures the accuracy of certain length calculations. The OTDR LENGTH option allows you to enter a cable length that already includes the twist factor.
- To support internationalization, you can now customize the numbering formats for values that appear in the Fiber Trace Report and the Glass Report. For details, refer to the Using Guide help topic titled Fiber Manager Reporting.
- To retain the behavior of previous versions of ArcFM, where report formats persist beyond the extent of a single ArcMap session, Telvent implemented a new model for storing .xslt files. For details, refer to the Using Guide help topic titled Fiber Manager Reporting.
The following enhancements have been added to Mobile.
- Mobile now supports relationships based on Global IDs.
- This release addresses the issue regarding broken relationships resulting from features containing different GUIDs between SDE and mobile client geodatabases. It requires that you run the ArcFM Set Server OID tool on your Initial Extract database.
- The GDB Extraction tool is now neither accessible nor supported.
- No new functionality was added for the 10.1 release.
What's New in Responder?
- Responder Web Map Viewer and Switch Order Requests now utilize ArcFM Server when accessing map data. The Switch Order Request workflow has changed to assist in data entry and device location. This provides a more usable format for viewing maps and creating Switch Order Requests.
- Responder Web functionality that previously required ArcGIS Server (such as Map Viewer), now requires a valid ArcFM Server license. Responder provides this to the client as necessary.
- The following enhancements have been made to Switching Orders within Responder Explorer:
- Snippets now maintain the grouping of steps.
- A new Pause All functionality exists for pausing all simulations for Switching Orders open in the same window.
- You can now manually refresh Switch Order device states using the Refresh Device States option within the Orders menu. This allows for more accurate messaging as device states change in Responder while a Switching Order is open in the Switch Order editor window.
- Switching Order groups now appear on any report that includes Switch Order information
- Switching Order groups are maintained within the archive.
- Responder Explorer now allows you to consolidate restored incidents.
- An Apply Updates tool now appears on the Responder Explorer toolbar. Clicking this tool allows you to apply all changes to the information on the window without collapsing all expanded grid rows. The Refresh Data tool still exists, but must be added to the toolbar from the Customize tool menu. This tool refreshes the window, and will collapse all expanded grid rows.
- This release includes the following new developer samples:
- Responder Explorer Customization: Illustrates how to create a button and context menu commands to display in Responder Explorer.
- Responder Submit Rules: Allows you to manipulate (insert, update, delete) data from a submit rule to modify rows in the DataSet.
- Responder Request: Includes steps on how to query Responder information.
What's New in ArcFM Server?
- ArcFM Server is now compatible with ArcGIS Server 10.1. It can only be run on 64-bit systems. See our Supported Versions page for Hardware and Operating System requirements.
- ArcGIS for Server 10.1 only supports publishing optimized maps (MSDs), as this is a best practice for map publishing. Non-optimized map documents (MXDs) are no longer supported.
- ArcGIS for Server 10.1 requires that you analyze your map documents (MXDs) before publishing them and fix any errors that appear. In addition, you must modify any customizations that rely on MXD-specific interfaces (such as IMap, ILayer, page layout dependencies, and so on).
- A white paper on the ArcFM Solution Resource Center discusses installing ArcFM Server 10.1 on a single machine or in a distributed environment.
- The Batch Plotting developer sample has been removed from the Developer Sample page of the Resource Center as it is not compatible with the 10.1 release. In addition, the following developer sample Customization Help topics have been removed as they are not compatible with the 10.1 release:
- Add Custom Relationships
- Batch Plotting
- Search Strategy Task