Transfer Parameters – Compor e reescrever valores de parâmetros
O Transfer Parameters permite que os usuários construam ou reescrevam valores de parâmetros a partir de outros parâmetros do modelo. É útil para padronizar nomes, códigos e texto composto sem editar os elementos um a um.
Descrição geral
O add-in trabalha com uma categoria selecionada, parâmetros de origem, um parâmetro de destino e uma estrutura de composição. Ele pode ser executado em todo o modelo, na vista ativa, em uma seleção manual ou em fluxos de trabalho de armadura baseados no host, e oferece suporte a modos como wrap, replace e regex.
Principais recursos
- Seleção de categoria: Limita o processamento ao tipo de elemento necessário.
- Parâmetros de origem e destino: Lê de um ou mais parâmetros de origem e escreve o resultado composto em um parâmetro de destino. A lista de parâmetros de origem tem uma caixa de pesquisa para filtrar por nome quando a categoria tem muitos parâmetros.
- Tabela Data Structure: Construa o texto de saída a partir de uma lista reordenável de entradas, cada uma com o próprio Prefixo, Parâmetro e Sufixo; reordene com mover para cima/baixo ou descarte uma entrada com Remove parameter.
- Modos de transformação: Wrap (compor a partir da tabela Data Structure como está), Replace (Localizar / Substituir Por simples, com uma opção Case Sensitive) e Regex (Localizar / Substituir Por com expressão regular).
- Quatro modos de seleção: All elements of the model, All elements in the view, Manual selection ou Reinforcements by concrete (encontra as armaduras suportadas nos elementos de concreto selecionados).
Requisitos
- O parâmetro de destino deve existir e ser gravável nos elementos do escopo.
Procedimento de uso
- Abra o Transfer Parameters no painel Model da faixa de opções do Frata.
- Em Select Category, escolha a categoria de elementos com a qual trabalhar.
- Defina os Source Parameter(s) e o Destination Parameter. Digite na caixa de pesquisa acima da lista de parâmetros de origem para filtrá-la por nome.
- Construa a Data Structure: adicione entradas com Prefix, Parameter e Suffix, e reordene-as com os controles de mover para cima/baixo até que o texto composto fique correto.
- Escolha um modo de transformação se precisar de algo além da composição direta: Replace para uma passada literal de encontrar/substituir (com Case Sensitive se necessário), ou Regex para localizar/substituir baseado em padrão.
- Em Selection Mode, escolha All elements of the model, All elements in the view, Manual selection ou Reinforcements by concrete.
- Pressione Execute para gravar o valor composto no Destination Parameter no escopo escolhido.
Recomendações
- Use Manual selection ou All elements in the view para testar a composição em alguns elementos antes de executá-la em todo o modelo.
- Reinforcements by concrete é o atalho quando você deseja gravar em parâmetros de armadura com base nos dados do host (por exemplo, copiar a marca ou o nível do host em cada barra suportada por ele) em vez de selecionar a armadura diretamente.
- O modo Regex é poderoso, mas implacável — teste-o primeiro em uma pequena seleção, pois um padrão inválido pode produzir um resultado inesperado em cada elemento do escopo.
Perguntas frequentes
Qual é a diferença entre os modos Wrap, Replace e Regex? O Wrap apenas compõe as entradas da Data Structure (prefixo + parâmetro + sufixo, em ordem) no valor de destino. O Replace executa adicionalmente uma passada literal de encontrar/substituir sobre esse texto composto. O Regex executa uma localização/substituição com expressão regular em vez de uma literal.
O que "Reinforcements by concrete" realmente seleciona? Permite escolher elementos host de concreto e, em seguida, opera sobre as armaduras suportadas por eles — útil para transferir dados do nível do host (como uma marca ou nível) para cada barra daquele host sem selecionar as barras individualmente.
Posso usar mais de um parâmetro de origem no valor composto? Sim — adicione várias entradas à tabela Data Structure, cada uma referenciando seu próprio parâmetro com seu próprio prefixo/sufixo, e reordene-as para controlar a sequência final.
O Case Sensitive afeta também o modo Regex, ou apenas o Replace? Ele se aplica à correspondência do texto Procurar em geral — para o comportamento exato no modo Regex, teste com uma amostra antes de executar no escopo completo, pois o tratamento de maiúsculas/minúsculas em regex pode se comportar de forma diferente de uma substituição literal.