Nexfield Systems Developer Tools & Digital Products

Data Guard 5-Minute First Workflow

This guide is for a first-time packaged-install user who wants to complete one full Data Guard workflow from opening the tool to reaching an import result.

If you have already confirmed the plugin is installed and visible in the Unreal Tools menu, this guide should take about five minutes.

What this walkthrough uses

This walkthrough uses the packaged example files that ship with the plugin:

  • Plugins/DataGuard/Resources/Examples/Example_ItemStats_Valid.csv
  • Plugins/DataGuard/Resources/Examples/Example_ItemStats_Schema.json
  • Plugins/DataGuard/Resources/Examples/Example_ItemStats_Overlay.json

It also uses the built-in example struct:

  • Example Item Stats Row

The best first full workflow is Struct-only.

Why this one first:

  • it is the shortest complete path
  • it proves the packaged plugin can open, validate, and continue into import
  • it confirms the bundled example struct and bundled example CSV are both usable

Step-by-step walkthrough

1. Open Data Guard

  1. Open Tools.
  2. Open Data Guard.
  3. Confirm Validation Setup appears.

Expected result:

  • you see the three validation modes:
    • Struct-only
    • JSON Schema
    • Struct + JSON Rules

2. Start the Struct-only flow

  1. Click Struct-only.
  2. In Choose Struct, select Example Item Stats Row.
  3. Continue to the CSV step.

3. Choose the packaged example CSV

Browse to:

  • Plugins/DataGuard/Resources/Examples/Example_ItemStats_Valid.csv

Expected result:

  • Validation Summary opens
  • Overall status: Passed
  • Import readiness: Passed
  • Issue Summary: None

4. Continue into import

  1. Continue from the passed Validation Summary.
  2. Follow the normal import steps.

Expected result:

  • you reach Import Summary
  • the summary reports imported rows
  • the wording says the import completed for the rows validated as ready

Two optional follow-up checks

JSON Schema

Use:

  • CSV: Plugins/DataGuard/Resources/Examples/Example_ItemStats_Valid.csv
  • schema JSON: Plugins/DataGuard/Resources/Examples/Example_ItemStats_Schema.json

Expected result:

  • Schema Validation Summary
  • Overall status: Passed

Struct + JSON Rules

Use:

  • struct: Example Item Stats Row
  • CSV: Plugins/DataGuard/Resources/Examples/Example_ItemStats_Valid.csv
  • overlay JSON: Plugins/DataGuard/Resources/Examples/Example_ItemStats_Overlay.json

Expected result:

  • Validation Summary
  • Overall status: Passed