El archivo Transform.cfg

El archivo data workbenchTransform.cfg contiene los parámetros que definen los orígenes de registro, las transformaciones de datos y los exportadores.

Las transformaciones que defina manipularán los datos sin procesar recopilados por los sensores (archivos .vsl) o contenidos en archivos de texto, archivos XML o bases de datos compatibles con ODBC y los generarán en campos existentes, sobrescribiendo los datos actuales o en campos recién definidos.

Para configurar la funcionalidad de transformación, edite el archivo Transform.cfg de Data Workbench en la carpeta Dataset para el perfil para el que desea exportar datos de evento. Normalmente, este perfil está dedicado a la funcionalidad de transformación (es decir, no se realiza ningún otro procesamiento de datos que no sea el definido en el archivo Transform.cfg de Data Workbench). Es importante tener en cuenta que todas las instrucciones de procesamiento especificadas en los archivos Log Processing Dataset Include para cualquier perfil heredado se aplican además de las especificadas en el archivo Transform.cfg de Data Workbench.

Para obtener información sobre los archivos de inclusión de conjuntos de datos, consulte Archivos de inclusión de conjuntos de datos.

Si los datos que desea exportar se procesan mediante un clúster de servidores de Data Workbench, cada uno de los servidores de procesamiento (DPU) del clúster procesa los datos, pero solo el primer DPU (servidor de procesamiento número 0 en el archivo profile.cfg) escribirá los datos de salida en su sistema de archivos local.

Para editar el archivo Transform.cfg de Data Workbench

  1. Mientras trabaja en el perfil cuyos datos desea exportar, abra Profile Manager y haga clic en Dataset para mostrar el contenido del directorio.
  2. Haga clic con el botón derecho en la marca de verificación situada junto a Data Workbench Transform.cfg y, a continuación, haga clic en Make Local. En la columna User aparece una marca de verificación para este archivo.
  3. Haga clic con el botón derecho en la marca de verificación recién creada y haga clic en Open > from the workbench. Aparecerá la ventana Transform.cfg del área de trabajo de datos.
  4. Edite los parámetros en el archivo de configuración utilizando la siguiente tabla como guía:
Parámetro Descripción
Hora de finalización

Opcional. Filtre los datos para incluir entradas de registro con marcas de tiempo hasta, pero no incluidas, esta vez. Adobe recomienda usar uno de los siguientes formatos para el momento:

  • 1 de enero de 2013HH:MM:SS EDT
  • 1 de enero de 2013 HH:MM:SS GMT

Por ejemplo, si especifica el 29 de julio de 2013 a las 00:00:00 EDT como Hora de finalización incluye datos hasta el 28 de julio de 2013 a las 11:59:59 PM EDT.

Debe especificar una zona horaria. La zona horaria no toma el valor predeterminado GMT si no se especifica. Para obtener una lista de abreviaciones de zona horaria admitidas por el servidor de Data Workbench, consulte Códigos de zona horaria .

El parámetro Usar hora de inicio/fin para fuentes de archivos de registro y sensor está relacionado con este parámetro.

Exportadores

Los subcampos de un exportador especifican cómo se procesan y/o dan formato a los datos de salida. Puede definir varios exportadores para un conjunto de orígenes de registro. Cada tipo de exportador crea la salida de forma independiente.

Existen tres tipos de exportadores:

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Para obtener más información sobre los tipos de exportadores, consulte Definición de exportadores .

Umbral hash Opcional. Un factor de muestreo para el submuestreo aleatorio de filas. Si se establece en un número n, solo se selecciona uno de cada n ID de seguimiento para la exportación, lo que reduce el número total de filas exportadas por un factor de n. Para exportar todas las filas, establecería Umbral hash en 1.
Condición de entrada de registro Opcional. Define las reglas según las cuales se tienen en cuenta las entradas de registro para la exportación. Para obtener más información acerca de la condición de entrada de registro , consulte Archivo de configuración de procesamiento de registros .
Fuentes de registro

Las fuentes de datos. Los orígenes de registro pueden ser archivos .vsl, archivos de registro, archivos XML o datos de bases de datos compatibles con ODBC. Para obtener información sobre fuentes de registro , consulte Archivo de configuración de procesamiento de registros .

Transform espera que todos los datos de origen estén en orden cronológico dentro de archivos de entrada ordenados lexicográficamente. Si no se cumple este requisito, los cálculos As de son incorrectos y se pueden procesar datos de entrada adicionales después de cerrar los archivos de salida.

Modo sin conexión

Opcional. Verdadero o falso. Si es true, Transform supone que todos los archivos de entrada están presentes cuando comienza a procesar los datos. Cuando se leen todos los datos de entrada, la transformación cierra todos los archivos de salida sin esperar a que se reciban datos adicionales. El valor predeterminado es false.

Nota: Si el modo sin conexión está establecido en verdadero, transformación espera que todos los datos de origen estén presentes antes de que se inicie el procesamiento. Se genera un mensaje de advertencia en el archivo VisualServer.log si se reciben datos adicionales después de cerrar los archivos de salida.

Volver a procesar

