WebFOCUS Adapter for Geographic Information Systems: ESRI ArcGIS Server and ArcGIS Flex API Release 8.2 Version 01M April 17, 2017 Active Technologies, EDA, EDA/SQL, FIDEL, FOCUS, Information Builders, the Information Builders logo, iWay, iWay Software, Parlay, PC/FOCUS, RStat, Table Talk, Web390, WebFOCUS, WebFOCUS Active Technologies, and WebFOCUS Magnify are registered trademarks, and DataMigrator and Hyperstage are trademarks of Information Builders, Inc. Adobe, the Adobe logo, Acrobat, Adobe Reader, Flash, Adobe Flash Builder, Flex, and PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Due to the nature of this material, this document refers to numerous hardware and software products by their trademarks. In most, if not all cases, these designations are claimed as trademarks or registered trademarks by their respective companies. It is not this publisher's intent to use any of these names generically. The reader is therefore cautioned to investigate all claimed trademark rights before using any of these names other than to refer to the product described. Copyright © 2017, by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. This manual, or parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc. Contents Preface ........................................................................ 13 Documentation Conventions .......................................................... 14 Related Publications .................................................................15 Customer Support ...................................................................15 Information You Should Have ..........................................................16 User Feedback ......................................................................17 Information Builders Consulting and Training ............................................ 17 1. Introducing Geographic Information Systems .................................. 19 Understanding Geographic Information Systems ......................................... 19 Defining the Geographic Business Intelligence Solution ...................................20 GBIS Components ...................................................................20 ArcGIS Server.................................................................. 20 ArcIMS........................................................................ 21 ArcSDE........................................................................21 WebFOCUS.................................................................... 21 WebFOCUS GIS Adapter......................................................... 21 New Features .......................................................................22 Mapping Capabilities............................................................22 Map Viewer Interface............................................................23 Techniques.................................................................... 24 2. WebFOCUS GIS Adapter Architecture .......................................... 25 XML-based Configuration Blocks .......................................................25 Orientation Modes ...................................................................26 Operational Flow - General....................................................... 26 Operational Flow - WebFOCUS Map View Manager................................... 26 Operational Flow - WebFOCUS Application.......................................... 27 Map Rendering Capabilities...................................................... 27 Identify Functionality.............................................................28 Run Map Procedure............................................................. 28 Current Limitations .................................................................. 28 3. Prerequisites for WebFOCUS GIS Viewer for Flex ...............................29 WebFOCUS Adapter for Geographic Information Systems: ESRI ArcGIS Server and ArcGIS Flex API 3 Contents Overview ........................................................................... 29 Map Document Requirements.................................................... 30 Data Storage Requirements......................................................30 Permission Requirements........................................................30 Creating a Map Service ...............................................................30 Configuring the Crossdomain.xml File .................................................. 54 4. Using the ESRI Configuration Utility ........................................... 55 Introduction .........................................................................55 Understanding the Layout and User Interface ............................................65 Navigating the Main Window......................................................66 Viewing the XML Definition File....................................................70 Saving the XML Definition File.................................................... 72 Exiting From the ESRI Configuration Utility..........................................73 Configuring FOCEXECs ............................................................... 73 Configuring Inbound Layers.......................................................92 Configuring Outbound Layers....................................................100 Configuring Synthetic Map Services ...................................................108 Configuring Symbols ................................................................114 Adding Bookmarks ................................................................. 120 Customizing JavaScript Syntax ....................................................... 122 Configuring Settings ................................................................ 122 Display Information Settings.................................................... 123 Window Settings...............................................................125 Miscellaneous Settings.........................................................127 Flushing Tables .................................................................... 129 Verifying the XML Definition File ...................................................... 130 Current Limitations .................................................................131 5. Using the WebFOCUS GIS Viewer for Flex .....................................133 Overview ..........................................................................133 WebFOCUS GIS Viewer for Flex Components ........................................... 137 Map Component...............................................................137 Navigation Component......................................................... 140 4 Information Builders Contents Tools Component..............................................................141 WebFOCUS Component.........................................................145 Help Component...............................................................149 WebFOCUS Map Component .........................................................152 WebFOCUS Report Component .......................................................155 Synthetic Layer Component ..........................................................158 WebFOCUS Data View Component ....................................................158 JavaScript Functions Available From Flexmapviewer.jsp ..................................159 jsRunFex..................................................................... 159 jsSetLayerVisible.............................................................. 161 jsClearMap................................................................... 161 jsSetMapExtent2.............................................................. 162 6. Creating WebFOCUS GIS Procedures ......................................... 163 Incorporating the GIS Filter .......................................................... 163 Creating a Report Procedure .........................................................166 Creating an Identify Procedure ....................................................... 166 Creating a Map Procedure ...........................................................167 7. Useful Techniques and Examples .............................................169 Creating Drill-Downs From a Report to a Map ...........................................169 Creating Drill-Downs Between Reports............................................174 Drawing Multiple Map Layers .........................................................175 Drawing Identical Map Layers Using Alternative Methods............................176 Including Custom Libraries ...........................................................178 Embedding Custom JavaScript Functions in the ESRIINFO.XML File ........................179 Directing Alternate Report Output to Different Windows ..................................179 Specifying Custom Colors in Your FOCEXEC ............................................180 Automatically Zooming On Selected Portions of the Map .................................180 Automatically Zooming On Drawn Map Features ........................................ 180 Controlling the Visible Map Viewing Area ...............................................181 Adding Additional Attributes to the URL........................................... 181 Increasing the Maximum Number of Selectable Map Features ............................ 182 Alternate Techniques...........................................................183 WebFOCUS Adapter for Geographic Information Systems: ESRI ArcGIS Server and ArcGIS Flex API 5 Contents Improving Map and Report Response Time .............................................184 Clear Server Internal Cache Information...........................................184 Defining a Tiled Map Service .........................................................185 Loading the Flex Map Viewer .........................................................185 Using Symbols Defined in Your Configuration File .......................................185 Controlling Layers That are Visible ....................................................186 Enabling a Buffer Using Selected Features From the Layer ............................... 186 Creating Rollovers ..................................................................195 Passing Parameters From an HTML Layout .............................................200 Navigating to a Geoprocessing REST Endpoint ..........................................202 Creating a Report or Map Binding Using a Geoprocessing Service .........................204 Controlling the Visibility of Dynamic Map Layers ........................................ 207 A. XML Schema Reference ..................................................... 209 Root Element <mapfexs> ............................................................209 Child Element <performance>...................................................209 Child Element <jsincludes>..................................................... 211 Child Element <errorpage>......................................................211 Child Element <menuinfo>......................................................211 Child Element <reportserver>....................................................212 Child Element <displayinfo>.....................................................213 Child Element <windows>.......................................................217 Child Element <callback>.......................................................220 Child Element <mapservice>....................................................220 Child Element <fex>........................................................... 226 Child Element <livemaps>...................................................... 234 Class Definitions ...................................................................235 ScaleBar..................................................................... 235 NorthArrow....................................................................237 ArrowMarkerSymbol............................................................238 Barchartsymbol................................................................239 CartographicLineSymbol........................................................240 Available With ArcGIS Server.................................................... 241 6 Information Builders Contents SimpleMarkerSymbol..................................................... 241 SimpleLineSymbol ....................................................... 243 SimpleFillSymbol .........................................................243 PieChartSymbol ..........................................................244 PictureMarkerSymbol .....................................................245 PictureLineSymbol ....................................................... 246 PictureFillSymbol .........................................................247 MultiLayerLineSymbol .................................................... 248 MultiLayerFillSymbol ......................................................249 MultiLayerMarkerSymbol...................................................250 CharacterMarkerSymbol .................................................. 251 DotDensityFillSymbol .....................................................252 GradientFillSymbol ....................................................... 253 HashLineSymbol .........................................................254 LineFillSymbol ...........................................................255 MarkerFillSymbol ........................................................ 255 MarkerLineSymbol ....................................................... 256 TextSymbol..............................................................257 StackedChartSymbol ..................................................... 259 CartoRampSymbol ....................................................... 261 ColorSymbol ............................................................ 261 Available With ArcGIS Server and ArcIMS..........................................262 CalloutMarkerSymbol .....................................................262 ChartSymbol ............................................................ 263 GradientFillSymbol ....................................................... 264 HashLineSymbol .........................................................264 RasterFillSymbol .........................................................265 RasterMarkerSymbol ..................................................... 266 RasterShieldSymbol ......................................................267 ShieldSymbol ............................................................268 SimpleLineSymbol........................................................268 SimpleMarkerSymbol..................................................... 269 SimplePolygonSymbol.....................................................270 WebFOCUS Adapter for Geographic Information Systems: ESRI ArcGIS Server and ArcGIS Flex API 7 Contents TextMarkerSymbol........................................................271 TextSymbol..............................................................273 TrueTypeMarkerSymbol....................................................274 Available With ArcGIS API for Flex 1.3.............................................275 SimpleMarkerSymbol .....................................................275 SimpleLineSymbol ....................................................... 275 SimpleFillSymbol .........................................................276 PictureMarkerSymbol..................................................... 277 PictureFillSymbol......................................................... 277 CompositeSymbol ........................................................278 TextSymbol..............................................................278 Constants .........................................................................279 drawmode....................................................................280 esriMaskStyle.................................................................281 esriGradientFillStyle............................................................281 esriLineJoinStyle...............................................................281 esriMarkerFillStyle.............................................................281 esriLineCapStyle...............................................................282 esriTextVerticalAlignment....................................................... 282 esriTextHorizontalAlignment.....................................................282 esriTextDirection...............................................................283 esriTextCase..................................................................283 esriTextPosition............................................................... 283 B. Symbol Class Settings and Parameters .......................................285 SimpleLineSymbol ..................................................................285 setAntialiasing................................................................ 285 setCapType...................................................................285 setColor......................................................................286 setJoinType...................................................................286 setOverlap....................................................................286 setTransparency...............................................................286 setLineType...................................................................286 8 Information Builders Contents setWidth..................................................................... 286 SimplePolygonSymbol ...............................................................287 setAntialiasing................................................................ 287 setBoundary.................................................................. 287 setBoundaryCapType...........................................................287 setBoundaryColor..............................................................288 setBoundaryJoinType...........................................................288 setBoundaryTransparency.......................................................288 setBoundaryType.............................................................. 288 setBoundaryWidth............................................................. 288 setFillColor................................................................... 288 setFillInterval..................................................................289 setFillTransparency............................................................ 289 setFillType....................................................................289 setOverlap....................................................................289 setTransparency...............................................................289 SimpleMarkerSymbol ............................................................... 290 setAntialiasing................................................................ 290 setColor......................................................................290 setMarkerType................................................................ 291 setOutline.................................................................... 291 setOverlap....................................................................291 setShadow................................................................... 291 setTransparency...............................................................291 setUseCentroid................................................................291 setWidth..................................................................... 292 RasterMarkerSymbol ................................................................292 setAntialiasing................................................................ 292 setHotSpot................................................................... 292 setImage.....................................................................293 setOverlap....................................................................293 setShadow................................................................... 293 setSize.......................................................................293 WebFOCUS Adapter for Geographic Information Systems: ESRI ArcGIS Server and ArcGIS Flex API 9 Contents setTransparency...............................................................293 setURL.......................................................................294 setUseCentroid................................................................294 TrueTypeMarkerSymbol ............................................................. 294 setAngle......................................................................294 setAngleField..................................................................294 setAntialiasing................................................................ 295 setCharacter..................................................................295 setFont.......................................................................295 setFontColor..................................................................296 setFontSize...................................................................296 setFontStyle.................................................................. 296 setGlowing....................................................................296 setOutline.................................................................... 296 setOverlap....................................................................297 setRotateMethod..............................................................297 setShadow................................................................... 297 setTransparency...............................................................297 setUseCentroid................................................................298 CallOutMarkerSymbol ...............................................................298 setAntialiasing................................................................ 298 setBoundaryColor..............................................................298 setFont.......................................................................298 setFontColor..................................................................298 setFontSize...................................................................299 setFontStyle.................................................................. 299 setGlowing....................................................................299 setInterval....................................................................299 setOutline.................................................................... 299 setShadow................................................................... 299 setTransparency...............................................................300 TextMarkerSymbol ..................................................................300 setAngle......................................................................300 10 Information Builders
Description: