# Exportación e importación de variables

En el software de edición de pantallas, puede ejecutar la exportación e importación de variables globales desde la barra de herramientas del editor de Variable. La propiedad de una alarma y el registro se incluyen en el elemento de exportación. No se admite la exportación e importación de variables locales.

Nota:

- Aunque se pueden importar datos exportados como archivos CSV o TXT desde el software de edición de pantallas versión 3.3 Service Pack 1 o anterior al software de edición de pantallas versión 3.4 o posterior, los archivos exportados desde la versión 3.4 o posterior no se pueden importar a la versión 3.3 Service Pack 1 o anterior, ya que la versión del archivo es la 2.0.
  Compruebe la versión del archivo de salida CSV o TXT en la línea [FileVersion] del archivo de salida.
- Los archivos de Excel son compatibles para la exportación e importación de variables a partir de la versión 4.4.

Los siguientes formatos de archivos son compatibles para la importación y exportación de variables:

- Archivo TXT (.txt, UTF-8 (sin BOM))
- Archivo CSV (.csv, UTF-8 (sin BOM))
- Archivo de Microsoft Excel (.xlsx)

Nota:

Archivo de Microsoft Excel

- Para exportar e importar variables en archivos de Excel, se necesita Microsoft Excel. El software de edición de pantalla es compatible con Microsoft Excel 2016, 2019 y 365.
- Cuando exporta variables a un archivo de Excel, puede establecer una contraseña para cifrarlo. Se recomienda configurar una contraseña compleja. Si olvida la contraseña, no se puede recuperar.
- El software de edición de pantallas no es compatible con Excel Information Rights Management (IRM).

Archivo TXT o CSV

- Cuando exporta variables a un archivo TXT o CSV, seleccione el delimitador.
- Los archivos TXT o CSV guardados con una codificación distinta de UTF-8 (sin BOM) no pueden importarse.
- Para más información sobre los formatos de archivos, véase lo siguiente.
  Configuración del archivo para guardar datos (Exportar)

Puede ver el archivo exportado utilizando programas como Microsoft Excel.

Nota:

La salida de datos tiene el siguiente formato:

