Skip to content

Commit cac8c08

Browse files
committed
Distribution Files for v10.3.0 Release
1 parent 74359a4 commit cac8c08

97 files changed

Lines changed: 19295 additions & 792 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

dist/Relationship Visualizer.zip

24 MB
Binary file not shown.

dist/Relationship Visualizer/ExcelToGraphviz.applescript

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
-- This file must reside in ~/Library/Application Scripts/com.microsoft.Excel/
2+
13
on runDot(dotParameters)
24
set dot_output to do shell script "/usr/local/bin/dot " & dotParameters & " 2>&1"
35
return dot_output
@@ -108,4 +110,4 @@ on pickColor(defaultRGB)
108110
set AppleScript's text item delimiters to oldDelimiters
109111
return ""
110112
end try
111-
end pickColor
113+
end pickColor

dist/Relationship Visualizer/README.txt

Lines changed: 23 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -2,63 +2,53 @@ Excel to Graphviz Relationship Visualizer
22
-----------------------------------------
33

44
INTRODUCTION
5+
------------
6+
The Relationship Visualizer lets you easily collect relationship information in Excel and quickly generate relationship graphs.
57

6-
The Relationship Visualizer lets you easily collect relationship information in Excel and quickly create relationship graphs.
8+
It automatically draws diagrams from high‑level instructions, handling details like shape placement and connecting lines. While it offers many customization options, it isn't designed for precise, pixel‑perfect control. If you need exact placement or prefer freehand drawing, this tool may not be the right fit.
79

8-
It automatically draws relationship diagrams from high-level instructions, handling details like shape placement and connecting lines. While it offers many customization options, it’s not designed for precise, pixel-perfect control. If you need exact placement or like to draw freehand, this tool might not be suitable for you.
10+
It's ideal for anyone who wants fast visualizations with minimal effort and doesn't need fine‑grained layout control. Simply provide statements like "A is related to B," and the Relationship Visualizer will produce a complete graphical representation of your data.
911

10-
This tool is perfect for those who want quick visualizations with minimal effort and aren't concerned with detailed placement. Just provide simple 'A is related to B' statements, and the Relationship Visualizer will generate a comprehensive graphical depiction of the data.
1112

1213

1314
INSTALLATION
15+
------------
16+
The documentation at https://exceltographviz.com/install/ provides everything you need to set up and use the Relationship Visualizer.
1417

15-
The documentation at https://exceltographviz.com/install/ provides all the information you need to set up and use the Relationship Visualizer.
18+
Please note that the required open‑source Graphviz tools are not included with this package. The online documentation explains how to download and install them separately.
1619

17-
Please note that the co-requisite Open Source Graphviz tools are not included in this package. The online documentation provides detailed instructions on how to obtain and install them separately.
1820

1921

2022
GETTING STARTED
23+
---------------
24+
Take the time to work through the guides at https://exceltographviz.com/ to get the most out of the Relationship Visualizer. Much of the underlying graphic‑processing complexity is already configured for you, so creating a graph can be as simple as entering a few lists and clicking a button. If you choose to explore the full feature set, you’ll be able to produce far more intricate and expressive diagrams. Once you get comfortable with the workflow, the entire process becomes straightforward, enjoyable, and genuinely rewarding.
2125

22-
Take the time to carefully follow the guides at https://exceltographviz.com/ and master the tool for the best results. Much of the graphic processing complexity is pre-configured and hidden, so creating a graph can be as easy as entering lists and pressing a button. However, exploring the full capabilities allows you to craft intricate and impressive graphs. Once you get the hang of it, the process becomes straightforward, enjoyable, and rewarding!
2326

2427

25-
MICROSOFT WINDOWS SOFTWARE REQUIREMENTS
2628

27-
* Microsoft Excel
28-
- Microsoft 365: Version 16.91.1 -or-
29-
- Office 2024: Version 16.91.1 -or-
30-
- Office 2021: Version 16.53 -or-
31-
- Office 2019: Version 16.0 -or-
32-
- Office 2016: Version 16.0
33-
* Operating System
34-
- Windows 10 -or-
35-
- Windows 11 -or-
36-
- Windows Server 2022
37-
* Graphviz
38-
- Version 11.0.0 (20240428.1522) or higher
29+
MINIMUM SUPPORTED CONFIGURATIONS
30+
--------------------------------
3931

