topic Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions in Archicad C++ API

AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

BerndSchwarzenbacher — Wed, 18 Sep 2024 13:41:12 GMT

Hi all,

I’m aware that Built-In Properties are no longer accessible through the Archicad SDK.
Unfortunately, this means that making an Add-On compatible with all language version is now drastically more difficult!
Previously for example the property “ElementID” was available in the Property Group “GeneralElemProperties” and to my knowledge this was the same across all Archicad language versions. If we want to change or access this property now, we have to know it’s name and group name for all languages. I wasn't able to find a list for such translations yet. I'm afraid I'll have to download all Language versions and produce the list myself.

Does anybody already have such a list of translations for properties like Element ID?

If there's no easy workaround, please @Akos Somorjai consider reintroducing a way to access such properties independent of the AC language version!

Best,
Bernd

Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

Viktor Kovacs — Wed, 17 Jul 2024 09:35:20 GMT

Hi Bernd,

The future-proof way of identifying built-in properties is to use their guids. You can hard-code the guid in your code, just as you hard-coded the name earlier. To get the list of available built-in properties with their guids you can use this code:

void DumpAllBuiltInProperties () { GS::Array<API_PropertyGroup> groups; ACAPI_Property_GetPropertyGroups (groups); for (const API_PropertyGroup& group : groups) { GS::Array<API_PropertyDefinition> definitions; ACAPI_Property_GetPropertyDefinitions (group.guid, definitions); for (const API_PropertyDefinition& definition : definitions) { if (definition.definitionType != API_PropertyStaticBuiltInDefinitionType) { continue; } GS::UniString report = group.name + "\t" + definition.name + "\t" + APIGuidToString (definition.guid); ACAPI_WriteReport (report, false); } } }

Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

BerndSchwarzenbacher — Wed, 17 Jul 2024 10:20:12 GMT

Thanks Viktor!

That does indeed work across languages (tested with AC28 INT/GER/ITA - Tech Preview).
I had the wrong assumption, that different property names would automatically lead to different GUIDs and that's why I've relied on the Fundamental BuiltIn property in the past. Might be that built-in properties are special regarding that. Thanks a lot for clearing it up 🙂

For reference: The 'Element ID' Property has the following GUID: 7E221F33-829B-4FBC-A670-E74DABCE6289

Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

Botonis — Wed, 17 Jul 2024 10:27:06 GMT

I totally support Bernd on this. Addon developers are a significant part of Archicad 's evolment and users' workflow.

Their work should be more productive and creative and so the SDK must also aim on this.

Edit: Glad that the instant solution by @Viktor Kovacs cleared things up.

Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

Viktor Kovacs — Wed, 17 Jul 2024 10:22:16 GMT

Yes, built-in property guids are stable across Archicad versions and languages. 🙂

Re: AC28: Builtin Properties no longer available -> Worse Compatibility with AC Language Versions

BerndSchwarzenbacher — Wed, 17 Jul 2024 10:25:51 GMT

Thanks @Botonis for always having my back!
Fortunately, the way Viktor showed is a very easy and better alternative to do the thing I tried to do 😀