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

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

Finalización del código

A medida que escribe la sintaxis del script en el Editor de scripts, Analytics realiza diferentes tipos de finalización de código. La finalización del código reduce el trabajo asociado a la escritura de la sintaxis y también presenta la forma válida de los comandos, funciones, palabras clave y parámetros de ACLScript.

  • Autocompletado de comandos, funciones y palabras clave Al empezar a escribir, la característica de autocompletado ofrece una lista de selección actualizada progresivamente de comandos, funciones y palabras clave de ACLScript que coinciden con los caracteres escritos. Puede seleccionar un elemento de la lista para completar automáticamente el elemento de sintaxis.

  • Ayuda emergente para parámetros de función Al escribir el paréntesis de apertura después de un nombre de función válido, la ayuda emergente muestra el tipo de datos de la salida devuelta por la función y el formato requerido para los parámetros de la función.

  • Cierre automático de elementos de sintaxis emparejados Al escribir el carácter de apertura de cualquiera de los elementos de sintaxis emparejados que aparecen a continuación, se suministra automáticamente el carácter de cierre:

    • Comillas dobles ""

    • Comillas simples ''

    • Comillas inversas ``

    • Paréntesis ()

Puede desactivar la opción de completar automáticamente comandos, funciones y palabras clave 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 emergente para parámetros de función y el cierre automático de elementos de sintaxis comunes no pueden desactivarse.

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

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

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 de Diligent One

    Para obtener más información, consulte Adquiera un token de acceso de Diligent One.

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

Resalte los términos o elementos de sintaxis repetidos

Puede resaltar términos repetidos a lo largo de un script, como nombres de tablas, campos, variables o palabras clave. También puede resaltar elementos de sintaxis repetidos, como paréntesis o comillas.

La posibilidad de resaltar todas las apariciones de un término o elemento de sintaxis concreto es una característica útil para el desarrollo y la depuración de scripts.

  • Términos Para resaltar varias instancias de un término, haga doble clic en una única instancia del término en cualquier parte del script.

  • Frases Para resaltar varias instancias de una frase, seleccione una única instancia de la frase en cualquier parte del script.

Nota

El comportamiento destacado no siempre coincide con sus expectativas. Por ejemplo, si selecciona los signos de porcentaje % que rodean un nombre de variable, es posible que no se resalten las instancias adicionales de la variable. En su lugar, haga doble clic en el nombre de la variable para resaltarla de forma más coherente en todo el script.

Resaltar los paréntesis coincidentes

Puede resaltar los paréntesis coincidentes en una expresión como una función con parámetros anidados. La posibilidad de resaltar los paréntesis de apertura y cierre coincidentes en expresiones complejas acelera la codificación y reduce la posibilidad de introducir un error al crear una expresión con paréntesis no coincidentes.

Para resaltar los paréntesis coincidentes, coloque el cursor inmediatamente antes o después de un paréntesis en una secuencia de comandos. Tanto el paréntesis inicial como el final aparecen resaltados. Si no se resaltan los paréntesis coincidentes, sabrá que falta uno de los pares de paréntesis.

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.

Abrir dos scripts uno al lado del otro

Puede abrir dos scripts uno al lado del otro en el Editor de scripts, lo que permite comparar y copiar fácilmente la sintaxis de un script a otro.

  1. En la pestaña Panorama del Navegador, seleccione los dos scripts que desea abrir uno al lado del otro.

    Puede pulsar Ctrl+clic para seleccionar dos scripts no adyacentes, o Mayús+clic para seleccionar scripts adyacentes.

  2. Haga clic con el botón derecho en uno de los scripts seleccionados y seleccione Edición lado a lado.

    Los dos scripts se abren en modo lado a lado.

  3. Haga clic en el cuerpo de cualquiera de los scripts para pasar de uno a otro.

    Si utiliza el color de fondo predeterminado en el Editor de scripts, el script activo en ese momento tiene un fondo más claro.

  4. Para guardar los cambios en uno o ambos scripts, realice una de las siguientes acciones:

    • Pulse Ctrl+S y haga clic en Sí en el cuadro o cuadros de diálogo de confirmación que aparezcan.

    • En la barra de herramientas de Analytics, haga clic en Guardar el proyecto abierto , y haga clic en Sí en el cuadro o cuadros de diálogo de confirmación que aparezcan.

  5. Para salir del modo lado a lado, haga clic en el icono de cierre de la pestaña de script.

    Los dos scripts se abren en pestañas separadas del Editor de scripts.

Probar el script

Si desea probar un 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.Analytics

  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.

Adquiera un token de acceso de Diligent One

¡Precaución!

El token de acceso generado concuerda con la cuenta utilizada para iniciar sesión en Diligent One. Como escritor de scripts, puede no ser apropiado especificar su propio token de acceso si otras personas van a usar el script.

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

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

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

    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 Diligent One 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 Diligent One y haga clic en Confirmar.Diligent One

        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. Diligent One le envía por correo electrónico una notificación 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 la contraseña de su cuenta de Diligent One.

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

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

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

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