Creación y edición de scripts

Tiene varias opciones para crear scripts:

  • Editor de scriptsEscriba la sintaxis del script en la ventana del Editor de scripts.
  • Log de comandosCopie y pegue la sintaxis del script desde el log de comandos.
  • Grabador de scriptsRegistre la sintaxis de los comandos a medida que los ejecuta.
  • Captura de sintaxisInserte la sintaxis de los comandos a medida que usted los selecciona en la interfaz de usuario sin ejecutarlos.
  • Historial de la tablaCopie 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.

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 claveAl 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ónAl 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 emparejadosAl 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.

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 la sintaxis.

Nota

Cuando agregue comandos ACLScript a un script debe seguir estas reglas de sintaxis con respecto a los saltos de línea:

  • Cada comando debe ingresarse en una línea separada. Dos comandos no pueden ocupar la misma línea (el mismo número de línea).

  • Casi todos los comandos ACLScript deben ingresarse en una sola línea (número de línea único). Los comandos de una sola línea no se pueden dividir en varias líneas. Los comandos de varias líneas deben seguir la sintaxis de varias líneas prescrita. Consulte los temas de ayuda de cada comando individual para conocer la sintaxis requerida. Consulte Comandos.

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.

    Consejo

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

    • Ctrl+Zdeshacer una o más acciones
    • Ctrl+Yrehacer una o más acciones
    • Ctrl+Sguarda 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, espacio 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 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.

  • PeríodosPara resaltar varias instancias de un término, haga doble clic en una única instancia del término en cualquier parte del script.

  • FrasesPara 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. Realice 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.

Importe scripts o fragmentos de código desde Portal para desarrolladores de Diligent

Otra opción para crear scripts consiste en usar las muestras de código de ACLScript en Portal para desarrolladores de Diligent. El portal contiene diversos recursos para desarrolladores que trabajan con los productos de Diligent, incluida una biblioteca basada en la Web de elementos automatizados mediante scripts de Analytics desarrollados por los empleados de Diligent. Como parte de su suscripción, puede descargar y utilizar cualquiera de estos elementos automatizados mediante scripts.

Descargue los elementos automatizados mediante scripts desde Portal para desarrolladores de Diligent y, luego, impórtelos en Analytics.

Nota

Es posible que pueda utilizar un elemento con script tal como está, o que deba personalizarlo para que se adapte a sus necesidades.

Descargar elementos con script desde la página de Muestras de código

  1. Vaya a la página de Muestras de Código en el Portal para desarrolladores de Diligent.

  2. Seleccione Iniciar sesión en la parte superior derecha e inicia sesióningrese usando su cuenta de Diligent One.

  3. En la página de Muestras de código, busque el elemento que desea utilizar y selecciónelo.

  4. Revise la información sobre los requisitos previos, los requisitos de datos y las limitaciones.

  5. Si el elemento coincide con sus necesidades, seleccione el ícono de descarga en el panel Archivos para descargar el elemento como un archivo *.aclscript en su computadora.

    Si existe más de un elemento en Archivos, descargue todos los elementos. Existe una dependencia entre los elementos.

  6. Si la sección Fragmentos de código dependientes existe en el panel de Archivos, puede navegar hasta esos elementos y descargarlos también.

Importar un elemento con script a la Analytics

  1. Abra el proyecto Analytics que desee usar para importar el elemento con scripts.

  2. En la pestaña Resumen del Navegador, haga clic derecho en la carpeta que desea usar para el elemento y seleccione Importar elemento del proyecto > Script.

  3. Navegue hasta el elemento descargado, selecciónelo y seleccione Abrir.

    El elemento con scripts se importa a Analyticsy se encuentra en la carpeta que especificó.

  4. En el cuadro de diálogo de confirmación, seleccione Aceptar.

  5. Repita el proceso para cualquier elemento adicional que haya descargado.

  6. Haga doble clic en un elemento importado para verlo en el Editor de scripts.

Adquiera un token de acceso de 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:

    • Desde el menú principal de Analytics, seleccione Herramientas > Token de acceso de Diligent One.

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

    Se abre la página Administrar tokens de API en el navegador. Es posible que primero deba iniciar sesión 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.

        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
        • ActivadoEl token caduca después del número de días que especifique.
        • DesactivadoEl 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 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 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 PASSWORDEn 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 PASSWORDEn Analytics, pegue el token que ha copiado en la solicitud de contraseña que aparezca durante la ejecución del script.

    • Comando SET PASSWORDEn Analytics, pegue el token en el lugar adecuado de la sintaxis de 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.

    Para obtener más información, consulte Creación y administración Tokens de acceso de Diligent One.