Creación y edición de scripts

Tiene varias opciones para crear scripts:

  • Editor de scripts escriba la sintaxis del script en la ventana del Editor de scripts
  • Log de comandos copie y pegue la sintaxis del script desde el log de comandos
  • Grabador de scripts grabe la sintaxis de los comandos a medida que los ejecuta
  • Captura de sintaxis inserte la sintaxis de los comandos a medida que usted los selecciona en la interfaz de usuario sin ejecutarlos
  • Historial de tabla copie la sintaxis del script del historial de una tabla de salida

Puede usar estas opciones combinadas. Por ejemplo, puede comenzar un script copiando la sintaxis del log de comandos y después agregarle líneas de sintaxis directamente en la ventana del Editor de scripts.

Para editar un script existente en Analytics, debe usar el Editor de scripts.

También puede usar un editor de scripts de su elección y copiar y pegar la sintaxis en un script de Analytics.

Autocompletado de la sintaxis

A medida que escribe la sintaxis en el Editor de scripts, Analytics ofrece completar automáticamente los comandos y las palabras clave de ACLScript, así como la ayuda en pantalla automática para los parámetros de las funciones.

Puede desactivar la opción de completar automáticamente seleccionando Desactivar la opción de completar automáticamente en los scripts en la ficha Interfaz del cuadro de diálogo Opciones (Herramientas > Opciones). La ayuda en pantalla para los parámetros de las funciones no se puede desactivar.

Importar scripts o snippets desde ScriptHub

Otra opción para crear scripts consiste en usar el contenido de ScriptHub. ScriptHub es una biblioteca basada en la web y contiene elementos de script de Analytics desarrollados por empleados de Galvanize y por la comunidad de usuarios de Galvanize. Como parte de su suscripción, puede descargar y utilizar cualquier elemento del contenido de ScriptHub.

Si desea obtener más información, consulte Importar desde ScriptHub.

Crear o editar un script en el Editor de scripts

Puede crear o editar scripts escribiendo la sintaxis necesaria de ACLScript directamente en el Editor de scripts o utilizando uno de los métodos admitidos para introducir sintaxis.

Nota

Cuando cree o edite un script, debe asegurarse de introducir cada comando de ACLScript en una línea separada.

Crear o editar el script

  1. Realice uno de los pasos siguientes para abrir el script en el Editor de scripts:
    • Para crear un nuevo script, seleccione Archivo > Nuevo > Script.

      El script se crea con el nombre Nuevo_Script. Haga clic con el botón derecho del ratón en el nombre y seleccione Renombrar para cambiar el nombre del script.

      Nota

      Los nombres de los scripts tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

    • Para abrir un script existente, haga clic con el botón derecho del ratón sobre el script en la ficha Panorama del Navegador.
  2. Agregue, modifique o elimine la sintaxis de ACLScript en el Editor de Scripts.

    Sugerencia

    Puede usar estas teclas de método abreviado para las acciones comunes:

    • Ctrl+Z deshacer una o más acciones
    • Ctrl+Y rehacer una o más acciones
    • Ctrl+S guarda el proyecto de Analytics, incluido el script abierto
  3. (Opcional) Coloque el cursor en el lugar adecuado de un script y realice cualquiera de los siguientes pasos para insertar uno o más elementos específicos:
    ElementoPasos

    Nombre del elemento del proyecto

    (tabla, script, vista, área de trabajo o índice)

    1. Haga clic con el botón derecho del ratón y seleccione Insertar > Elemento del proyecto.
    2. Seleccione el tipo de elemento desde la lista desplegable Tipo de elemento.
    3. Seleccione uno o más nombres de elementos y haga clic en Aceptar.
    Nombre del campo
    1. Desde la barra de herramientas del Editor de scripts, haga clic en Insertar campo .
    2. Seleccione uno o más nombres de campos y haga clic en Aceptar.
    Expresión
    1. Desde la barra de herramientas del Editor de scripts, haga clic en Insertar expresión .
    2. Cree una expresión y haga clic en Aceptar.
    Cuadro de diálogo
    1. Desde la barra de herramientas del Editor de scripts, haga clic en Crear nuevo diálogo .
    2. Cree un cuadro de diálogo personalizado, haga clic en Cerrar y haga clic en Aceptar.

    Si desea obtener más información, consulte Crear cuadros de diálogo personalizados.

    Fecha y hora
    1. Haga clic con el botón derecho del ratón y seleccione Insertar > Fecha y hora.
    2. Introduzca o seleccione una fecha, fechahora u hora, y haga clic en Aceptar.
    Token de HighBond
    1. Haga clic con el botón derecho del ratón y seleccione Insertar > Token de HighBond para insertar un token de acceso de HighBond en el script.

      Se abre la página Administrar tokens API en el navegador. Es posible que primero deba iniciar sesión en Launchpad.

    2. Realice una de las siguientes acciones:
      • Utilizar un token existente En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar y escriba la contraseña de su cuenta de HighBond. Se muestra el token sin enmascarar.
      • Crear un nuevo token Haga clic en Crear token > HighBond API y escriba la contraseña de su cuenta de HighBond.

        Se crea un nuevo token de HighBond.

      Consejo

      Utilice un token existente a menos que tenga un motivo para crear uno nuevo. Si el token existente no funciona, cree uno nuevo.

      El uso de un token existente reduce la cantidad de tokens que necesita administrar.

    3. Haga clic en Copiar para copiar el token.

      Consejo

      No cierre el cuadro de diálogo que contiene el token hasta que haya pegado correctamente el token en el script.

    4. En Analytics, pegue el token en el lugar adecuado del script.
    5. En Launchpad, cierre el cuadro de diálogo que contiene el token.

      Si creó un nuevo token, se agrega una versión parcialmente enmascarada del token en la parte superior de su lista de tokens.

      Si desea más información, consulte Creación y administración de tokens de acceso.

    Precaución

    Proteja sus tokens de acceso como cualquier contraseña de cuenta. Contienen información exclusiva de su cuenta de HighBond. No debe compartir sus tokens de acceso.

  4. Seleccione Archivo > Guardar proyecto.
  5. En el cuadro de diálogo de confirmación, haga clic en Sí.

