Comando SET

Ajusta una opción de Analytics configurable.

Nota

El comando SET establece una opción Analytics mientras dura la sesión Analytics. Este comportamiento se produce si se utiliza el comando SET en la línea de comandos de Analytics o en un script de Analytics.

Para ajustar las opciones de Analytics de manera que no se modifiquen entre sesiones de Analytics, debe utilizar el cuadro de diálogo Opciones. Si desea obtener más información, consulte Configuración de las opciones de ACL.

Sintaxis

Sintaxis

Ejemplos y observaciones

SET BEEP valor

SET BEEP 2

Especifica la cantidad de sonidos cortos que se oirán cuando se complete el procesamiento del comando.

El parámetro valor debe estar entre 1 y 255.

SET CENTURY valor

SET CENTURY 40

Especifica el año de inicio del siglo para los años de dos dígitos.

El parámetro valor debe estar entre 0 y 99.

Si se establece el valor de comienzo de siglo en 40 significa que los años de dos dígitos 40 al 99 se interpretan como 1940 y 1999, y los años de dos dígitos 00 a 39 se interpretan como 2000-2039.

SET CLEAN {ON | OFF}

SET CLEAN ON

Cuando se activa esta opción, Analytics reemplaza los datos de caracteres no válidos por espacios en blanco y los datos numéricos no válidos por ceros.

SET DATE <TO> {0 | 1 | 2 | cadena}

SET DATE "YYYY/MM/DD"

Especifica cómo muestra Analytics las fechas y la porción de la fecha de las fechahoras en las vistas, los reportes y los archivos exportados.

  • SET DATE 0 establece la fecha a formato MM/DD/AAAA

  • SET DATE 1 establece la fecha a formato MM/DD/AA

  • SET DATE 1 establece la fecha a formato DD/MM/AA

  • SET DATE "<cadena>" establece la fecha para el formato personalizado que especifique

    Al utilizar el comando SET DATE para especificar los formatos de fecha personalizados, debe usar 'D' para Día, 'M' para Mes e 'Y' para año, aun cuando haya especificado caracteres de formato diferente en el cuadro de diálogo Opciones. Por ejemplo:

    SET DATE "DD MMM YYYY"

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

Configuración predeterminada: OFF

Especifique ON para eliminar automáticamente el archivo de datos asociado al eliminar un formato de tabla.

Especifique ON para impedir la eliminación del archivo de datos asociado al eliminar un formato de tabla.

Debe incluir el guion bajo ( _ ) en DELETE_FILE.

Si se especifica SET DELETE_FILE sin ningún parámetro, en la línea de comandos se muestra si DELETE_FILE está activado o desactivado.

¡Precaución!

Tenga cuidado al activar esta opción. Es posible que se elimine un archivo de datos original junto con la tabla.

Los archivos de datos se eliminan directamente. No se envían a la Papelera de reciclaje de Windows.

SET DESIGNATION valor

SET DESIGNATION "Producido por ABC Corporation"

El parámetro valor es una cadena entre comillas que especifica la etiqueta que se mostrará en la parte superior de cada página impresa.

SET ECHO {ON | NONE}

SET ECHO NONE
Los comandos COM y los resultados en los scripts son excluidos del log.
SET ECHO ON

Especifique NONE para dejar de escribir los comandos y los resultados en los scripts de Analytics en el log de comandos. Especifique ON para reanudar el registro en el log.

El comando SET ECHO solo se aplica al log de comandos y de resultados en los scripts. Los comandos realizados a través de la interfaz de usuario o emitidos desde la línea de comandos y los resultados que producen se registran siempre, independientemente de cómo se establece ECHO.

Puede emitir el comando SET ECHO NONE/ON en un script o desde la línea de comandos, pero independientemente de donde se ejecute el comando, solo afecta al log de comandos y los resultados en los scripts.

Si se especifica SET ECHO sin ningún parámetro, en la línea de comandos se muestra si el registro en el log de comandos y de resultados en los scripts está encendido o apagado.

SET EXACT {ON | OFF}

SET EXACT ON

Configuración predeterminada: OFF

Controla de qué manera Analytics compara los campos de caracteres, las expresiones o los valores literales.

