Migrar scripts desde AX a Robots

Importante

Solo proceda a migrar los scripts si ha completado la etapa previa de la migración. Si desea obtener más información, consulte Recrear la estructura del almacén de AX en Robots.

Debe migrar los scripts asociados para cada proceso automatizado de AX que planee volver a crear en Robots. Debe migrar todos los scripts de estudios analíticos y todos los subscripts o scripts auxiliares.

No puede migrar los scripts directamente desde AX a Robots. Debe exportar los scripts desde AX a una ubicación intermedia donde esté instalado Analytics, como su propia computadora. Después de completar el trabajo de preparación necesario, confirme y envíe (cargue) los scripts desde la ubicación intermedia a Robots.

Compatibilidad con versiones anteriores de Robots

En general, Robots está diseñado para ofrecer la mayor compatibilidad posible con versiones anteriores de AX. La mayoría de los scripts de AX deberían funcionar en Robots sin necesidad de modificación.

Los scripts que dependan de un diseño específico de AX se deberán ajustar. Por ejemplo:

  • los scripts que acceden a la base de datos operativa de AX para leer los logs o programas de trabajos
  • los scripts que incluyen rutas absolutas a los recursos del servidor que ya no son válidas en el Agente de Robots

Si necesita ayuda para ajustar los scripts de estudios analíticos para usarlos en Robots, comuníquese con el Soporte de Diligent.

Exportar los scripts desde AX

Para comenzar la migración, utilice la opción Exportar para exportar scripts desde AX. Los scripts se exportan en la aplicación de análisis que los contiene. Cada aplicación de análisis exportada se convierte en un proyecto de Analytics independiente en el destino de exportación.

En este procedimiento se da por sentado que está utilizando su propia computadora como la ubicación intermedia.

  1. Cree una carpeta en su computadora para almacenar los scripts exportados.
  2. En el Explorador del servidor de AX, seleccione la aplicación de análisis que contiene los scripts que desea exportar.

    Puede usar la combinación de teclas Ctrl+clic para seleccionar varias aplicaciones de análisis de la misma carpeta principal de Aplicaciones de análisis o seleccionar la carpeta principal para exportar todas las aplicaciones de análisis de la carpeta.

  3. Seleccione Archivo > Exportar.
  4. En el cuadro de diálogo Exportar, asegúrese de que ambas opciones estén sin seleccionar:
    • ¿Trabajar con los archivos exportados?
    • Exportar los archivos de datos junto con las definiciones seleccionadas
  5. Haga clic en Examinar, seleccione la carpeta que creó para almacenar scripts y haga clic en Aceptar.
  6. Haga clic en Aceptar para exportar la o las aplicaciones de análisis.

    Los scripts se exportan en la aplicación de análisis a la ubicación especificada. Cada aplicación de análisis se convierte en un proyecto de Analytics.

  7. Repita el proceso para los demás scripts que esté preparado para migrar.

Scripts de estudios analíticos enlazados

A diferencia de AX, Robots no admite scripts de estudios analíticos enlazados. Si utiliza scripts de estudios analíticos enlazados en AX, exporte el script de estudio analítico principal y después confírmelo y envíelo a cada robot en el que lo necesite.

Completar todo el trabajo de preparación necesario

Después de la exportación desde AX, los scripts están preparados para ser enviados y confirmados a Robots si:

  • todos los scripts asociados con un proceso automatizado se encuentran en un único proyecto de Analytics
  • todos los scripts que se deben ejecutar en secuencia en un proceso automatizado:
    • utilizan un esquema de nombres alfanuméricos adecuado
    • tienen un tipo de estudio analítico adecuado, si está implementado

Cadenas de estudios analíticos

A diferencia de AX, Robots no admite cadenas de estudios analíticos. Si utiliza cadenas de estudios analíticos, es posible que deba hacer un trabajo de preparación antes de que los scripts estén preparados para ser confirmados y enviados a Robots. Si desea obtener más información, consulte Replicar las cadenas de estudios analíticos en Robots.

Confirmar y enviar (cargar) los scripts a Robots

Una vez que todos los scripts asociados con un proceso automatizado estén incluidos en un único proyecto de Analytics y tengan los nombres adecuados, puede confirmar y enviar los scripts a Robots.

