Parámetros compartidos en Revit: qué son, cómo crearlos, el archivo .txt, el cajetín y los errores que más se repiten

La diferencia de fondo es el GUID. Revit reconoce un parámetro compartido por su GUID, no por su nombre. Por eso el mismo parámetro puede estar en cien familias y en diez proyectos y Revit sabe que es el mismo dato. Un parámetro de familia, en cambio, solo existe dentro de esa familia.

Cuándo usar cada uno:

• De familia: para controlar la geometría interna, como un ancho o un ángulo que nadie va a tabular.
• De proyecto: para un dato que solo se tabula o filtra en ese proyecto.
• Compartido: para todo lo que se etiqueta, se tabula en varios proyectos, va al cajetín o lo lee un plugin.

Los parámetros compartidos viven en un archivo de texto que guarda, para cada uno, su nombre, su GUID, su tipo de dato y el grupo al que pertenece. El propio archivo advierte en su encabezado que no se edite a mano.

Dónde está: en cualquier carpeta. Cada usuario elige qué archivo usa en Gestionar › Parámetros compartidos, y Revit recuerda esa ruta en su equipo.

Lo que poca gente sabe: una vez que un parámetro compartido está en un proyecto o en una familia, su definición queda guardada ahí. El archivo solo se necesita para agregar parámetros nuevos. Si el archivo se pierde, los proyectos siguen funcionando, y un parámetro se puede recuperar exportándolo desde una familia que lo tenga, con su mismo GUID. Lo que nunca hay que hacer es crearlo de nuevo con el mismo nombre.

Las reglas de una oficina ordenada:

• Un solo archivo maestro, en una carpeta de red de solo lectura para todos menos el responsable.
• Grupos por uso, como Láminas, Estructuras o Metrados.
• Nombres con prefijo de la oficina, para no confundirlos con los de fabricantes o clientes.
• Nunca borrar y recrear un parámetro: el nuevo tendría otro GUID.

Crearlo en el archivo:

1. Gestionar › Parámetros compartidos.
2. Elige el archivo o crea uno nuevo.
3. Crea un grupo, o elige uno existente.
4. Crea el parámetro: nombre, tipo de dato, como texto, número, longitud o sí/no, y una descripción que explique para qué sirve.

Agregarlo al proyecto:

1. Gestionar › Parámetros de proyecto › Añadir.
2. Elige Parámetro compartido y selecciónalo del archivo.
3. Decide si es de ejemplar o de tipo, en qué grupo de Propiedades aparece y a qué categorías se aplica.

Agregarlo a una familia: en el editor de familias, Tipos de familia › Nuevo parámetro › Parámetro compartido. Si la familia y el proyecto usan el mismo parámetro compartido, Revit los reconoce como uno solo al cargar la familia.

• Tablas de planificación. Un parámetro compartido aparece en la lista de campos de las tablas de sus categorías, y se puede editar desde la tabla. Si necesitas llenarlo desde Excel, lo vemos en exportar tablas de Revit a Excel y reimportarlas.
• Etiquetas. En la familia de etiqueta, el rótulo se arma con el mismo parámetro compartido. Así la etiqueta lee el valor de cualquier elemento que lo tenga.
• El cajetín. Para mostrar un dato propio de la oficina en el cajetín, como el número de colegiatura del ingeniero o la especialidad, se crea un parámetro compartido, se agrega al proyecto en la categoría Láminas y se usa en el rótulo del cajetín. Lo contamos en revisiones y firmas en Revit para varios planos.

• El parámetro no aparece en la tabla. Es un parámetro de familia, no compartido; o no está vinculado a la categoría de esa tabla.
• La etiqueta no muestra nada. El elemento no tiene ese parámetro: su familia no lo incluye o el parámetro de proyecto no está en su categoría.
• La etiqueta muestra un signo de interrogación. El parámetro existe, pero está vacío en ese elemento.
• Dos parámetros con el mismo nombre. Alguien creó otro con el mismo nombre en otro archivo: tiene otro GUID y Revit los trata como datos distintos. La tabla lee uno, la etiqueta otro y los valores no coinciden.
• No encuentro el parámetro al cargarlo. Revit está apuntando a otro archivo de parámetros compartidos; revisa la ruta en Gestionar › Parámetros compartidos.
• Ejemplar o tipo equivocado. Si el valor debe cambiar en cada elemento y se creó como de tipo, al cambiarlo cambian todos los del mismo tipo.

• Un responsable del archivo maestro, y un registro de cada parámetro nuevo: para qué sirve, quién lo pidió, en qué categorías va.
• Plantillas con los parámetros ya cargados, para que cada proyecto empiece igual.
• Familias revisadas antes de entrar a la biblioteca: que usen los parámetros del archivo maestro y no copias.
• Auditorías periódicas de los proyectos para encontrar parámetros duplicados o huérfanos. Es parte de lo que revisa una auditoría BIM.

• Cargar los parámetros de la oficina en lote, en muchos proyectos y familias a la vez, con sus categorías y grupos.
• Detectar duplicados: el mismo nombre con distinto GUID, en todos los modelos de un proyecto.
• Llenar valores desde Excel y devolverlos, sin pasar por cada elemento.
• Revisar familias antes de que entren a la biblioteca.

El núcleo, con la API de Revit, es corto:

// Agrega un parámetro compartido de texto a la categoría Láminas
DefinitionFile archivo = app.OpenSharedParameterFile();
DefinitionGroup grupo = archivo.Groups.get_Item("Laminas") ?? archivo.Groups.Create("Laminas");
Definition def = grupo.Definitions.get_Item("OF_Colegiatura")
    ?? grupo.Definitions.Create(new ExternalDefinitionCreationOptions("OF_Colegiatura", SpecTypeId.String.Text));

CategorySet categorias = app.Create.NewCategorySet();
categorias.Insert(doc.Settings.Categories.get_Item(BuiltInCategory.OST_Sheets));

using (var t = new Transaction(doc, "Parámetro compartido"))
{
    t.Start();
    doc.ParameterBindings.Insert(def, app.Create.NewInstanceBinding(categorias), GroupTypeId.IdentityData);
    t.Commit();
}

Si quieres empezar con la API desde cero, lo explicamos en Revit API en español, primeros pasos.