Transcript
IBM i2 Analyst's Notebook Connector for Esri Release Notes Version 8.9.1 May 2012
IBM® i2® Analyst's Notebook Connector for Esri enables IBM i2 Analyst’s Notebook® users to gain direct access to private and public ArcGIS Servers to enhance existing analytical workflow with geospatial views and analysis. Analyst’s Notebook Connector for Esri enhances Analyst’s Notebook through the Foundation Module plug-in. This allows the display and use of maps alongside Analyst’s Notebook charts. Intelligence data and geospatial data may be integrated on the map and chart. Simple geospatial analysis tasks can be performed and geospatial queries run over ArcGIS Server data using map drawing tools and buffers to determine the area of interest. Analyst’s Notebook users are now offered a level of self-service access to geospatial data and services that were previously inaccessible, improving responsiveness, reducing workflow dependencies on the GIS function and enhancing the output of the analytical process. Important: IBM i2 Intelligence Analysis software at version 8.9 is not compatible with earlier versions of i2 software. Upgrading directly is not supported. To install IBM i2 software at version 8.9, you must first uninstall all of your existing i2 software, and then install the new versions. The program or programs covered by these release notes are designated for deployment. .
Contents Release Contents
2
What’s New in this Release?
2
System Requirements
5
Multicultural Support
6
Hardware Specification
8
Documentation
8
Installation
9
Known Limitations
9
Contacting IBM Support
12
Notices INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
© Copyright IBM Corporation 1991, 2012
Release Contents The following table summarizes the releases of Analyst’s Notebook Connector for Esri: Version
Release Date
Analyst's Notebook Connector for Esri 8.9.1
May 2012
Analyst's Notebook Esri Edition 1.1.3
September 2011
Analyst’s Notebook Esri Edition 1.1.1
May 2011
Analyst's Notebook Esri Edition 1.0.3
September 2010
What’s New in this Release? New Features in 8.9.1 Analyst's Notebook Connector for Esri 8.9 includes changes that support the integration of the product into the IBM technology stack. It provides guaranteed compatibility with other IBM i2 products that have the same version number. At version 8.9, IBM i2 products no longer support or require authorization mechanisms such as dongles or software license management (SLM). When you purchase or upgrade to version 8.9 of an IBM i2 product, you must upgrade your other i2 products to version 8.9 at the same time. The Lambert_Conformal_Conic map projection has been added to the list of supported projections. For more information, refer to the IBM i2 Analyst’s Notebook Connector for Esri Configuration Guide. Features in 1.1.3 This was a maintenance release that reduced the installation footprint without changing the feature set. Features in 1.1.1 The following new and updated features were included in 1.1.1: • Clustering of mapped items An option to cluster entities that are located in the same vicinity. At lower zoom levels, this will change the display of items from icons to a circle that contains a count of the number of entities. At higher zoom levels, these entities will display normally • Support for different coordinate systems Support for coordinate systems that use the following map projections: • Albers • Bonne © Copyright International Business Machines Corporation 1991, 2012
2
• Gauss_Kruger • Mercator_Auxiliary_Sphere • Mercator • Polyconic • Sinusoidal • Stereographic • Transverse_Mercator By default, the following coordinate systems are defined: Esri Well-Known ID
Esri Name
4326
GCS WGS 1984
27700
British National Grid
32661
UPS North
32671
UPS South
102100
WGS 1984 Web Mercator Auxiliary Sphere
102113
WGS 1984 Web Mercator
It can be configured to define other coordinate systems. • Multicultural support Translation of 1.1.1 is possible, and support on non-English operating systems has been tested. See Multicultural Support for further details of supported locales. • Drag and Drop onto a map surface Analyst’s Notebook chart items can be dragged and dropped onto an open Map Window. If you drag an item from the chart that doesn't have coordinates, then attributes on the chart item are created for the location on the map where the item is dropped. • Geocoding for chart items Chart items with valid address data can be geocoded to generate geographical coordinates. You can configure a geocoding service to specify how addresses are extracted from chart items. You can use the Geocode Address tool in the Toolbox to process addresses and generate coordinates for them. • Service Area Analysis Using Service Area Analysis you can find (for example) all the locations that lie within a certain time or distance from a specified starting point based on a network layer of streets. • Exporting maps as a picture file Map views and all other layers displayed in the Map Window can be exported as picture files (*.png), allowing them to be saved and printed.
3
© Copyright International Business Machines Corporation 1991, 2012
• Exporting map details to the clipboard Map views and all other layers displayed in the Map Window can be exported to the clipboard so that you can paste them into another application. Features in 1.0 The main highlights in 1.0 were: • Direct access to Esri map content from a window within Analyst’s Notebook. • A flexible user interface, allowing you to undock and move the Map Window to another monitor if necessary. • The ability to send chart items to maps quickly using familiar shortcut menus. • Options to configure settings for extracting coordinates and sending chart items using the Map Chart Items Task Pane. • A useful list of “Items sent to Esri” allows instant access to your mapped chart items. • Support for converting and aggregating disparate geospatial data formats into the correct format for the chosen base map. • The ability to customize and enhance the map view by adding both Esri feature layers and information from Analyst’s Notebook charts. • Map drawing tools that allow you to identify geographical points and areas of interest. • Support for ArcGIS Route Finding and Buffering services. • The ability to run geospatial queries over your ArcGIS Server feature layers using map drawing tools and buffers to define the area of interest. • The ability to send mapped ArcGIS Server feature data and property values to the Analyst’s Notebook chart. • Synchronized map and chart selection and easy to use pan and zoom ‘grab hand’ functionality. • Support for the creation of multiple instances of the same chart item on the map when that item contains multiple location data.
© Copyright International Business Machines Corporation 1991, 2012
4
System Requirements At release these are the supported operating systems for Analyst's Notebook Connector for Esri 8.9.1: Operating System Desktop Operating Systems Windows 7 Professional/Enterprise/Ultimate x86 (32-bit) and x64 (64bit) Windows Vista Business/Enterprise/Ultimate x86 (32-bit) and x64 (64bit) SP1 or later Windows XP Professional x86 (32-bit) SP3 or later and x64 (64-bit) SP2 or later Server Operating Systems offering thin client environments Windows Server 2008 R2 x64 (64-bit) with Terminal Services enabled Windows Server 2008 x86 (32-bit) and x64 (64-bit) with Terminal Services enabled Windows Server 2003 Standard/Enterprise x86 (32-bit) and x64 (64bit) SP2 or later with Terminal Services enabled Windows Server 2003 R2 Standard/Enterprise x86 (32-bit) and x64 (64 bit) SP2 or later with Terminal Services enabled All server operating systems are also supported with Citrix MetaFrame Presentation/Xen App Server 4.0 or later Analyst's Notebook Connector for Esri requires that Analyst’s Notebook 8.9.1 or later is present on the installation system. Analyst's Notebook Connector for Esri requires that Microsoft .NET Framework 3.5 SP1 is present on the installation system. The Microsoft .NET redistributable run time must have been installed before installing Analyst's Notebook Connector for Esri. This is present on the Installation CD. You can also download it from the Microsoft website. Analyst's Notebook Connector for Esri requires Esri ArcGIS Server 9.3.1 or above. By default the client is configured to access Esri ArcGIS Online public Internet server. See the IBM i2 Analyst's Notebook Connector for Esri Configuration Guide for details about how to direct the client to your preferred ArcGIS Server. Analyst's Notebook Connector for Esri requires that Microsoft Windows Installer 4.5 is present if the installation system is running Windows Vista or Windows Server 2008. This is present on the installation CD. You can also download it from the Microsoft website.
5
© Copyright International Business Machines Corporation 1991, 2012
The documentation provided with Analyst's Notebook Connector for Esri is available in PDF format. In order to display this documentation, a PDF viewer must be present on the installation system.
Multicultural Support Analyst's Notebook Connector for Esri is developed in US English. IBM supports this product in the English language on the following regional versions of the supported operating systems: Language Group/Language
Language Collection
Support Status
Western Europe and USA
Basic
Supported
Central Europe
Basic
Supported
Baltic
Basic
Supported
Cyrillic
Basic
Supported
Turkic
Basic
Supported
Arabic
Complex Script
Supported
Japanese
East Asian
Supported
Korean
East Asian
Supported
Traditional Chinese
East Asian
Supported
Simplified Chinese
East Asian
Supported
Thai
Complex Script
Unsupported
Vietnamese
Complex Script
Unsupported
Greek
Basic
Unsupported
Hebrew
Complex Script
Unsupported
Indic
Complex Script
Unsupported
Georgian
Complex Script
Unsupported
Armenian
Complex Script
Unsupported
Dhivehi
Complex Script
Unsupported
Galician
Complex Script
Unsupported
Gujararti
Complex Script
Unsupported
Kannada
Complex Script
Unsupported
Krygyz
Complex Script
Unsupported
Mongolian (Cyrillic)
Complex Script
Unsupported
Punjabi
Complex Script
Unsupported
Syriac
Complex Script
Unsupported
Telagu
Complex Script
Unsupported
Note: Analyst's Notebook Connector for Esri is not mirrored in Arabic.
© Copyright International Business Machines Corporation 1991, 2012
6
Analyst's Notebook Connector for Esri is localizable dependent on the list of supported environments listed above. Only coordinate systems that use the default map projections are supported. Coordinate systems in common use in particular regions will only be supported if they use one of the supported projections. The coordinate formats used in chart data are limited to those currently supported, listed here: • British National Grid (BNG) • British National Grid (Decimal) • Decimal Degrees (DD) • Degrees Minutes Seconds (DMS) • Military Grid Reference System (MGRS) • Universal Polar Stereographic (UPS) • Universal Transverse Mercator (UTM) See the IBM i2 Analyst’s Notebook Connector for Esri Configuration Guide for further information. Virtual Machine Environments Analyst's Notebook Connector for Esri is supported in Virtual Machine environments running on any of the operating systems listed above. The following virtual environments have been tested: • Citrix XenServer • VMWare Workstation 6 or later • VMWare ESX Server 3 or later • Microsoft Hyper-V Esri Server Requirements All Esri services and functions are optional. If required Esri services are unavailable then the dependent functionality will be unavailable. The requirements for each function are:
7
Function
Requires…
Base maps
At least one map service configured to use cached tiles to be running.
Dynamic Maps
At least one map service configured to use dynamically generated tiles to be running.
Buffering
Geometry Service to be running.
Route Finding
At least one map service running with network analysis capability enabled. The exposed map document must contain network analysis, routing capability.
Querying
A dynamic map service to be running containing at least one feature layer.
© Copyright International Business Machines Corporation 1991, 2012
Calculate Service Area
At least one map service running with network analysis capability enabled. The exposed map document must contain network analysis, service area capability.
Geocoding
At least one Geocode service to be running, exposing an Address Locator.
Export to File
No additional requirements.
Export to Clipboard
No additional requirements.
For more information about Esri services and functions, refer to your Esri documentation.
Hardware Specification These are the minimum desktop hardware requirements for IBM i2 Analyst's Notebook Connector for Esri 8.9: Minimum requirements 1.4 GHz processor computer 512 MB RAM 500 MB free disk space for installation, plus space to store chart data. (This does not include disk space required for prerequisites.) XGA-capable graphics card (1024 x 768 high color (16 bit)), and color monitor Mouse or trackball For better performance, and for running a combination of IBM i2 products, a higher specification is recommended: Recommended requirements At least 2 GHz processor computer At least 2 GB RAM At least 1 GB free disk space for installation, plus space to store chart data (This does not include disk space required for prerequisites.) Total disk space requirements depend on number of i2 products to be installed. SXGA-capable graphics card (1280 x1024 high color (16 bit)) and color monitor Mouse or trackball CD-ROM drive or network access (for installation)
Documentation IBM i2 Analyst's Notebook Connector for Esri Configuration Guide This guide describes how to configure Analyst's Notebook Connector for Esri to work with ArcGIS Server. It covers the services that need to be set up on ArcGIS Server, and how to access them using Analyst's Notebook Connector for Esri. © Copyright International Business Machines Corporation 1991, 2012
8
Online help Comprehensive online help that provides reference information for all the product's functionality is available from within Analyst's Notebook Connector for Esri.
Installation Before installing Analyst’s Notebook Connector for Esri, please check that your system meets all the prerequisites described in on page 5. Note: Administrator privileges are required in order to install Analyst's Notebook Connector for Esri. To install Analyst's Notebook Connector for Esri: 1. Close all applications that you might have open. 2. Extract the product files from your downloaded distribution or insert the product CD into your computer's optical drive. 3. Browse to the top level of the folder structure, and run Setup.exe.
Known Limitations The following are known limitations in Analyst's Notebook Connector for Esri. You cannot print from the Map window You cannot print from the Map window. There are two ways to work around this: Export maps as graphics You can export the displayed map and other layers displayed in the Map Window as a picture file. To export a map as a picture file: 1. Select Export Map from the Toolbox. 2. In the Save As dialog, from the Save in drop-down list, select the folder in which you want to save the chart. 3. Type a file name in the File name box. 4. Click OK.
9
© Copyright International Business Machines Corporation 1991, 2012
Export maps to the Clipboard You can also export the map and all other layers displayed in the Map Window to the Clipboard so that you can paste them into another application. To export a map to the Clipboard: 1. Select Export Map to Clipboard from the Toolbox. To see just the Map Window, you will have to edit the generated bitmap in a graphics application, such as Microsoft Paint. Paste the graphic into your chosen application. Double-clicking to pan and zoom to map extents does not always work (#787) When double clicking on the layer tab for a dynamic map, it pans and zooms to the initial extents of the map, not the full extents. If the initial extents of the dynamic map are invalid or cannot be converted into the spatial reference of any loaded base maps, then again nothing will happen. When double clicking on the layer tab for a base map, nothing will happen if the full extents of the map are invalid. Uninstalling Analyst's Notebook Connector for Esri removes the ServerEndpoints.config file (#733) If you uninstall Analyst's Notebook Connector for Esri the ServerEndPoints.config file is removed, even if you have made changes to it. Invalid x/y values may be interpreted incorrectly (#187 & #687) Invalid x/y values such as lat/long values that are out of range, or BNG coordinates with decimal places, may be interpreted incorrectly. This results in either error messages displayed in the Sent Items list (in the Map Chart Items Task Pane), or items charted in unexpected places. If you hide items on the chart, they are not hidden in the Map Window (#619) Items that are sent from a chart to the Map Window aren’t hidden in the Map Window if you hide them on the chart. iBase chart item labels aren’t treated as addresses when the Mailing Address semantic type is used (#589) The labels of iBase chart items that have a Mailing Address semantic type assigned will not be treated as addresses.
© Copyright International Business Machines Corporation 1991, 2012
10
Fails to geocode chart items if attempting to geocode more than the suggested batch size (#588) Geocoding services have a SuggestedBatchSize property which is set on the server. If you attempt to geocode more items than specified in the SuggestedBatchSize results in the additional items failing to geocode. Different links between the same items are merged on the map (#399 & 372) When items that have multiple links to another item are sent to a map, all links between these items are displayed as a single link. This can lead to overlapping label text. To work around this issue, consolidate links within Analyst’s Notebook before adding them to the chart surface. Once a spatial reference is chosen, others can’t be used (#201) If a map of a particular spatial reference is chosen, maps using other spatial references can’t be chosen, even if the original map is no longer in use. Analyst's Notebook Connector for Esri must be restarted to clear the current spatial reference. Same icon used for all features returned in query (#127) Currently all features on a single layer returned as the same icon, even when the underlying layer uses more than one icon. Selection and visibility problems with overlapping items on map (#110) When two or more items exist at the same location on the map it is only possible to select the top item. Items behind can be selected in Analyst’s Notebook but they may not be visible on the map Single mapped items can be selected from a chart item with multiple locations (#65) If an entity has multiple mapped locations you can select and delete only one location (on the map). This will remove all entries in the Sent Items list for that entry, but leave the other locations on the map. Chart item property changes made through the Analyst's Notebook API do not update mapped representation automatically (#56) Currently the map will only update items which have been changed in Analyst's Notebook via the Edit Items dialog. Items on map disappear after zooming in and attempting to pan to their location (#37) Items on map disappear after zooming in and attempting to pan to their location by dragging the map (using the mouse). This applies to any item on the map including routes. For example, when zoomed in and following a route it may disappear before reaching the end. 11
© Copyright International Business Machines Corporation 1991, 2012
Dashed/dotted links (lines) can appear solid on the map (#39) Gaps between dashes or dots on (tentative or unconfirmed) link lines are too small for links with a small width, making the line appear solid.
Contacting IBM Support IBM Support provides assistance with product defects, answers FAQs, and helps users resolve problems with the product. Before you begin After trying to find your answer or solution by using other self-help options such as technotes, you can contact IBM Support. Before contacting IBM Support, your company or organization must have an active IBM software subscription and support contract, and you must be authorized to submit problems to IBM. For information about the types of available support, see the Support portfolio topic in the "Software Support Handbook". Procedure To contact IBM Support about a problem: 1. Define the problem, gather background information, and determine the severity of the problem. For more information, see the Getting IBM Support topic in the Software Support Handbook. 2. Gather diagnostic information. 3. Submit the problem to IBM Support in one of the following ways: -
Online through the IBM Support Portal: You can open, update, and view all of your service requests from the Service Request portlet on the Service Request page.
-
By phone: For the phone number to call in your region, see the Directory of worldwide contacts web page.
Results If the problem that you submit is for a software defect or for missing or inaccurate documentation, IBM Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the IBM Support website daily, so that other users who experience the same problem can benefit from the same resolution.
© Copyright International Business Machines Corporation 1991, 2012
12
