Skip to content

Commit e36d973

Browse files
linaaafdbreseman
andauthored
Add troubleshooting for Jackson core dependency issue and Oracle datatypes (#11297)
* Update agent-commons.md Small troubleshooting addition about Oracle datatypes * Add troubleshooting for missing Jackson Core dependency Added a troubleshooting section for missing Jackson Core dependency and provided resolution steps. * Document missing Jackson Core dependency issue Added information about missing Jackson Core dependency and resolution steps. * Document missing Jackson Core dependency issue Added information about missing Jackson Core dependency and resolution steps. * Document Jackson Core dependency issue and fix Added section on missing Jackson Core dependency and its resolution. * Update Mx GenAI Connector documentation with troubleshooting Added troubleshooting section for missing Jackson Core dependency and Gradle updates. * Document missing Jackson Core dependency issue Added information about missing Jackson Core dependency and its resolution. * Language edit --------- Co-authored-by: Dana Breseman <dana.breseman@mendix.com>
1 parent be3d610 commit e36d973

7 files changed

Lines changed: 56 additions & 0 deletions

File tree

content/en/docs/marketplace/genai/mendix-cloud-genai/Mx GenAI Connector.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -307,6 +307,15 @@ To check your JDK version and update it if necessary, follow these steps:
307307
2. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
308308
3. Rerun the project.
309309

310+
311+
### Missing Jackson Core Dependency
312+
313+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
314+
315+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
316+
317+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.
318+
310319
### Migrating From Add-on Module to App Module
311320

312321
Since the module has been changed with version 3.0.0 from an add-on to an app module, updating it via the marketplace will require a migration to ensure it works properly with your application.

content/en/docs/marketplace/genai/reference-guide/agent-commons.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -251,3 +251,7 @@ If you encounter an error stating that an attribute or a reference is required a
251251
### Conflicted Lib Error After Module Import
252252

253253
If you encounter an error caused by conflicting Java libraries, such as `java.lang.NoSuchMethodError: 'com.fasterxml.jackson.annotation.OptBoolean com.fasterxml.jackson.annotation.JsonProperty.isRequired()'`, try synchronizing all dependencies (**App** > **Synchronize dependencies**) and then restart your application.
254+
255+
### String Comparison Errors with Oracle Database
256+
257+
When using Oracle Database, Mendix maps unlimited string values (such as user prompt and system prompt attributes) to data types that may not support string comparisons (for example, in a rule). This can lead to errors. To fix the errors, edit the attribute types in the domain model and specify a string length.

content/en/docs/marketplace/genai/reference-guide/external-platforms/openai.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -319,6 +319,15 @@ To check your JDK version and update it if necessary, follow these steps:
319319
2. You may also need to update Gradle. To do this, go to **Edit** > **Preferences** > **Deployment** > **Gradle directory**. Click **Browse** and select the appropriate Gradle version from the Mendix folder. For Mendix 10.10 and above, use Gradle 8.5. For Mendix 10 versions below 10.10, use Gradle 7.6.3. Then save your settings by clicking **OK**.
320320
3. Rerun the project.
321321

322+
323+
### Missing Jackson Core Dependency
324+
325+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
326+
327+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
328+
329+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.
330+
322331
### Chat Completions with Vision and JSON Mode (Microsoft Foundry)
323332

324333
Microsoft Foundry does not support the use of JSON mode and function calling in combination with image (vision) input and will return a `400 - model error`. Make sure the optional input parameters `ResponseFormat` and `ToolCollection` are set to `empty` for all chat completion operations if you want to use vision with Microsoft Foundry.

content/en/docs/marketplace/genai/reference-guide/genai-commons.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1020,6 +1020,14 @@ This microflow creates a new [MetadataCollection](#metadatacollection-entity) an
10201020

10211021
This section lists possible solutions to known issues.
10221022

1023+
### Missing Jackson Core Dependency
1024+
1025+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
1026+
1027+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
1028+
1029+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.
1030+
10231031
### Outdated JDK Version Causing Errors while Calling a REST API {#outdated-jdk-version}
10241032

10251033
The Java Development Kit (JDK) is a framework needed by Mendix Studio Pro to deploy and run applications. For more information, see [Studio Pro System Requirements](/refguide/system-requirements/). Usually, the correct JDK version is installed during the installation of Studio Pro, but in some cases, it may be outdated. An outdated version can cause exceptions when calling REST-based services with large data volumes, like for example embeddings operations or chat completions with vision.

content/en/docs/marketplace/genai/reference-guide/mcp-modules/mcp-client.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,3 +94,12 @@ There are several possible reasons why the client cannot connect to your server.
9494
* The [GenAI Showcase App](https://marketplace.mendix.com/link/component/220475) provides an example on how to expose microflows as tools via the MCP Server module.
9595
* The official [MCP docs](https://modelcontextprotocol.io/introduction)
9696
* The [MCP Java SDK GitHub Repository](https://github.com/modelcontextprotocol/java-sdk)
97+
98+
99+
### Missing Jackson Core Dependency
100+
101+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
102+
103+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
104+
105+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.

content/en/docs/marketplace/genai/reference-guide/mcp-modules/mcp-server.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,3 +134,11 @@ If you encounter an error caused by conflicting Java libraries, such as `java.la
134134
* The official [MCP docs](https://modelcontextprotocol.io/introduction)
135135
* The [MCP Java SDK GitHub Repository](https://github.com/modelcontextprotocol/java-sdk)
136136
* A blog post on [How to use MCP to bring Mendix Business Logic into Claude for Desktop](https://www.mendix.com/blog/how-to-use-mcp-to-bring-mendix-business-logic-into-claude-for-desktop/)
137+
138+
### Missing Jackson Core Dependency
139+
140+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
141+
142+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
143+
144+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.

content/en/docs/marketplace/platform-supported-content/modules/aws/amazon-bedrock.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -882,3 +882,12 @@ If you encounter an error stating that an attribute or a reference is required a
882882
### Conflicted Lib Error After Module Import
883883

884884
If you encounter an error caused by conflicting Java libraries, such as `java.lang.NoSuchMethodError: 'com.fasterxml.jackson.annotation.OptBoolean com.fasterxml.jackson.annotation.JsonProperty.isRequired()'`, try synchronizing all dependencies (**App** > **Synchronize dependencies**) and then restart your application.
885+
886+
887+
### Missing Jackson Core Dependency
888+
889+
This applies to cases where your app fails to compile and throws the following error: `Missing dependencies: com.fasterxml.jackson.core:jackson-core:2.22.0`.
890+
891+
This dependency is advertised in Maven repositories but does not actually exist. When you build your app, the automated dependency management attempts to download it and fails because the version is unavailable.
892+
893+
To resolve this issue, download and install [GenAI Commons 6.2.2](https://marketplace.mendix.com/link/component/239448) from Mendix Marketplace. This module includes a fixed Jackson Core dependency configuration and will allow your app to compile successfully. Once Maven resolves the issue, dependency ranges will be used again to re-enable automated dependency management, including automatic vulnerability fixes.

0 commit comments

Comments
 (0)