- Las cadenas se encapsulan con comillas dobles (").
  Por ejemplo, "Esto es una cadena"
- Los caracteres especiales "=", "+", "-", "@", TAB y ENTRAR que aparecen al principio de una entrada van precedidos de una comilla simple (').
  Por ejemplo: "'=1+2"

## Notas sobre la importación de variables

- Al importar, si no existe una velocidad de exploración con el mismo nombre, se crea una nueva velocidad de exploración con el intervalo del archivo exportado. Si la velocidad de escaneo ya existe en el proyecto, la velocidad de escaneo se actualiza.
- Si importa un archivo exportado desde el software de edición de pantallas versión 3.1 Service Pack 1B o anterior, a las variables externas se les asigna la velocidad de exploración por defecto. Para más información sobre las velocidades de exploración, consulte lo siguiente.
  Configuración del intervalo de lectura de los valores de las variables externas (Velocidad de exploración)
- Las variables que se importaron mediante la importación de archivos de símbolos no se pueden actualizar con el comando importar variable. Para actualizar las variables en el archivo de símbolos, consulte lo siguiente.
  Importación de símbolos desde dispositivos externos - Notas después de importar el archivo de símbolos
- No se pueden importar variables a un proyecto que contenga un archivo de símbolos. Para importar variables, siga estos pasos.
  1. Elimine el archivo de símbolos del proyecto.
  2. Exporte las variables del proyecto.
  3. Importe las variables al proyecto.
  4. Importe el archivo de símbolos al proyecto.

- Existe una convención de nomenclatura para los nombres de las variables en el software de edición de pantalla.
  Si el nombre de una variable contiene caracteres que no siguen la convención de nomenclatura, la variable no se importa.
  Para más detalles, consulte lo siguiente.
  Convenciones de nomenclatura

### Al importar un archivo de Excel

- Cuando importa un archivo de Excel protegido, debe introducir la contraseña.
- Solo se importan valores desde los archivos de Excel. Las macros y fórmulas no se recalculan durante la importación.
- La FileVersion de la hoja [Summary] se verifica durante la importación. Los demás valores de conteo se ignoran.
- El tamaño máximo de archivo que puede importar es de 100 MB.

## Formato de la variable

### Estructura del archivo de Excel exportado

En el archivo de Excel exportado, los datos se organizan en las siguientes hojas, cada una con información específica:

- Summary: Descripción general de todas las variables exportadas.
- VariableTypes: Tipos de variables, como arreglos o estructuras, si existen.
- Variables: Datos de las variables.
- ScanRates: Velocidades de exploración, si existen.
- AlarmGroups: Todos los grupos de alarmas, incluso si no hay alarmas configuradas.
- Alarms: Alarmas, si existen.
- LoggingGroups: Todos los grupos de registro, incluso si no contienen variables.
- LoggingRecords: Variables, si existen.

Ejemplo: hoja Variables

Nota:

- Solo puede editar los datos en azul. Si se modifica el formato, no puede importar el archivo. Todas las columnas son obligatorias.
- Las hojas y las columnas pueden estar en cualquier orden.

### Estructura del archivo CSV exportado

Cuando se abre en Excel, el archivo CSV exportado se organiza como se muestra a continuación.

Nota: Solo puede editar los datos en azul. Si se modifica el formato, no puede importar el archivo.

###

## Exportar elementos

Esta tabla indica una propiedad que corresponde al elemento exportado.

El elemento cuya propiedad no está establecida, estará en blanco.

### Elementos del archivo de Excel exportado

[VariableTypes]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [Todos los tipos de datos del usuario] | Siguiendo las convenciones de nomenclatura.
Type | [Tipo de datos] | [Todos los tipos de datos del usuario] | Siguiendo el tipo de datos de apoyo.
ElementTypeName | Indica el tipo de datos del elemento de la matriz o del miembro de la estructura. | [Todos los tipos de datos del usuario] | Siguiendo el tipo de datos de apoyo.
Dimensions | [Dimensión] | [Todos los tipos de datos del usuario] | Siguiendo la rango de apoyo de la propiedad.

[Variables]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
FolderName | [Carpeta] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
DataType | [Tipo de datos] | [Todas las variables] | Siguiendo el tipo de datos de apoyo.
Dimension | [Dimensión] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
Source | [Origen] | [Todas las variables] | No editar
DeviceAddress | [Dirección de dispositivo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
BaseAddress | [Dirección base] (solo cuando se selecciona un arreglo o una estructura). | [Todas las variables] | TRUE/FALSE
ScanRate | [Velocidad de exploración] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
InitialValue | [Valor Inicial] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
InputRange | [Rango de entrada] | [Todas las variables] | TRUE/FALSE
Min | [Mínimo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
Max | [Máximo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
EnableVariableLength | [Longitud de la variable] | [Todas las variables] | TRUE/FALSE
NumberOfBytes/NumberOfWords | [Número de bytes] (solo cuando se selecciona un STRING). / [Número de palabras] (solo cuando se selecciona un WSTRING). | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
StringEncode | [Código de cadena] (sólo cuando se selecciona un dispositivo externo desde [Origen].) | [Todas las variables] | Sigue la codificación de apoyo.
Retentive | [Retentivo] | [Todas las variables] | TRUE/FALSE
Value | [Valor] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
BindingType | Indica el tipo de datos asignado. | Ventana de selección de propiedades para la propiedad de la variable. | Sólo el objeto que se puede establecer en una propiedad.
BindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
BindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
DataSharing | [Compartir datos] | [Todas las variables] | None/ReadOnly/ReadWrite
Comments | [Comentarios] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.

[ScanRates]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [Todas las velocidades de exploración] | Siguiendo las convenciones de nomenclatura.
Interval | [Intervalo (100 ms)] | [Todas las velocidades de exploración] | 1 - 600

[AlarmGroups]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [AlarmGroup] | Siguiendo las convenciones de nomenclatura.
***LabelType [1] | Indica la configuración de etiquetas. | [AlarmGroup] | Direct/LanguageTable
***Label [1] | Indica los nombres de las etiquetas. | [AlarmGroup] | Siguiendo la rango de apoyo de la propiedad.
Parameter | [Parámetro] | [AlarmGroup] | Siguiendo la rango de apoyo de la propiedad.
AlarmBehavior | [Comportamiento de la alarma] | [AlarmGroup] | Optional ACK/Mandatory ACK

1. *** se refiere a LoLo, Lo, Hi, HiHi, Active, ACK, RTNo UNACK.

[Alarms]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Variable | [Variable] | [Alarma booleana]/[Alarma de nivel] | Siguiendo las convenciones de nomenclatura.
AlarmGroupName | [Nombre] | [AlarmGroup] | Siguiendo las convenciones de nomenclatura.
Type | [Tipo de alarma] | [Alarma booleana]/[Alarma de nivel] | HiHi/Hi/Lo/LoLo
Condition | [Condición de disparador] (Alarma booleana) / [Valor] (Alarma de nivel) | [Alarma booleana]/[Alarma de nivel] | Si la propiedad está seleccionada, se muestra TRUE para la alarma booleana. La alarma de nivel sigue el rango compatible de la propiedad.
Deadband | [Banda muerta] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
Severity | [Gravedad] | [Alarma booleana]/[Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
Parameter | [Parámetro] | [Alarma booleana]/[Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
MessageType | Indica un ajuste del mensaje. | [Alarma booleana]/[Alarma de nivel] | Direct/Language Table
Message | [Mensaje] | [Alarma booleana]/[Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.

[LoggingGroups]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [Grupo de registro] | Siguiendo las convenciones de nomenclatura.
MaxRecord | [N.º máximo de registros] | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
ConditionType | [Tipo de condición] | [Grupo de registro] | ValueChange/Periodic/Script
Frequency | [Frecuencia] (solo cuando se selecciona [Periódico] en [Tipo de condición]). | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
Units | [Unidades] (solo cuando se selecciona [Periódico] en [Tipo de condición]). | [Grupo de registro] | Secs/Mins/Hours/100ms
Condition | [Condición de ejecución] (solo cuando se selecciona [Cambio de valor] en [Tipo de condición]). | [Grupo de registro] | ON/OFF/On Change
TriggerVariable | [Variable del disparador] (solo cuando se selecciona [Cambio de valor] en [Tipo de condición]). | [Grupo de registro] | Siguiendo las convenciones de nomenclatura.
TriggerVariableBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
InterlockType | Indica la configuración de [Enclavamiento]. | [Grupo de registro] | Direct/Variable
Interlock | [Enclavamiento] | [Grupo de registro] | TRUE/FALSE
InterlockBindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
InterlockBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
ExportData | [Activar] | [Grupo de registro] | TRUE/FALSE
WriteDataTo | [Almacenamiento de datos] | [Grupo de registro] | USB Storage/SD Card/Internal
AppendDateTime | [Agregar fecha/hora] | [Grupo de registro] | TRUE/FALSE
DetectModification | [Detectar modificación] | [Grupo de registro] | TRUE/FALSE
FolderNameType | Indica la configuración de [Nombre de carpeta]. | [Grupo de registro] | Direct/Variable
FolderName | [Nombre de carpeta] | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
FolderNameBindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
FolderNameBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
FileNameType | Indica la configuración de [Nombre de archivo]. | [Grupo de registro] | Direct/Variable
FileName | [Nombre de archivo] | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
FileNameBindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
FileNameBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
ExportStatus | [Activar] | [Grupo de registro] | TRUE/FALSE
SaveStatus | [Estado de guardado] | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
SaveStatusBindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
SaveStatusBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
ErrorStatus | [Estado de error] | [Grupo de registro] | Siguiendo la rango de apoyo de la propiedad.
ErrorStatusBindingMode | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/TwoWay
ErrorStatusBindingConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.

[LoggingRecords]

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
VariableName | [Nombre de la variable] | [LoggingRecord] | Siguiendo las convenciones de nomenclatura.
LoggingGroupName | [Nombre] | [Grupo de registro] | Siguiendo las convenciones de nomenclatura.

### Elementos del archivo CSV exportado

Elementos | Propiedad | La ubicación con la propiedad | Valor disponible
Name | [Nombre] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
Type | [Tipo de datos] | [Todas las variables] | Siguiendo el tipo de datos de apoyo.
ElementType | Indica el tipo de datos del elemento de la matriz o del miembro de la estructura. | [Todas las variables] | Siguiendo el tipo de datos de apoyo.
Dimensions | [Dimensión] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
InitialValue | [Valor Inicial] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
RetentiveEnabled | [Retentivo] | [Todas las variables] | TRUE/FALSE
FolderName | [Carpeta] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
BindType | Indica el tipo de datos asignado. | Ventana de selección de propiedades para la propiedad de la variable. | Sólo el objeto que se puede establecer en una propiedad.
BindObject | Indica el nombre de los datos asignados. | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
BindField | Indica la propiedad de los datos asignados. | Ventana de selección de propiedades para la propiedad de la variable. | Solamente una propiedad de un objeto asignado.
BindIsArray | Indica si una variable definida por el usuario se define como el valor. | Ventana de selección de propiedades para la propiedad de la variable. | TRUE/FALSE
BindValue | - | - |
BindDirection | [Dirección] | Ventana de selección de propiedades para la propiedad de la variable. | OneWay/Both
BindConverter | [Convertidor] | Ventana de selección de propiedades para la propiedad de la variable. | Siguiendo las convenciones de nomenclatura.
HasInputRange | [Rango de entrada] | [Todas las variables] | TRUE/FALSE
MinValue | [Mínimo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
MaxValue | [Máximo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
Target | [Modelo] | Arquitectura del sistema | No editar
Source | [Origen] | [Todas las variables] | No editar
ScanRate | [Velocidad de exploración] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
ScanRateInterval | [Intervalo] | [Todas las velocidades de exploración] | 1 - 600
AddressEnabled | [Dirección base] (solo cuando se selecciona un arreglo o una estructura). | [Todas las variables] | Si la propiedad está seleccionada, se muestra TRUE.
Address | [Dirección de dispositivo] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
HasBinding | Indica TRUE, cuando se utiliza un objeto u otra variable para la propiedad de la variable. | [Todas las variables] | TRUE/FALSE
VariableLength | [Longitud de la variable] | [Todas las variables] | TRUE/FALSE
NumberOfBytes | [Número de bytes/palabras] | [Todas las variables] | Siguiendo la rango de apoyo de la propiedad.
StringEncode | [Código de cadena] (sólo cuando se selecciona un dispositivo externo desde [Origen]). | [Todas las variables] | Sigue la codificación de apoyo.
HasAlarm | Indica TRUE, cuando la variable se utiliza en una Alarma. | [Todas las alarmas] | TRUE o en blanco
AlarmType | Indica el Límite, cuando se utiliza la variable en la Alarma de nivel. | [Alarma de nivel] | Limit o en blanco
***ThresholdState [1] | Indica Activar, cuando se utiliza la variable en la Alarma de nivel. | [Alarma de nivel] | Enable o en blanco
***Threshold [1] | [Tipo de alarma] | [Alarma de nivel] | HiHi/Hi/Lo/LoLo
***ThresholdValue [1] | [Valor] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
***ThresholdDeadBand [1] | [Banda muerta] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
***ThresholdAlarmGroup [1] | Indica el nombre del grupo de alarmas, que incluye una variable. | [Alarma de nivel] | Siguiendo las convenciones de nomenclatura.
***ThresholdMessageMode [1] | Indica un ajuste del mensaje. | [Alarma de nivel] | Direct/Language Table
***ThresholdMessage [1] | [Mensaje] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
***ThresholdSeverity [1] | [Gravedad] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
***ThresholdParameter [1] | [Parámetro] | [Alarma de nivel] | Siguiendo la rango de apoyo de la propiedad.
ThresholdState | [Condición de disparador] | [Alarma booleana] | Enabled/Disable
ThresholdType | [Tipo de alarma] | [Alarma booleana] | Hi/Lo
ThresholdCondition | - | - | WhenHigh/WhenLow No editar
ThresholdAlarmGroup | Indica el nombre del grupo de alarmas, que incluye una variable. | [Alarma booleana] | Siguiendo las convenciones de nomenclatura.
ThresholdMessageMode | Indica un ajuste del mensaje. | [Alarma booleana] | Direct/Language Table
ThresholdMessage | [Mensaje] | [Alarma booleana] | Siguiendo la rango de apoyo de la propiedad.
ThresholdSeverity | [Gravedad] | [Alarma booleana] | Siguiendo la rango de apoyo de la propiedad.
ThresholdParameter | [Parámetro] | [Alarma booleana] | Siguiendo la rango de apoyo de la propiedad.
DataSharing | [Compartir datos] | [Todas las variables] | None/ReadOnly/ReadWrite
LoggingGroup | Indica el nombre del grupo, cuando la variable se utiliza en el registro. | [Todos los registros] | Siguiendo las convenciones de nomenclatura.
Comments | [Comentarios] | [Todas las variables] | Siguiendo las convenciones de nomenclatura.
AlarmGroupId | Indica el nombre del grupo de alarmas. | [Todas las variables] | Siguiendo las convenciones de nomenclatura.

1. *** se refiere a HiHi, Hi, Lo, o LoLo.