Installing the Tools
Before you start
You need to install the following software to use Utilihive SDK and its Domain-Specific Language (DSL):
-
The Java Development Kit (JDK) installer from Amazon Corretto automatically sets the necessary Java path variables. If you prefer using the CLI, install the Java 17 JDK using the Software Development Kit Manager (SDKMAN).
Utilihive SDK version 10.x and earlier requires Java 11. If you are upgrading Utilihive SDK from an older version, install Java 17, and update your IntelliJ project to use it. In this case, it is recommended to uninstall Java 11.
To view the JDK version, run the following command in the terminal:
java -version
Your default
java
command must use version 17. If it does not, set Java 17 as the default or uninstall other Java versions from your machine. -
The IntelliJ code editor comes with built-in support for Kotlin and is the easiest way to work with the Utilihive SDK. The free IntelliJ Community Edition is sufficient for developing GridOS Connect integration flows.
Both the Community Edition and Ultimate Linux bundle have the Install-Linux-tar.txt
file. Linux users should read this file to learn how to start IntelliJ after downloading it. To install or upgrade IntelliJ, visit the IntelliJ download page. -
It is recommended to start with an example project, which is downloaded as a Git repository.
On Windows and macOS, install Git through IntelliJ during project setup.
Configure the SDK
The Utilihive SDK is installed as a project dependency using Maven. Only licensed users can access and use the SDK. If you need help with your license, contact Utilihive Support.
To configure Maven, you must have access to the GE Vernova Artifactory.
GE Vernova Artifactory Access
Contact your GE Vernova Support representative for more information on how to get access to GE Vernova Artifactory.
Generate an Artifactory token:
-
Go to: https://dig-grid-artifactory.apps.ge.com/ui/user_profile
-
Once logged in, click on Generate an Identity Token. The description should help you remember its purpose, e.g:
GridOS Connect Token
. -
Click Next. The generated token is used as your password credential, with your SSO as the username.
Configure Maven
You can use the standalone Maven installer or the version embedded in IntelliJ. The next step is to configure Maven to use your licensed credentials.
Create a settings.xml
file in the $HOME/.m2
directory.
On Windows, this would be: C:\Users\<username>\.m2
.
If the
|
Add the following to settings.xml
:
Replace the <username>
and <password>
values with your Artifactory credentials.
If you already have a settings.xml file, add the gev-artifactory <server> element to the existing list of servers.
|
Set up the project
Use the example project
To use the Utilihive SDK, it is recommended to start with the official example project. It comes preconfigured with dependencies, tests, and sample configurations. Clone the project from the following GitHub URL:
https://github.com/utilihive/flow-developer-example-project-mvn.git
Open IntelliJ, go to
, enter the GitHub URL, and select Clone.
Once you have cloned the project, open in IntelliJ and verify that it is using the correct JDK. Go to
, then under , select , and select OK.
It may take a few minutes for IntelliJ to download the project’s dependencies.
On Windows, IntelliJ might show a warning about Defender slowing things down. If this occurs, select Exclude directories to avoid unnecessary virus scans on your project and IDE folders. Apply similar exclusions for other antivirus programs and operating systems. |
Configure the repository in pom.xml
Make sure the server ID in your settings.xml
file matches the repository entry in the pom.xml
file of the example project.
<repositories>
<repository>
<id>gev-artifactory</id>
<url>https://dig-grid-artifactory.apps.ge.com/artifactory/gridos-connect-sdk/</url>
</repository>
</repositories>
Kotlin 2.1
The current versions of the Flow Developer SDK depend on Kotlin 2.1.
When installing or updating the SDK, flow developers must complete the following steps in IntelliJ to ensure the correct Kotlin language level is used.
-
Set the Kotlin dependency version to
2.1.x
, where x is the latest patch version of the Kotlin runtime. -
Refresh the Maven project in IntelliJ.
-
Enable the K2 compiler in the IntelliJ Kotlin settings. To do this, select Settings on the right navigation bar, then choose
, and turn on Enable K2 mode. -
Verify the Kotlin compiler settings are set to 2.1.
-
Ensure the Kotlin module settings in your project are either delegating to the project settings, or explicitly set to Kotlin language level 2.1.
Set up the project manually
If you start from an empty IntelliJ project, add the required dependencies to your pom.xml
file, including the Utilihive SDK.
Use the example project’s pom.xml
as a reference.
Download source files
Whether you are using the example project or your own, it is recommended that you download the Maven sources for the SDK dependencies.
This enables IntelliJ to display contextual documentation when you hover over processor properties.
For example, the following image shows documentation for an id
property:

To enable this feature in IntelliJ:
-
On Windows or Linux, select
. On macOS, select . -
Go to
. -
In the Automatically download section, make sure the Sources option is selected.
-
If you do not want Maven sources to download automatically or if automatic download does not work, you can manually trigger the download. Open Maven tool window on the right and select
.
JSONiq language support IntelliJ plugin
Utilihive data mapping is done using the JSONiq query language. We provide a plugin for IntelliJ that supports syntax highlighting for both JSONiq files and inline JSONiq code.
You can request the installation file from Utilihive Support. The plugin is provided as a ZIP file.
Once the ZIP file is downloaded, to install:
-
Go to
. -
In the tabs section, click the three stacked dots (or the cog wheel icon in newer versions of IntelliJ), select Install Plugin from Disk, and select the ZIP file.
-
Restart IntelliJ to apply the changes.
Usage
In JSONiq files (.jq
or .jqy
file extensions), syntax highlighting is enabled by default. Use the language annotation provided by IntelliJ to highlight the inline code. The following syntax displays inline code:
@Language("JSONiq")
val mapper = """
Your JSONiq code here
""".trimIndent()
// If the @Language annotation is not available, use the following syntax:
//language=JSONiq
val mapper = """
Your JSONiq code here
""".trimIndent()
For more information on language support for IntelliJ, see IntelliJ Language Injection.
Next steps
Now, you have set up a project, see flow tutorials for the next steps.