Learn about file sample system
Zparse provides a robust system for managing data mappings, including the ability to attach sample files to a specific mapping version. This allows you to create and test a new mapping version with sanitized sample before it goes live. This ensures the new mapping is fully validated and ready for production, providing a seamless transition with no disruption to the existing workflow.
When is it useful ?
Collaborating on data mapping can be challenging, as it's often difficult to ensure every team member is using the same relevant and representative sample files.
This becomes especially complex when you need to test not only for valid data, but also for specific invalid data that your pipeline must be able to handle gracefully. Furthermore, it's not unusual to receive additional samples with new edge cases throughout a mapping's lifecycle, and our system makes it easy to add these to your testing suite for robust, continuous validation.
Zparse simplifies this by allowing you to attach and manage sample files directly to each mapping version, ensuring all collaborators are working with the same data for consistent, reliable testing.
Good sample should cover as much case as possible, empty values, invalid values, edge case on date format...
How to simplify your life using sample system
As soon as you have added a reader in your mapping you can start uploading your sample:
Click on Run mapping
Now drop a sample file, and click on Save your file as a sample to reuse it later
You can rename the file to be more user friendly if needed. Also you can select a Folder where it will be saved in the filestore (pro-tip: create a dedicated folder for each mapping).
Than click on Run mapping this will upload the sample and run the mapping against it :)
After a mapping is updated, you can instantly access your sample files by re-opening the menu. Use the play button to run your updated mapping directly from there, eliminating the need to re-upload files or search for them elsewhere.
Also after running it, it is automatically loaded into quick access so you can replay it directly without re-opening the menu.
Running your sample files frequently while you're mapping is highly recommended. It's an excellent way to constantly confirm that your mapping is behaving exactly as you expect.