Sobre a Automação do Excel

Este recurso permite gerar desenhos esquemáticos automaticamente a partir de dados contidos em um arquivo Excel. Esse arquivo deve ter um formato específico para ser importado no SOLIDWORKS Electrical.

Iniciantes podem encontrar dificuldades para implementar este recurso. Para ajudá-lo, você pode fazer o download de um exemplo, no final deste capítulo.

Compatibilidade

O recurso de Automação do Excel é compatível somente com o Excel 2016 e 365, com a edição de 64 bits.

Definição de macro

O recurso de Automação de XLS utiliza apenas as macros esquemáticas; as outras não estão disponíveis e não devem ser utilizadas. Essas macros são específicas e devem incluir estas duas regras: variáveis e ponto de inserção.

Item Descrição
Ponto de inserção As macros são inseridas automaticamente no desenho e devem ter um ponto de inserção específico. No recurso de ponto de inserção, clique no ponto onde deseja que a macro seja inserida. Você terá que inserir as coordenadas desse ponto no arquivo XLS.
Definição de variável A macro contém variáveis que propaga informações no esquema. Essas variáveis serão substituídas por textos que você configurará no arquivo XLS. As variáveis devem ser formatadas com o caractere "%" colocado antes e depois da variável. Por exemplo, %VAR1%, na qual o nome da variável é "VAR1". O texto utilizado na variável é gratuito, mas ele pode ser o mesmo na macro e no arquivo XLS.

É possível utilizar variáveis para substituir:

  • Todos os objetos com uma marca (como componentes, localizações ou desenhos): Para gerenciar as marcas (localização, função ou componente), edite a macro no Gerenciamento de macros e substitua a marca pela variável. Por exemplo, se a macro contém um contato, marcado como K1, substitua essa marca pela variável %COMPMARK1%. Da mesma forma, usando o Gerenciamento de localização, você pode substituir a marca da localização por uma variável, como %LOCMARK1% e atribuir esta localização a um componente.
  • Peças do fabricante: Com relação à peça do fabricante, associe o componente a uma peça do fabricante em que você insere as variáveis no nome do fabricante (por exemplo: %MANUFACTURER1%) e para a referência da peça do fabricante (por exemplo: %MANUFPART1%).
  • Contador de equipotenciais: Para utilizar variáveis no contador de equipotenciais, edite o contador de equipotenciais do fio e substitua-o por uma variável, como %EQUIP1%.
  • Nomes do estilo de fio: Para utilizar variáveis no nome do estilo de fio, abra o Gerenciamento de estilos de fios. Nas propriedades do estilo de fio, substitua o nome do estilo de fio pela variável (por exemplo: %WireStyle1%).
  • Dados traduzíveis e dados do usuário: as variáveis podem ser utilizadas também na descrição, nos dados do usuário ou nos dados traduzíveis de qualquer objeto que tenha uma marca (por exemplo: %TransData_1_ES% para os primeiros dados traduzíveis em espanhol).

Definição do arquivo Excel

Vários arquivos Excel de modelo são entregues com o SOLIDWORKS Electrical para ajudar você a criar seus próprios arquivos Excel. Eles são armazenados na pasta \XlsAutomation\Template dos dados do SOLIDWORKS Electrical.

Para criar um novo arquivo Excel para automação, clique em Importar/Exportar > Automação do Excel > Criar novo arquivo Excel para automação .

O arquivo Excel pode ser da versão 97/2003 (.xls), até o formato 2013 (.xlsx) ou xlsm (arquivo Excel com macros). Apenas a primeira planilha visível do arquivo será processada; as demais serão ignoradas. Não há restrições sobre o nome da planilha.

O arquivo Excel deve conter instruções específicas para ser utilizado para realizar a Automação do Excel. Ele pode ter o número de linhas antes do cabeçalho que o usuário desejar. O processo lê a primeira linha com a primeira cadeia de caracteres que começa com o caractere "#". Essa é a linha de cabeçalho.

