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 Diligent y por la comunidad de usuarios de Diligent. 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 en 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 token

    Para obtener más información, consulte Adquirir un token de acceso de HighBond.

  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.

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.

Adquirir un token de acceso de HighBond

¡Precaución!

El token de acceso generado concuerda con la cuenta utilizada para iniciar sesión en HighBond. Como escritor de scripts, puede no ser apropiado especificar su propio token de acceso si el script que será usado por otras personas.

Proteja los tokens de acceso como cualquier contraseña de cuenta.

Utilice un token de acceso 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.

  1. Realice una de las siguientes acciones:

    • En el menú principal de Analytics, seleccione Herramientas > Token de acceso HighBond.

    • En el Editor de scripts, haga clic con el botón derecho del ratón y seleccione Insertar > Token de HighBond.

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

    Acceder a la página Administrar tokens de API desde Analytics es una función muy práctica. También puede iniciar sesión en HighBond para acceder a la página desde su perfil de usuario sin usar Analytics.

  2. Realice una de las siguientes acciones:

    • Usar un token existente

      1. En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar.

      2. Introduzca la contraseña de su cuenta de HighBond y haga clic en Confirmar.

        Se muestra el token sin enmascarar.

      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 el token correctamente.

    • Cree un nuevo token

      1. Haga clic en Agregar token > Analytics.

      2. En el panel lateral Nuevo token de Analytics, especifique la siguiente información:

        Campo u opción Descripción
        Descripción

        Introduzca una descripción que proporcione información útil, por ejemplo:

        • El propósito del token
        • Dónde se utiliza el token, por ejemplo, el nombre y la ubicación del script de Analytics, o el nombre y la ubicación de la tarea del robot
        Caducidad del token
        • Activado el token caduca después del número de días que especifique
        • Desactivado el token nunca caduca

        Nota

        Es posible que su organización tenga una política de seguridad que requiera que los tokens caduquen después de cierto tiempo. La creación de tokens con fecha de caducidad es una buena práctica. HighBond le envía una notificación por correo electrónico automatizada antes de la fecha de caducidad.
        Caduca en Especifique los días que faltan para que el token caduque (de 1 a 365).
        Contraseña Introduzca su contraseña de HighBond.

      3. Haga clic en Generar token.

      4. Haga clic en Copiar para copiar el token.

        Consejo

        No cierre el panel lateral que contiene el token hasta que haya pegado el token correctamente.

  3. En función del método de definición de contraseña que utilice, realice una de estas acciones:

    • Etiqueta de estudios analíticos PASSWORD En el Diseñador de la tarea de un robot ACL, pegue el token que ha copiado en un campo de parámetro de contraseña.

    • Comando PASSWORD En Analytics, pegue el token que ha copiado en la solicitud de contraseña que aparezca durante la ejecución del script.

    • Comando SET PASSWORD En Analytics, pegue el token que ha copiado en el lugar adecuado de la sintaxis del comando SET PASSWORD de un script.

  4. En Launchpad, cierre el cuadro de diálogo o el panel lateral 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 de HighBond.