MasterTool: Como exportar e importar GVLs por meio de Scripts em Python

Neste tutorial, você irá aprender a exportar e importar variáveis criadas em uma GVL por meio de scripts em Python.

Componentes:

Software: MasterTool 3.50 ou superior

Seções do Tutorial:

1. INTRODUÇÃO

2. SCRIPTS

     2.1 Script de Exportação de GVL

     2.2 Script de Importação de GVL

1. INTRODUÇÃO

A função de Scripts em Python foi adicionada nas versões de MasterTool IEC XE 3.50 e superiores, e fornece uma maior liberdade de controle do seu projeto e CLP. Neste tutorial, iremos mostrar um exemplo de scripts em Python com a função de exportar e importar GVLs, facilitando a transferência das variáveis entre projetos.

Caso tenha mais interesse em Python, você pode encontrar mais informações neste post no nosso blog: Aplicação de Python na indústria: lógica de controle para automação inteligente.

Em anexo no final desta página do tutorial, você pode encontrar os dois arquivos ExportGVLToCSV.py e ImportGVLFromCSV.py.

O código foi desenvolvido com o intuito de facilitar o uso, sem necessidade de ter o conhecimento de lógica de programação e da sintaxe de Python. Por isso, iremos apenas demonstrar o seu uso e funcionamento.

A função criada para este tutorial é simples e poderia ser feita de outras formas como copiar e colar, mas serve para dar um exemplo de funcionamento de Scripts em Python. Caso tenha o interesse e o conhecimento, você pode utilizar estes códigos como inspiração para realizar diversas funções além dessa.

2. SCRIPTS

2.1 Script de Exportação de GVL

O script ExportGVLToCSV.py serve para exportar as variáveis declaradas em uma GVL para um arquivo CSV. 

Para demonstrar isso, vamos criar um projeto uma GVL que chamaremos de GVL_Tutorial_1.

Nesta GVL, vamos declarar algumas variávais para demonstrar o funcionamento da exportação.

Após fazer o download dos arquivos Python em anexo neste tutorial, que você pode encontrar no fim desta página, iremos abrir a aba Ferramentas, clicar em Scripting e em Executar Arquivo de Script.

Na tela do explorer aberta, vamos selecionar o arquivo de script desejado, ExportGVLToCSV.py, e apertar em Abrir.

Este é o processo padrão de rodar qualquer script!

Após abrir o arquivo de script, uma tela de dialog será aberta solicitando que você informe o nome da GVL que deseja exportar.

Como criamos a GVL GVL_Tutorial_1, estaremos digitando o seu nome na caixa de texto e apertando em OK.

Após digitar o nome da GVL e apertar em OK, uma nova tela de Dialog é aberta, agora solicitando que o usuário digite o caminho desejado para exportar o arquivo CSV com as variáveis da GVL que indicamos anteriormente. O programa já escreve um caminho padrão para facilitar o processo para o usuário. Caso deseje outro endereço ou outro nome de arquivo, você pode alterar na caixa de texto e apertar em OK.

Por último, uma caixa de diálogo é aberto para confirmar os valores indicados pelo usuário. Caso realmente sejam os valores, aperte em Sim. Caso deseje alterar algum deles, aperte em Não e digite novamente.

Apertando em Sim, se a GVL for exportada com sucesso, você verá um aviso de sucesso!

Após exportar a GVL, podemos observar na pasta do caminho que o arquivo foi gerado.

Abrindo o arquivo, vemos as nossas variáveis declaradas na GVL.

2.2 Script de Importação de GVL

O script ImportGVLFromCSV.py serve para importar as variáveis de uma GVL exportada pelo script ExportGVLToCSV.py mostrado anteriormente.

Para demonstrar o seu funcionamento, vamos criar um novo projeto, e declarar uma GVL para receber as variáveis da importação.

Deixaremos a GVL vazia, sem declarar nenhuma variável manualmente, pois as importaremos pelo script.

Novamente, após criar a GVL, vamos ir em Ferramentas -> Scripting -> Executar Arquivo de Script.

E desta vez, selecionaremos o arquivo ImportGVLFromCSV.py apertaremos em Abrir

Após rodar o script, a primeira caixa de diálogo solicita que o usuário informe o nome da GVL na qual você deseja importar as variáveis. Importante notar que este nome não se refere à GVL da exportação, e sim à GVL do projeto novo, onde você quer importar as variáveis, e não precisa possuir o mesmo nome. Nesse caso, como criamos a GVL_Tutorial_2, digitaremos esse nome e clicaremos em OK.

Após indicar a GVL, o usuário terá que indicar o caminho na qual o arquivo CSV se encontra. Caso o endereço seja diferente do padrão, digite-o na caixa de texto abaixo. Após garantir que o arquivo se encontra no caminho indicado, aperte em OK.

Por último, o programa irá novamente solicitar que você confirme os valores digitados. Caso estejam errados, aperte em Não e os digite novamente. Caso estejam certos, aperte Sim.

Se houver um sucesso na importação, você receberá a mensagem de sucesso.

Após importação, podemos encontrar as variáveis importadas pelo script na nossa GVL indicada.

Com isso, você está capacitado a exportar e importar GVLs utilizando scripts em Python.