Editar la sintaxis del comando con un cuadro de diálogo

En lugar de editar los comandos manualmente en un script, puede editarlos usando el cuadro de diálogo asociado.

Nota

Este método está disponible únicamente para los comandos que tienen cuadros de diálogo.

  1. Seleccione un comando existente de ACLScript en el script.
  2. Desde la barra de herramientas del Editor de scripts, haga clic en Editar comando .

    Se abre el cuadro de diálogo del comando.

  3. En el cuadro de diálogo, haga los cambios necesarios en los parámetros del comando y haga clic en Aceptar.

    Se actualiza la sintaxis del script.

Probar el script

Si desea probar el script ejecutándolo, o recorriendo los pasos, haga clic en Ejecutar  o en Paso  en la barra de herramientas del Editor de scripts.

Nota

Si ejecuta o pasa por un script, todos los scripts abiertos se guardan automáticamente.

Abrir el proyecto como una aplicación de análisis

Si esta creando o editando estudios analíticos y desea abrir el proyecto como una aplicación de análisis, haga clic en Abrir como Aplicación de análisis  en la barra de herramientas del Editor de scripts.

Crear un script desde el log de comandos

Puede copiar las entradas del log desde la ficha Log del Navegador como punto de partida para crear un nuevo script o para agregarlas a un script existente. La sintaxis de cada comando que se ejecutó previamente en Analytics se graba en una entrada de log individual.

Puede seleccionar los siguientes tipos de entradas de log y copiarlas en un script nuevo o existente:

  • entradas individuales
  • una serie de entradas asociadas con una tabla
  • grupos más grandes de entradas asociados con una sesión o un período de tiempo
  1. En el Navegador, haga clic en la ficha Log para mostrar el log.
  2. Seleccione la entrada o el grupo de entradas del log que desee incluir en el script.

    Si selecciona elementos de nivel superior en la vista de árbol, las subentradas se seleccionarán automáticamente.

  3. Complete una de las siguientes acciones:
    Crear un nuevo script
    1. Haga clic con el botón derecho del ratón en la ficha Log y seleccione Guardar elementos seleccionados > Script.
    2. En el cuadro de diálogo Guardar script como, introduzca un nombre para el nuevo script y haga clic en Aceptar.

      Nota

      Los nombres de los scripts tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

      El nuevo script se agrega a la ficha Panorama del Navegador. El script se guarda en la carpeta que contiene la tabla de Analytics activa o en la carpeta del proyecto raíz si no hay una tabla abierta.

    Copiar la sintaxis de un script existente
    1. Haga clic con el botón derecho del ratón en la ficha Log y seleccione Copiar.
    2. Abrir un script existente si no hay ninguno abierto.
    3. En el Editor de scripts, coloque el cursor en el sitio donde desea insertar la sintaxis que copió.
    4. Haga clic con el botón derecho del ratón y seleccione Pegar.