Al confirmar y enviar scripts, se los carga desde un entorno local a la aplicación Robots basada en la nube. Utilizamos la frase "confirmar y enviar" en lugar de "cargar" porque cada vez que confirma y envía scripts al mismo robot, crea una nueva versión de los scripts en el historial de scripts.

Si desea obtener información detallada, consulte Committing ACL scripts (uploading) to Robots.

  1. Abra el proyecto de Analytics con los scripts que desea confirmar y enviar.
  2. Desde el menú principal de Analytics, seleccione Archivo > Confirmar y enviar scripts.

    If an error message appears, there may be a problem with the analytic header, or the script syntax, in one or more of the scripts in the project.

    For more information, see ACL script development workflow in Analytics and Robots.

  3. Si es necesario, en el cuadro de diálogo Seleccionar destino, haga doble clic en la instancia adecuada de Diligent One.

    La Colección de robots aparece con la lista de robots existentes.

  4. En la lista de robots, seleccione el robot al que desea confirmar los scripts y haga clic en Aceptar.

    El proyecto de Analytics que contiene los scripts y el robot existente se asocian, de manera que en las confirmaciones posteriores no es necesario buscar manualmente el robot.

  5. Escriba un breve mensaje de envío y confirmación que describa los scripts confirmados y haga clic en Aceptar.

    Los scripts se confirman y envían al modo de desarrollo en el robot.

  6. En el cuadro de diálogo La confirmación y envío de los scripts se completó correctamente, haga clic en el segundo enlace para inspeccionar los scripts que acaba de confirmar y enviar a la aplicación Robots.

    Se abre la ficha Versiones de scripts con la versión de los scripts que se confirmó y envió.

  7. Seleccione la versión del script (vn).

    Se abre el panel lateral Detalles de la versión. Los nombres de los scripts de estudios analíticos individuales y los scripts auxiliares se incluyen debajo de Cambios en la versión del script.

  8. En Analytics, haga clic en Aceptar para salir del cuadro de diálogo La confirmación y envío de los scripts se completó correctamente.

Replicar las cadenas de estudios analíticos en Robots

Nota

Esta sección se aplica únicamente si utiliza cadenas de estudios analíticos en AX.

A diferencia de AX, Robots no admite actualmente la unión de scripts de estudios analíticos desde cualquier lugar del almacén para crear una cadena de estudios analíticos que se ejecute en una secuencia. Para implementar la ejecución de una serie de scripts de estudios analíticos en secuencia dentro de Robots, debe hacer dos cosas:

  • incluir los scripts de estudios analíticos en un único robot y crear una tarea única para ejecutar los scripts
  • usar los nombres de los scripts y el tipo de estudio analítico para crear una secuencia de scripts

Incluir los scripts de estudios analíticos en un único robot

Incluya los scripts de estudios analíticos que desea ejecutar en secuencia dentro de un único robot.

Para incluir los scripts en un único robot, primero debe incluir todos los scripts relacionados en un único proyecto de Analytics. Usted confirma y envía los scripts como un único conjunto denominado versión de un script desde el proyecto de Analytics al robot.

Una vez que los scripts se encuentran en un único robot, usted crea una tarea única para ejecutar la serie de scripts de estudios analíticos.

Incluir los scripts asociados en un único proyecto de Analytics

Si los scripts asociados con un único proceso automatizado se distribuyen en dos o más proyectos de Analytics, debe unir los scripts en un único proyecto antes de confirmarlos y enviarlos a Robots. Esto podría ocurrir si los scripts de estudios analíticos forman parte de una cadena de estudios analíticos en AX.

  1. Abra el proyecto de Analytics que desea usar para incluir todos los scripts asociados con un proceso automatizado.
  2. En la ficha Panorama del Navegador, haga clic con el botón secundario del ratón en el nombre del proyecto, ubicado en la parte superior de la vista de árbol, y seleccione Copiar de otro proyecto > Script.
  3. En el cuadro de diálogo Ubicar archivo de proyecto, busque y seleccione el proyecto de Analytics desde el que desea copiar el o los scripts y haga clic en Abrir.
  4. En el cuadro de diálogo Importar, complete cualquiera de los siguientes pasos para agregar uno o más scripts a la lista A nombre_del_proyecto:
    • Haga doble clic en un script.
    • Haga Ctrl+clic en varios scripts y después haga clic en el botón de la flecha hacia la derecha.
    • Haga clic en Agregar todos para agregar todos los scripts.
  5. Haga clic en Aceptar para copiar el o los scripts en el proyecto de destino.

    Si ya existe un script con el mismo nombre en el proyecto, se agregará un número creciente como sufijo al nombre del script copiado.

  6. Repita el proceso para los scripts de otros proyectos que necesite incluir en el proyecto de destino.