Nota

Los espacios en blanco se tratan como caracteres.

  • SET EXACT está en OFF Analytics utiliza la cadena más corta al comparar dos cadenas de diferente longitud. La comparación comienza con los caracteres ubicados más a la izquierda y continúa hacia la derecha.

    Por ejemplo, "AB" es igual a "AB" y también se considera igual a "ABC".

  • SET EXACT está en ON las cadenas que se comparan deben ser idénticas para que haya una coincidencia. Al comparar dos cadenas de diferente longitud, Analytics completa la cadena más corta con espacios en blanco al final para hacer que coincida en longitud con la cadena más larga.

    Por ejemplo, "AB" es igual a "AB", pero no se considera igual a "ABC".

Si desea ver más ejemplos del uso de SET EXACT, consulte "Comparaciones de caracteres exactos" en la ficha Tabla (cuadro de diálogo Opciones).

Puede usar la función ALLTRIM( ) para quitar los espacios en blanco al principio y al final para asegurarse de que solo se comparen los caracteres de texto y los espacios internos.

Por ejemplo: ALLTRIM(" AB") = ALLTRIM("AB") es verdadero cuando los valores se encierran con ALLTRIM( ), pero si no se los encierra, es falso.

Algunos comandos y funciones de Analytics se ven afectados por SET EXACT y otros, no:

Afectada No afectada
  • Comando LOCATE
  • Función MATCH( )
  • Función BETWEEN( )
  • Comando JOIN
  • Comando DEFINE RELATION
  • Función FIND( )
  • Función FINDMULTI( )

SET FILTER <TO> {prueba | nombre_filtro}

SET FILTER TO NúmProd = "070104347"
SET FILTER TO FiltroNúmProd

Crea un filtro global (filtro de vista) en la tabla abierta y especifica ya sea una prueba lógica o el nombre de un filtro guardado existente.

Si especifica SET FILTER sin ningún parámetro, se eliminan los filtros de la tabla abierta.

SET FOLDER ruta de carpeta

Especifica la carpeta del proyecto de Analytics en la ficha Panorama para el resultado del comando. La carpeta de salida predeterminada es la carpeta que contiene la tabla activa.

Se trata de una ruta de estilo DOS que utiliza el formato/nombre_de_carpeta/nombre_de_subcarpeta, en el cual la barra inicial (/) indica el nivel raíz en la ficha Panorama. Debe especificar una ruta completa de archivo.

  • SET FOLDER /Tablas/Resultados establece la carpeta de salida en la subcarpeta Resultados. Si la subcarpeta Resultados no existe, se crea.

  • SET FOLDER / establece la carpeta de salida en el nivel raíz de la ficha Panorama

  • SET FOLDER establece la carpeta de salida al valor predeterminado (la carpeta que contiene la tabla activa).

La carpeta de salida sigue estando de la manera en que usted la estableció - hasta que la restablezca, o cierre el proyecto. Al abrir el proyecto, la carpeta de salida vuelve al valor predeterminado de la carpeta de la tabla activa.

SET FORMAT {ON | OFF}

SET FORMAT ON

Configuración predeterminada: OFF

Si utiliza el parámetro ON, Analytics muestra automáticamente el formato de tabla actual y las definiciones de campos calculados cuando se abre una nueva tabla. Los resultados aparecen en el log del comando.

SET FUZZYGROUPSIZE <TO> num

SET FUZZYGROUPSIZE TO 10

Especifica el número máximo de elementos que pueden aparecer en un grupo de duplicados inexactos en los resultados de salida. El parámetro num no puede ser inferior a 2 ni mayor que 100. El tamaño predeterminado es 20. El tamaño especificado se mantiene en vigor durante la sesión Analytics.

SET GRAPH tipo

SET GRAPH LINE

Especifica el tipo de gráfico que se utilizará para todos gráficos generados posteriormente. Los comandos ejecutados deben ser compatibles con el tipo de gráfico especificado. Por ejemplo, el comando BENFORD no puede producir un gráfico PIE2D o PIE3D. Si se especifica un tipo de gráfico incompatible, se utiliza el tipo de gráfico predeterminado (BAR3D).

