Etiqueta DATA

Especifica que una tabla de Analytics generada por un script de estudio analítico se copia a una ubicación central de almacenamiento de datos en Robots.

En general, usted almacena las tablas de Analytics para que puedan ser utilizadas como tablas de entrada para scripts de estudios analíticos posteriores.

Nota

El almacenamiento de tablas de Analytics en una ubicación de almacenamiento de datos central tiene lugar gracias a ACL Robotics, con un único Agente de Robots en las instalaciones físicas. Esta función no está disponible si usa un Agente de Robots en la nube. La etiqueta DATA se ignora en los scripts de estudios analíticos que se ejecutan con un agente basado en la nube.

Sintaxis

//DATA nombre_tabla
  <descripción>

Parámetros

Nombre Descripción
nombre_tabla

El nombre de la tabla de Analytics que se debe almacenar.

Nota

El valor de nombre_tabla debe coincidir de forma exacta con el nombre de la tabla de salida de Analytics en el script de estudio analítico. No está poniéndole nombre a una tabla con nombre_tabla, está haciendo coincidir un nombre de tabla especificado en el script.

Puede usar caracteres comodín en el nombre_tabla para facilitar la coincidencia con un nombre de tabla en el script.

No puede utilizar una variable para nombre_tabla.

Debe especificar el nombre de la tabla, no el nombre del archivo de datos de origen.

Correcto:

//DATA Cheques_faltantes

Incorrecto:

//DATA Cheques_faltantes.fil

Nota

Si una tabla de Analytics existente de la subcarpeta de datos tiene el mismo valor que usted especifica, se sobrescribe la tabla existente.

Caracteres que no se admiten en los nombres de las tablas de datos

No incluya ningún espacio en el nombre_tabla.

No utilice ninguno de los siguientes caracteres en el nombre_tabla. No se los admite:

! @ # $ % ^ & ( ) - + = { } [ ] | \ : ; ' " < > , / . ` ~

Caracteres comodín

Puede utilizar caracteres comodín en nombre_tabla si es posible que parte del nombre de la tabla cambie. Por ejemplo, si el nombre de la tabla depende del mes (facturas-ene, facturas-feb, etc.), al especificar facturas-* se asegura de que se encuentre y se copie la tabla sin importar el sufijo del mes.

Puede especificar un único carácter comodín para copiar todas las tablas de salida de Analytics del script de estudio analítico a la subcarpeta de datos:

//DATA *

¡Precaución!

Tenga cuidado al usar caracteres comodín. Es posible que sobrescriba accidentalmente tablas de datos existentes si el patrón del comodín que especifica coincide con tablas que usted no planeaba sobrescribir.

Lo más conveniente es que el valor de nombre_tabla sea lo más específico posible. Use caracteres comodín únicamente cuando sea necesario.

Cargas a Robots

Si desea obtener información sobre las cargas a Robots, consulte Cargas a la aplicación Robots basada en la nube.Robots
descripción

opcional

Texto descriptivo sobre la tabla de salida u otra información. La descripción puede ser de varias líneas, pero no se pueden saltear líneas.

La descripción aparece únicamente en el encabezado del estudio analítico y los usuarios finales no pueden verla en Robots.

Ejemplos

Copia de una tabla de Analytics a la ubicación de almacenamiento

El siguiente encabezado de estudio analítico especifica que la tabla Facturas, que se genera en el script asociado, se copie en la ubicación de almacenamiento:

COMMENT
//ANALYTIC Importar tabla
//DATA Facturas
END
IMPORT DELIMITED TO Facturas "Facturas.fil" FROM "Facturas.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR ALLFIELDS

Observaciones

Almacenamiento de tablas de salida

Las tablas de salida no se copian automáticamente a la ubicación de almacenamiento. Debe utilizar una etiqueta DATA para cada tabla que desee almacenar. Si es necesario, puede incluir varias etiquetas DATA en un encabezado de estudio analítico.

¿Cuándo debo usar la etiqueta DATA?

Existen dos situaciones en las que es necesario usar la etiqueta DATA y almacenar las tablas de Analytics:Analytics

  • las tablas de salida se usan como entrada para scripts de estudios analíticos posteriores
  • los usuarios pueden seleccionar campos o tablas de entrada al programar un script de estudio analítico o al ejecutarlo ad hoc

Nota

Si se completa la totalidad de un proceso de análisis de datos con un único script de estudio analítico, no es necesario utilizar la etiqueta DATA.

La etiqueta DATA no tiene por fin especificar tablas de resultados. Para eso, use de la etiqueta RESULT. Si desea obtener más información, consulte Etiqueta RESULT.

Las tablas de salida se usan como entrada para scripts de estudios analíticos posteriores

Según el entorno de instalación y la estructura de los scripts asociados, es posible que necesite usar la etiqueta DATA para almacenar una tabla de salida de Analytics que desee usar en un script de estudio analítico posterior.Analytics

Durante el procesamiento del script de estudio analítico, Robots utiliza un directorio temporal para almacenar las tablas de salida de Analytics y acceder a ellas; por lo tanto, tal vez no necesite usar la etiqueta DATA.RobotsAnalytics

La siguiente tabla sirve como guía.

Entorno de instalación Use la etiqueta DATA si... No necesita usar la etiqueta DATA si...
Robots

(Enterprise Edition solamente)
  • se necesita una tabla de salida de Analytics de una tarea de robot como datos de entrada para otra tarea de robot
  • se genera una tabla de Analytics y, a continuación, se la utiliza como datos de entrada de una secuencia de scripts de estudios analíticos que se ejecutan en una tarea de robot única
  • se completa la totalidad de un proceso de análisis de datos con un único script de estudio analítico

Los usuarios pueden seleccionar campos o tablas de entrada

Las etiquetas de estudio analítico TABLE y FIELD crean parámetros de entrada que le permiten al usuario seleccionar una tabla de Analytics, y seleccionar campos de la tabla, para usarlos como datos de entrada de un script de estudio analítico. Sin embargo, la tabla ya debe existir en la ubicación de almacenamiento para poder seleccionarla.

Si está desarrollando un script de estudio analítico que le permite al usuario escoger una o más tablas y campos de entrada, se debe ejecutar un script de estudio analítico anterior con la etiqueta DATA y guardar la o las tablas adecuadas en la ubicación de almacenamiento.

Ubicar tablas de entrada en la sección Tablas de origen de Robots

También puede agregar el prefijo src_ al nombre de una tabla de salida para ubicar la tabla de entrada en la sección Tablas de origen de la ficha Entrada/Salida de Robots.Robots

//DATA src_Facturas

Debe agregar el prefijo al nombre de la tabla tanto en la etiqueta DATA como en el script que la acompaña.

La sección Tablas de origen le permite separar visualmente las tablas que brindan datos de entrada para scripts posteriores. Si ningún nombre de tabla de salida tiene el prefijo src_, la sección Tablas de origen no aparece en la ficha Entrada/Salida y todas las tablas se ubican, por valor predeterminado, en la sección Otras tablas.

Cargas a la aplicación Robots basada en la nube

Con los scripts de estudios analíticos que se ejecutan en las instalaciones de Robots, la especificación de DATA carga únicamente el formato de tabla (nombre de campo, tipo de datos, longitud del campo) desde el Agente de Robots de las instalaciones físicas a la aplicación Robots basada en la nube en Diligent One. Los datos de la tabla continúan dentro de la red de su organización, dentro del directorio de Agente de Robots.

Toda la información se encripta mientras está en tránsito.