Usar los nombres de los scripts y el tipo de estudio analítico para crear una secuencia de scripts

Nombres de los scripts

Los scripts de estudios analíticos se ordenan alfanuméricamente por nombre en una tarea de un robot y se ejecutan en orden. Por lo tanto, debe asignar un nombre a los scripts de estudios analíticos de forma tal que se cree la secuencia de ejecución que usted desee.

Por ejemplo, el primer script de la secuencia podría usar el prefijo A_01, el segundo script podría tener el prefijo A_02, o B_01, etc. Un sistema de prefijos facilita la inserción de otros scripts más adelante. Los subscripts o los scripts auxiliares no están sujetos al requisito de asignación de nombres en secuencia.

Nota

No puede cambiar el nombre de los scripts en Robots; por lo tanto, asegúrese de que todos los scripts tengan el nombre correcto en Analytics antes de confirmarlos y enviarlos a Robots.

Tipo de estudio analítico

Para facilitar la creación de una secuencia, puede especificar un tipo para los scripts de estudios analíticos. Si especifica un tipo, los scripts se agrupan en áreas independientes de una tarea. Las áreas se ordenan de la siguiente manera y se ejecutan en orden:

  • Importar
  • Preparación
  • Análisis

Dentro de cada área, los scripts se ordenan alfanuméricamente. Sin importar cuál sea el nombre de los scripts, una tarea ejecuta todos los scripts de un área antes de pasar a la siguiente área.

Si desea obtener más información, consulte Etiqueta ANALYTIC.

Renombrar los scripts de estudios analíticos para crear una secuencia de ejecución

Si desea que dos o más scripts de estudios analíticos se ejecuten en una secuencia, deben tener un nombre que cree la secuencia de ejecución que usted desee. Si desea obtener más información, consulte Replicar las cadenas de estudios analíticos en Robots.

Nota

El nombre del script de estudio analítico que especificó en el encabezado del estudio analítico es el nombre utilizado en Robots. El nombre del script de la ficha Panorama del Navegador no se utiliza.

  1. En Analytics, abra el script de estudio analítico que desea renombrar.
  2. En la etiqueta //ANALYTIC del encabezado de estudio analítico, actualice el nombre del estudio analítico y haga clic en Guardar el proyecto abierto .

    Si desea obtener más información, consulte Etiqueta ANALYTIC.

  3. Repita el proceso para todos los scripts de estudios analíticos que se deben renombrar.

Especificar un tipo de estudio analítico para agrupar scripts de estudios analíticos

Si desea agrupar scripts de estudios analíticos en áreas independientes de Importación, Preparación y Análisis de la tarea, debe especificar un tipo de estudio analítico correspondiente para cada script. La agrupación de scripts de estudios analíticos le da una opción adicional de crear una secuencia de scripts, pero esto no es necesario. Si desea obtener más información, consulte Replicar las cadenas de estudios analíticos en Robots.

  1. En Analytics, abra el script de estudio analítico para el cual desea especificar el tipo.
  2. En la etiqueta //ANALYTIC del encabezado de estudio analítico, agregue un tipo de estudio analítico y haga clic en Guardar el proyecto abierto .

    Si desea obtener más información, consulte Etiqueta ANALYTIC.

  3. Repita el proceso para todos los scripts de estudios analíticos que deben contar con un tipo de estudio analítico.

Cómo continuar

Una vez que haya migrado los scripts de uno o más procesos automatizados, está preparado para comenzar a migrar datos: Migrar datos de AX a Robots.