El parámetro tipo debe ser uno de los siguientes:

  • PIE2D

  • PIE3D

  • BAR2D

  • BAR3D – Este es el tipo de gráfico predeterminado.

  • STACKED2D

  • STACKED3D

  • LAYERED

  • LINE

  • BENFORD – Combina un gráfico de barras 2D y un gráfico de líneas 2D.

SET HISTORY <TO> valor

SET HISTORY TO 50

Especifica el número máximo de entradas que se conservarán en el historial de la tabla. El parámetro valor debe estar entre 1 y 100.

SET INDEX <TO> valor

SET INDEX TO "CódigoCliente.INX"

Especifica el índice que se aplicará a la tabla activa.

SET LEARN <TO> script

SET LEARN TO RegInventario

Especifica el nombre del archivo de script que utiliza el Grabador de scripts para registrar los comandos.

SET LOG <TO> {archivo |OFF}

SET LOG TO "análisis.log"
SET LOG OFF

El primer comando activa el registro en el log especificado. Si el log especificado no existe, se lo crea.

El segundo comando restaura el registro en el log de comandos original de Analytics.

Nota

La longitud máxima del nombre del log y la ruta del proyecto de Analytics es de 259 caracteres, incluida la ruta al archivo, el nombre del log y la extensión del archivo (.log).

SET LOOP <TO> núm

SET LOOP TO 20

Especifica el número máximo de bucles que puede ejecutar el comando LOOP antes de que se termine el comando.

El rango núm es de 0 a 32767, donde 0 desactiva las pruebas de bucle.

SET MARGIN lado <TO> valor

SET MARGIN TOP TO 100

Especifique LEFT, RIGHT, TOP o BOTTOM para el parámetro lado. Si desea cambiar el margen en todos los lados, debe especificar cada margen con un comando SET MARGIN por separado. Si se especifica un valor de 100, se crea un margen de 1 pulgada.

SET MATH <TO> {FIRST | LAST | MIN | MAX}

SET MATH TO MIN

Configuración predeterminada: MAX

Especifica cómo funciona la precisión decimal cuando se evalúan dos operandos en una expresión numérica.

  • FIRST utiliza la cantidad de posiciones decimales del primer operando en un par de operandos
  • LAST utiliza la cantidad de posiciones decimales del último operando en un par de operandos
  • MIN utiliza la cantidad mínima de posiciones decimales en un par de operandos
  • MAX utiliza la cantidad máxima de posiciones decimales en un par de operandos

En las expresiones con varios operandos, la configuración SET MATH funciona de a pares, aplica el ajuste especificado a cada par de operandos y, si es necesario, hace un redondeo a medida que se los evalúa en el orden matemático estándar.

Si la configuración SET MATH reduce la cantidad de posiciones decimales de un resultado, el resultado se redondea, pero no se trunca.

Si desea obtener más información, consulte Controlar el redondeo y la precisión decimal en expresiones numéricas.

Nota

No puede usar SET MATH mientras tiene abierta una tabla de Analytics.

SET MONTHS <TO> cadena

Especifica las abreviaturas de tres caracteres para los nombres de los meses. El parámetro cadena es la lista de abreviaturas de meses separadas por comas.

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

Configuración predeterminada: OFF

  • NOTIFYFAILSTOP está en OFF Analytics permite que el script continúe aun cuando un comando NOTIFY del script falle.
  • NOTIFYFAILSTOP está en ON Analytics deja de procesar un script y escribe un mensaje en el registro si un comando NOTIFY del script falla. El script se detiene después del primer error, o después de la cantidad especificada de NOTIFYRETRYATTEMPTS, si ninguno de los intentos se completa correctamente.

SET NOTIFYRETRYATTEMPTS <TO> núm

SET NOTIFYRETRYATTEMPTS TO 10

Especifica la cantidad de veces que el comando NOTIFY intentará enviar un mensaje de correo electrónico si el intento inicial no se completa correctamente. Escriba un número del 0 al 255. Si escribe 0, no se realizan más intentos después del primer error. El valor predeterminado es 5.

Una posible causa para que el comando NOTIFY no pueda enviar un correo electrónico es que el servidor de correo electrónico no esté disponible.

