Skip to main content

0 questions
18 posts

Do you have questions about Troubleshooting?

Log in to ask questions about Troubleshooting publicly or anonymously.

David JonesSemarchy Team
Sr. Customer Success Consultant at Semarchy

Filtering Business Views based on User Roles

This article details the steps necessary to filter an application in Semarchy xDM based on the roles of the connected user. While the core components of this solution can be applied to multiple scenarios, this article focuses on filtering Business Views.

The provided example uses the CustomerB2C demo application: the objective is to filter products depending on their origin and the regional roles (e.g "Data Steward USA", "Data Steward Asia"...) owned by the connected user.

Solution overview

This solution is based on:

  • The USER_ROLES built-in SemQL variable: this variable provides the list of roles of the connected user
  • The... (More)
David JonesSemarchy Team
Sr. Customer Success Consultant at Semarchy

The first and best tool to start with is the existing documentation.

Native Resources

Leveraging the existing Semarchy documentation within your API-related project will help create a solid foundation for understanding the available tools, architecture, and implementation patterns. Refer to our official documentation for the most accurate details on using Semarchy REST API's.

1. Semarchy xDM Integration Guide26 contains thorough documentation on our REST client, including an Overview section as well as complete examples.

2.Semarchy xDM Administration Guide28 contains extensive details on Managing REST Clients.

3. Within the application, select REST API to access in-application resources, the Documentation... (More)

Fathia JamaSemarchy Team
Sr. Customer Success Consultant at Semarchy

Here are the minimum hardware requirements to run Semarchy. Depending on the volume of records processed by the application you may need to increase these values to improve your performance.

Application Server

Maximum Memory -Xmx value must be at least 4 GB (on Tomcat).
The OS should have at least 8 GB of RAM.
Database Server
Server Requirements
CPU: 4 CPUs minimum. Plan for more CPUs when using database parallelism
Memory: 16 GB
Database Requirements
Oracle: Minimum size of the SGA: 8 GB or above, depending on number of records.
PostgreSQL: Minimum size of the Cache: 8 GB or above,... (More)

David JonesSemarchy Team
Sr. Customer Success Consultant at Semarchy

Excel export fails due to missing libraries (Linux OS) - How to fix?

Context: Scenario is likely to occur in Linux environments *with no UI, attempting to export to an Excel file from an xDM collection results in an error vs successful export. Reviewing the error log, users may encounter errors similar to the one below, indicating an issue initializing specific classes.

Description of Error (Stack Trace/PDE Log)

java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11FontManager

at java.base/java.lang.Class.forName0(Native Method)

at java.base/java.lang.Class.forName(

at java.desktop/sun.font.FontManagerFactory$

at java.base/ Method)



at java.desktop/java.awt.Font.getFont2D(

at java.desktop/java.awt.Font.canDisplayUpTo(

at java.desktop/java.awt.font.TextLayout.singleFont(

at java.desktop/java.awt.font.TextLayout.<init>(


The root cause of this issue is commonly found to be missing libraries, creating a scenario where... (More)