Get property values
get_property_valuesRead built-in and user-defined property values of many elements or element tool defaults at once, returned as one table.
Instructions
Reads property values (built-in and user-defined) of many elements — and/or of element TOOL DEFAULTS — as one table: {properties: [{guid, name, group, type}], results: [{guid | elementType, values: [cell per property, same order]} | {guid, error}]}. Each cell is {value, display?, isDefault?} (display = Archicad's formatted text incl. units, only when it differs from value; isDefault only for user-defined properties: true = the element has no own value and shows the default/expression) or {status: 'NotAvailable' (property not available for this element/classification) | 'NotEvaluated' | 'Undefined' (value set to Undefined) | 'Empty'}. Units: lengths m, areas m², volumes m³, angles DEGREES; option sets by display value. Without properties: every property available for the targets (scope UserDefined by default; BuiltIn/All can be hundreds). Address built-ins language-independently with {builtIn: 'General_ElementID'} etc.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Used only without properties: which properties to return (default UserDefined) | |
| elements | No | Elements to read | |
| properties | No | Properties to read (columns). Omit = all available (see scope) | |
| includeDisplay | No | Add Archicad's formatted display text (default true) | |
| elementDefaults | No | Read the tool default settings of these element types |