CSV

Overview of XMPro’s CSV Agents, including the Listener, Context Provider, and Action Agent. Learn how to simulate, provide, and export data using CSV files in Data Streams.

The CSV agents allow you to include data from CSV files in your data stream.

A comma-separated values (CSV) file is a delimited plain text file that uses a comma to separate values. Each row of the file is a data record. Each record consists of one or more fields, separated by commas. These files are often used for exchanging data between different applications.

The Listener allows you to return the contents of a CSV file one row at a time to simulate events in a data stream. You can configure whether the events loop or cease once the end of the file is reached.

The Context Provider allows you to read a CSV file and output the entire contents to the data stream for contextual data. All rows in the file are made available to the output endpoint as individual events when the data cache is refreshed during runtime.

The Action Agent allows you to write the events in a data stream to a CSV file. This is useful when testing a data stream or to send data to another system for processing. You can configure whether a new file is created daily and whether the contents are overwritten.

If the events passed to the Action Agent require further processing in the data stream, split the data stream beforehand with a Broadcast Transformation.

Pre-requisites

The CSV files used in these Agents must be accessible to Stream Host via File System.

Current Version

• Download the CSV Listener v3.52 (Last Updated: 22 Jan 2025)

• Download the CSV Context Provider v1.14 (Last Updated: 23 Jul 2025)

• Download the CSV Writer (Action Agent) v1.12 (Last Updated: 22 Jul 2025)

Please contact XMPro if you're looking for an older version of this Agent.

Listener Release Notes

Version	Date	Description
3.52	22 Jan 2025	Repackaged to translate the Agent's properties.
3.51	06 Sep 2022	Repackaged to include the Agent's Category.
3.50	14 Feb 2022	Added option to loop the records when the end of the file is reached Added option to output the current polling time.
3.40	29 May 2020	Renamed agent to CSV Simulator.
3.33	19 Oct 2018	Update help URL.
1.00	05 Mar 2018	Initial Release.

Context Provider Release Notes

Version	Date	Description
1.14	23 Jul 2025	Support ability to reload CSV file content each polling interval so it can change without stopping the data stream.
1.13	22 Jan 2025	Repackaged to translate the Agent's properties.
1.12	06 Sep 2022	Repackaged to include the Agent's Category.
1.11	02 Jun 2021	Added the option to upload a file instead of reading files on the Stream Host.
1.00	30 Mar 2020	Initial Release.

Action Agent Release Notes

Version	Date	Description
1.12	22 Jul 2025	Support a dynamic file name. Support output as a Base64-encoded string to the output payload.
1.02	22 Jan 2025	Repackaged to translate the Agent's properties.
1.01	06 Sep 2022	Repackaged to include the Agent's Category.
1.00	25 Mar 2020	Initial Release.