Servicio de configuración de extracción de datos

El servicio de extracción de datos utiliza valores configurada para determinar cuando ejecutar un extracto, qué extractar y dónde transferir los archivos de salida generados. Antes de poder utilizar el servicio de extracción de datos de IBM Sterling® Order Management System, el agente de extracción de datos del servicio debe estar configurado para funcionar en sus entornos.

Para que el servicio de extracción de datos extraiga los datos que necesita, deben definirse las configuraciones de tabla que indican los datos que deben extraerse para cada tabla de base de datos. De forma predeterminada, solo algunas tablas de base de datos están habilitadas para el servicio de extracción de datos. Existe una configuración de tabla para cada tabla que se ha habilitado para el servicio.

Nota: Para extraer datos que utilizan el servicio de extracción de datos, en las extensiones personalizadas debe añadir un índice en la columna MODIFYTS para cada tabla para la que se ha configurado la extracción de datos.

El servicio de extracción de datos lee la configuración de tabla para obtener las plantillas de consulta configuradas y determinar los datos que deben extraerse para esa tabla. Las configuraciones de tabla se almacenan dentro de la tabla de base de datos YFS_DATA_EXTR_CFG. El servicio de extracción de datos utiliza una API de creación, recuperación, actualización y supresión para gestionar esta tabla.

Existe un servicio CocDataExtractConfig en el Gestor de Aplicaciones para realizar todo tipo de operaciones sobre configuraciones de tablas de bases de datos.

Para ver los detalles de este servicio y ver las configuraciones de tabla, abra la herramienta Gestor de aplicaciones y vaya a Modelado de procesos > General > Servicios > Coc_Data_Extract para ver el servicio.

Cuando sea necesario añadir o cambiar una configuración, realice los cambios dentro del entorno de configuración maestro y, a continuación, migre la configuración a sus otros entornos con la herramienta de despliegue de configuración.

Plantillas

Al definir una configuración de tabla, las plantillas de consulta que definen el proceso de extracción de una configuración de tabla pueden parecerse a la siguiente estructura:

Plantilla de entrada:
```
<DataExtractConfig 
 Action="ADD|MODIFY|DELETE|GET|LIST" 
 DataExtractConfigKey="" 
 TableName="" TaskId="" 
 Columns="" 
 FrequencyInHours="" 
 FirstRunExtractInDays=""
/>
```
Donde

DataExtractConfigKey

Clave exclusiva para la configuración de tabla.

TableName

Nombre de la tabla que incluye datos que van a extraerse.

TaskId

Identificador para una extracción de tabla.
El identificador cuando se combina con el valor del atributo TableName forman un registro de configuración de tabla exclusivo. El identificador puede tener como máximo una longitud de 50 caracteres.

FrequencyInHours

Frequencia con la que se ejecuta el proceso de extracción para una tarea.
Este valor se establece en horas. Por ejemplo, el valor 12 indica que se extraen datos para las tablas que se configuran en la tarea cada 12 horas. El valor predeterminado es 24.

FirstRunExtractInDays

El rango, en días, desde la hora actual para la que se extraen los datos cuando el agente se ejecuta por primera vez. Después de que el agente se ejecute por primera vez, se establece NextStartts y las extracciones sucesivas se producen basándose en NextStartts. Por lo tanto, incluso si se modifica FirstRunExtractInDays , no se tiene en cuenta después de la primera ejecución.
El valor predeterminado es 30. Por ejemplo, si el agente se ejecuta la primera vez el 7/1/2016 con el valor predeterminado, se extraen todos los datos modificados desde el 6/1/2016.

Columnas

Lista separada por comas de columnas para una tabla que incluye datos que se van a extraer.
Los datos se extraen de las columnas en el orden en el que se listan las columnas.

Además de estos atributos, también puede pasar los atributos siguientes. Pase estos atributos con discreción y sólo si tiene una comprensión completa de su utilidad subyacente.

IsInactive

Distintivo para establecer una configuración activa o inactiva.
De forma predeterminada, todas las configuraciones están activas. Sin embargo, si desea desactivar una configuración, puede establecer IsInactive=Y. A continuación, puede reactivarlo estableciendo IsInactive=N.

NextStartts

Hora de inicio personalizada para la extracción de datos.
De forma predeterminada, el agente de extracción de datos realiza un seguimiento automático de la siguiente hora de inicio de los datos que se extraerán basándose en ejecuciones anteriores. Sin embargo, en escenarios específicos, puede especificar una hora de inicio personalizada pasando el atributo NextStartts=<custom start time>. Este atributo no es aplicable para una acción LIST.

PRECAUCIÓN:
Se recomienda NO utilizar el atributo NextStartts a menos que haya una necesidad apremiante de utilizar una hora de inicio personalizada. Si no se utiliza correctamente, es posible que esta acción pueda afectar negativamente al proceso de extracción de datos.

NextRun

