Skip to main content
Version: 4.3

External Converters

CMDBuild supports integration with external conversion services for processing CAD and BIM files.

The platform delegates file conversion operations to external web services that expose a compatible REST API. These services receive source files, perform the required conversion, and return the converted output to CMDBuild for further processing.

Currently, the following converter services are supported:

  • dwg2dxf: conversion service for CAD files.
  • ifc2xkt: conversion service for BIM models.

How It Works​

CMDBuild does not perform file conversion directly.

When a user imports a supported file:

  1. CMDBuild sends the file to the configured converter service.
  2. The converter service processes the file.
  3. The converted output is returned to CMDBuild.
  4. CMDBuild imports the resulting data and makes it available within the application.

Communication between CMDBuild and the converter services is performed through REST APIs secured with authentication credentials configured on both sides.

CMDBuild Configuration​

CMDBuild must be configured with the endpoint URL and the credentials required to access the converter services.

dwg2dxf​

org.cmdbuild.gis.dwg2dxf.url
org.cmdbuild.gis.dwg2dxf.username
org.cmdbuild.gis.dwg2dxf.password

ifc2xkt​

org.cmdbuild.bim.ifc2xkt.url
org.cmdbuild.bim.ifc2xkt.username
org.cmdbuild.bim.ifc2xkt.password

REST API​

Converter services expose a REST interface used by CMDBuild.

Authentication​

API requests are authenticated using the credentials configured in both CMDBuild and the converter service.

Status Endpoint​

Used by CMDBuild to verify service availability.

dwg2dxf​

GET /dwg2dxf/api/v1/status

ifc2xkt​

GET /ifc2xkt/api/v1/status

Conversion Endpoint​

Used by CMDBuild to submit files for conversion.

dwg2dxf​

POST /dwg2dxf/api/v1/convert

Request:

  • multipart/form-data
  • uploaded file

ifc2xkt​

POST /ifc2xkt/api/v1/convert

Request:

  • multipart/form-data
  • uploaded file

Expected Behavior​

A converter service should:

  • accept an uploaded source file;
  • perform the requested conversion;
  • return the converted result to the caller;
  • return a suitable error response if the conversion cannot be completed.

CMDBuild relies exclusively on these REST endpoints and is independent of the specific conversion technology used internally by the service.