40-
macOS SOFTWARE REQUIREMENTS
32+
Windows:
33+
- Excel for Microsoft 365, Excel LTSC 2024, or Excel LTSC 2021
34+
- Windows 10, Windows 11, or Windows Server 2022
35+
- Graphviz 14.1.1 (20251213.1925) or higher
36+
37+
macOS:
38+
- Excel for Microsoft 365 for Mac, Excel LTSC 2024 for Mac, or Excel LTSC 2021 for Mac
39+
- macOS Ventura, Sonoma, or Sequoia
40+
- Graphviz 14.1.1 (20251213.1925) or higher
4141

42-
* Microsoft Excel
43-
- Microsoft 365 for Mac: Version 16.91.1 (24111613) as of November 19, 2024.
44-
- Office 2024 for Mac: Version 16.91.1 (24111613) as of November 19, 2024.
45-
- Office 2021 for Mac: Version 16.53 (released in 2021)
46-
* Operating System
47-
- macOS Sequoia -or-
48-
- macOS Sonoma -or-
49-
- macOS Ventura
50-
* Graphviz
51-
- Version 11.0.0 (20240428.1522) or higher
5242

5343

5444
LICENSE
45+
-------
5546

5647
MIT License
5748

58-
Copyright (c) 2015-2024 Jeffrey Long
49+
Copyright (c) 2015-2026 Jeffrey Long
5950

60-
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
61-
furnished to do so, subject to the following conditions:
51+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6252

6353
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6454

-257 KB
Binary file not shown.

dist/Relationship Visualizer/changelog.md

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,105 @@
11
# Change Log
22

