Overview
Customer management plugin uses a search engine (for example, Elasticsearch engine) to retrieve user details using partial match on big databases.
The plugin listens for incoming requests on a Kafka topic and sends the reply to the Engine on an outgoing topic.
Kafka topics for Customer Management
Kafka topics for customer management
Customer Search
The kafka topics used for the Customer Management plugin can be defined/overwritten using the following environment variables (that can be found in the deployment of the service):
KAFKA_TOPIC_CUSTOMER_SEARCH_IN
- used to search customers in the customer management pluginKAFKA_TOPIC_CUSTOMER_SEARCH_OUT
- used to get the response from the customer management plugin to the Engine.
The request sent to the plugin can use any key that was previously configured in the Elasticsearch index where the customers are saved.
Example of an Elasticsearch index:
With this index configuration we can search for customers using any key:
Key examples
Example 1 - using only the “ClientUniqueIdentifier” key:
Example 2 - using “FirstName” and “LastName” keys:
Example 3 - using “FirstName”, “DateOfBirth” and “LegalForm” keys:
Keys description
- customers - list of customers found in the customer management, in the used Elasticsearch index, maximum 10 results
- hasMore - boolean, true if number of results are bigger than 10, false if the number of results are equal or smaller than 10
- error - error description if the request returned an error
Topic name example:
Sent body example:
Was this page helpful?