Crear un script con el Grabador de scripts

El Grabador de scripts de Analytics permite crear un script registrando sus acciones a medida que trabaja con tablas y comandos en la interfaz de usuario de Analytics. La ventaja de utilizar el Grabador de scripts para crear scripts es que no necesita introducir manualmente la sintaxis requerida para cada comando de ACLScript y ni siquiera necesita conocer la sintaxis.

El Grabador de scripts sólo captura comandos. Como regla general, si el comando aparece en el log de comandos, puede ser capturado por el Grabador de scripts.

Consejo

El Grabador de scripts también es una herramienta útil para aprender ACLScript. Puede grabar los pasos de análisis con el Grabador de scripts y luego revisar los scripts resultantes para conocer los comandos y la sintaxis requeridos para reproducir el comportamiento en un script.

  1. Desde el menú principal de Analytics, seleccione Herramientas > Activar el grabador de scripts.

    El icono del Grabador de scripts se muestra en la barra de estado y se muestra una casilla de verificación a la izquierda del elemento del menú, que indica que el Grabador de scripts está activo.

  2. Realice los pasos de análisis o procedimientos que desea registrar.

    Analytics graba cada comando procesado en un nuevo script.

  3. Al finalizar el análisis o el procesamiento de datos, seleccione nuevamente Herramientas > Activar el grabador de scripts para desactivar el Grabador de scripts.

    Analytics le indica que guarde el script.

  4. Introduzca en el cuadro de texto un nombre descriptivo para el script y haga clic en Aceptar.

    Nota

    Los nombres de los scripts tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

Crear un script con la captura de sintaxis

La captura de sintaxis permite usar los menús y los cuadros de diálogo de Analytics para insertar la sintaxis de ACLScript automáticamente en un script.

  1. Abra el script con el que desea trabajar.
  2. (Opcional) Abra la tabla con la que desea trabajar.

    Consejo

    Si comienza la captura de sintaxis antes de abrir una tabla, la tabla no se abre físicamente en la ficha Vista porque los comandos no se ejecutan realmente durante la captura de la sintaxis. Es posible que le resulte difícil visualizar los comandos subsiguientes sin una tabla abierta que le sirva de orientación.

  3. Desde la barra de herramientas del Editor de scripts, haga clic en Comenzar la captura de sintaxis .
  4. Realice los pasos de análisis o procedimientos que desea registrar.

    La sintaxis asociada se inserta automáticamente en el script. Los comandos no se ejecutan verdaderamente.

  5. Haga clic en Finalizar la captura de sintaxis  para detener la inserción de sintaxis de los comandos en el script.

Crear un script a partir del historial de tabla

Puede crear un script sobre la base del historial asociado con una tabla de resultados o salida de Analytics.

Por ejemplo, si agrega una tabla de inventario mensual a un proyecto de Analytics y extrae los elementos y las divisiones pertinentes a una nueva tabla, podría hacer un script de ese proceso sobre la base del historial de la tabla asociada con la primera tabla de salida que creó.

Cada tabla que se crea como la salida de un comando de Analytics conserva un registro de los comandos que se utilizaron para crear la tabla, incluidos los comandos que crean tablas intermedias entre la tabla original de Analytics y la tabla de salida. Puede copiar este historial de la tabla a un nuevo script que se puede utilizar para automatizar la creación de las siguientes tablas de salida.

  1. Abra una tabla de salida que sea el resultado de un proceso que desee automatizar en un script.
  2. Seleccione Herramientas > Crear script desde el historial de tabla.

    Si se encuentra activa la Vista_predeterminada, Analytics le solicitará que renombre la vista para evitar que se sobrescriba al ejecutar el nuevo script.

  3. Si Analytics le solicita renombrar la vista, haga clic en Renombrar, introduzca otro nombre y haga clic en Aceptar.
  4. Introduzca un nombre para el nuevo script en el cuadro de diálogo Guardar como y haga clic en Aceptar.

    Nota

    Los nombres de los scripts tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

  5. (Opcional) Abra y edite el nuevo script si desea ajustar cualquiera de las conductas del script.

    Por ejemplo, en lugar de sobrescribir la tabla original puede optar por guardar la salida a una tabla con otro nombre.