Communication between HxGN EAM and the ArcGIS platform is accomplished using web services. GIS map services to be displayed inside HxGN EAM are defined by installation parameters. These map services are published via the GIS as REST URLs. HxGN EAM releases prior to 11.1 utilized only SOAP URLs. However, beginning with HxGN EAM 11.1, new GIS map screens and pop-ups were developed and optimized to utilize REST services only. This has resulted in significantly improved performance as well as greater functionality and stability. Further, beginning with HxGN EAM 12.1, in addition to supporting the ArcGIS Server map service REST URL format, HxGN EAM may alternatively consume ArcGIS Online hosted feature layers, as defined by the URL of the corresponding ArcGIS Online item ID for the hosted feature layer.
HxGN EAM is using ESRI’s ArcGIS Maps SDK for JavaScript to provide support for REST web services. Based on this architecture the map display works as follows:
-
When an equipment map is viewed or a map search is performed, a web service call is made to the GIS Server specified in the GISSERV installation parameter.
-
The web service scans the map layer(s) specified on the searched equipment for the unique GIS ID(s) associated to both the EAM equipment and GIS feature(s).
-
The GIS server then generates a map image showing the location of the feature(s) and makes it available in a virtual directory on the GIS server.
-
HxGN EAM retrieves it and returns it for "display" in the appropriate screen.
HxGN EAM may consume either map services published to a standalone ArcGIS Server
or an ArcGIS Server that has been federated to an ArcGIS Portal; or may consume ArcGIS
Online hosted feature layers (available through the ArcGIS Online item ID).
See the ArcGIS portal section for details.
See the EAM configuration tasks for GIS for more information on defining services.
For additional information about where to find the item ID for an ArcGIS Online item, see the following: https://community.esri.com/t5/arcgis-online-blog/where-can-i-find-the-item-id-for-an-arcgis-online/ba-p/890284.