SET NOTIFYRETRYINTERVAL <TO> segundos

SET NOTIFYRETRYINTERVAL TO 30

Especifica la cantidad de tiempo, en segundos, entre NOTIFYRETRYATTEMPTS. Escriba un número del 1 al 255. El tiempo predeterminado es de 10 segundos.

SET ORDER <TO> valores

Especifica la secuencia de ordenamiento para los campos de caracteres. El parámetro valores especifica todos los caracteres para la secuencia de ordenamiento seleccionada.

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

Configuración predeterminada: ON

Si se especifica OFF, Analytics no interrumpe el procesamiento cuando se produce un error de desborde.

SET PASSWORD núm <TO> cadena

SET PASSWORD 1 TO "contraseña123"

Se utiliza para crear una definición de contraseña y especificar un valor de contraseña para la ejecución de scripts sin intervención del usuario

El parámetros num identifica de forma única la definición de la contraseña y debe ser un valor entre 1 y 10. Especifique el valor de la contraseña como una cadena entre comillas.

SET PERIODS <TO> valor <;...n>

SET PERIODS TO “0;30;90;180;10000”

Especifica los períodos de antigüedad predeterminados que utiliza el comando AGE.

SET PICTURE formato

SET PICTURE "9.999.999,99"

Especifica el formato predeterminado para los valores numéricos.

SET READAHEAD <TO> tamaño

Especifica el tamaño de bloque de datos leído. Sólo debe cambiar este valor de configuración si el Soporte le aconseja que lo haga.

SET RETRY <TO> núm

SET RETRYIMPORT <TO> núm

SET RETRY TO 50

Especifica la cantidad de veces que Analytics intenta importar o exportar los datos si el intento inicial no se completa correctamente. Escriba un número del 0 al 255. Si escribe 0, no se realizan más intentos después del primer error. El valor predeterminado es 0.

No hay ningún período de espera entre los reintentos. Cada nuevo intento se realiza inmediatamente después del intento erróneo anterior.

La capacidad de especificar reintentos resulta útil al conectarse a bases de datos o servicios de datos en la nube, que pueden estar temporalmente inaccesibles.

Se aplica a los siguientes comandos:

  • ACCESSDATA
  • IMPORT GRCPROJECT
  • IMPORT GRCRESULTS
  • IMPORT SAP
  • RETRIEVE
  • REFRESH

    (solo para tablas creadas inicialmente con ACCESSDATA o IMPORT SAP)

  • EXPORT . . . ACLGRC

    (exportar a Resultados de HighBond)

Nota

SET RETRYIMPORT se retiene para tener compatibilidad con versiones anteriores. SET RETRYIMPORT y SET RETRY realizan acciones idénticas.

SET SAFETY {ON | OFF}

SET SAFETY OFF

Especifique ON para mostrar un cuadro de diálogo de confirmación al sobrescribir cualquiera de los siguientes:

  • campos en formatos de tabla

  • Tablas de Analytics

  • archivos, incluidos los archivos de datos de Analytics (.fil)

Especifique OFF para impedir que se muestre el cuadro de diálogo.

Si se especifica SET SAFETY sin ningún parámetro, en la línea de comandos se muestra si SAFETY está encendido o apagado en ese momento.

SET SEPARATORS <TO> valores

SET SEPARATORS TO ",.;"

Especifica los separadores decimal, de miles y de lista predeterminados que utiliza Analytics. Los valores de SET SEPARATORS deben ser tres caracteres separadores válidos en el siguiente orden:

  • decimal (punto, coma o espacio)

  • miles (punto, coma o espacio)

  • lista (punto y coma, coma o espacio)

Entre los tres separadores, el separador decimal debe ser único. Debe especificar los tres separadores cuando utilice el comando. El separador de lista se utiliza principalmente para separar los parámetros de las funciones.

SET SESSION <nombre_sesión>

SET SESSION
SET SESSION "Análisis"

Crea una nueva sesión en el log de comandos de Analytics. La sesión se identifica con la marca de hora actual.

El nombre_sesión le permite agregar hasta 30 caracteres de información adicional para la identificación. No es necesario usar comillas, pero puede usarlas si lo desea.

SET SORTMEMORY num

