Serviço de configuração de extração de dados

O serviço de extração de dados usa definições configuradas para determinar quando executar uma extração, o que extrair e onde transferir arquivos de saída gerados. Antes de poder usar o serviço de extração de dados do IBM Sterling® Order Management System, o agente de extração de dados do serviço deve ser configurado para funcionar em seus ambientes.

Para o serviço de extração de dados para extrair os dados necessários, as configurações de tabela que indicam os dados a serem extraídos para cada tabela de banco de dados devem ser definidas. Por padrão, apenas algumas tabelas de banco de dados são ativadas para o serviço de extrair dados. Existe uma configuração de tabela para cada tabela ativada para o serviço.

Nota: para extrair dados que usam o serviço de extração de dados, em suas extensões customizadas, deve-se incluir um índice na coluna MODIFYTS para cada tabela para a qual a extração de dados está configurada.

O serviço de extração de dados lê a configuração da tabela para obter os modelos de consulta configurados e determinar os dados para extrair para essa tabela. As configurações de tabela são armazenadas dentro da tabela de banco de dados YFS_DATA_EXTR_CFG O serviço de extração de dados usa uma API de criação, recuperação, atualização e exclusão para gerenciar essa tabela

Um serviço CocDataExtractConfig está disponível no Gerenciador de aplicativos para concluir todos os tipos de operações nas configurações da tabela do banco de dados.

Para visualizar detalhes desse serviço e visualizar as configurações de tabela, abra a ferramenta Applications Manager e acesse Modelagem do processo > Geral > Serviços > Coc_Data_Extract para visualizar o serviço.

Quando for necessário incluir ou mudar uma configuração, faça as mudanças em seu ambiente de configuração principal e, em seguida, migre a configuração para seus outros ambientes com a ferramenta Configuration Deployment.

Modelos

Quando você está definindo uma configuração de tabela, os modelos de consulta que definem o processo de extração para uma configuração de tabela podem ser semelhantes à estrutura a seguir:

Modelo de Entrada:
```
<DataExtractConfig 
 Action="ADD|MODIFY|DELETE|GET|LIST" 
 DataExtractConfigKey="" 
 TableName="" TaskId="" 
 Columns="" 
 FrequencyInHours="" 
 FirstRunExtractInDays=""
/>
```
em que

DataExtractConfigKey

Chave exclusiva para configuração de tabela.

TableName

Nome da tabela que inclui dados a serem extraídos.

TaskId

Identificador para uma extração de tabela.
O identificador quando combinado com o valor do atributo TableName forma um registro de configuração de tabela exclusivo. O identificador pode ter no máximo 50 caracteres.

FrequencyInHours

Frequência com que o processo de extração é executado para uma tarefa
Esse valor é configurado em horas Por exemplo, um valor de 12 indica que os dados são extraídos para as tabelas configuradas na tarefa a cada 12 horas. A configuração padrão é 24.

FirstRunExtractInDays

O intervalo, em dias, do horário atual para o qual os dados são extraídos quando o agente é executado pela primeira vez. Após o agente ser executado pela primeira vez, o NextStartts é configurado e as extrações sucessivas acontecem com base no NextStartts. Portanto, mesmo se o FirstRunExtractInDays for modificado, ele não será considerado após a primeira execução
O valor padrão é 30. Por exemplo, se o agente for executado pela primeira vez em 1/07/2016 com a configuração padrão, todos os dados modificados desde 1/06/2016 serão extraídos.

Colunas

Lista separada por vírgula de colunas para uma tabela que inclui dados que devem ser extraídos.
Os dados são extraídos das colunas na ordem em que as colunas são listada

Além desses atributos, também é possível transmitir os atributos a seguir: Passe esses atributos com discrição e somente se você tiver um entendimento completo de sua utilidade subjacente

IsInactive

Sinalizador para definir uma configuração ativa ou inativa
Por padrão, todas as suas configurações estão ativas No entanto, se você desejar desativar uma configuração, será possível configurar IsInactive=Y É possível então reativá-lo configurando IsInactive=N.

NextStartts

Horário de início customizado para a extração de dados
Por padrão, o agente de extração de dados rastreia automaticamente o próximo horário de início dos dados a serem extraídos com base em execuções anteriores No entanto, em cenários específicos, é possível especificar um horário de início customizado passando o atributo NextStartts=<custom start time>. Esse atributo não é aplicável para uma ação LIST..

CUIDADO:
É recomendado que você NÃO use o atributo NextStartts , a menos que haja uma necessidade urgente de usar um horário de início customizado. Se não for usado corretamente, é possível que essa ação possa afetar negativamente seu processo de extração de dados.

