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
Download PDF