i2 Connect example connectors
To create a connector, you need a data source to query, and a server that supports REST endpoints to query it from. On that foundation, you can build the functionality that takes requests from the i2 Connect gateway, retrieves data from the source, and returns it to the gateway in a shape that is ready for conversion to i2 Analyze records.
Developing a connector walkthrough
The documentation for understanding, deploying and configuring both i2 Analyze and an example connector is divided into the following sections:
- Building an i2 Analyze schema and working with the i2 Connect gateway
- Deploying i2 Analyze
- Deploying a connector
- Creating a service
- Querying an external data source
- Implementing parameterized searches
- Implementing seeded searches
- Implementing seeded, parameterized searches
- Validating requests
Further materials for connector development:
The workshop requires the following tools and technologies:
i2 Analyze 4.4.1: The server that hosts the i2 Connect gateway.
i2 Analyst's Notebook Premium 9.4.1: The client that provides the user interface for interacting with your connector. The client displays the resulting entity and link records with their properties.
i2 Analyze Schema Designer: The tool that enables you to design and create your i2 Analyze schema. During installation of Analyst's Notebook Premium, ensure that you also install Schema Designer.
Microsoft Visual Studio Code: The recommended IDE for developing your connector. You can use any IDE you like, but the Visual Studio Code Spring Boot Dashboard plugin can handle running and redeploying the connector for you. Download it here.
Postman: An API development tool that you can use to create and execute requests against REST endpoints. Download Postman here.
An application framework dependent on the language you are writing the connector with.
- Java (Spring Boot): The connector is written in Java with Spring Boot. Spring Boot is a Spring framework with an embedded Tomcat server that makes it easy to spin up a web application. No installation is required.
- Python (Flask): The Python connector is written and run on a Flask application. Flask is a micro web framework which requires no particular tools or libraries. No manual installation other than the specified setup instructions is required as the Pipfile contains it as a dependency.
To help you to understand some of the tools and technologies you will use, here are a few resources that contain more information about them:
- i2 Analyze data model examples
- Example requests and responses
- Using Postman
- Running the example connectors:
- Source identifiers
- Semantic type identifiers
- Source references
- SPI version negotiation
Schemas and schema types
The documentation for understanding and configuring connector schemas, gateway schemas, type locations, item type mappings, and item type security is divided into the following sections:
The example connectors used are:
SPI version information
New versions of the REST SPI are always released as part of new i2 Analyze releases. Documentation for the latest version of the SPI is available through the REST SPI link at the top of the page.
|SPI version 🡆
i2 Analyze version 🡇