Test Data Section Documentation

This section focuses on the Test Data Generator, a tool designed to create multiple test data files based on a template structure (XML or JSON) and configurable generation rules.

Core Workflow

1. Select Template: Choose a loaded file (from the "Files" section) to use as the structural template for generation.
2. Configure Fields: Define how data should be generated for each field within the template structure.
3. (Optional) Save Configuration: Save the current field configurations for later reuse.
4. Set Generation Options: Specify the number of files to generate and optionally choose a source ZIP template.
5. Generate: Create the test files based on the template and configurations.

Features

1. Template Selection

• Select Template File: A dropdown list populated with the currently loaded files (XML/JSON). The selected file's structure is displayed in the "Template Configuration" area.
  • Defaults to the first loaded file if available.

2. Template Configuration

This interactive tree displays the structure of the selected template file and allows configuration of data generation for each field.

• Tree Display: Shows the hierarchical structure of the template.

• Expand/Collapse:

  • Nodes can be expanded/collapsed individually using arrow icons.
  • Expand All / Collapse All buttons control the entire tree's expansion state.

• Field Configuration: For each field (leaf node) in the tree:

  • Behavior Selection: A dropdown menu allows choosing the generation behavior for the field's value.
  • Settings Icon (Gear icon): Opens the field configuration dialog to configure detailed options specific to the selected behavior.
  • Value Preview: Displays the original value from the template alongside a preview/example of the value that would be generated based on the current configuration.
  • Copy Value: Clicking the preview value copies it to the clipboard.
  • Tooltips: Hovering over the preview value shows a tooltip explaining the configuration and providing an example.

Field Generation Behaviors

• Keep Original: (Default) Uses the exact value found in the template file.

• Auto Increment (Enumerate): Generates sequential numeric values. Can often detect numbers within strings (e.g., ID-001 -> ID-002).

  • Options: Starting value (can use template value), increment amount.

• Generate UUID: Creates unique identifiers.

  • Options: Uppercase/lowercase, prefix, suffix.

• From List: Selects values sequentially or randomly from a predefined list (managed via the "Manage Lists" dialog).

  • Options: Select list, selection mode (sequential, random).

• Generate Date: Creates date/datetime values.

  • Options: Mode (Increment Day/Time, Today +/- Days, Fixed Date, Random Date), base date, date format, include time.

• Generate Number: Generates random numbers.

  • Options: Type (Integer, Decimal), min/max values, precision (for decimals).

• Reference Value: Copies the generated value from another field within the same generated file.

  • Options: Specify the source field, optional simple transformation.

• Custom Script (Advanced): Uses custom code to generate a value.

  • Options: Provide code snippet.

3. Configuration Management

• Saved Configurations Dropdown: Lists previously saved configuration sets for the currently selected template file type.

  • Selecting a saved configuration applies its rules to the "Template Configuration" tree.

• Save Button (Save icon): Opens a dialog to name and save the current set of field configurations associated with the template.

  • Saved configurations are stored locally in your browser.

4. List Management

• Manage Lists Button (List icon): Opens the List Manager dialog.
  • Allows users to create, view, edit, and delete reusable lists of text values.
  • Lists can be imported/exported.
  • These lists are used by the "From List" field behavior.

5. File Generation Options

• Number of Files to Generate: A numeric input field to specify how many distinct output files should be created.

• Template Source (Optional ZIP): A dropdown to select a loaded ZIP file.

  • If a ZIP is selected, the generator might use the file structure within the ZIP as a base, potentially replacing or merging generated data into copies of the files found inside.
  • If None is selected, generation is based purely on the primary selected template file.

• Generate Test Files Button: Starts the file generation process.

  • A progress bar indicates the status.
  • Generated files are added to the application's file list (visible in the "Files" section).