3+
## Version 10.3.0
4+
5+
This release continues to expand the **SQL capabilities** of the Relationship Visualizer.
6+
7+
**Enhancements**
8+
9+
The Relationship Visualizer received the following improvements:
10+
11+
- **Added support for “n” levels of clusters** – Previously, automatic clustering was limited to two levels via the `CLUSTER` and `SUBCLUSTER` column names. SQL clustering now supports an open‑ended number of levels by using integer‑suffixed field names. [(#13, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/13)
12+
13+
For example:
14+
15+
`SELECT [continent] AS [CLUSTER1], [country] AS [CLUSTER2], [state] AS [CLUSTER3], [county] AS [CLUSTER5], [city] AS [CLUSTER6] ...`
16+
17+
Each level supports its own label, tooltip, style name, and attributes (e.g., `[CLUSTER1 LABEL]`, `[CLUSTER1 STYLE NAME]`, `[CLUSTER1 ATTRIBUTES]`, `[CLUSTER1 TOOLTIP]`).
18+
19+
- **Added `{label}` placeholder in cluster labels** – Introduced a `{label}` substitution token for cluster labels. This update allows HTML‑like formatting strings to be stored in the saved style format, enabling enhancements such as embedding an image next to the label value. When the graph is rendered, the label value from the `data` worksheet replaces the `{label}` placeholder.
20+
[(#14, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/14)
21+
22+
- **Revised format‑string parsing** – Updated the logic that interprets saved style formats to correctly recognize HTML‑like syntax and pass it through to the Style Designer when the **Edit Style** button is used. [(#15, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/15)
23+
24+
- **Revised refresh‑all‑previews behavior** – Removed the progress‑bar dialog displayed when refreshing all style previews. Percent‑complete progress is now shown in the status bar. [(#16, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/16)
25+
26+
## Version 10.2.0
27+
28+
This small release focuses primarily on expanding the **SQL capabilities** of the Relationship Visualizer.
29+
30+
### Enhancements
31+
32+
The Relationship Visualizer received the following improvements:
33+
34+
- **Added SQL placeholder substitution** – SQL extensions now support `SET PLACEHOLDER name = value` definitions and expand `{name}` tokens in statements before execution, enabling template‑style SQL for parameter‑driven queries.
35+
- **Added filename sanitization** – Introduced a routine that replaces invalid characters in filenames to prevent file write errors.
36+
37+
## Version 10.1.0
38+
39+
This release focuses primarily on expanding the **SQL capabilities** of the Relationship Visualizer.
40+
41+
### Enhancements
42+
43+
The Relationship Visualizer received the following improvements:
44+
45+
- **Concatenation Mode for Iterative SQL Queries** - Combine multiple detail records into a single string per header row (e.g. list of songs under an album, list of countries per continent, etc.).
46+
47+
- **Floating Action Buttons** - Context-sensitive floating icons now appear next to selected cells in supported columns. Each button triggers a specific action:
48+
- *'sql' Worksheet*
49+
- `` Edit this SQL statement
50+
- `` Run this SQL statement
51+
- `` View query status using a dialog
52+
- *'styles' Worksheet*
53+
- `` Edit this style in the Style Designer
54+
- `` Refresh this style's preview image
55+
56+
Buttons auto-appear/disappear on selection, respect sheet protection, and support per-button validation (e.g. SQL only shows "Run" when SQL row is active and begins with `SELECT`).
57+
58+
- **Image Zoom Dropdown List** - Restored the Image Zoom dropdown list which was removed in the V9.0 UI refresh. The v9.0 Zoom In (+) and Zoom Out (-) buttons, and the 5% increments from 5%-150% have been retained.
59+
60+
## Version 10.0.0
61+
62+
This release focuses primarily on expanding and strengthening the **SQL capabilities** of the Relationship Visualizer.
63+
64+
### Enhancements
65+
66+
The Relationship Visualizer received the following improvements:
67+
68+
- Added support for using **Microsoft Access** (`.accdb` / `.mdb`) files as SQL data sources. [(#5, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/5)
69+
- Added SQL **enumeration** support for generating range‑based result sets (e.g. `from x to y by z`). [(#6, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/6)
70+
- Added SQL **iterative query‑set** execution with dynamic placeholder substitution. It allows a result from one query to be used as a parameter in a second query. [(#7, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/7)
71+
- Added SQL **error logging** to capture query failures in an external log file. [(#9, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/9)
72+
- Improved usability by abbreviating long file‑system paths in the `SQL` and `Graphviz` ribbon tabs. [(#10, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/10)
73+
- Implemented a comprehensive set of **ADO SQL hardening changes**, improving reliability, determinism, and fault‑tolerance across the entire execution pipeline. [(#11, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/11)
74+
- Expanded the SQL log‑to‑file feature to include **environment documentation**, improving diagnostics and reproducibility. [(#12, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/12)
75+
76+
### Defect Fixes
77+
78+
The following defects were corrected:
79+
80+
- Addressed an intermittent SQL execution failure caused by underlying COM/Automation instability in VBA. [(#4, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/4)
81+
- **Breaking change**: SQL query clustering previously grouped results by **CLUSTER LABEL** instead of **CLUSTER**, and failed when cluster labels were null. [(#8, closed)](https://github.com/jjlong150/ExcelToGraphviz/issues/8)
82+
83+
The fix correctly groups by **CLUSTER**, but this correction is **not backward‑compatible** and may alter the structure of existing graphs that relied on the prior (incorrect) behavior. You will have to modify cluster-oriented SQL statements if you use this feature.
84+
85+
## Version 9.1.0
86+
87+
### Font Name Improvements
88+
89+
Revised the logic used to build the font list in the **Style Designer**.
90+
91+
- Expanded the available font choices by removing the earlier prefix/suffix‑based screening logic that filtered out fonts.
92+
- Added an **excluded fonts** list on the `lists` worksheet. Testing shows these fonts fall back to a default font in Graphviz, so they are filtered out of the available font list.
93+
- Cross‑checked the retrieved font list against the excluded‑fonts list to produce a clean set of fonts that Graphviz can reliably render.
94+
- Added logic to **remove duplicates** and **alphabetize** the final font list.
95+
96+
Restructured the Windows and macOS code paths so both platforms now share the same filtering, deduplication, and sorting pipeline.
97+
- macOS still relies on the font list stored in the `lists` worksheet, but the code is now structured to allow a native macOS font‑enumeration solution to be added cleanly when available.
98+
99+
Updated the **Style Designer** ribbon tab to use a two‑image preview approach.
100+
- The ribbon continues to display the legacy (backward‑compatible) `A` icon beside the font name.
101+
- The font gallery now shows a wider 14pt preview image using the characters `Aa Bb Cc` to provide a clearer representation of each font.
102+
3103
## Version 9.0.0
4104

5105
### UI Visual Refresh

dist/Relationship Visualizer/samples/01 - Basic Examples/Assorted Graphs.xlsm renamed to dist/Relationship Visualizer/samples/01 - Basic Examples/Relationship Visualizer.xlsm

3.55 MB
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)