A linha de cabeçalho deve ter dois tipos de informações: nome do campo (#field) e nome da variável (%variable%).

É possível gerenciar vários idiomas no cabeçalho do arquivo. Insira uma coluna utilizando o campo #title_lang para identificar os textos que descrevem os idiomas diferentes.

Itens Descrição
Nomes de campo Para identificar um nome do campo, observe que ele deve começar com o caractere "#". Em geral, o nome do campo corresponde ao nome do campo do banco de dados. Por exemplo, "#fil_title" corresponde à marca do desenho em que a macro será inserida. Alguns desses campos são necessários para obter um resultado consistente.

Os nomes dos primeiros campos que você deve gerenciar correspondem ao nome e às posições da macro.

Tabela 1. Macro
Nome do campo Descrição Obrigatório
#mac_name Nome da macro Sim
#mac_posx A coordenada X na qual a macro será inserida Sim
#mac_posy A coordenada Y na qual a macro será inserida Sim
#mac_insert Se esta coluna estiver presente, não oculta e contiver um 0 ou estiver vazia, a macro não será processada. Não

Quanto aos outros campos do banco de dados, o SOLIDWORKS Electrical só aceita campos de tabelas de desenho ("fil"), pacotes ("bun"), locais ("loc") e funções ("fun").

O único campo obrigatório é o #fil_title, que é o título do desenho no qual a macro será inserida. Mas, se você inserir qualquer outro campo, como livro, localização ou função, a referência da tabela correspondente será obrigatória. Por exemplo, se você inserir qualquer campo de localização, o campo #loc_text será obrigatório.

Os campos compatíveis são exibidos na tabela a seguir:
Tabela 2. Desenhos
Nome do campo Descrição Obrigatório
#fil_filename Nome do arquivo no disco Não
#fil_title A marca do desenho Sim
#fil_filetype O tipo de desenho (*) Não
#fil.tra_0.xx A descrição do desenho, onde xx é o código de idioma Não
#fil.use_data0 Os dados do usuário do desenho Não
(*) Os valores compatíveis para o tipo de arquivo são:
  • 0: Desenho esquemático
  • 1: Desenho de diagrama de linha
  • 5: Capa
  • 9: Desenho do layout do painel
  • 12: Desenho de esquema misto
Tabela 3. Livros
Nome do campo Descrição Obrigatório
#bun_tag A marca do livro Sim (se qualquer livro for usado)
#bun.tra_0.xx A descrição do livro, onde xx é o código de idioma Não
Tabela 4. Pastas
Nome do campo Descrição Obrigatório
#fol_name A marca da pasta Não (se alguma pasta for usada)
#fol.tra_0.xx A descrição da pasta, onde xx é o código de idioma Não
Tabela 5. Localizações
Nome do campo Descrição Obrigatório
#loc_text A marca da localização Sim (se qualquer localização for utilizada)
#loc_tagpath Caminho da marca (marca completa) Não
#loc_tagroot Marca de raiz Não
#loc.tra_0.xx Descrição da localização, onde xx é o código de idioma Não
Tabela 6. Funções
Nome do campo Descrição Obrigatório
#fun_text A marca da função Sim (se alguma função for utilizada)
#fun_tagpath Caminho da marca (marca completa) Não
#fun_tagroot Marca de raiz Não
#fun.tra_0.xx Descrição da função, onde xx é o código de idioma Não

Os dados do usuário e os dados traduzíveis também podem ser adicionados como um campo, mas, como eles não estão diretamente na tabela do objeto, sua definição é um pouco diferente.

Ele é formatado da seguinte maneira para dados traduzíveis: #ttt.tra_nn.xx

Em que
  • ttt: é substituído pelo prefixo da tabela (fil, bun, loc e fun).
  • tra: serve para dados traduzíveis (não modifique).
  • nn: é substituído pelo índice de dados necessário (0 para a descrição). Até 14 para dados traduzíveis.
  • .xx: deve ser substituído pelo código do idioma, usually.l1 (L1) para o principal idioma do projeto elétrico. Os códigos de idiomas compatíveis são:
    • De idiomas do projeto elétrico (L + 1 a 3): "l1", "l2", "l3"
    • Código padrão do idioma: en, es, fr, it, ru, ko, ja, pt..., zh, zh-tw

Por exemplo, para a descrição do arquivo no idioma principal do projeto elétrico: #fil.tra_0.l1

Para dados do usuário, a sintaxe é similar, mas não especificada para o idioma: #ttt.use_datann

Em que
  • ttt: deve ser substituído pelo prefixo da tabela (fil, bun, loc e fun).
  • use_data: serve para dados do usuário (não modifique).
  • nn: deve ser substituído pelo índice de dados necessário, de 0 a 19 para dados do usuário.

Exemplo, para dados do usuário do arquivo: #fil.use_data0

Variáveis Depois de especificar todos os dados, você precisa indicar onde inserir as macros (desenho, livro, localização e função) e você deve especificar as variáveis que deseja que sejam substituídas pelos seus valores. Para fazer isso, você pode utilizar dois métodos.

O primeiro método consiste em escrever na primeira coluna disponível do cabeçalho, a referência "#mac_var_name" e, na coluna seguinte "#mac_var_value", e consecutivamente, quantos pares de colunas você precisar. Depois disso, para cada linha (para cada macro que deseja inserir), você escreverá, na primeira coluna, o nome da variável e, na segunda coluna, o valor dessa variável. Por exemplo:

#mac_name #mac_var_name #mac_var_value #mac_var_name #mac_var_value
Test0 %motor1% M5 %motor2% M6
Neste caso, você insere a macro Test0, a variável %motor1% é alterada para M5 e a variável %motor2% é alterada para M6.

O segundo método é melhor caso você utilize os mesmos nomes de variáveis para todos as macros. Nesse método, você especifica o nome da variável no cabeçalho, por exemplo, %VAR1%, e nas diferentes linhas, o valor que tal variável possui para a macro inserida. Por exemplo:

#mac_name %var1% %var2%
Test0 M5 M6
Test1 V3 V4
Nesse caso, a primeira linha insere a macro Test0, altera a variável %var1% para M5 e %var2% para M6 e, na segunda linha, a macro Test1 é inserida, com a variável %var1% sendo alterada para V3 e a variável %var2% sendo alterada para V4.
Os nomes das variáveis não diferem maiúsculas e minúsculas.
Utilização da fórmula com variáveis É possível utilizar uma fórmula para gerar o valor automaticamente durante a geração automática do desenho. A fórmula será identificada por dois caracteres "{ }", um no início "{" e o outro no final "}". O conteúdo entre esses dois caracteres será uma fórmula que pode ser como qualquer fórmula do software. As variáveis na fórmula devem ser formatadas da mesma forma que uma fórmula no arquivo Excel (%VARIABLE%).

Por exemplo, defina a marca de um componente com este valor: {"PP_" + %VARIABLE% + "RR" + %VARIABLE2%}

Ao inserir a macro 2 vezes, por meio de geração do Excel, o resultado será PP_33RR12 na primeira vez e PP_33RR13 na segunda vez.

Se, no arquivo Excel, houver duas linhas com:

%VARIABLE% definida como 33 e %VARIABLE2% definida como 12

%VARIABLE% definida como 33 e %VARIABLE2% definida como 13

Gerenciar a seção de fio Na caixa de diálogo Propriedades do fio da macro, insira a variável %SECTION% para o campo Seção ou calibre. No Excel, você pode adicionar uma coluna %SECTION% opcional e inserir o valor do tamanho do fio.
Fios de conexão automática Para usar essa opção, você deve selecionar o parâmetro Macros de conexão automática na guia Geral na configuração do projeto elétrico.

Quando você usa a Automação do Excel para criar esquemas, pode conectar automaticamente os fios ou símbolos entre o esquema existente e a macro inserida.

Os elementos que você deseja vincular devem estar alinhados. Você pode conectar fios a símbolos ou fios a fios.

Gerenciar setas de origem-destino Considere duas macros com uma seta de origem posicionada em uma macro e uma seta de destino posicionada na outra macro. Ao optar por inserir essas duas macros usando a automação do Excel, é possível estabelecer a conexão entre as setas de origem e destino nas duas macros.

Nas macros, insira os símbolos de origem ou destino nos quais você insere a mesma variável (por exemplo: %Group1%) como o nome do grupo.

No arquivo Excel, adicione uma coluna usando essa variável. Nesta coluna, insira o nome do grupo. Todos os símbolos com o mesmo nome do grupo serão associados automaticamente.

Substituir um símbolo ao inserir uma macro Considere um símbolo inserido em uma macro. Ao inserir essa macro da automação do Excel, é possível substituir esse símbolo.

Edite a macro e abra as propriedades do símbolo. Insira a variável, por exemplo: %SYMBOL_NAME%no campo Variável de automação do Excel.

No arquivo Excel, adicione uma coluna usando a variável (%SYMBOL_NAME% em nosso exemplo). Nesta coluna, insira o nome do símbolo que deseja usar.

#mac_name %SYMBOL_NAME%
Test0 TR-EL002
Test0 TR-EL035
Neste exemplo, insira a macro Test0, uma primeira vez com o símbolo TR-EL002 e uma segunda vez com o símbolo TR-EL035, mesmo que outro símbolo tenha sido definido na macro Test0.

Instalar o suplemento do Excel

Para ajudá-lo a criar o arquivo do Excel, você pode usar um suplemento. Para instalá-lo, clique em Importar/Exportar > Instalar suplemento do Excel .

O programa de instalação do suplemento do Excel inicia automaticamente. Caso não inicie, selecione o arquivo EwExcelAddIn.vsto.

Geração automática de desenhos

Após criar o arquivo Excel, você pode importá-lo no SOLIDWORKS Electrical para gerar os desenhos automaticamente. Clique em Importar/exportar > Automação do Excel .

Uma caixa de diálogo de seleção do arquivo será aberta, permitindo que você selecione o arquivo Excel. Os livros, pastas e desenhos são criados automaticamente, as macros são inseridas nestes desenhos e as variáveis são substituídas pelos valores.

O SOLIDWORKS Electrical não verifica se os desenhos existem ou se eles contêm outras entidades elétricas. Neste caso, as macros serão inseridas independentemente das entidades existentes no desenho.

Uma caixa de diálogo de relatório é aberta para exibir o resultado da importação.