Definición de exportadores

Los exportadores proporcionan las instrucciones para enviar los datos del evento.

La funcionalidad de transformación proporciona tres tipos de exportadores para exportar archivos .vsl, archivos de registro, archivos XML y datos ODBC como archivos .vsl, archivos de texto o archivos de texto delimitados que se pueden utilizar en rutinas de carga de DataWarehouse, agencias de auditoría u otros destinos.

NOTA

Para que un exportador funcione correctamente, el origen de registro debe cumplir los requisitos adecuados que se describen en la sección Log Sources de Log Processing Configuration File.

Definición de un exportador

  1. Abra Transform.cfg en Data Workbench. Consulte Para editar el archivo Insight Transform.cfg.

  2. Haga clic con el botón secundario en Exporters y, a continuación, haga clic en Add New.

  3. Seleccione una de las siguientes opciones:

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    NOTA

    Para la opción ExportVSLFile, todos los campos ampliados del archivo de entrada y todos los campos definidos por el usuario del formulario cs(header) siempre se escriben en el archivo de salida VSL. Si sobrescribe un campo extendido existente, el nuevo valor se escribirá en el archivo de salida, incluso si el campo está en blanco.

  4. Edite los parámetros de Exportadores en el archivo de configuración utilizando la siguiente tabla como guía:

    Parámetro Descripción
    Formato de datos

    Solo para ExportTextFile. El formato de cada línea de salida, que consiste en secuencias de escape del nombre del campo (expresado como %nombre del campo%) y cualquier otro texto fijo deseado. El formato debe incluir un separador de líneas, normalmente [CR] [LF].

    Se puede incrustar un signo de porcentaje literal (%) en la cadena de formato escapando el carácter como se muestra aquí: %%

    Un ejemplo de entrada para el parámetro Formato de datos es %x-timestring% %x-trackingid%[CR][LF].

    Campos Solo para ExportDelimitedTextFile. Nombres de los campos que se van a generar.
    Delimitador

    Opcional. Solo para ExportDelimitedTextFile. Carácter que se utiliza para separar los campos del archivo de salida.

    El software no puede omitir los delimitadores que están incluidos en los valores de los datos. Como resultado, Adobe no recomienda utilizar comas como delimitadores.

    Si mantiene pulsada la tecla Ctrl y hace clic con el botón derecho en el parámetro Delimitador, aparece un menú Insertar. Este menú contiene una lista de caracteres especiales que a menudo se utilizan como delimitadores.

    Separador de líneas Opcional. Solo para ExportDelimitedTextFile. Caracteres utilizados para separar líneas en los archivos de salida. El valor predeterminado es [CR] [LF].
    Nombre

    Opcional. Identificador del exportador. Este nombre aparece en la interfaz Estado detallado.

    Para obtener información sobre la interfaz Estado detallado, consulte la Guía del usuario de Data Workbench.

    Comentarios Opcional. Notas sobre el exportador.
    Ruta de salida

    Ruta en la que se deben almacenar los archivos de salida. La ruta de acceso es relativa a la carpeta de instalación del servidor de Data Workbench.

    Nota: El servidor de Data Workbench que almacena los datos de salida es el servidor de procesamiento número 0 en el archivo profile.cfg.

    Período de rotación del archivo

    Opcional. Frecuencia con la que se exportan los datos al archivo de salida. Cada archivo de salida contiene datos relacionados con un período de tiempo específico denominado período de rotación. Todos los cálculos de hora están en GMT: Un día comienza a medianoche GMT y finaliza el día siguiente a la medianoche GMT, incluso si los datos escritos en el archivo incluyen un campo que se ha transformado a la hora local.

    Los valores disponibles son los siguientes:

    • AÑO. Cada archivo contiene datos de un año natural.
    • MES. Cada archivo contiene datos de un mes natural. Los meses se numeran del 1 (enero) al 12 (diciembre).
    • SEMANA. Cada archivo contiene datos durante una semana. Una semana empieza el lunes. La semana que comienza en uno de los primeros siete días del año es la semana 1, y la semana anterior (parcial), si la hay, es la semana 0.
    • DÍA. Cada archivo contiene datos de un día del calendario.
    • HORA. Cada archivo contiene datos de una hora.
    • NONE. No se realiza ninguna rotación. Todos los datos se escriben en el mismo archivo (o en un conjunto de archivos según otros parámetros de configuración). Consulte el parámetro File Name Format en esta tabla.

    El periodo de rotación predeterminado del archivo es DAY.

    • Establezca la rotación del archivo en NONE solo cuando trabaje en modo sin conexión. Consulte la descripción del parámetro Modo sin conexión.
    Formato de nombre de archivo

    Opcional. Formato del nombre del archivo de salida.

    Cada entrada de registro se puede almacenar en un archivo cuyo nombre se deriva de la hora de inicio del periodo de rotación y, opcionalmente, de los valores de los campos en las filas que contiene. Los campos que se van a utilizar en el nombre del archivo están incrustados como escapes de nombre de campo (expresados como %nombre de campo%).

    Los componentes de nombre de archivo relacionados con el periodo de rotación están incrustados en la cadena de formato mediante las siguientes secuencias de escape:

    • %yyyy% (año de cuatro dígitos)
    • %yy% (año de dos dígitos)
    • %mm% (mes de dos dígitos, 01 - 12)
    • %ww% (semana de dos dígitos, 01 - 52)
    • %dd% (día de dos dígitos, 01 - 31)
    • %HH% (hora de dos dígitos, 00 - 23)

    El formato de nombre de archivo predeterminado es %yyyy%%mm%%dd%-%x-mask%.txt

    • Las secuencias de escape distinguen entre mayúsculas y minúsculas.
    • Cuando el periodo de rotación de archivos está establecido en NINGUNO, se sustituye una cadena vacía por cada una de las secuencias de escape, si está presente.
    • Se genera un error si Formato del nombre de archivo no genera un nombre de archivo único para cada período de rotación (consulte el parámetro Período de rotación de archivos en esta tabla). Por ejemplo, al usar el período de rotación DAY, las secuencias de escape %dd%, %mm% y %yy% o %yyyy% deben estar presentes en el patrón para evitar la pérdida de datos.
    • Si utiliza secuencias de escape de nombre de campo dentro del patrón y el campo dado tiene muchos valores distintos, se escriben muchos archivos de salida para cada período de rotación. Tenga en cuenta que este escenario puede provocar un rendimiento deficiente, por lo que debe utilizar esta función con precaución.
    • Todos los cálculos están en GMT.
    Ejecutar al pasar el ratón por encima

    Opcional. Cuando se finaliza cada archivo, se puede ejecutar un comando externo (Windows). La línea de comandos se deriva del nombre del archivo final sustituyendo las siguientes secuencias de escape en este parámetro:

    • %dir%. La parte de directorio del nombre del archivo final, incluida la barra invertida final.
    • %file%. El nombre del archivo (excepto el directorio y la extensión) del archivo final.
    • %ext%. La extensión (incluido el "." inicial) del nombre del archivo final.
    • %Ruta%. El nombre de la ruta de acceso completa del archivo, equivalente a %dir%%file%%ext%.

    De forma predeterminada, este parámetro está vacío (no se ejecuta ningún comando).

    Límite de memoria

    Opcional. Cantidad de memoria en bytes utilizada para almacenar en búfer la salida del exportador. El valor predeterminado es 10 000 000 bytes.

    Nota: Si tiene muchos archivos de salida abiertos al mismo tiempo, puede que desee aumentar este valor, pero puede disminuir la cantidad de memoria disponible para el uso de otros componentes del sistema. Sin embargo, reducir este valor puede ralentizar el proceso de exportación. Para obtener ayuda, póngase en contacto con el Adobe.

    Límite de archivos abiertos

    Opcional. Número máximo de archivos que pueden abrirse al mismo tiempo para la salida del exportador. Si se supera este número, se registra un error en el registro de eventos y el servidor de Data Workbench deja de ejecutarse. El valor predeterminado es 1000.

  5. Una vez definido el exportador (y haya realizado cambios en otros parámetros) en el archivo Transform.cfg, guarde el archivo localmente y guárdelo en el perfil adecuado del equipo de servidor de Data Workbench.

En esta página