Property Sets

O que faz

Um property set (conjunto de propriedades) é um pacote nomeado de campos que se anexa a uma entidade do desenho: pset.seguranca.defensa.corpo com as propriedades def.comprimento, def.material, e assim por diante. É a maneira de o projeto guardar, na própria entidade, o que a geometria não diz.

O assunto tem duas metades, e quase toda dúvida vem de confundi-las:

Os dois armazenamentos do dado

O CapCad grava o valor em dois lugares, com papéis diferentes:

• CapPset — o registro portátil. Um registro por entidade, guardado num Xrecord no dicionário de extensão da entidade. É um objeto DWG comum: não exige Object Enabler, não vira proxy, e AutoCAD puro, GstarCAD, ZWCAD, BricsCAD e ARES Commander o preservam ao abrir e salvar. É a fonte da verdade do CapCad.
• O property set nativo (AEC). Só existe sob um vertical da Autodesk. Quando o Civil 3D é o programa hospedeiro, o espelho é obrigatório: toda gravação do CapCad é repetida no conjunto nativo, resolvendo o identificador estável para o nome de exibição do estilo. Fora do Civil 3D o espelho simplesmente não existe e só o registro portátil é escrito.

O que sustenta os dois é o identificador estável. Cada conjunto e cada propriedade do estilo tem um var (interno, pontuado, minúsculo — pset.vertical.placa, def.comprimento) e um name (o nome que aparece no CAD, sem pontos — PSET-VERTICAL-PLACA, COMP). O CapPset guarda sempre o var; o name é assunto do espelho nativo. Um estilo com a marca do DNIT e outro com a marca da concessionária podem batizar o mesmo campo de maneiras diferentes: como o var é o mesmo, a migração entre eles funciona e o dado gravado continua legível.

Fluxo de trabalho

1. Defina os conjuntos no estilo. Aba Property Sets do Editor de estilos: o var de cada conjunto, o nome que ele terá no CAD, e a lista de propriedades com tipo e valor padrão.
2. Instale as definições no desenho. CAPCAD_PSET_MANAGER › aba Instalar, ou CAPCAD_PSET_INSTALL na linha de comando. Sem esse passo o Civil 3D não tem onde pendurar os valores nativos.
3. Anexe os conjuntos às entidades. Pelo editor por entidade (CAPCAD_PSET_EDIT), pelo botão Attach all to entity do formulário de utilidades do Civil 3D, ou automaticamente, quando um comando do CapCad desenha o elemento.
4. Preencha os valores. No mesmo editor, ou por CAPCAD_PSET_VALUE_SET quando outro programa está comandando.
5. Confira. CAPCAD_PSET_LIST para uma entidade; a aba QA do gerenciador para o desenho inteiro contra o estilo.
6. Entregue. Aba Exportar (CSV por conjunto) ou aba IFC.

Os comandos

CAPCAD_PSET_MANAGER — o gerenciador

Abre o formulário CapCad Property Sets, não modal, com sete abas que cobrem toda a operação do lado das definições. Uma única janela é reaproveitada: rodar o comando de novo traz a janela existente para a frente em vez de empilhar cópias. Só existe no Civil 3D.

CAPCAD_PSET_INSTALL — instalar as definições no desenho

Pergunta CapStyle path: e cria, no dicionário de definições de property set do desenho, um conjunto para cada entrada da seção Property Sets do estilo, usando o name (não o var) como identificador do lado do CAD. Ao final informa X created, Y updated, Z failed.

Quando já existe um conjunto com aquele nome, o comando sincroniza a definição existente com o estilo: acrescenta as propriedades que faltam e remove as que não estão mais no estilo. A remoção é destrutiva — os valores gravados nas propriedades removidas se perdem. Se você renomeou uma propriedade e quer preservar os valores, rode a migração antes da instalação.

CAPCAD_PSET_MIGRATE — migrar de um estilo para outro

