# 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.

Observação:

- 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)

Observação:

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.

Observação:

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.
  1. Remover o arquivo de símbolo do projeto.
  2. Exportar as variáveis do projeto.
  3. Importar as variáveis para o projeto.
  4. 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

Observação:

- 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.

Observação: 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.

1. *** refere-se a HiHi, Hi, Lo ou LoLo.