Migrating Libraries to ARCHICAD 23

The new version of ARCHICAD will work perfectly well with any older-version ARCHICAD libraries. However, if you stay with your older libraries, you will not get the full benefit of library improvements and fixes.

We recommend that when you migrate a project to ARCHICAD 23, you also migrate your older-version Library to the ARCHICAD 23 Library, using the easy and automatic Migrate ARCHICAD Libraries function.

IMPORTANT: When migrating an older-version project, if you want to use the newest library, make sure you use the Migrate ARCHICAD Libraries function. If you add and delete Libraries using Library Manager, you may end up with a large number of missing library parts.

Note: The automatic Migration process described below is available only for projects that use ARCHICAD Libraries 10 and later.

At any time, to view information about possible Library-related issues in your current project, check the Libraries item in the Action Center (File > Info > Action Center).

Migrate ARCHICAD Libraries when Opening Older-Version Project

When you open an older-version project in ARCHICAD 23, and if your project includes an ARCHICAD Library (version 10 and later), you are prompted to use the Migrate ARCHICAD Libraries function:

MigrateLibraryWarning.png 

Click Migrate ARCHICAD Libraries. This process will do the following:

load the new ARCHICAD library

load the ARCHICAD Migration Libraries folder (What is a Migration Library? See below.)

automatically replace placed objects from the older libraries (versions 13-22) with their latest compatible version

remove ARCHICAD libraries with lower version numbers

The Migrate ARCHICAD Libraries process may take several minutes. Once it is complete, if your project includes objects from pre-ARCHICAD 13 libraries, you may still have missing library parts. In this case, use Library Manager to load Old ARCHICAD Migration Libraries. (What is a Migration Library? See below.)

If instead you choose Skip Migration, you will load the old Library that was saved with the project. All placed objects will be available from that library, but you will not be able to use any library improvements and fixes from the latest version.

Migrate ARCHICAD Libraries for a Running Project

You can use the Migrate ARCHICAD Libraries process at any time, not only when migrating an older-version project. For example:

if you did not use the Migrate ARCHICAD Libraries process when opening an older-version project, but now would like to

if you have new issues with missing library parts as the project develops (e.g. new library parts added as a result of Teamwork or Hotlinked Modules)

Use the Migrate ARCHICAD Libraries button in Library Manager.

MigrateLibraries.png 

Note: If the button is not shown in Library Manager, this is because ARCHICAD has determined that there is no need for it: all needed libraries (latest ARCHICAD library plus Migration libraries) have already been loaded; and the project has no missing library parts.

Migrating Libraries in a Teamwork Project

To migrate a Teamwork project, use the Migrate Project process described here: Migrating a Teamwork Project (v. 13-22) to ARCHICAD 23.

During this process, make sure that the Migrate ARCHICAD Libraries checkbox is checked. This will ensure smooth migration of your ARCHICAD Libraries together with the Teamwork project.

Note: Some objects in your migrated Teamwork project may be listed as “Temporarily Missing” in the Library Manager. As soon as other users do a Send and Receive, this problem will be solved automatically.

What is a Migration Library?

Each new version of the ARCHICAD Library contains many objects that have been updated since the previous version. For the most part, these updated objects are compatible with placed older versions of the same object, and will automatically replace the older versions.

Some objects from older ARCHICAD libraries, however, have no counterpart in the new ARCHICAD 23 library (typically, these are “discontinued” objects deemed obsolete). But if you have such objects placed in your project, you want them available even if after migrating a project.

ARCHICAD Migration Libraries serve this purpose: they contain only those objects from an earlier-version ARCHICAD Library that do not have counterparts in the latest-version ARCHICAD Library. A Migration Library is much smaller than full-version ARCHICAD Library.

When Are Migration Libraries Used?

Migration Libraries are loaded automatically with two workflows:

Migrate ARCHICAD Libraries 

See Migrate ARCHICAD Libraries when Opening Older-Version Project.

Consolidate: If you have placed objects from multiple ARCHICAD libraries and have loaded all the libraries, you will be prompted to Consolidate your libraries. The Migration Libraries are loaded automatically.

See Consolidate Multiple ARCHICAD Libraries.

If you do not use these workflows, then some of your placed objects from older-version projects may not have a compatible corresponding object in ARCHICAD 23. In this case:

Those incompatible older objects will be “Missing Objects” if you have removed your old libraries. In this case, you must replace these missing objects with new ones from the ARCHICAD 23 library, and reset their parameters as needed.

Keeping your old libraries alongside your new libraries is not recommended, because a great many of the loaded objects will be duplicates and/or superfluous, and increase library loading time and potential errors.

Notes:

If you still have missing library parts, it may be because you are using library parts from ARCHICAD libraries earlier than version 13. If so, you must manually add the Old ARCHICAD Migration Libraries folder to the project, using Library Manager.

If your ARCHICAD Libraries are BIMcloud/BIM Server Libraries (for example, for a Teamwork project) and you want to consolidate them, ARCHICAD will not be able to locate the migration libraries automatically. In this case, you must upload the migration libraries from your hard drive to the BIMcloud/BIM Server.

Where to Find Migration Libraries

Migration Libraries are installed on your computer as part of ARCHICAD installation. They are divided into two folders:

ARCHICAD Migration Libraries (for ARCHICAD library versions 13 and up)

Old ARCHICAD Migration Libraries (generally available for ARCHICAD library versions 10-12)

You can also download Migration Libraries from the GRAPHISOFT website.

Note: Available migration libraries may vary, depending on your localized version.

Obsolete Objects

Objects are “obsolete” in two cases:

the object has been discontinued entirely as of the new ARCHICAD version (e.g. a computer or TV object that is no longer current)

the object has a counterpart in the new ARCHICAD version, but due to changed parameters or functions (e.g. a window whose sash has been altered), the old object will not be replaced automatically

If you use the Migrate Libraries or Consolidate functions as described above, the Migration Libraries will be loaded automatically, together with the necessary obsolete objects, and you won’t have any missing objects.

Note: You will only be able to access only those obsolete objects from the Migration Libraries that have already been placed in your project.

Replace Obsolete Object with Latest Library Part

If you are using an obsolete object (e.g. window from an earlier version) and wish to replace it manually with the newest corresponding library part, be aware that the new window will not be exactly the same as the older one (otherwise, it would have been replaced automatically): something will work differently.

Therefore, when you do replace the old window with the new one, you should reset the new window’s parameters as needed.

To expedite this, use Parameter Transfer: this way, you will pick up the old window’s parameters and inject them into the new window before placing it. This still won’t produce an exact replica, but everything that can be replicated will be, and this will save you manual work.

1.Use the Pick up Parameters shortcut (Alt+click) to pick up the parameters of the placed object.

PickUpTripleSash.png 

2.Select the old window in the project.

3.Open the Window Settings dialog box.

4.In Window Settings, navigate to the new library folder and the corresponding new window that you want to use.

5.Move your cursor to the new replacement window- and press Ctrl+Alt (Mac: Cmd+Opt). The cursor will change to a syringe shape.

InjectDoubleSash.png 

6.Now click on the new window object to inject the parameters. All transferable parameters of your old window will be transferred to the newly activated window.

7.Click OK to close Window Settings and to replace the old window with the new one, using the changed parameters.

These modifications to the new window are in effect only until you close the dialog box and place the window; the new window’s default settings will not change.