Pergunta Source capstyle path:, Target capstyle path: e Detach source PSets after migration? (padrão No). Percorre todos os layouts — model space e cada layout de papel, não só o model — e, em cada entidade, pareia os conjuntos do estilo de origem com os do estilo de destino pelo var, copiando valor a valor. Ao final: Migration complete — X migrated, Y skipped, Z errors.

O var é a única ponte. Conjuntos ou propriedades cujos var não casem não são pareados e ficam para trás. Renomear uma propriedade dentro do mesmo conjunto pede três passos, nesta ordem: instalar (para criar a propriedade nova), migrar (para copiar os valores para ela) e instalar de novo (para remover a órfã).

Diferentemente da instalação, a migração só aceita arquivos .capstyle locais: um nome de estilo na nuvem é reportado como File not found.

CAPCAD_PSET_ATTACH — anexar um conjunto (canal de automação)

Pergunta Handle|PropSet: e espera dois parâmetros separados por |: o identificador (handle) da entidade e o conjunto. Valores com espaço podem vir entre aspas. Se não vierem exatamente dois parâmetros, ou se o handle não existir no desenho, o comando avisa e para.

O conjunto pode ser dado pelo var ou pelo nome de exibição: o comando o canonicaliza para o var do estilo ativo antes de gravar, e um nome desconhecido passa adiante tal como veio. O anexo semeia os valores padrão do estilo, como faz o anexo nativo. Grava sempre o registro portátil e, no Civil 3D, também o conjunto nativo.

Este comando existe para ser chamado por outro programa, não digitado à mão — no editor por entidade o mesmo trabalho é um clique.

CAPCAD_PSET_VALUE_SET — gravar um valor (canal de automação)

Pergunta Handle|PropSet|PropName|PropValue:, com quatro parâmetros separados por |. Anexa o conjunto se ele ainda não estiver na entidade e grava o valor. Conjunto e propriedade também são canonicalizados para os seus var. Um valor vazio faz o comando sair sem gravar nada.

CAPCAD_PSET_EDIT — o editor por entidade

O substituto do CapCad para a paleta de dados estendidos: pede Select entity:, abre uma janela modal com uma linha por propriedade e, ao salvar, grava o registro portátil e repete cada valor no conjunto nativo quando o hospedeiro é o Civil 3D. A linha de comando confirma: CapPset saved: N set(s) on <handle>.

CAPCAD_PSET_LIST — listar os conjuntos de uma entidade

Pede uma entidade e escreve na linha de comando, para cada conjunto anexado, uma linha por propriedade no formato id, tipo, nome = valor.

Atenção. Este comando lê apenas os property sets nativos do Civil 3D. Ele não enxerga o registro portátil do CapCad: numa entidade cujos dados só existam no CapPset, ele não escreve nada. Para ver o que está realmente gravado, use CAPCAD_PSET_EDIT.

O formulário do gerenciador

O CapCad Property Sets só pode ser aberto no Civil 3D, por isso não há captura dele aqui. Esta seção descreve a janela em texto.

No alto, fixos em todas as abas: o rótulo Desenho ativo:, que se atualiza sempre que a janela recebe o foco (o Civil 3D deixa trocar de desenho com o formulário aberto), e o botão Editor de estilos.... Embaixo, também fixos, uma caixa de log que espelha tudo o que os serviços escrevem na linha de comando e uma barra de status com o resumo da última operação.

O editor por entidade

Também não há captura dele aqui.

Uma grade de três colunas — Pset, Property, Value —, uma linha por propriedade, agrupadas pelo conjunto. Embaixo, a lista Pset com o vocabulário do estilo ativo (aceita digitação de um valor fora da lista), uma segunda lista com as propriedades do conjunto escolhido, e três botões:

Salvar grava o registro portátil na entidade e, no Civil 3D, repete cada valor no conjunto nativo. Antes de gravar, tudo o que estiver digitado como nome de exibição é convertido para o var correspondente. Uma linha com o conjunto preenchido e a propriedade em branco vale como "conjunto anexado sem valores". Cancelar descarta tudo.

