I returned safe and sound to Europe from Autodesk University 2016 in Las Vegas and recuperated from jetlag over the weekend.
Today I discuss upcoming events, new simple samples to embed a Forge viewer in a web page or blog post, and strategies to embed a dictionary into the Revit database:
DataStorage, not ProjectInfoAutodesk University ended, and all went well, including the classes I presented and the DevDay conference held the day before AU proper started:
The next DevDay conference is coming up fast, the one and only European one this year, followed by four days of joint hacking, research and learning, in Munich, Germany:
Read all about the annual, worldwide Developer Day Conferences and Accelerator workshops at autodeskdevdays.com.
Registration is easy and open for all.
Simply visit the event website and click on the Register button.
That is the next thing for me to prepare for now.
If you are unable to attend the European DevDay in Munich, you may be interested in visiting New York instead.
CORE Studio at Thornton Tomasetti is hosting the AEC Technology Symposium and Hackathon 2016 there on Thursday December 8.
Workshops Include:
Please refer to the AEC Technology Symposium and Hackathon 2016 for all further details.
I repeatedly mentioned the recent BIM and Forge workshop at TuDa.
Our hosts at the uni there implemented a web page to share the agenda, www.bim.tu-darmstadt.de.
After the single day workshop on Friday, they continued exploring Forge over the weekend and updated the web site to display the university building in an embedded Forge viewer over the weekend.
You can check it out yourself and view source to see the single line of code to add the iframe tag hosting the embedded A360 viewer.
Another take on this is provided by the TrueVis A360 embedder WordPress plugin and accompanying A360 embedder examples.
Using those, you can completely automate the viewer embedding in a WordPress blog post.
And now, back to the Revit API.
DataStorage, not ProjectInfoI had an interesting discussion with my colleagues Simon Jones, Miroslav Schonauer and Scott Conover on storing a dictionary in the Revit database – note that the AutoCAD ObjectARX environment provides support for so-called named dictionaries:
Question: Is there a way of defining named dictionary storage for data in a Revit project?
The only option I can find is to use Extensible Storage on an arbitrary element placed in the model – but is there a way that avoids the requirement for an inserted element (and the risk that someone deletes it)?
Answer 1: Yes.
Officially, extensible storage is the only way... if you place it onto the ProjectInformation instance, that is equivalent of per-doc data as ProjectInformation is GUARANTEED to be a singleton in RVT.
I personally use a mechanism that I devised a few releases before extensible storage had been introduced – serialising a class into binary stream, encoding it via String64 and then storing into an invisible string parameter. I found it much quicker to design my custom data-class than fiddling with extensible storage definitions…
But in either case, the ProjectInfo element is the way to get per-doc data…
Answer 2: No!
Sorry, but please stop using the ProjectInfo class in that manner immediately.
I used to recommend that earlier as well, and have stopped since learning better last year.
This is extremely important due to issues with worksharing.
Scott Conover explains that very explicitly in his AU class on add-ins that cooperate with worksharing.
At the same time as the introduction of extensible storage, the DataStorage element was introduced.
That is a new Revit database element class whose sole purpose is to host extensible storage data.
You can create as many of these as you like, and tag them in any way you like in order to make your one and only or several of them with all the associated element-specific or projectwide data easily accessible.
The Building Coder defines a dedicated topic group on extensible storage.
One of its entries actually points to a discussion quite similar to what you are asking for, named GUID storage for project identification. All you would need to do to adapt it to your requirements would be to replace the GUID that is stores by a suitable dictionary.
Here is some more on the DataStorage element hosting extensible storage in a worksharing environment.
Answer 3: If worksharing is involved, I agree :-) most of the tools we are involved with would have many serious issues with worksharing, i.e., they are by-design used only for a central-model style workflow.
In any case, if starting from scratch, I agree that DataStorage should be used!
Answer 4: If you are certain that Worksharing will not be involved, there’s not much difference between using ProjectInfo and DataStorage, except that using DataStorage provides better encapsulation from another add-in accidentally deleting your data from ProjectInfo when it accesses its own.
If Worksharing is to be involved, you should definitely avoid using the ProjectInfo instance.
Please refer to The Building Coder topic group on extensible storage for more information on it in all its aspects.