Note: By clicking on the link below you can find the install file for the plugin.
Version 1.0.8
The Catenda Revit plugin is a plugin that can be installed for Autodesk Revit.
With this plugin you will be able to collaborate on 3D viewpoints, topics and documents with the other members of the construction project
The following topics will be described in this article:
Getting started
After installing the plugin, open a Revit model and click on the Catenda button in the Add-Ins.
Login with your email address and Catenda Hub password.
If you have MFA enabled for your account you will be asked to fill in your MFA code.
Next, click on “Allow access” to allow the Revit add-in to access your Catenda Hub account. This will open the main view of the Catenda Hub add-in.
You can remove the access to your Catenda Hub account at any time by going to your Catenda Hub application page and click on “Revoke access” near “Revit plugin for Catenda Hub”.
Topic List
In this page, you will find the main menu to navigate in your Catenda Hub project, topic boards and topics.
Interface
Select your Catenda Hub project
Select a topic board in this project
Create a new topic in the currently selected topic board
Sort currently displayed topics
Open the Catenda Hub add-in menu
Search and filter the displayed topics
The list of currently filtered topics in the topic board
Project and topic board selection
Selecting a Catenda Hub project will display the list of topic board in this project, allowing you to selected one to display the corresponding topics. It will also save the Catenda Hub project and topic board in your Revit model and open them automatically the next time you open this model.
Catenda Add-in Menu
Go to the Upload page
Open the Settings page
Open your Catenda Hub account page in your default browser
Log out from your Catenda Hub account
Topic selection
In the topic list, you will find all the main information about an topic:
The title of the topic
Its status (Open, Closed, …), its type (Info, Error, …) and its labels
The member requesting the topic
The member the topic is assigned to
The due date of the topic
When the topic was last updated. You can hover over the date to display the full date and time of update.
The number of comments in the topic
The image of the first comment in the topic
Catenda Hub topic number
You can click on any topic to go to the topic detail page.
Sort topics
You can sort the displayed topics to bring he most relevant to you first.
Bring the most recently created topic first
Bring the oldest topic first
Bring the most recently updated topic first. Updating an topic can involve changing any of this properties, title, comments, …
Bring the least recently updated topic first
Bring the most recent due date first
Bring the oldest due date first
Filter topics
Using the filter bar, you can combine any type of filter to display only the most relevant topics.
Current filters are displayed as small chips in the filter bar. Here, only topics with the “Open” status are displayed. Click in the filter bar to display all available filters (1).
On the left (2) is the name of the filter, every filter belong to a type displayed on the right (3).
Available filters types includes:
Requested By: Get all topics requested by a given user
Assigned To: Get all topics assigned to a given user
Due Date: Get all overdue topics or topic due in less than a month, two week, a week or a day
Status: Get all topics of a given status (Open, Closed, …)
Type: Get all topics of a given type (Error, Warning, Info, …)
Label: Get all topics with a given label
My topics: Get all topics assigned or requested by yourself
You can search for these filters by typing text in the filter bar (1). You can also use this to create a text filter to search for a specific text in the topic title or description (2).
Topic Details
In this view, you can review and edit a specific topic.
Interface
Go back to the Topic List
Refresh the content of this topic
Navigate between topics
Set the topic status (Open, Closed, …)
Set the topic type (Error, Warning, Info, …)
Set the due date of the topic
Set the member assigned to the topic. You can assign a topic to an individual user or a team.
Set the member requesting this topic. You can set an individual user or a team.
Edit the topic labels
The list of comments in the topic
Topic properties
You can edit any property of the topic: Status, type, assignee, requester, due date, labels. Every menu will display a list of available properties. However, you cannot create a new status, type or label directly in the plugin, you will have to use the web interface of Catenda Hub to do that.
You can click on the title to edit it:
You can click on the pen icon to edit the description:
You can also type text in the label bar to filter down the list of filters:
Comments
All comments are displayed below the topic. A comment can contains text, a picture, a snapshot from your Revit current view or a viewpoint.
The author of the comment
When the comment was created. You can hover over the date to display the full date and time of update.
The zoom button (see chapter below)
The image associated with the comment
The text of the comment
Zoom
If the comment contains a viewpoint, you can zoom to this viewpoint. Zoom in will create a new 3D view in your Revit model focused on the same viewpoint.
For the viewpoint to be relevant, you must have opened the same model than the one where the comment was created. The plugin assumed that Shared Coordinates where used while exporting the model to IFC.
If the viewpoint has been created from a perspective view, the new 3D view will have its projection mode set to “Perspective”. Otherwise, the projection mode will be “Orthographic”.
The add-in will create only one perspective view and one orthographic view. After having created them, it will reuse them for any subsequent use of the zoom function. You can change that in the settings menu. You can also use the settings menu to change the name of these view.
Related elements
If the topic contains related elements, the add-in will select them in Revit when you zoom to a viewpoint.
For this function to work, you Revit model must have been exported to IFC with the “Store the IFC GUID in an element parameter after export”. This add the IFCGuid parameter on every object, allowing the plugin to select the related elements.
Add comment
You can add comments to an topic by writing in the text box and clicking on Submit.
You can also add a picture from your computer by clicking on the “Plus” button. You can annotate this picture by clicking on the preview image after selecting it.
Add 3D snapshot
You can also add your current Revit view as a viewpoint and a snapshot attached to your comment. Just like any picture, you can annotate the snapshot by clicking on the preview image.
If the IFCGUID parameter is present, selected elements in Revit will be added to your topic as related elements.
Upload to Catenda Hub
You can upload your current Revit model directly to Catenda Hub as an IFC file.
After opening the upload page:
Select the Catenda Hub model where you will be creating a new revision
Type in a comment associated with the upload
Select an IFC configuration. A new configuration can be created in the IFC export menu in Revit. You can also select the <Catenda setup> for an easy to use configuration well suited to Catenda Hub.
Click on Upload
selectedConfig.Name = "<Catenda Setup>"; selectedConfig.IFCVersion = IFCVersion.IFC2x3CV2; selectedConfig.SpaceBoundaries = 1; selectedConfig.ActivePhaseId = ElementId.InvalidElementId; selectedConfig.ExportBaseQuantities = true; selectedConfig.SplitWallsAndColumns = false; selectedConfig.VisibleElementsOfCurrentView = false; selectedConfig.Use2DRoomBoundaryForVolume = false; selectedConfig.UseFamilyAndTypeNameForReference = true; selectedConfig.ExportInternalRevitPropertySets = true; selectedConfig.ExportIFCCommonPropertySets = true; selectedConfig.Export2DElements = false; selectedConfig.ExportPartsAsBuildingElements = true; selectedConfig.ExportBoundingBox = false; selectedConfig.ExportSolidModelRep = false; selectedConfig.ExportSchedulesAsPsets = false; selectedConfig.ExportUserDefinedPsets = false; selectedConfig.ExportUserDefinedPsetsFileName = ""; selectedConfig.ExportLinkedFiles = false; selectedConfig.IncludeSiteElevation = true; selectedConfig.UseActiveViewGeometry = false; selectedConfig.ExportSpecificSchedules = false; selectedConfig.TessellationLevelOfDetail = 0; selectedConfig.StoreIFCGUID = true; selectedConfig.ExportRoomsInView = true;
Settings
The settings page allows you to change how the plugin will create 3D view when using the Zoom function.
Keep the 3D view orthographic. This option will force the Revit 3D view to be orthographic even if the corresponding viewpoint has been created with a perspective view.
Create a new view for every topic. Instead of reusing the same 3D view each time you use the Zoom function, this option will create a new 3D view for every topic each time you use the zoom function.
3D view name suffix. This text will be added to the name of the 3D view created when using the Zoom function.