O vocabulário do estilo

O Editor de estilos oferece nove categorias canônicas de conjunto, cada uma ligada a um catálogo de colunas do CapCad, que é de onde vêm as propriedades sugeridas:

Os prefixos pos., cad., sys., eixo. e metodo_ valem em qualquer catálogo. Conjuntos fora desta lista são aceitos: entram como categoria personalizada.

Tipos de propriedade

O estilo aceita nove tipos: text, real, integer, km, area, geographic, geographic_pair, datetime e filepath. Na instalação, o Civil 3D só conhece três — integer vira Integer, real vira Real e todo o resto vira Text. A distinção não se perde, porém: ela continua no estilo, e é ela que a exportação IFC usa para tipar cada propriedade (km em metros como IfcLengthMeasure, area como IfcAreaMeasure, e assim por diante; um valor numérico que não converta — uma estaca no formato 0+000, por exemplo — vira rótulo de texto, nunca um número inventado).

Regras de nome

O nome de exibição é validado antes de ir para o CAD, porque o Civil 3D rejeita nomes malformados com um erro sem explicação. Ele precisa ser não vazio, ter no máximo 256 caracteres para um conjunto e 64 para uma propriedade, não começar por algarismo, e usar apenas letras, algarismos, _ e -. Espaços e pontos são recusados — é por isso que o name não pode ser igual ao var.

Lembrado entre sessões

O gerenciador lembra o último caminho usado em cada aba, a direção da ressincronização e o estado das caixas de simulação e de checagem de entidades. Tudo é gravado ao fechar a janela.

O campo da aba Instalar é a exceção: ele é preenchido, a cada abertura, com o estilo ativo do desenho — resolvido na ordem de sempre (configuração do projeto, eixo, registro do desenho, capcad.default) — e não com o último caminho usado.

Notas

• O registro portátil viaja com a entidade. Copiar, colar ou dar WBLOCK leva o Xrecord junto. O que não viaja é o contexto do estilo: como os valores são gravados por var e são autocontidos, continuam legíveis no desenho de destino, mas a associação com as definições vem do estilo ativo de lá.
• Apagar todo o dado apaga o registro. Salvar uma entidade sem nenhum conjunto remove o Xrecord, em vez de deixar um registro vazio.
• CAPCAD_XDATA_CLEAN não limpa os property sets. Aquele comando apaga o XData da entidade; o CapPset mora no dicionário de extensão, que é outro lugar. Veja Entidades, grupos e diagnóstico.
• A instalação sincroniza removendo. Vale repetir: instalar um estilo que perdeu uma propriedade apaga essa propriedade das definições do desenho, e com ela os valores gravados. Migre antes.
• Nesta versão, os comandos de dado existem só no AutoCAD. CAPCAD_PSET_EDIT, CAPCAD_PSET_ATTACH e CAPCAD_PSET_VALUE_SET existem apenas no CapCad para AutoCAD e Civil 3D. Em BricsCAD, GstarCAD, ZWCAD e ARES Commander o registro portátil continua sendo lido e preservado nos desenhos, mas não há comando para criá-lo ou editá-lo.
• O botão Editor de estilos... do gerenciador abre o editor nos cinco CADs.
• Os dois caminhos vindos do Editor de estilos só funcionam sob o Civil 3D. CAPCAD_PSET_MANAGER e CAPCAD_PSET_INSTALL só existem no Civil 3D. Em BricsCAD, GstarCAD, ZWCAD e ARES o botão avisa que é recurso de Civil 3D; no AutoCAD puro os dois botões não estão disponíveis.
• Desenhos de versões anteriores são lidos normalmente. Os property sets deles são lidos como estão e, na gravação seguinte, reescritos na forma atual.
• As mensagens do gerenciador e do editor aparecem em inglês no produto em português, assim como os títulos das duas janelas e alguns textos de apoio das abas Ressincronizar e IFC.
• CAPCAD_PSET_EDIT exige licença. Os demais comandos desta página não exigem.