Troubleshooting Library Issues

From the following list, click on the specific library-related issue for more information:

Missing Library Parts

Objects Temporarily Missing

Unsupported Objects

Find and Select Missing Library Parts

Duplicated Library Parts

Substituted Objects

Consolidate Multiple ARCHICAD Libraries

Remove Unused Linked Libraries

Library Path Too Long

Missing Library Parts

The Library Manager indicates any Missing Library Parts.

MissingEmbedded.png 

Missing library parts cannot be displayed in the project. (The place of missing library parts is indicated by fuzzy dots.)

Missing library parts are listed in the Warnings Panel of the Library Manager, together with:

the name of the source library if any, with its last known location, from which the missing objects originate.

number of missing object, plus the number of placed instances of each missing object. For each missing object, the number of its placed instances is shown in parentheses.

Items in the Missing Library Parts folder of the Library Manager are missing from the project

either because they were embedded objects, and have been deleted (you cannot retrieve them, since they no longer exist)

or because they were located in libraries that have been deleted from the project or moved to a different location.

To retrieve these objects, use the Add command in Library Manager to add the missing libraries, then click Reload & Apply.

Note: Some Favorites include a GDL object (such as a Favorite Zone that includes a Zone Stamp). If that GDL object becomes Missing (i.e., its library is not loaded), the Library Manager lists all missing objects from Favorites.

Objects listed under “Missing from unknown library” are missing objects about which no other information is available - their source library (or libraries) are not known.

Objects Temporarily Missing

In a Teamwork project, you may encounter a category in the Library Manager entitled “Temporarily Missing.” This may occur when a user makes changes in a BIMcloud Library that result in placed objects being updated in some way. If those objects are reserved by any user, then all users joined in to the project will encounter the “Temporarily Missing” category.

This will be resolved as soon as the user(s) who have reserved the objects do a Send & Receive; then the objects will no longer be missing.

Unsupported Objects

These files reference unsupported image formats.

Find and Select Missing Library Parts

To find and select missing library parts in the active window, use the Find & Select function.

See also Find and Select Elements.

1.In the first “Criteria” row in the Find and Select dialog box, choose a GDL object type element.

2.In the next row, for the next criterion, choose “Library Part Missing.”

3.As the value, select “True”.

Note: You can also choose “False” as the value; this will select all instances of the defined GDL Object types, except for the ones whose library object is missing.

MissingStair.png 

4.Click the Plus button to execute the Find & Select function.

Missing Libraries

If you have modified the name of a library folder, or changed its location in the file hierarchy, then the next time you open ARCHICAD, the library folder listed in the Library Manager dialog box will be shown as Missing.

MissingLibrary.png 

Placed objects from unavailable libraries are listed in the “Missing Library Parts” folder of Library Manager. In the project model, they are represented by fuzzy dots.

The solution is to click Add Linked Library from the Library Manager’s Add button, and browse for the library file under its new name or location.

Duplicated Library Parts

Any Duplicated Library Parts are listed in the Warnings Panel of the Library Manager. Each such library part is followed by the name and path of the project libraries that contain it.

Click More Info at the bottom of Library Manager for detailed information on the duplicates:

DuplicatedLibparts.png 

In the Information box, click the black arrow to choose the list format you need:

List placed duplicates

List all duplicates

List all placeable duplicates

List all non-placeable duplicates

Watch the Video

Avoid Duplicate Library Parts

The problem with having a lot of duplicate objects in your projects is twofold: every time you load your libraries, you will be loading many superfluous objects and/or libraries, causing unnecessary slowdowns; and the presence of duplicates can lead to further ambiguities if you should modify a duplicate library object or save it under a new name.

See Substituted Objects.

There are several possible strategies to resolve the issue of duplicates:

If the Libraries with Duplicate Objects are ARCHICAD Libraries, it is best to Consolidate.

See Consolidate Multiple ARCHICAD Libraries.

If all the placed objects from one of the libraries are duplicates (i.e. these objects also exist in the other library), you can remove the first library altogether.

If the duplicated libraries are not ARCHICAD libraries, you might consider comparing the two libraries’ contents manually (open the library folder at its source and view the objects), and then delete the duplicates from one of the libraries.

If the duplicate placed objects are project-specific, you should embed them into the project. This will also eliminate the library from the project.

See Embed Placed Objects from a Library.

Substituted Objects

An object in this category has been placed in the project, but several possible substitutes for this object (that is, objects with the same GUID as the placed object, though they may be named differently) exist in at least two linked libraries. ARCHICAD randomly uses one or the other source for the object’s placed instances.

To avoid this situation, you should manually replace the instances of the “substituted object” with a single one of its possible duplicates from the loaded libraries.

(To do this, you can use Find & Select to locate the placed instances of the substituted object. Then choose a specific library object from the loaded libraries to replace it.)

Consolidate Multiple ARCHICAD Libraries

Any time you add an additional ARCHICAD library to a project that already has one, ARCHICAD will recognize the presence of older-version ARCHICAD libraries (versions 10 and later). In this case, the yellow Consolidate button appears in Library Manager.

Note: The Consolidate button appears in Library Manager any time that at least one outdated ARCHICAD Library - that is, a Library which is not the latest one - has been added to the project.

ConsolidateIcon.png 

ConsolidateLibs.png 

Consolidating ARCHICAD libraries is recommended because:

it replaces the old ARCHICAD libraries with the latest library

it loads the requisite Migration Libraries so that you still have access to any now-obsolete library parts that may still be placed in the project

Migration Libraries are much smaller than the full ARCHICAD libraries, so you will avoid superfluous objects

you avoid errors that can result from placing identically named library parts that are present in several loaded libraries

Remove Unused Linked Libraries

Library Manager tells you whether you have actually placed any objects from your linked libraries. If not, you don’t need that library and you can remove it from the project. In this example, there are no objects placed from the selected ARCHICAD library; you can remove it.

UnneededLibrary.png 

To remove a library folder, select it from Library Manager and click the “Remove” icon with the blue X.

Library Path Too Long

The Windows operating system has a limit of 260 on the number of characters that the library path name can contain. Consequently, you may encounter a warning that the program is unable to save a local copy of the BIMcloud library, because the library path is too long.

To resolve this problem, try one of these solutions:

Simplify the library’s file structure. 

Go to File > Libraries and Objects > Manage BIMcloud Libraries.

Download the BIMcloud library to a folder on your hard drive.

In this folder, do one of the following:

Create a container file (.lcf) out of the library folder, using File > Libraries and Objects > Create Container.

See also Library Container File.

Alternatively, create a different, simplified folder structure for the library (e.g. move the library folder to a higher position in the folder hierarchy so that the file path becomes shorter).

Go to File > Libraries and Objects > Manage BIMcloud Libraries and use Update to overwrite the server library with the .lcf file, or the restructured folder.

Move the Local Data folder.

Your local copies of BIMcloud libraries are stored in your Local Data Folder on your hard drive.

If this location results in a file path that is too long, move the Local Data folder:

See Move Local Teamwork Data to a Different Folder.

The new location should be at a higher level of the folder hierarchy, thus making the path shorter.