Exportar e importar variáveis
No software de edição de tela, você pode executar a exportação e importação de variáveis globais usando a barra de ferramentas do editor de variáveis. A propriedade de um alarme e de registro estão incluídos no item de exportação. A exportação e importação de variáveis locais não é suportada.
- Embora você possa importar dados exportados como arquivos CSV ou TXT a partir do software de edição de tela versão 3.3 Service Pack 1 ou anterior para o software de edição de tela versão 3.4 ou posterior, os arquivos exportados da versão 3.4 ou posterior não podem ser importados para a versão 3.3 Service Pack 1 ou anterior, pois a versão do arquivo é 2.0.
Verifique a versão do arquivo de saídas CSV ou TXT na linha [FileVersion] do arquivo de saída. - Os arquivos Excel são suportados para exportação e importação de variáveis a partir da versão 4.4.
Os seguintes formatos de arquivo são suportados para importar e exportar variáveis:
- Arquivo TXT (.txt, UTF-8 (sem BOM))
- Arquivo CSV (.csv, UTF-8 (sem BOM))
- Arquivo Microsoft Excel (.xlsx)
Arquivo Microsoft Excel
- Para exportar e importar variáveis em arquivos do Excel, é necessário o Microsoft Excel. O software de edição de tela é compatível com o Microsoft Excel 2016, 2019 e 365.
- Ao exportar variáveis para um arquivo do Excel, você pode definir uma senha para criptografá-las. É recomendável definir uma senha complexa. Se você esquecer a senha, ela não poderá ser recuperada.
- O software de edição de tela não é compatível com o Gerenciamento de Direitos de Informação (IRM) do Excel.
Arquivo TXT ou CSV
- Ao exportar variáveis para um arquivo TXT ou CSV, selecione o delimitador.
- Arquivos TXT ou CSV salvos usando codificação diferente de UTF -8 (sem BOM) não podem ser importados.
- Para obter informações sobre formato do arquivos, consulte o seguinte.
Salvar configurações de arquivo de dados (Exportar)
Você pode ver o arquivo exportado usando programas de software como o Microsoft Excel.
A saída de dados é formatada da seguinte forma:
- As strings são encapsuladas por aspas duplas (").
Por exemplo, "Isto é uma string" - Os caracteres especiais "=", "+", "-", "@", TAB e ENTER que aparecem no início de uma entrada são prefixados com aspas simples (').
Por exemplo, "'=1+2"
Notas sobre Importando variáveis
- Ao importar, se não existir uma taxa de digitalização com o mesmo nome, então uma nova taxa de digitalização é criada com o intervalo do arquivo exportado. Se a taxa de digitalização já existe no projeto, a taxa de digitalização é atualizada.
- Se você importar um arquivo exportado do software de edição de tela versão 3.1 Service Pack 1B ou anterior, as variáveis externas receberão a taxa de digitalização padrão. Para obter informações sobre taxas de digitalização, consulte o seguinte.
Configurando o intervalo para Leitura de valores de variáveis externas (Taxa de digitalização) - As variáveis que foram importadas utilizando o arquivo de importação de símbolo não podem ser atualizadas com o comando de variável de importação. Para atualizar as variáveis no arquivo de símbolo, consulte o seguinte.
Importação de símbolos a partir de dispositivos externos - Notas após a Importação do Arquivo de símbolo - Você não pode importar variáveis para um projeto que contém um arquivo de símbolo. Para importar variáveis, siga estas etapas.
- Remover o arquivo de símbolo do projeto.
- Exportar as variáveis do projeto.
- Importar as variáveis para o projeto.
- Importar o arquivo de símbolo para o projeto.
- Existe uma convenção de nomenclatura para nomes de variáveis no software de edição de tela.
Se um nome de variável contém caracteres que não seguem a convenção de nomenclatura, a variável não será importada.
Para obter detalhes, consulte o seguinte.
Convenções de nomenclatura
Ao importar um arquivo Excel
- Ao importar um arquivo Excel protegido, você precisa digitar a senha.
- Apenas os valores são importados dos arquivos Excel. As macros e fórmulas não são recalculadas durante a importação.
- O FileVersion na planilha [Summary] é verificado durante a importação. Os outros valores de contagem são ignorados.
- O tamanho máximo de arquivo que você pode importar é 100 MB.
Formato variável
Estrutura do arquivo Excel exportado
No arquivo Excel exportado, os dados são organizados nas seguintes planilhas, cada uma contendo informações específicas:
- Summary: Visão geral de todas as variáveis exportadas.
- VariableTypes: Tipos de variáveis, como matriz ou estrutura, se presentes.
- Variables: Dados variáveis.
- ScanRates: Taxas de digitalização, se presentes.
- AlarmGroups: Todos os grupos de alarmes, mesmo que nenhum alarme esteja definido.
- Alarms: Alarmes, se presentes.
- LoggingGroups: Todos os grupos de registro, mesmo que não contenham variáveis.
- LoggingRecords: Variáveis, se presentes.
Exemplo: Variables planilha
- Você pode editar somente os dados em texto azul. Se o formato for modificado, você não poderá importar o arquivo. Todas as colunas são obrigatórias.
- As planilhas e colunas podem estar em qualquer ordem.
Estrutura do arquivo CSV exportado
Quando aberto no Excel, o arquivo CSV exportado é organizado conforme mostrado abaixo.
Você pode editar somente os dados em texto azul. Se o formato for modificado, você não poderá importar o arquivo.
Itens de exportação
Esta tabela indica uma propriedade que corresponde ao item exportado.
O item cuja propriedade não está definida, estará em branco.
Itens do arquivo Excel exportado
[VariableTypes]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Name |
[Nome] |
[Todos os tipos de dados de usuário] |
Seguindo as convenções de nomenclatura. |
| Type | [Tipo de dados] | [Todos os tipos de dados de usuário] | Seguindo o tipo de dados suportados. |
| ElementTypeName | Indica o tipo de dados do elemento de matriz ou membro da estrutura. | [Todos os tipos de dados de usuário] | Seguindo o tipo de dados suportados. |
| Dimensions | [Dimensão] | [Todos os tipos de dados de usuário] | Seguindo a faixa de suporte da propriedade. |
[Variables]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Name |
[Nome] |
[Todas as variáveis] |
Seguindo as convenções de nomenclatura. |
| FolderName | [Pasta] | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |
| DataType | [Tipo de dados] | [Todas as variáveis] | Seguindo o tipo de dados suportados. |
| Dimension | [Dimensão] | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| Source | [Origem] | [Todas as variáveis] | Não editar |
| DeviceAddress | [Endereço do dispositivo] | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| BaseAddress | [Endereço base] (Apenas quando uma Matriz ou Estrutura é selecionada.) | [Todas as variáveis] | TRUE/FALSE |
| ScanRate | [Taxa de digitalização] | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |
| InitialValue | [Valor inicial] | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| InputRange | [Faixa de entradas] | [Todas as variáveis] | TRUE/FALSE |
| Min | [Mínimo] | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| Max | [Máximo] | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| EnableVariableLength | [Tamanho da variável] | [Todas as variáveis] | TRUE/FALSE |
| NumberOfBytes/NumberOfWords | [Número de bytes] (Apenas quando uma STRING é selecionada.) / [Número de palavras] (Apenas quando um WSTRING é selecionado.) | [Todas as variáveis] | Seguindo a faixa de suporte da propriedade. |
| StringEncode | [Codificação de strings] (apenas quando selecionado dispositivo externo da [Origem].) | [Todas as variáveis] | Seguindo a codificação de suporte. |
| Retentive | [Retentivo] | [Todas as variáveis] | TRUE/FALSE |
| Value | [Valor] | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |
| BindingType | Indica o tipo de dados atribuídos. | Janela do seletor de propriedades para propriedades da variável. | Apenas o objeto que pode ser definido em uma propriedade. |
| BindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| BindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| DataSharing | [Compartilhamento de dados] | [Todas as variáveis] | None/ReadOnly/ReadWrite |
| Comments | [Comentários] | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |
[ScanRates]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Name |
[Nome] |
[Todas as Taxas de digitalização] |
Seguindo as convenções de nomenclatura. |
| Interval | [Intervalo (100 ms)] | [Todas as Taxas de digitalização] | 1 - 600 |
[AlarmGroups]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Name |
[Nome] |
[AlarmGroup] |
Seguindo as convenções de nomenclatura. |
| ***LabelType [1] | Indica a configuração do rótulo. | [AlarmGroup] | Direct/LanguageTable |
| ***Label [1] | Indica os nomes dos rótulos. | [AlarmGroup] | Seguindo a faixa de suporte da propriedade. |
| Parameter | [Parâmetro] | [AlarmGroup] | Seguindo a faixa de suporte da propriedade. |
| AlarmBehavior | [Comportamento de Alarme] | [AlarmGroup] | Optional ACK/Mandatory ACK |
1. *** refere-se a LoLo, Lo, Hi, HiHi, Active, ACK, RTNou UNACK.
[Alarms]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Variable |
[Variável] |
[Alarme de bool]/[Alarme de nível] |
Seguindo as convenções de nomenclatura. |
| AlarmGroupName | [Nome] | [AlarmGroup] | Seguindo as convenções de nomenclatura. |
| Type | [Tipo de alarme] | [Alarme de bool]/[Alarme de nível] | HiHi/Hi/Lo/LoLo |
| Condition | [Condição do trigger] (Alarme de bool) / [Valor] (Alarme de nível) | [Alarme de bool]/[Alarme de nível] | Se a propriedade estiver selecionada, exibirá TRUE para alarme Bool. O alarme de nível segue a faixa suportada pela propriedade. |
| Deadband | [Banda morta] | [Alarme de nível] | Seguindo a faixa de suporte da propriedade. |
| Severity | [Severidade] | [Alarme de bool]/[Alarme de nível] | Seguindo a faixa de suporte da propriedade. |
| Parameter | [Parâmetro] | [Alarme de bool]/[Alarme de nível] | Seguindo a faixa de suporte da propriedade. |
| MessageType | Indica a configuração de uma mensagem. | [Alarme de bool]/[Alarme de nível] | Direct/Language Table |
| Message | [Mensagem] | [Alarme de bool]/[Alarme de nível] | Seguindo a faixa de suporte da propriedade. |
[LoggingGroups]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
| Name | [Nome] | [Grupo de registro] | Seguindo as convenções de nomenclatura. |
| MaxRecord | [Registro máx] | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| ConditionType | [Tipo de condição] | [Grupo de registro] | ValueChange/Periodic/Script |
| Frequency | [Frequência] (apenas quando [Periódico] é selecionado em [Tipo de condição].) | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| Units | [Unidades] (apenas quando [Periódico] é selecionado em [Tipo de condição].) | [Grupo de registro] | Secs/Mins/Hours/100ms |
| Condition | [Condição de execução] (apenas quando [Alterar valor] é selecionado em [Tipo de condição].) | [Grupo de registro] | ON/OFF/On Change |
| TriggerVariable | [Variável de trigger] (apenas quando [Alterar valor] é selecionado em [Tipo de condição].) | [Grupo de registro] | Seguindo as convenções de nomenclatura. |
| TriggerVariableBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| InterlockType | Indica a configuração [Travar]. | [Grupo de registro] | Direct/Variable |
| Interlock | [Travar] | [Grupo de registro] | TRUE/FALSE |
| InterlockBindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| InterlockBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| ExportData | [Habilitar] | [Grupo de registro] | TRUE/FALSE |
| WriteDataTo | [Armazenamento de dados] | [Grupo de registro] | USB Storage/SD Card/Internal |
| AppendDateTime | [Acrescentar data/hora] | [Grupo de registro] | TRUE/FALSE |
| DetectModification | [Detectar modificação] | [Grupo de registro] | TRUE/FALSE |
| FolderNameType | Indica a configuração [Nome da pasta]. | [Grupo de registro] | Direct/Variable |
| FolderName | [Nome da pasta] | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| FolderNameBindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| FolderNameBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| FileNameType | Indica a configuração [Nome do arquivo]. | [Grupo de registro] | Direct/Variable |
| FileName | [Nome do arquivo] | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| FileNameBindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| FileNameBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| ExportStatus | [Habilitar] | [Grupo de registro] | TRUE/FALSE |
| SaveStatus | [Salvar status] | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| SaveStatusBindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| SaveStatusBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
| ErrorStatus | [Status de erro] | [Grupo de registro] | Seguindo a faixa de suporte da propriedade. |
| ErrorStatusBindingMode | [Direção] | Janela do seletor de propriedades para propriedades da variável. | OneWay/TwoWay |
| ErrorStatusBindingConverter | [Conversores] | Janela do seletor de propriedades para propriedades da variável. | Seguindo as convenções de nomenclatura. |
[LoggingRecords]
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
VariableName |
[Nome da variável] |
[Registro de log] |
Seguindo as convenções de nomenclatura. |
| LoggingGroupName | [Nome] | [Grupo de registro] | Seguindo as convenções de nomenclatura. |
Itens do arquivo CSV exportado
| Itens | Propriedade | A localização com a propriedade | Valor disponível |
|
Name |
[Nome] |
[Todas as variáveis] |
Seguindo as convenções de nomenclatura. |
|
Type |
[Tipo de dados] |
[Todas as variáveis] |
Seguindo o tipo de dados suportados. |
|
ElementType |
Indica o tipo de dados do elemento de matriz ou membro da estrutura. |
[Todas as variáveis] |
Seguindo o tipo de dados suportados. |
|
Dimensions |
[Dimensão] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
InitialValue |
[Valor inicial] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
RetentiveEnabled |
[Retentivo] |
[Todas as variáveis] |
TRUE/FALSE |
|
FolderName |
[Pasta] |
[Todas as variáveis] |
Seguindo as convenções de nomenclatura. |
|
BindType |
Indica o tipo de dados atribuídos. |
Janela do seletor de propriedades para propriedades da variável. |
Apenas o objeto que pode ser definido em uma propriedade. |
|
BindObject |
Indica o nome dos dados atribuídos. |
Janela do seletor de propriedades para propriedades da variável. |
Seguindo as convenções de nomenclatura. |
|
BindField |
Indica a propriedade dos dados atribuídos. |
Janela do seletor de propriedades para propriedades da variável. |
Apenas uma propriedade de um objeto atribuído. |
|
BindIsArray |
Indica se uma variável definida pelo usuário é definida como o valor. |
Janela do seletor de propriedades para propriedades da variável. |
TRUE/FALSE |
|
BindValue |
- | - | |
|
BindDirection |
[Direção] |
Janela do seletor de propriedades para propriedades da variável. |
OneWay/Both |
|
BindConverter |
[Conversores] |
Janela do seletor de propriedades para propriedades da variável. |
Seguindo as convenções de nomenclatura. |
|
HasInputRange |
[Faixa de entradas] |
[Todas as variáveis] |
TRUE/FALSE |
|
MinValue |
[Mínimo] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
MaxValue |
[Máximo] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
Target |
[Modelo] |
Arquitetura do sistema |
Não editar |
|
Source |
[Origem] |
[Todas as variáveis] |
Não editar |
|
ScanRate |
[Taxa de digitalização] |
[Todas as variáveis] |
Seguindo as convenções de nomenclatura. |
|
ScanRateInterval |
[Intervalo] |
[Todas as Taxas de digitalização] |
1 - 600 |
|
AddressEnabled |
[Endereço base] (apenas quando uma Matriz ou Estrutura é selecionada.) |
[Todas as variáveis] |
Se a propriedade estiver selecionada, exibirá TRUE. |
|
Address |
[Endereço do dispositivo] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
HasBinding |
Indica VERDADEIRO, ao utilizar um objeto ou outra variável para propriedade variável. |
[Todas as variáveis] |
TRUE/FALSE |
|
VariableLength |
[Tamanho da variável] |
[Todas as variáveis] |
TRUE/FALSE |
|
NumberOfBytes |
[Número de bytes/palavras] |
[Todas as variáveis] |
Seguindo a faixa de suporte da propriedade. |
|
StringEncode |
[Codificação de strings] (apenas quando selecionado dispositivo externo da [Origem]). |
[Todas as variáveis] |
Seguindo a codificação de suporte. |
|
HasAlarm |
Indica VERDADEIRO, quando a variável é usada em um Alarme. |
[Todos os alarmes] |
TRUE ou em branco |
|
AlarmType |
Indica Limite, quando se usa variável em Alarme de nível. |
[Alarme de nível] |
Limit ou em branco |
|
***ThresholdState [1] |
Indica Habilitar, ao utilizar variável em Alarme de nível. |
[Alarme de nível] |
Enable ou em branco |
|
***Threshold [1] |
[Tipo de alarme] |
[Alarme de nível] |
HiHi/Hi/Lo/LoLo |
|
***ThresholdValue [1] |
[Valor] |
[Alarme de nível] |
Seguindo a faixa de suporte da propriedade. |
|
***ThresholdDeadBand [1] |
[Banda morta] |
[Alarme de nível] |
Seguindo a faixa de suporte da propriedade. |
|
***ThresholdAlarmGroup [1] |
Indica o nome do grupo de alarme incluindo uma variável. |
[Alarme de nível] |
Seguindo as convenções de nomenclatura. |
|
***ThresholdMessageMode [1] |
Indica a configuração de uma mensagem. |
[Alarme de nível] |
Direct/Language Table |
|
***ThresholdMessage [1] |
[Mensagem] |
[Alarme de nível] |
Seguindo a faixa de suporte da propriedade. |
|
***ThresholdSeverity [1] |
[Severidade] |
[Alarme de nível] |
Seguindo a faixa de suporte da propriedade. |
|
***ThresholdParameter [1] |
[Parâmetro] |
[Alarme de nível] |
Seguindo a faixa de suporte da propriedade. |
|
ThresholdState |
[Condição do trigger] |
[Alarme de bool] |
Enabled/Disable |
|
ThresholdType |
[Tipo de alarme] |
[Alarme de bool] |
Hi/Lo |
|
ThresholdCondition |
- |
- |
WhenHigh/WhenLow Não editar |
|
ThresholdAlarmGroup |
Indica o nome do grupo de alarme incluindo uma variável. |
[Alarme de bool] |
Seguindo as convenções de nomenclatura. |
|
ThresholdMessageMode |
Indica a configuração de uma mensagem. |
[Alarme de bool] |
Direct/Language Table |
|
ThresholdMessage |
[Mensagem] |
[Alarme de bool] |
Seguindo a faixa de suporte da propriedade. |
|
ThresholdSeverity |
[Severidade] |
[Alarme de bool] |
Seguindo a faixa de suporte da propriedade. |
|
ThresholdParameter |
[Parâmetro] |
[Alarme de bool] |
Seguindo a faixa de suporte da propriedade. |
|
DataSharing |
[Compartilhamento de dados] |
[Todas as variáveis] |
None/ReadOnly/ReadWrite |
|
LoggingGroup |
Indica o nome do grupo, quando a variável é usada no Registro. |
[Todos os registros] |
Seguindo as convenções de nomenclatura. |
| Comments | [Comentários] | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |
| AlarmGroupId | Indica o nome do grupo de alarme. | [Todas as variáveis] | Seguindo as convenções de nomenclatura. |