JAVA SDK Integration

Learn about Innoslate's Advanced Functionalities: A Comprehensive Guide to JAVA SDK Integration with Innoslate Enterprise

Sections Available in SDK Integration

Function	Description
Required Libraries	Understand the required libraries needed to enable seamless Java SDK integration with Innoslate.
Generating Token	Learn the process of generating an authentication token through step-by-step explanation in order to gain a secure connection with Innoslate's API.
SDK Services	Learn about examples of how to utilize SDK services in Innoslate. There is a selection of sample code and scripts, to help understand the service.

Dive into JAVA SDK Integration within the Innoslate Enterprise ecosystem in this detailed guide. We'll embark on a journey through the required libraries, unveiling the process of generating authentication tokens, and explore the extensive functionalities of SDK services. This article will provide you with a solid foundation for leveraging JAVA SDK Integration to amplify your Innoslate utilization, boosting operational efficiency and productivity.

Required Libraries

To effectively utilize the Java SDK Integration with Innoslate Enterprise, two crucial elements must be added to your project: dependencies-repackaged.jar and innoslate-java-sdk.jar. These files are pivotal in furnishing the necessary libraries and functions that enable seamless interactions with the Innoslate software.

The dependencies-repackaged.jar serves as a comprehensive collection of libraries that your project may require, helping to avoid any missing dependency issues and ensuring smoother development. On the other hand, innoslate-java-sdk.jar is the heart of Innoslate's Java SDK, containing the core classes and methods you'll use to interact with Innoslate APIs.

These essential files can be easily obtained from the Support team. We recommend reaching out to ensure you receive the most up-to-date versions, allowing you to benefit from any new features, bug fixes, or improvements.

Generating Token

1. Within Innoslate, click the “User Account” drop-down menu, at the top right corner of your navigation bar, displayed as a green circle with your first initial. 

2. Click “My Profile”. 

3. This opens the “Edit Your Profile Information” menu. Look for the API Keys section,, provide the API key a name then click “Generate Authentication Key”.

 

5. The API key will generate the authentication token.

⚠️After leaving this view, the authentication token will be inaccessible, so ensure you copy it to a safe location.

6. Exit the view either by clicking the “Save”, “Cancel”, or ‘X’ at the top of the modal. Saving is only needed if any updates are made to the user profile. The authentication token does not require the save button to be clicked.

Gain Authorization:

There are two methods to gain access to Innoslate:

1. withAuthenticationKey - This allows you access to Innoslate 4 without exposing your password. The domain name and the auth token is all that is required. 

Enterprise Example:

Auth auth = AuthFactory.withAuthenticationKey("http://localhost:8080",
"cml0dGVyY2hyaXN8YWJj=VE6sPtlAREeu2cbNNehHe4CiQ3KVUXcunwIObZCszQ", null);

2. withUsernamePassword -This way allows you access to Innoslate 4 with your username and password.  The domain name, username, password is all that is required. Note: This method will not work on cloud.innoslate.com.

Enterprise Example:

Auth auth = AuthFactory.withUsernamePassword("http://localhost:8080", "johndoe1", 
"password", null);

SDK Services 

Database Service

Once you have your auth token you can now create your database service. This will allow the JAVA SDK to interact with Innoslate. To create your DatabaseService the Auth object and the name of the organization slug is required.

DatabaseService Example: 

DatabaseService ds = DatabaseServiceFactory.withOrganizationSlug(auth, "slug"); 

Project Service

Creating a new project example:

InnoProject project = ds.projects().create().setName("Project Name");

ds.projects().save(project);

Access existing project example:

InnoProject project = ds.projects().get(2);

Entity Service

Creating a new entity example:

InnoEntity entity = ds.entities().create(1).get(0).setProjectId(project.getId())
.setInnoClass("Action").setName("Action").setNumber("1.0");

ds.entities().save(Arrays.asList(entity));

Access existing entity example:

InnoEntity entity = ds.entities().get(5);

Searching for an entity example:

List<? extends InnoEntity> list = ds.entities().search("John", 1000, 0, 
project.getId());
InnoEntity entity = list.get(0);

 

To continue learning about Enterprise User Guides, Click Here.

(Next Article: MatLab Toolkit Integration)