SET SORTMEMORY 800

Especifica la cantidad máxima de memoria asignada para los procesos de ordenamiento e indexado. El parámetro num debe ser un valor de 0 a 2000 megabytes (MB), que se introduce en incrementos de 20 MB. Si la memoria para ordenar se establece en 0, Analytics utiliza la memoria disponible actualmente.

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

Configuración predeterminada: OFF

Solo para uso en la definición de una tabla de Analytics que utiliza una fuente de datos ODBC (comando IMPORT ODBC) o el acceso directo de base de datos (DEFINE TABLE DB).

Si se utiliza el parámetro ON, al definir la tabla Analytics suprime la porción hora de los valores de fechahora. Por ejemplo, 20141231 235959 se lee, aparece en las vistas y posteriormente se procesa como 20141231.

La inclusión de este comando en un script de Analytics anterior a la habilitación de fechahora (pre v.10.0), que asume que la porción hora de los datos de fechahora se truncará, permite que el script se ejecute en la versión con fechahora habilitada de Analytics.

Analytics suprime la porción hora utilizando solo la parte de fecha del formato de fechahora. Los datos de la hora siguen presentes en el archivo .fil o la tabla de base de datos. Si es necesario, puede volver a definir el campo o definir un nuevo campo para incluir la porción hora de los datos.

Si SET SUPPRESSTIME = OFF, las tablas de Analytics definidas utilizando ODBC o el acceso de base de datos directo incluyen los valores de la fechahora completos.

Puede emitir el comando SET SUPPRESSTIME ON/OFF en un script o desde la línea de comandos.

Si se especifica SET SUPPRESSTIME sin ningún parámetro, en las pantallas de la línea de comandos se muestra si la supresión de la porción hora de los datos de fechahora está activada o desactivada.

SET SUPPRESSXML {ON | OFF}

SET SUPPRESSXML ON

Configuración predeterminada: OFF

Especifica que la salida del comando está en texto plano en lugar de texto con formato.

SET TEST {ON | OFF}

SET TEST ON

Especifica si los resultados de las pruebas IF, WHILE, FOR y NEXT asociadas con los comandos GROUP se deben registrar en el log.

SET TIME <TO> cadena

SET TIME "hh:mm:ss PM"

Especifica cómo muestra Analytics la porción de la horas de las fechahoras y las horas independientes en las vistas, los reportes y los archivos exportados.

Al utilizar el comando SET TIME para especificar formatos de hora, debe utilizar 'h' para la hora, "m" para minutos y "s" para segundos, incluso si se han especificado diferentes caracteres de formato de hora en el cuadro de diálogo Opciones. Por ejemplo:

SET TIME TO "hh:mm"

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

Configuración predeterminada: ON

  • UTCZONE está en ON Analytics cambia la visualización de la hora local con un desplazamiento del UTC al UTC equivalente a la hora local. (UTC es el horario universal coordinado, la hora en los cero grados de longitud.)
  • UTCZONE está en OFF Analytics muestra las horas locales con un desplazamiento del UTC sin convertirlas a UTC.

Por ejemplo:

  • 01 ene 2015 04:59:59 (SET UTCZONE ON)
  • 31 dic 2014 23:59:59-05:00 (SET UTCZONE OFF)

La conversión de la hora local a UTC se hace para fines de visualización solamente y no afecta a los datos de origen. Puede cambiar entre uno y otro modo de visualización diferentes toda vez que lo desee.

SET VERIFY {ON | OFF | BLANK}

SET VERIFY ON

Cuando se especifica ON, Analytics verifica automáticamente si el contenido de un campo de datos corresponde al tipo de datos del campo en el formato de tabla cada vez que se abre una tabla. Cuando se especifica BLANK, Analytics reemplaza los datos de caracteres no válidos por espacios en blanco y los datos numéricos no válidos por ceros, además de realizar la verificación descrita en el caso del parámetro ON.

SET WIDTH <TO> caracteres

SET WIDTH TO 20

Especifica el ancho de visualización predeterminado para los campos calculados numéricos o las expresiones numéricas ad hoc cuando Analytics no puede determinar el ancho máximo.

Guía de creación de scripts de ACL 14.1