Configurar el archivo de configuración de orden del Programa de utilidad de extracción de datos

Cree un archivo de configuración de orden de extracción para que el Programa de utilidad de extracción de datos lo utilice para identificar objetos de negocio para extraer y la secuencia para extraer los datos. Este archivo también debe identificar los otros archivos de configuración para configurar el programa de utilidad e identificar los archivos de salida CSV o XML que el programa de utilidad va a generar.

Procedimiento

  1. Vaya al siguiente directorio, que contiene los archivos de configuración de ejemplo para extraer datos:
    • WCDE_installdir\samples\DataExtract
  2. Cree una copia de seguridad del archivo o archivos de configuración wc-extract-business-object.xml en el directorio o subdirectorios para el objeto u objetos que desea extraer, donde business-object es el nombre del objeto de negocio que se extrae.
  3. Abra el archivo de configuración de objeto de negocios (wc-dataextract-object.xml) para el objeto que desea extraer para su edición.
  4. Configure el elemento <_config:DataLoadEnvironment> para establecer el valor del atributo configFile para identificar el archivo de configuración de entorno. Si el archivo no está en el mismo directorio que el archivo de configuración principal, incluya la vía de acceso relativa al archivo de configuración de entorno.
  5. Configure el elemento <_config:LoadOrder> para establecer el valor para todos los atributos que desea aplicar al proceso de extracción para todos los elementos de carga.
    Por ejemplo, puede incluir una de las siguientes propiedades de par nombre-valor configurables para configurar la estructura de todos los archivos de salida CSV generados.
    firstTwoLinesAreHeader
    Configura los archivos de salida CSV generados de modo que incluyan dos líneas de datos de cabecera. La primera línea incluye la palabra clave para el tipo de objeto de negocio que se incluye en el archivo. La segunda línea incluye las cabeceras de columna. Puede incluir los siguientes valores para esta propiedad:
    true
    Los archivos CSV incluyen dos líneas de datos de cabecera.
    false
    Los archivos CSV no incluyen dos líneas de datos de cabecera. Este valor es el valor predeterminado.
    firstLineIsHeader
    Configura los archivos de salida CSV generado de modo que incluyan la cabecera de columna como línea de los datos de cabecera. Puede incluir los siguientes valores para esta propiedad:
    true
    Los archivos CSV incluyen las cabeceras de columna como una línea de cabecera.
    false
    Los archivos CSV no incluyen una línea de datos de cabecera. Este valor es el valor predeterminado.
    Si no incluye ninguna de las dos propiedades o establece las dos propiedades en false, el archivo de salida CSV generado no incluye ningún dato de cabecera. Los archivos incluyen solamente los registros de datos. Si incluye las dos propiedades establecidas en true, los archivos de salida CSV generados incluirán dos líneas de datos de cabecera.
    Nota: Puesto que el Programa de utilidad de extracción de datos utiliza la infraestructura existente del Programa de utilidad de carga de datos , puede incluir los atributos commitCount y batchSize. Dado que el Programa de utilidad de extracción de datos no inserta ningún datos en la base de datos, cualquier valor de estos atributos no afecta al proceso de extracción. Si incluye estos atributos, establezca el valor de commitCount en 0 y el valor de batchSize en 0.
  6. Configure la variable outputDirectory que se utiliza al especificar el directorio donde está el programa de utilidad para generar los archivos de salida configurados.
    Esta variable configurable se utiliza dentro del atributo location para el elemento <_config:DataOutputLocation> de cada elemento de carga para ayudar a definir de forma rápida la ubicación del archivo de salida. De forma predeterminada este directorio se denomina output y está en el mismo directorio que el archivo de configuración de orden de extracción de datos de ejemplo. Si desea el nombre del directorio o la ubicación, edite la siguiente configuración de variables en el archivo de ejemplo: 
    <_config:Variable name="outputDirectory" value"output" />
    Si desea cambiar la ubicación del directorio, incluya la vía de acceso relativa desde el directorio del archivo de configuración de orden o la vía de acceso absoluta del directorio donde desea que se generen los archivos de salida y todos los directorios de salida.
  7. Configure cada elemento <_config:LoadItem>.
    Asegúrese de que el valor para el atributo name identifique el objeto sobre el que se está extrayendo datos. el valor para cada uno de los atributos businessObjectConfigFile debe identificar el archivo de configuración de objeto de negocio correcto que el programa de utilidad necesita utilizar para transformar los datos de objeto. Si el archivo no está en el mismo directorio que el archivo de configuración principal, incluya la vía de acceso relativa al archivo de configuración de objeto de negocio.
  8. En el elemento <_config:DataOutputLocation> para cada elemento de carga, cambie el valor del atributo location de modo que identifique el nombre de archivo para el archivo de salida que se va a generar.
    Si desea que este archivo se genere en un subdirectorio distinto en la estructura de directorios de salida configurada, incluya la vía de acceso relativa al destino donde desea que el archivo se genere. Esta vía de acceso relativa es desde el directorio de salida configurado.

    Si desea que el programa de utilidad genere archivos de salida XML en lugar de archivos CSV predeterminados, especifique el nombre de archivo de salida con la extensión de nombre de archivo .xml. También debe editar el archivo de configuración de objeto de negocio para que el programa de utilidad utilice el grabador de datos XML.

  9. Guarde y cierre el archivo de configuración.

Qué hacer a continuación

Ejecute el mandato Programa de utilidad de extracción de datos. Para obtener más información sobre los parámetros que se pueden configurar al ejecutar el programa de utilidad desde un programa de utilidad de línea de mandatos, consulte Programa de utilidad de extracción de datos.

Para obtener más información sobre cómo extraer tipos de objetos específicos, consulte: