manage-sheets

Manage Revit Sheets & Views

Perform sheet/view operation:

"$ARGUMENTS"

Clarify before scripting

• Create new sheets or modify existing ones?
• Where does the sheet list come from? (Dynamo input, Excel, hardcoded in script?)
• Which title block should be used? (Get the first available one, or ask for the name?)
• Place views on sheets? If so, which views, at which positions?

Batch sheet creation script

import clr
clr.AddReference('RevitServices')
from RevitServices.Persistence import DocumentManager
from RevitServices.Transactions import TransactionManager
clr.AddReference('RevitAPI')
from Autodesk.Revit.DB import *

doc = DocumentManager.Instance.CurrentDBDocument

# ── Dynamo inputs ────────────────────────────────────────────────────────────
# IN[0] = list of sheet numbers (strings), e.g. ["A-001", "A-002", "A-003"]
# IN[1] = list of sheet names (strings),   e.g. ["Ground Floor Plan", "Roof Plan", "Sections"]
sheet_numbers = IN[0] if isinstance(IN[0], list) else [IN[0]]
sheet_names   = IN[1] if isinstance(IN[1], list) else [IN[1]]

# ── Get the first available title block type ─────────────────────────────────
tb_types = list(FilteredElementCollector(doc)
                .OfCategory(BuiltInCategory.OST_TitleBlocks)
                .WhereElementIsElementType()
                .ToElements())
tb_id = tb_types[0].Id if tb_types else ElementId.InvalidElementId

TransactionManager.Instance.EnsureInTransaction(doc)
created = []
skipped = []

try:
    for number, name in zip(sheet_numbers, sheet_names):
        # Check if sheet number already exists
        existing = [v for v in FilteredElementCollector(doc)
                    .OfClass(ViewSheet).ToElements()
                    if v.SheetNumber == number]
        if existing:
            skipped.append({'Number': number, 'Status': 'Already exists'})
            continue

        sheet = ViewSheet.Create(doc, tb_id)
        sheet.SheetNumber = number
        sheet.Name = name
        created.append({
            'Number': number,
            'Name':   name,
            'Id':     sheet.Id.IntegerValue,
            'Status': 'Created'
        })

    TransactionManager.Instance.TransactionTaskDone()
    OUT = [created, skipped]

except Exception as e:
    TransactionManager.Instance.ForceCloseTransaction()
    import traceback
    OUT = 'ERROR: ' + str(e) + '\n' + traceback.format_exc()