NextRun

Tempo customizado para acionar a próxima execução.
Por padrão, o agente de extração de dados rastreia automaticamente o horário em que o próximo acionador da extração de dados é executado No entanto, em cenários específicos, é possível especificar uma próxima execução customizada passando o atributo NextRun=<custom next run time>. Esse atributo não é aplicável para uma ação LIST..

Nota: É recomendável que você NÃO use esse atributo, a menos que haja uma necessidade absoluta de usar um próximo tempo de execução customizado

Modelo de saída para uma ação diferente de LIST:


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

Modelo de saída para uma ação que é LIST:


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

Validações de configuração:

Como parte da configuração do serviço de extração de dados, as validações a seguir podem ser concluídas para a configuração com base na qual os valores são definidos para uma configuração de tabela

Ação	Validação
`ADD`	Quando o atributo `Action` tiver o valor `ADD`, será feita uma verificação para determinar se a configuração existe. Se a configuração existir, ocorrerá um erro. Todos os atributos de entrada, no XML do modelo de entrada, além do atributo `DataExtractConfigKey` , são obrigatórios quando o atributo tem o valor `ADD` para concluir essa validação...
`MODIFY`, `DELETE`ou `GET`	Quando o atributo `Action` tem o valor `MODIFY`, `DELETE`, ou `GET`, uma verificação existe para determinar se a configuração foi feita. Se a configuração não existir, ocorrerá um erro O valor para o atributo `DataExtractConfigKey` ou ambos os atributos `TableName` e `TaskId` devem ser transmitidos para concluir essa validação..
`LIST`	Quando o atributo `Action` tem o valor `LIST`, os atributos de entrada para o modelo de consulta são comparados com todas as configurações.. Todas as configurações correspondentes aos atributos de entrada são listadas na saída. Se nenhum atributo for transmitido, todas as configurações serão lisadas
`ADD` ou `MODIFY`	Quando o atributo `Action` tiver o valor `MODIFY` ou `ADD` e o valor para o atributo `TableName` for transmitido, o valor para o atributo será comparado ao código comum CDE_VALID_TABLE. Se o nome da tabela corresponder ao código comum, extrair dados da tabela será suportado. A validação é dispensada para tabelas estendidas.. Uma tabela de históricos é considerada suportada quando a contraparte não de histórico para a tabela é suportada É possível incluir na lista de permissões de tabelas suportadas obtendo mais valores de códigos comuns do CodeTypeacima.
`ADD` ou `MODIFY`	Quando o atributo `Action` tiver o valor `MODIFY` ou `ADD` e o valor para o atributo `Columns` for transmitido, o valor para o atributo será verificado para determinar se a coluna existe para a tabela... Se a coluna não existir, ocorrerá um erro Não forneça nenhuma coluna para nenhuma tabela quando o tipo de dados para a coluna for um tipo de dados BLOB ou CLOB.

Nota: Se o serviço de extração for executado quando o agente de extrair dados estiver em execução e já estiver processando uma extração de dados, qualquer modificação feita em uma configuração não afetará a extração de dados em andamento. As mudanças são aplicadas ao próximo acionador do agente..

Tabelas de banco de dados suportadas para extração de dados

Antes da liberação 22.3 , algumas tabelas de transações eram fornecidas por padrão e você poderia incluir tabelas para extração de dados usando a API manageCommonCode A partir da versão 22.3, por padrão, cada tabela no Sterling™ Order Management System é uma tabela de extração de dados válida e você não precisa adicionar nenhuma tabela manualmente para a extração de dados. É recomendado usar o serviço de extração de dados para extrair dados apenas de tabelas transacionais. Também é recomendável usar a Configuration Deployment Tool (CDT) para extrair dados das tabelas de configuração e outros serviços apropriados para buscar dados para tabelas principais.

Migrando configurações de extração de dados

Quando você precisar copiar suas configurações de extração de dados entre ambientes, será possível usar o Configuration Deployment Tool (CDT)... É possível usar essa ferramenta a qualquer momento para migrar dados de configuração para as tabelas de configuração de extração YFS_DATA_EXTR_CFG e YFS_DATA_EXTR_CLM do banco de dados do ambiente de configuração principal para um banco de dados de destino. No entanto, antes de importar configurações de extração de dados de um ambiente para outro, as tabelas e as colunas para as quais a extração de dados está definida também estão presentes no ambiente de destino.

Para obter mais informações sobre a migração de dados de CDT, consulte Trabalhando com a configuração principal