Tiempo personalizado para desencadenar la siguiente ejecución.
De forma predeterminada, el agente de extracción de datos realiza un seguimiento automático de la hora a la que se ejecuta el siguiente desencadenante de la extracción de datos. Sin embargo, en escenarios específicos, puede especificar una siguiente ejecución personalizada pasando el atributo NextRun=<custom next run time>. Este atributo no es aplicable para una acción LIST.

Nota: Se recomienda NO utilizar este atributo a menos que haya una necesidad absoluta de utilizar un tiempo de ejecución siguiente personalizado.

Plantilla de salida para una acción distinta de LIST:


<DataExtractConfig 
 DataExtractConfigKey="" 
 TableName="" 
 TaskId="" 
 Columns="" 
 FrequencyInHours="" 
 FirstRunExtractInDays="" 
 IsInactive=""
 NextStartts=""
 NextRun=""
/>

Plantilla de salida para una acción que es LIST:


<DataExtractConfigList>    
  <DataExtractConfig ...as defined above />
</DataExtractConfigList>

Validaciones de configuración

Como parte de la configuración del servicio de extracción de datos, las siguientes validaciones pueden completarse para la configuración basándose en los valores que se establecen para una configuración de tabla

Acción	Validación
`ADD`	Cuando el atributo `Action` tiene el valor `ADD`, se realiza una comprobación para determinar si la configuración existe. Si la configuración existe, se produce un error. Todos los atributos de entrada, en el XML de plantilla de entrada, aparte del atributo `DataExtractConfigKey` , son obligatorios cuando el atributo tiene el valor `ADD` para completar esta validación.
`MODIFY`, `DELETE` o `GET`	Cuando el atributo `Action` tiene el valor `MODIFY`, `DELETE`o `GET`, existe una comprobación para determinar si se ha realizado la configuración. Si la configuración no existe, se produce un error. El valor para el atributo `DataExtractConfigKey` o los dos atributos `TableName` y `TaskId` debe pasarse para completar esta validación.
`LIST`	Cuando el atributo `Action` tiene el valor `LIST`, los atributos de entrada para la plantilla de consulta se comparan con todas las configuraciones. Todas las configuraciones que coinciden con los atributos de entrada se listan en la salida. Si no se pasa ningún atributo, se listan todas las configuraciones.
`ADD` o `MODIFY`	Cuando el atributo `Action` tiene el valor `MODIFY` o `ADD` y se pasa el valor para el atributo `TableName`, el valor para el atributo se compara con el código común CDE_VALID_TABLE. Si el nombre de tabla coincide con el código común, se da soporte a la extracción de datos de la tabla. Se suspende la validación para tablas ampliadas. Una tabla de historial se considera que está soportada cuando se da soporte a la contrapartida de no historial para la tabla. Puede añadir a la lista de elementos permitidos de tablas soportadas obteniendo valores de código más comunes del CodeTypeanterior.
`ADD` o `MODIFY`	Cuando el atributo `Action` tiene el valor `MODIFY` o `ADD` y se pasa el valor para el atributo `Columns`, el valor para el atributo se comprueba para determinar si la columna existe para la tabla. Si la columna no existe, se produce un error. No proporcione ninguna columna para ninguna tabla cuando el tipo de datos para la columna sea BLOB o de tipo de datos CLOB.

Nota: Si el servicio de extracción se ejecuta cuando el agente de extracción de datos se está ejecutando y ya está procesando una extracción de datos, cualquier modificación que realice en una configuración no afectará a la extracción de datos en curso. Los cambios se aplican la siguiente activación del agente.

Tablas de base de datos soportadas para la extracción de datos

Antes del release 22.3 , se proporcionaban algunas tablas de transacciones de forma predeterminada y se podían añadir tablas para la extracción de datos utilizando la API manageCommonCode . A partir de la versión 22.3, por defecto, todas las tablas del sistema de Sterling™ Order Management son tablas de extracción de datos válidas y no es necesario añadir manualmente ninguna tabla para la extracción de datos. Se recomienda utilizar el servicio de extracción de datos para extraer datos sólo de tablas transaccionales. También se recomienda utilizar la herramienta de despliegue de configuración (CDT) para extraer datos de las tablas de configuración y otros servicios adecuados para captar datos para las tablas maestras.

Migración de configuraciones de extracciones de datos

Cuando necesite copiar las configuraciones de extracciones de datos entre entornos, puede utilizar la herramienta de despliegue de configuración (CDT). Puede utilizar esta herramienta en cualquier momento para migrar datos de configuración para las tablas de configuración de extracción YFS_DATA_EXTR_CFG y YFS_DATA_EXTR_CLM de la base de datos de entorno de configuración maestra a una base de datos de destino. Sin embargo, antes de importar configuraciones de extracción de datos de un entorno a otro, las tablas y las columnas para las que se define la extracción de datos también están presentes en el entorno de destino.

Para obtener más información sobre la migración de datos de CDT, consulte Trabajar con la configuración maestra.