Opcional. Aquí se puede introducir cualquier carácter o combinación de caracteres. Si se cambia este parámetro y se guarda el archivo en el equipo Transform , se iniciará el reprocesamiento de datos.

Para obtener información sobre el reprocesamiento de los datos, consulte Reprocesamiento y retransformación .

Etapas

Opcional. Los nombres de las etapas de procesamiento que se pueden utilizar en los archivos Log Processing Dataset Include que se ejecutan además del archivo Transform.cfg del Data Workbench. Las etapas de procesamiento proporcionan una forma de ordenar las transformaciones que se definen en los archivos Inclusión del conjunto de datos de procesamiento de registros . Este parámetro es muy útil si ha definido una o más transformaciones dentro de varios archivos de inclusión de conjunto de datos de procesamiento de registros y desea que se realicen transformaciones específicas en puntos específicos durante el proceso de exportación.

El orden en el que se enumeran las fases aquí determina el orden en el que se ejecutan las transformaciones de los archivos de inclusión de conjunto de datos de procesamiento de registros durante la exportación de datos. El preprocesamiento y el postprocesamiento son fases integradas; El preprocesamiento siempre es la primera etapa y el postprocesamiento siempre es la última. De forma predeterminada, hay una etapa denominada predeterminada .

Adición de una nueva fase de procesamiento

  • En la ventana Data Workbench Transform.cfg , haga clic con el botón derecho en Etapas y, a continuación, haga clic en Agregar nueva > etapa .
  • Introduzca un nombre para la nueva etapa.

Eliminar una etapa de procesamiento existente

  • Haga clic con el botón derecho en el número correspondiente al escenario que desee eliminar y haga clic en Quitar < #stage_number .

Nota: Cuando especifica un escenario en un archivo inclusión de conjunto de datos de procesamiento de registros , el nombre del escenario debe coincidir exactamente con el nombre que escriba aquí. Para obtener más información sobre los archivos de inclusión de conjuntos de datos, consulte Archivos de inclusión de conjuntos de datos .

Hora de inicio

Opcional. Filtre los datos para incluir entradas de registro con marcas de hora en o después de esta hora. Adobe recomienda usar uno de los siguientes formatos para el momento:

  • 1 de enero de 2013 HH:MM:SS EDT
  • 1 de enero de 2013 HH:MM:SS GMT

Por ejemplo, si especifica el 29 de julio de 2013, 00:00:00 EDT como Hora de inicio, se incluirán datos a partir del 29 de julio de 2013, a las 12:00:00 a. m., EDT.

Debe especificar una zona horaria. La zona horaria no toma el valor predeterminado GMT si no se especifica. Para obtener una lista de abreviaciones de zona horaria admitidas por el servidor de Data Workbench, consulte Códigos de zona horaria .

Nota: El parámetro Usar hora de inicio/fin para fuentes de archivos de registro y sensor está relacionado con este parámetro.

Transformaciones

Opcional. Define las transformaciones que se deben aplicar a los datos. Para obtener información sobre los tipos de transformación disponibles, consulte Transformaciones de datos .

Nota: Los siguientes tipos de transformación no funcionan cuando se definen en el archivo Transform.cfg de Data Workbench:

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
NOTA

Si se reciben datos adicionales después de cerrar los archivos de salida (consulte Log Sources y Offline Mode en la tabla anterior), Transform crea nuevos archivos de salida con los datos adicionales. Los nombres de los nuevos archivos de salida se generan a partir del nombre del archivo de salida original con la adición de un número de versión entre paréntesis justo antes de la extensión. Por ejemplo, si el archivo de salida original es 20070701-ABC.vsl, las versiones posteriores de este archivo tendrán el nombre 20070701-ABC(1).vsl, 20070701-ABC(2).vsl, etc. Tenga en cuenta que el uso de archivos con versiones como entrada al servidor de Data Workbench puede provocar errores de procesamiento.

Adobe recomienda evitar la creación de archivos de salida con versiones, asegurándose de que todos los datos de origen estén en orden cronológico dentro de archivos de entrada ordenados lexicográficamente y, si Offline Mode está establecido en true, que todos los datos de origen estén presentes antes de que se inicie el procesamiento. Para obtener más información, consulte las entradas Log Sources y Offline Mode en la tabla anterior.

  1. Agregue transformaciones haciendo clic con el botón derecho en Transformations y haciendo clic en Add new > Transformation type. Complete los campos de transformación.

    Consulte Transformaciones de datos para obtener descripciones y ejemplos de las transformaciones que puede utilizar con la funcionalidad de transformación.

  2. Haga clic con el botón derecho (modified) en la parte superior de la ventana y, a continuación, haga clic en Save.

  3. Para que los cambios realizados localmente surtan efecto, en Profile Manager, haga clic con el botón derecho en la marca de verificación de Data Workbench Transform.cfg en la columna User y, a continuación, haga clic en Save to > profile name, donde el nombre del perfil es el nombre del perfil para el que desea exportar datos. El reprocesamiento de los datos comienza después de la sincronización del perfil.

    NOTA

    Para obtener información sobre el reprocesamiento de los datos para su exportación, consulte Reprocesamiento y retransformación.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now