gdl-Mapping-editor

The idea for this routine and large parts of the routine itself come from Lukas Ölmüller.

Archicad 28 and 29 introduced a new method for globally controlling the default attributes of GDL objects(such as pen colors, contour pens, or material thicknesses) [1]. Instead of adjusting these values individually in each object, they can be exported via a central JSON file, edited externally, and reimported so that the changes take effect for all new instances or after a reset to the default value [1], [2].

Step 1: Exporting attributes from Archicad

1. In Archicad, open the toolbar window and activate the “Edit GDL Library Element” palette [1].
2. In this palette, search for the command “Import and Export Mapping Values Table” [1].
3. Select the option to export [1].
4. Archicad will then create a file called “mapping_values.json”. Save this file in an easily accessible location, e.g., on your desktop [3].

Step 2: Editing with the GDL Parameter Mapping Editor

Since the plain JSON file is very confusing in a text editor [3], use the b-prisma editing tool:

1. Go to Download at the bottom of this page, download the zipped html file and open it on your machine [4].
2. Importing the JSON file: Drag and drop your exported “mapping_values.json” file onto the highlighted field or click on “Load file” to select it [4].
3. Editing: The data is now processed in a structured manner. You will see a table with columns for Object, Variable name, Identifier, Type, and Value [4].
4. Use the filter functions to search for specific parameters (e.g., “pen color” or “thickness”) [5], [6].
5. Bulk change: The tool offers the option of a bulk change for filtered parameters, allowing you to set all contour pens to a new value at the same time, for example [6], [4].
6. Save: Once you have made the desired changes, save (export) the modified file back to your computer as a JSON file.

Step 3: Import the changed values into Archicad

1. Return to Archicad and reopen the “Import and Export Mapping Values Table” command in the GDL palette [1].
2. This time, select “Import” and select your edited JSON file [7].
3. Archicad lists the changes (before/after comparison) [7].
4. In case of conflicts, select the option “Replace original” so that the new default values are written to the GDL objects [7].
5. Check effectiveness: To see the changes to a placed object, you may need to “Reset to default” it in the settings [2].

Note: Proceed with caution when performing these steps, as you are changing the global default settings of your library elements [8].

Think of this JSON file as a central master list for a building: instead of going to each door individually to change the lock, simply update the list at the main entrance and all locks in the building will automatically adjust to this new default.