[Feature Request]: Export UID of items, in Properties Tables in HTML Docs... and in Index page per item.

[Vasileios Pothos]

Hi.

Would it be possible to add in the "Export HTML Docs..." HTML generated data, for each item, along with it's name, also it's unique ID?

For example in the attached file, I would like to have in the exported Docs the following:

FC StartStop ID: AAAAAAGQt3bYo4Pkgf4=
start ID: AAAAAAGQt3boEYPoqg4=

stop ID: AAAAAAGQt3b/YoPx9+M=

For instance, see in the image below what I mean. I can see for this diagram in the properties it's name, but not it's unique UID ( AAAAAAGQt3bYo4Pkgf4= ) which for me it's very important - to identify this diagram (or component/model whatever).

I would like also to have that - in a way to also be searchable via the browser. Which also means in the "Index" it would be nice to have as shown below - the name of each component and the corresponding UID in parenthesis lets say, thus a search in the Index page would be sufficient to find the item by it's UID.:

The ID is crucial for me because I use it in source code comments via my plugin "Model Id : Copy and Select" when I documenting graphically code (it helps me a lot especially if you have to document and understand-learn unknown code). Also, with this UID I do references to different components in my designs, without having to add additional labels. If I need to show something to someone I know I propose him to download StarUML and my plugins and find i.e. the diagram with ie uid `AAAAAAGQt3bYo4Pkgf4=`.

To this end I use the StarUML file as the documentation, with direct references to the source code based on ie flow chart diagrams, and at the same time I can find and refer easily to each component by it's UID - using my plugin. But after the update of StarUML v6.2.0 I am thinking that, if anyone in the future needs to use these IDs for documentation purposes as I've described, without buying the StarUML for himself, it would be impossible.

These UIDs are part of the documentation, because they match items to code lines and used for references, even in the markdown documentation itself. To this end, given the latest update, I believe they should also be exportable to the HTML Docs, which seems now to be the only alternative for someone who wants to freely access the useful properties of the exported designs - which UID is also a part of them (their unique identifier).

So, would this be possible such an update to the HTML Docs... exporting utility?
For every item to also have it's UID available in it's parameters, and in the Index page (for reverse search via browser)... ?

Thanks.

[StarUML]

Hi,

We are very surprised that you are using the "_id" entry for external tracking - this is only guaranteed to be unique inside the .mdj file, and is likely to change at any time. This is not even exposed in the UI for normal users to use.

This is very dangerous and I hope you find another alternative like below:

1. Use path name (e.g. "Model1 > Package1 > Class1")
2. Adding a ID tag (Use Tag Editor)
3. Or requesting a new feature: Adding "id" (not "_id") property for all elements in order to support user-editable, human readable and external trackable identifier. (e.g. "CLASS0001", "UC0001", ...). Show this "id" in HTML docs.

Thanks,

2024년 7월 16일 화요일 오전 3시 25분 23초 UTC+9에 vasileio...@gmail.com님이 작성: