We take a look at maintaining relationships between Revit elements when copying, at ACC, the Autodesk Construction Cloud, and its APIs:
A new exciting Forge API may prove especially useful to Revit users, the BIM 360/ACC Model Properties API.
It provides a powerful new tool to query, filter and compare properties of models.
For example, previously, if you were interested in only MEP elements (e.g., pipes and ducts) with a subset of their properties, you were required to download the entire model data and to parse the massive body if BIM data yourself. With this new tool, you can download only the elements and properties that you are interested in. The actual query operation is performed in the cloud, so you have much less data to download. This causes a considerable performance gain, especially dealing with large models. Of course, as a developer, you have more functionality to take advantage of with less coding. With more and more people interested in analysing models, moving toward a model-based approach, and sharing models saved in Docs, among various disciplines and phases, we foresee a lot of potential use cases using this tool.
For more information, check out the article mentioned above, the comparison of Model Properties API versus Model Derivative API and the other Forge community blog posts about ACC APIs.
If you are interested in learning more about Autodesk Construction Cloud products and making use of the Autodesk Construction Cloud (ACC) APIs, you are invited you to join the ACC Integration Partner Summit 2022, a virtual event on March 17, 2022.
Your Autodesk hosts will be Jim Lynch, SVP & GM of ACS, Josh Cheney, Senior Manager of Strategic Alliances, Jim Gray, Director of Product, ACS Service Infrastructure, and Anna Lazar, Strategic Alliances & Partnerships.
For more information about the event, please refer to the community blog article on ACC Integration Partner Summit 2022, or jump directly to the registration form.
Returning to the pure .NET desktop Revit API, some interesting aspects of maintaining relationships between elements were discussed in
the Revit API discussion forum thread
on PhaseCreated and PhaseDemolished after using CopyElements:
Question: I'm trying to copy elements from one document into another, which I'm managing fine.
The issue I'm facing is that, despite having the origin document phases present in the destination document (same phase names at least), the copied elements' Phase Created and Phase Demolished do not match the original elements'.
I checked if the ElementIds returned by CopyElements come up in the same order as the given ElementIds, but unfortunately that was not the case, and once the elements are copied, I'm struggling to make a connection between origin and destination so I can match the phases.
I read the discussion on copying elements, types and parameters, but it didn't help.
Answer 1: I believe that when you collect a bunch of elements and copy them all together in one single operation, Revit will try to maintain and restore all their mutual relationships in the target database. Therefore, it might help if you add all possible references these elements have to other source database elements to the set of elements to copy. These references will include the element instances themselves, their types, phases, levels, views, materials, and whatever other objects you are interested in. Then you will have to test and see what Revit can do to try to avoid creating duplicates of them in the target database and map them to existing target objects instead.
This behaviour is hinted at in the list of extensible storage features.
Answer 2: That’s standard behaviour for the Revit User Interface. Elements that are pasted into a view do not get their phases from the copied elements. Instead, they get their phases from the phase of the view they are pasted into. For example, if the view pasted into has a new construction phase, that’s the phase that the elements will inherit for their created in phase.
It’s possible to check the phases of every element copied, store those in an array, and then apply the phases to the new elements. I created an add-in that does exactly that and posted the code online:
Here is the C# code for an app I wrote that copies and pastes Revit elements and gives the pasted elements the same phase and workset of the copied elements.
You will have to do some extra work to deal with the fact that you are pasting into a different document, but that should be fairly easy to do.
Response: Thanks for the help, @jeremy.tammik and @sragan.
@sragan I was doing exactly what you suggested but I was getting inconsistent results when comparing the elements from the source model against the destination model. I then tried a few different ways and ended up realising that the CopyElements does return the same order of the given ElementId list, which then solved my problem.
When I collected the elements in my source document, I also collected their Phase Created and Phase Demolished and stored all 3 in a list:
List<KeyValuePair<ElementId, KeyValuePair<string, string>>>()
This allowed me to compare the output of CopyElements with that list and apply the settings of each element individually.
Many thanks to Fabio for raising this issue and Steve Ragan for sharing and explaining his effective solution!
I am a fan of open source, the creative commons license, free stuff, good will, sharing and learning together as a community. Consequently, I share everything I can in public in the hope that it will come in useful for others as well and help make the world a better place.
In a similar vein, a colleague involved in community work pointed out Unsplash:
Unsplash has over a million free high-resolution photos grouped in popular photo categories. All photos are free to download and use under the Unsplash License.
This Tuesday, February 22, 2022, is both a Tuesday and a spectacular, unique Twosday, the date being both a palindrome and an ambigram:
According to the ISO 8601 international standard covering the worldwide exchange and communication of date- and time-related data, this is wrong, of course, and should be written the other way around, as 2022-02-22...