¶ InfoNode Handler
InfoNode Handler is an automation extension for Revit that places and manages InfoNode family instances in your active model, based on subitem data from dRofus. It streamlines coordination between linked models and dRofus, ensuring that all relevant objects are represented and updated in your Revit project.
-
Dry Run:
Type: Checkbox
Default: False
Description: When enabled, the extension simulates all actions without making any changes to your Revit model. Use this to preview what would happen before committing changes.
-
Ignore Host Model Name:
Type: Checkbox
Default: False
Description: When enabled, the extension will include hosts even if their model name is missing in dRofus. This is useful for handling objects that lack proper model name data.
-
Host Occurrence Model Name:
Type: Text
Default: parent_occurrence_id_occurrence_data_17_11_11_10
Description: The dRofus field used to identify the host model name for filtering. Change this if your dRofus setup uses a different field.
-
Host Item Data 1:
Type: Text
Default: parent_occurrence_id_article_id_dyn_article_13101110
Description: The dRofus field for custom host data (e.g., type, classification). Adjust as needed for your workflow.
-
Host Item Data 2:
Type: Text
Default: parent_occurrence_id_article_id_dyn_article_13101211
Description: Another dRofus field for additional host data. Configure to match your project requirements.
When you run InfoNode Handler, it:
- Checks that the InfoNode family exists in your model.
- Verifies that all required parameters are present.
- Collects all linked model names and relevant family instances.
- Queries dRofus for subitems (occurrences) matching your configuration.
- Matches Revit family instances to dRofus hosts and prepares InfoNode placements.
- If Dry Run is off, places or updates InfoNodes in your model and removes outdated ones.
- If Dry Run is on, simulates all actions and provides a summary without making changes.
-
Prerequisites:
- Ensure your Revit model contains the InfoNode family.
- Linked models should be loaded and have dRofus occurrence IDs assigned.
-
Configuration:
- Open the extension settings and adjust fields as needed.
- Enable Dry Run to preview changes.
- Enable Ignore Host Model Name if you want to include hosts with missing model names.
-
Execution:
- Run the extension from the Assistant platform or Revit.
- Review the summary showing created, moved, updated, and deleted InfoNodes.
-
Verification:
- Check that InfoNodes are placed/updated as expected in your model.
Add screenshots of the configuration UI, InfoNode placements in Revit, and the summary results here.
- Causes: The InfoNode family is missing or not loaded.
- Solution: Load the InfoNode family into your project and try again.
- Resources: [Revit Family Loading Guide]
- Causes: Your InfoNode family or instances are missing required parameters (InfoNode_hostdata, InfoNode_hostID, InfoNode_hostname, InfoNode_hosttag, InfoNode_modname, InfoNode_subs, InfoNode_hostdata2).
- Solution: Check parameter names in your family and ensure they match the configuration.
- Resources: [Revit Parameter Management]
- Causes: InfoNodes reference models that aren't currently loaded, or model names don't match.
- Solution: Load all required linked models or enable "Ignore Host Model Name" for hosts with missing data.
- Causes: Multiple family instances with the same dRofus occurrence ID exist in linked models.
- Solution: Review duplicates listed in the summary and remove redundant instances from your linked models.
-
Q: When should I use Dry Run mode?
- A: Use Dry Run to preview all changes before modifying your model. This is especially useful for large projects or first-time runs.
-
Q: What does Ignore Host Model Name do?
- A: It allows the extension to process hosts even if their model name is missing in dRofus, ensuring no objects are skipped due to incomplete data. InfoNodes for these hosts will have "Ingen data" as the model name.
-
Q: Can I customize which dRofus fields are used?
- A: Yes, adjust the configuration fields in the extension settings to match your dRofus schema.
-
Q: What happens to old InfoNodes that no longer match?
- A: They are automatically deleted by the "Great Purge" function to keep your model clean.
- Version 0.1.3 - November 2025
- Migrated to dRofusClient NuGet package
- Added Dry Run mode for safe simulation
- Added Ignore Host Model Name option for incomplete data
- Improved filtering and data matching logic
- Enhanced error handling and validation
- Removed debug file exports for cleaner execution
This documentation was generated based on the extension's code structure.