IBM i2 Analyst's Notebook SDK 8.9.7 Fix Pack 2 Readme

Fix Readme

Abstract

Readme file for: IBM® i2® Analyst's Notebook SDK 8.9.7 Fix Pack 2
Product Component release: 8.9.7
Update name: Fix Pack 2
Fix ID: 8.9.7.2-SEC-I2ANDK-WinOS-FP0002
Publication date: 23 July 2021
Last modified date: 23 July 2021
Online version of the readme file: https://www.ibm.com/support/pages/node/6348544

Important: The most current version of the readme file can always be found online.

Download location

IBM i2 Analyst's Notebook SDK 8.9.7 Fix Pack 2 can be downloaded from Fix Central. For more information, see the download document:

https://www.ibm.com/support/pages/node/6339687

Prerequisites

This fix pack can be applied to a system with an existing installation of IBM i2 Analyst's Notebook SDK 8.9.7. The sample projects require either Microsoft Visual Studio 2017 with .NET Framework version 4.7.2, or Microsoft Visual Studio 2019 with .NET Framework version 4.8.

This fix pack is compatible with i2 Analyze 4.3.4 and IBM i2 Analyst's Notebook Premium 9.2.4.

Installation information

The fix pack distribution contains folders named Samples and Documentation. You can put the contents of the Samples folder wherever you would normally store Visual Studio development projects. The documentation, which describes the samples and the new API, is in HTML format and best viewed when hosted on a web server. The simplest approach is to use your existing i2 Analyze server:

Copy the Documentation folder from this distribution to the server where the i2 Analyze deployment toolkit is installed.

Put the Documentation folder in the toolkit\configuration\fragments\opal-services folder, alongside the existing WEB-INF folder.

Note: "Documentation" forms part of the URL for the API documentation. To change the URL, rename the copied folder before you complete the next steps.
On the i2 Analyze server, open a command prompt and navigate to the toolkit\scripts folder in the deployment toolkit.
Enter the following commands in sequence to redeploy and restart the i2 Analyze server with the new API documentation:
```
setup -t stopLiberty
setup -t deployLiberty
setup -t startLiberty
```
After the server restarts, you can read the documentation at
```
http(s)://<host_name>/opal/Documentation
```
Where <host_name> is the fully qualified name of the i2 Analyze server, and Documentation might be different if you changed the directory name in Step 1.

List of fixes

IBM i2 Analyst's Notebook SDK 8.9.7 Fix Pack 2 enables the development of Analyst's Notebook plug-ins that can interact with i2 Analyze records on charts and in the Information Store. The distribution includes a set of API documentation and sample projects that demonstrate some applications of the new functionality:

Disconnected records - records can now be created using the i2.Notebook.Chart.Data.Disconnected namespace that are not associated with an Analyst's Notebook chart.
Extra Charting Controller methods - Extra methods are added to the i2.Notebook.Opal.Controllers.IChartingController to add disconnected records or record groups to charts. In addition, you can apply system matching rules to identify matches in the Information Store and the target chart.
Custom URI handler - Analyst's Notebook plug-ins can now be created that can accept custom URIs that are launched by web pages hosted in an external browser.

Note: Although no interface signatures have changed, update project references and deliverables to ensure you are using the latest components.

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 jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third-party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third-party software code identified below are "Excluded Components" and are subject to the following terms and conditions:

The Excluded Components are provided on an "AS IS" basis
IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
IBM will not be liable to you or indemnify you for any claims related to the Excluded Components
IBM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components.

Document change history

First published: 23 July 2021

Copyright and trademark information

IBM, the IBM logo, and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml.

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYDGD","label":"i2 Analyst's Notebook SDK"},"ARM Category":[{"code":"a8m500000008jDoAAI","label":"i2 Analyst's Notebook and other i2 software->SDK"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.9.7","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Tips