Parâmetros compartilhados no Revit: o que são, como criar, o arquivo .txt, o carimbo e os erros que mais se repetem

A diferença de fundo é o GUID. O Revit reconhece um parâmetro compartilhado pelo GUID, não pelo nome. Por isso o mesmo parâmetro pode estar em cem famílias e em dez projetos e o Revit sabe que é o mesmo dado. Um parâmetro de família, ao contrário, só existe dentro daquela família.

Quando usar cada um:

• De família: para controlar a geometria interna, como uma largura ou um ângulo que ninguém vai tabular.
• De projeto: para um dado que só é tabulado ou filtrado naquele projeto.
• Compartilhado: para tudo o que vai em tags, em tabelas de vários projetos, no carimbo ou é lido por um plugin.

Os parâmetros compartilhados vivem num arquivo de texto que guarda, para cada um, nome, GUID, tipo de dado e o grupo a que pertence. O próprio arquivo avisa no cabeçalho que não deve ser editado à mão.

Onde fica: em qualquer pasta. Cada usuário escolhe qual arquivo usa em Gerenciar › Parâmetros compartilhados, e o Revit lembra esse caminho no seu computador.

O que pouca gente sabe: depois que um parâmetro compartilhado está num projeto ou numa família, sua definição fica salva ali. O arquivo só é necessário para adicionar parâmetros novos. Se o arquivo se perde, os projetos continuam funcionando, e um parâmetro pode ser recuperado exportando-o de uma família que o tenha, com o mesmo GUID. O que nunca se deve fazer é criá-lo de novo com o mesmo nome.

As regras de um escritório organizado:

• Um único arquivo mestre, numa pasta de rede somente leitura para todos, menos o responsável.
• Grupos por uso, como Pranchas, Estruturas ou Quantitativos.
• Nomes com prefixo do escritório, para não confundi-los com os de fabricantes ou clientes.
• Nunca apagar e recriar um parâmetro: o novo teria outro GUID.

Criá-lo no arquivo:

1. Gerenciar › Parâmetros compartilhados.
2. Escolha o arquivo ou crie um novo.
3. Crie um grupo, ou escolha um existente.
4. Crie o parâmetro: nome, tipo de dado, como texto, número, comprimento ou sim/não, e uma descrição que explique para que serve.

Adicioná-lo ao projeto:

1. Gerenciar › Parâmetros de projeto › Adicionar.
2. Escolha Parâmetro compartilhado e selecione-o no arquivo.
3. Decida se é de instância ou de tipo, em que grupo das Propriedades aparece e a que categorias se aplica.

Adicioná-lo a uma família: no editor de famílias, Tipos de família › Novo parâmetro › Parâmetro compartilhado. Se a família e o projeto usam o mesmo parâmetro compartilhado, o Revit os reconhece como um só ao carregar a família.

• Tabelas. Um parâmetro compartilhado aparece na lista de campos das tabelas das suas categorias, e pode ser editado pela tabela. Se você precisa preenchê-lo pelo Excel, vemos isso em exportar tabelas do Revit para o Excel e importar de volta.
• Tags. Na família da tag, o rótulo é montado com o mesmo parâmetro compartilhado. Assim a tag lê o valor de qualquer elemento que o tenha.
• O carimbo. Para mostrar um dado próprio do escritório no carimbo, como o registro do profissional no CREA ou CAU ou a disciplina, cria-se um parâmetro compartilhado, adiciona-se ao projeto na categoria Folhas e usa-se no rótulo do carimbo. Contamos isso em revisões e assinaturas no Revit para várias pranchas.

• O parâmetro não aparece na tabela. É um parâmetro de família, não compartilhado; ou não está vinculado à categoria daquela tabela.
• A tag não mostra nada. O elemento não tem esse parâmetro: sua família não o inclui ou o parâmetro de projeto não está na sua categoria.
• A tag mostra um ponto de interrogação. O parâmetro existe, mas está vazio naquele elemento.
• Dois parâmetros com o mesmo nome. Alguém criou outro com o mesmo nome em outro arquivo: tem outro GUID e o Revit os trata como dados diferentes. A tabela lê um, a tag outro, e os valores não batem.
• Não encontro o parâmetro ao carregá-lo. O Revit está apontando para outro arquivo de parâmetros compartilhados; confira o caminho em Gerenciar › Parâmetros compartilhados.
• Instância ou tipo trocado. Se o valor deve mudar em cada elemento e foi criado como de tipo, ao mudá-lo mudam todos do mesmo tipo.

• Um responsável pelo arquivo mestre, e um registro de cada parâmetro novo: para que serve, quem pediu, em que categorias vai.
• Templates com os parâmetros já carregados, para que cada projeto comece igual.
• Famílias revisadas antes de entrar na biblioteca: que usem os parâmetros do arquivo mestre e não cópias.
• Auditorias periódicas dos projetos para encontrar parâmetros duplicados ou órfãos. É parte do que revisa uma auditoria BIM.

• Carregar os parâmetros do escritório em lote, em muitos projetos e famílias de uma vez, com suas categorias e grupos.
• Detectar duplicados: o mesmo nome com GUID diferente, em todos os modelos de um projeto.
• Preencher valores pelo Excel e devolvê-los, sem passar por cada elemento.
• Revisar famílias antes que entrem na biblioteca.

O núcleo, com a API do Revit, é curto:

// Adiciona um parâmetro compartilhado de texto à categoria Folhas
DefinitionFile arquivo = app.OpenSharedParameterFile();
DefinitionGroup grupo = arquivo.Groups.get_Item("Pranchas") ?? arquivo.Groups.Create("Pranchas");
Definition def = grupo.Definitions.get_Item("ESC_Registro")
    ?? grupo.Definitions.Create(new ExternalDefinitionCreationOptions("ESC_Registro", 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 compartilhado"))
{
    t.Start();
    doc.ParameterBindings.Insert(def, app.Create.NewInstanceBinding(categorias), GroupTypeId.IdentityData);
    t.Commit();
}

Se você quer entender as APIs da Autodesk desde o início, veja desenvolvimento de add-ins para Revit e Civil 3D.