Rename XmlExtractor/RptToXml to XmlExtractor/Source, rewrite README

- Renamed inner folder from RptToXml/ to Source/ for clarity
- Rewrote XmlExtractor README with complete documentation:
  what it extracts, prerequisites, building, usage, output structure
- Updated main README and .gitignore with new paths
- MIT license and attribution preserved

Author: bit-nk

CrystalReport/.gitignore

@@ -40,13 +40,13 @@ _package/
 XML_Output/
 
 # XmlExtractor build artifacts and sample .rpt files
-XmlExtractor/RptToXml/bin/
-XmlExtractor/RptToXml/obj/
-XmlExtractor/RptToXml/packages/
-XmlExtractor/RptToXml/Samples/
+XmlExtractor/Source/bin/
+XmlExtractor/Source/obj/
+XmlExtractor/Source/packages/
+XmlExtractor/Source/Samples/
 XmlExtractor/.gitignore
-XmlExtractor/RptToXml/.editorconfig
-XmlExtractor/RptToXml/RptToXml.sln.DotSettings
+XmlExtractor/Source/.editorconfig
+XmlExtractor/Source/RptToXml.sln.DotSettings
 
 # AI assistants
 .claude/

CrystalReport/README.md

@@ -144,7 +144,7 @@ CrystalReport/                          <- Solution root
 
 1. **SAP Crystal Reports runtime** (64-bit) from [SAP](https://www.sap.com/cmp/td/sap-crystal-reports-visual-studio-trial.html)
 2. **Build the main solution**: Open `CrystalReport.slnx` in Visual Studio, build in Debug
-3. **Build XmlExtractor**: Open `XmlExtractor\RptToXml\RptToXml.sln` in Visual Studio, build in Debug
+3. **Build XmlExtractor**: Open `XmlExtractor\Source\RptToXml.sln` in Visual Studio, build in Debug
 4. Copy your `.rpt` files into `_source\_rpt_files_main\`
 5. Create `_source\config\datasources.yaml` (see [Config](#config-file) section)
 
@@ -209,7 +209,7 @@ All commands run from the `CrystalReport\` solution root.
 
 ### Step 1 -- XML Extraction
 ```bat
-XmlExtractor\RptToXml\bin\Debug\RptToXml.exe ^
+XmlExtractor\Source\bin\Debug\RptToXml.exe ^
   "_source\_rpt_files_main\ServiceContract.rpt" ^
   "Output\_cr_xml\ServiceContract.xml"
 ```

CrystalReport/XmlExtractor/README.md

@@ -1,40 +1,120 @@
-# RptToXml
+# Crystal Report XML Extractor
 
-Dumps a Crystal Reports RPT file to XML. Useful for diffs.
+Extracts the complete definition of Crystal Report (`.rpt`) files into structured XML, including report layout, formatting, data sources, SQL commands, formulas, parameters, and saved data.
 
-Binary releases available on the [Releases](https://github.com/ajryan/RptToXml/releases) page.
+This is Step 1 of the Crystal Report to Power BI migration pipeline. The extracted XML serves as the source of truth for all downstream conversion steps.
 
-Ported to C# from the [original VB project](http://code.google.com/p/rpttoxml/)
+Based on [RptToXml](https://github.com/ajryan/RptToXml) by Aidan Ryan (MIT License).
 
-## Running
+---
 
-Download the latest [release](https://github.com/ajryan/RptToXml/releases).
+## What It Extracts
 
-RptToXml references Crystal Reports assemblies. The easiest way to get them onto a development machine is to install the Crystal Reports Runtime from an MSI downloaded from [this page](https://www.sap.com/cmp/td/sap-crystal-reports-visual-studio-trial.html).
+| Data | Description |
+|---|---|
+| **Report Layout** | Sections (header, detail, footer), objects with exact positions (x, y, width, height) |
+| **Formatting** | Font (name, size, bold, italic, underline), text color, alignment, borders |
+| **Data Sources** | Database connections (server, database), SQL command text, table joins |
+| **Fields** | Database fields with type and length, formula field definitions |
+| **Formulas** | Full Crystal formula text (supports multilingual switch statements) |
+| **Parameters** | Report parameters with types and default values |
+| **Saved Data** | Cached report data exported as tab-separated values |
+| **Visual Elements** | Lines, boxes, images, subreports with positions and styles |
+| **Suppress Conditions** | Visibility rules and conditional formatting formulas |
 
-Install the SAP frameworks (probably need 32-bit and 64-bit):
+---
 
-- SAP Crystal Reports for Visual Studio (SP##) runtime engine for .NET framework MSI (32-bit)
-- SAP Crystal Reports for Visual Studio (SP##) runtime engine for .NET framework MSI (64-bit)
+## Prerequisites
 
-Run the executable from the command line with
+**SAP Crystal Reports Runtime** (64-bit) must be installed:
 
-```sh
-# process a single file
-RptToXml.exe path/to/report_name.rpt path/to/output.xml
+1. Go to https://origin.softwaredownloads.sap.com/public/site/index.html
+2. Search for: "SAP Crystal Reports, developer version"
+3. Download: **CR for Visual Studio SP39 CR Runtime 64-bit MSI** (117.1 MB)
+4. Run the MSI installer
 
-# process a directory of reports
-cd path/to/reports
-RptToXml.exe -r
+---
+
+## Building
+
+Open `Source\RptToXml.sln` in Visual Studio and build (Debug or Release).
+
+The executable is at `Source\bin\Debug\RptToXml.exe`.
+
+---
+
+## Usage
+
+**Single file:**
+```bat
+RptToXml.exe "path\to\report.rpt" "path\to\output.xml"
 ```
 
-## Building From Source
+**All files in a folder:**
+```bat
+cd path\to\rpt_folder
+RptToXml.exe -r --ignore-errors
+```
 
-The solution will build with VS2012 or higher. Express editions have not been tested but should work.
+**Options:**
+
+| Flag | Description |
+|---|---|
+| `-r` | Recursively process all .rpt files in the current directory |
+| `--ignore-errors` | Continue to the next file if an error occurs |
+| `--stdout` | Write XML to console instead of file |
+
+---
+
+## Output Structure
+
+```xml
+<Report Name="" FileName="report.rpt" HasSavedData="True">
+  <Summaryinfo ReportTitle="..." />
+  <PrintOptions PageContentWidth="..." PageContentHeight="..." PaperOrientation="..." />
+  <Database>
+    <TableLinks> ... </TableLinks>
+    <Tables>
+      <Table Alias="Header" ClassName="CrystalReports.CommandTable">
+        <ConnectionInfo QE_ServerDescription="." QE_DatabaseName="..." />
+        <Command>SELECT ... FROM ...</Command>
+        <Fields>
+          <Field Name="..." Type="..." Length="..." />
+        </Fields>
+      </Table>
+    </Tables>
+  </Database>
+  <DataDefinition>
+    <FormulaFieldDefinition Name="Title" ...>
+      switch({@X_Language} = 'EN', 'Service Contract', True, 'Default')
+    </FormulaFieldDefinition>
+    <ParameterFieldDefinition Name="DocKey" ValueType="NumberField" />
+  </DataDefinition>
+  <ReportDefinition>
+    <Areas>
+      <Area Kind="PageHeader">
+        <Section Height="2705" Kind="PageHeader" Name="PageHeaderSection1">
+          <ReportObjects>
+            <FieldObject Name="Title1" DataSource="{@Title}" Top="191" Left="0" Width="6313" Height="529">
+              <Font Name="Arial" Size="16" Bold="False" />
+              <ObjectFormat HorizontalAlignment="DefaultAlign" EnableSuppress="False" />
+            </FieldObject>
+          </ReportObjects>
+        </Section>
+      </Area>
+    </Areas>
+  </ReportDefinition>
+  <SavedData>
+    <Row Index="0"><Col Index="0">Service Contract</Col></Row>
+    <Row Index="1"><Col Index="0">Customer Name</Col><Col Index="1">:</Col><Col Index="2">Microchips</Col></Row>
+  </SavedData>
+</Report>
+```
 
-Install the SAP pacakge for Visual Studio:
+---
 
-- SAP Crystal Reports for Visual Studio (SP##) installation package for Microsoft Visual Studio IDE (VS 20## and above or below)
+## License
 
+MIT License. See [LICENSE](LICENSE) for details.
 
-Find the executable `RptToXml.exe` in ```RptToXml/bin/<where did you build to?>``` after building the solution in Visual Studio.
+Original work by [Aidan Ryan](https://github.com/ajryan/RptToXml). Modified for the Crystal Report to Power BI migration pipeline with saved data extraction and security hardening.