FlowX.AI CMS

​

Key features

The FlowX.AI CMS offers the following features:

​

Deployment and integration

The CMS can be rapidly deployed on your chosen infrastructure, preloaded with necessary taxonomies or content via a REST interface, and integrated with the FlowX Engine using Kafka events.

For deployment and configuration, refer to the:

​

Using the CMS service

Once the CMS is deployed in your infrastructure, you can define and manage custom content types, such as lists with different values based on external systems, blog posts, and more.

​

Kafka integration

You can use Kafka to translate/extract content values based on your defined lanaguages and source systems.

​

Request content

Manage content retrieval messages between the CMS and the FlowX Engine using the following Kafka topics:

• KAFKA_TOPIC_REQUEST_CONTENT_IN: This variable defines the topic used by the CMS to listen for incoming content retrieval requests.
• KAFKA_TOPIC_REQUEST_CONTENT_OUT: This variable defines the topic where the CMS sends the results of content retrieval requests back to the FlowX Engine.

​

Example: Request a label by language or source system code

To translate custom codes into labels using the specified language or source system, use the following request format. For instance, when extracting values from a specific enumeration for a UI component:

For example when you want to use a UI component where you want to extract values from an specific enumeration.

​

Request content request

Add a Send Message Task (kafka send event) and configure it to send content requests to the FlowX.AI Engine.

The following values are expected in the request body of your Send Message Taks node:

• At least one of language and sourceSystem should be defined (if you only need the sourceSystem to be translated, you can leave language empty and vice versa, but they cannot both be empty)
• A list of entries and their codes to be translated

Expected Request Body:

{
  "language": "en",
  "sourceSystem": "FlowX",
  "entries": [
    {
      "codes": [
        "ROMANIA",
        "BAHAMAS"
      ],
      "contentDescription": {
        "name": "country", //the name of the enumeration we used in this example
        "version": 1, //optional, only if you want to extract from a specific version of your enumeration
        "draft": true //optional
      }
    }
  ]
}

​

Request content response

Add a Receive Message Task to handle the response from the CMS service. Configure it to listen to the topic where the Engine sends the response, e.g., we have the ai.flowx.updates.contents.values.v1 topic.

Response Message Structure:

{
  "entries": [
    {
      "contentName": "country",
      "code": "ROMANIA",
      "label": "Romania",
      "translatedCode": "ROMANIA-FlowX"
    },
    {
      "contentName": "country",
      "code": "BAHAMAS",
      "label": "Bahamas",
      "translatedCode": "BAHAMAS-FlowX"
    }
  ],
  "error": null
}

Next, we will change the system language and modify our process to display translations dinamycally on a another key on a separate screen.