Guia de Implementação › Especificações de configuração do conector › Seção Geral

Seção Geral

A seção Geral consiste em atributos e subnós, como segue:

Estrutura do XML:

<General	
MajorVersion="2345"
MinorVersion="01245"
WorkingDirectoryName=" output"
DataSourceControlFileName="DatasourceControl.xml"
SendFileName="Send.txt"
SendControlFileName="SendControl.xml"
LogDebugMode="no"
ConsoleDebugMode="no"
RunOnce="yes"	
RepeatUntilDry="yes"
RuntimeErrorLimit="1"	
RetryRejectedEvents="yes"
RejectedEventsFileName="rejectedEvents.txt"
RejectedEventsUpperLimit="1000"
RegExUnlimitedSearch (V3.1 Patch)="no"
HoldRejectedEventsSpan="24"
GenerateStatistics="yes"
StatisticsFileName="MyStatistics.txt" >
KeepHistoricState="yes" >
DefaultTimeFormat="%Y/%m/%d-%H:%M:%S"
DefaultDecimalSymbol="."
DataSourceIdMaxLength="60"
DefaultDigitGroupingSymbol=","
SaveIllegalEvents ="no"
WriteEventErrorToLog ="yes"
IllegalEventsDirectoryName="xxxpath"
<DataSourceDifferenceFromUTC 
	DefaultOffset="2"
	TimeFormat="%Y/%m/%d-%H:%M:%S">
	<DayLightSaving 
		From="2001/04/09-12:00:00"
		To="2001/09/01-12:00:00"
		Shift="1"/>
</ DataSourceDifferenceFromUTC >
</General>

• MajorVersion - especifica o número da versão principal.
• MinorVersion - especifica o número da versão secundária.
• WorkingDirectoryName (opcional) -

  especifica o caminho padrão para os arquivos de saída do conector (controle da origem de dados, conversão, envio).

  Valor padrão: diretório de saída (pasta) no diretório do arquivo de configuração.

• DataSourceControlFileName (opcional) -

  especifica o nome do arquivo que o conector usa para acompanhar os últimos registros de dados recuperados da origem de dados.

  Valor padrão: DataSourcecontrol.xml (se não for especificado, é usado o valor padrão).

• SendFileName (opcional) -

  especifica o nome do arquivo contendo os eventos antes de serem enviados ao CA Business Service Insight.

  Valor padrão: Send.txt (se não for especificado, é usado o valor padrão)

• SendControlFileName (opcional) -

  especifica o nome do arquivo que o conector usa para monitorar o processo de envio.

  Valor padrão: SendControl.xml (se não for especificado, é usado o valor padrão)

• DataSourceIdMaxLength -

  define o comprimento máximo para o campo DataSourceId na tabela t_raw_data. Se o usuário inserir um texto mais longo, haverá erro no conector.

  Este valor deve ser inferior ou igual ao tamanho real da tabela.

  Valor padrão: 60

• SaveIllegalEvents - se selecionado, este atributo indica que os eventos inválidos devem ser gravados no arquivo.

  Valor padrão: no

• WriteEventErrorToLog - indica se erros nos dados devem ser gravados na tabela T_Log.

  Valores válidos: "yes" e "no"

  Valor padrão: "yes"

• IllegalEventsDirectoryName - não há valor padrão
• SendFileName (opcional) -

  especifica o nome do arquivo contendo os registros antes de serem enviados ao CA Business Service Insight.

  Valor padrão: Send.txt (se não for especificado, é usado o valor padrão).

• §SendControlFileName (opcional) -

  especifica o nome do arquivo que o conector usa para monitorar o processo de envio.

  Valor padrão: SendControl.xml (se não for especificado, é usado o valor padrão).

• LogDebugMode (opcional)

  Valores válidos: "yes" e "não"

  quando definido como "yes", o item seguinte é enviado à linha log-original da origem de dados, dos resultados da análise, CA Business Service Insight Unified Event.

• ConsoleDebugMode (opcional)

  Valores válidos: "yes" e "não"

  quando definido como "yes", são exibidas mensagens de depuração no console.

  • Indicadores para a leitura e a conversão de registros:
    • .: para um registro lido e convertido em um evento de saída.
    • i: para um registro ignorado pelo analisador de expressão regular.
    • I: para um registro lido e ignorado pelas tabelas de conversão.
    • R: para um registro lido, mas recusado pela tabela de conversão (não pode ser convertido pelas tabelas de conversão).
    • X: para um registro que apresentou problema durante a análise. Ele será ignorado e perdido ou será salvo na pasta de eventos inválidos.

  Observação: quando o registro lido passa por mais de um conversor, o indicador do registro é colocada entre parênteses. Por exemplo: […] ou [RRI].

  • Indicadores de status do conector:
    • 0: o conector está ativo e não leu nenhum registro no último segundo.
    • E: status Erro.
    • P: status Pausado.
    • S: comando Interromper recebido do CA Business Service Insight.
    • B: status Bloqueado. A tabela de eventos recusados está completa.
    • Indicadores de tabelas de conversão:
    • L: aguardando tabelas de conversão.
    • T: tabela de conversão enviada pelo/recebida do CA Business Service Insight.
    • t: alterações na tabela de conversão enviadas pelo/recebidas do CA Business Service Insight.
    • Indicadores de conexão:
    • <Connecting CA Business Service Insight: tentando estabelecer conexão com o CA Business Service Insight.
    • <Connecting CA Business Service Insight>: conexão estabelecida.
    • <Connecting DataSource: tentando estabelecer conexão com a origem de dados.
    • <Connecting DataSource>: conexão estabelecida.
• RunOnce (opcional)

  Valores válidos: "yes" e "não"

  quando definido como "no", o conector é executado continuamente.

  Quando definido como "yes", o conector do arquivo de texto é executado, lido, registrado e interrompido automaticamente. O conector de arquivo lê arquivos inteiros, aguarda alguns segundos, tenta ler novos registros (conforme o SleepTime). Se tais registros não existirem, ele é interrompido.

  Um conector de SQL executa cada consulta apenas uma vez. Se RepeatUntilDry estiver definido como "no", ele é interrompido imediatamente. Se RepeatUntilDry estiver definido como "yes", ele aguarda (conforme o SleepTime), tenta executar as consultas novamente (conforme o SleepTime da consulta) e, se não houver novos registros, ele é interrompido.

• RepeatUntilDry (opcional)

  Valores válidos: "yes" e "no" - valor padrão: "yes"

  Consulte o atributo RunOnce acima.

• RuntimeErrorsLimit (opcional) -

  determina o limite de erros (por exemplo, erros em eventos de entrada), antes de o conector ser bloqueado. Quando definido como 0, o conector não bloqueado.

  Valor padrão: 1 (o que significa que o conector é bloqueado após o primeiro erro)

• RetryRejectedEvents (opcional)

  Valores válidos: "yes" e "no" - valor padrão: "yes"

  Quando definido como "yes", os registros que precisam de conversão são mantidos no arquivo de eventos recusados enquanto aguardam a conversão.

  Não é recomendado definir este atributo como "no" para evitar a perda de dados importantes.

• RejectedEventsFileName (opcional) -

  o nome do arquivo que o conector usa para acompanhar os registros de dados recuperados a partir da origem de dados que aguardam a conversão.

  Valor padrão: rejected.txt (se não for especificado, é usado o valor padrão).

• RejectedEventsUpperLimit (opcional) -

  determina o limite dos registros recusados que são mantidos no arquivo rejected.txt. Quando o conector atinge esse limite superior, ele é interrompido e alterado para o status bloqueado até que esses registros sejam convertidos.

  Valor padrão: 1000

• RegExUnlimitedSearch - orienta o conector a realizar pesquisas completas, conforme a expressão regular.

  Valores válidos: "yes" e "não"

  Valor padrão: no

• HoldRejectedEventsSpan (opcional) -

  determina o número de horas durante as quais salvar o arquivo de eventos recusados. Se este atributo não for mencionado, o conector não apaga os eventos, os quais devem ser manipulados antes de o conector ser iniciado novamente.

  Não é recomendado usar este atributo, pois há risco de perda de dados importantes.

• GenerateStatistics (opcional)

  Valores válidos: "yes" e "no" - valor padrão: "yes"

  Quando definido como "yes", o conector cria um arquivo contendo informações estatísticas a cada minuto.

• StatisticsFileName (opcional) -

  especifica o nome do arquivo de estatística.

  Valor padrão: statistics.txt (se não for especificado, é usado o valor padrão).

• KeepHistoricState (opcional)

  Valores válidos: "yes" e "no" - valor padrão: "no"

  Quando definido como "yes", o conector salva todos os arquivos, exceto pelo arquivo de log, em uma nova pasta chamada Historic state yyyymmdd-hhmmss, onde yyyymmdd e hhmmss são os formatos de data e hora de criação.

• DefaultTimeFormat (opcional) -

  especifica o formato de data e hora padrão. Se este atributo for especificado, usa-se o formato de data e hora onde o atributo TimeFormat estiver ausente. Se ele não for especificado, o atributo TimeFormat em outros elementos é obrigatório.

• DefaultDecimalSymbol (opcional) -

  especifica o símbolo decimal padrão para os campos reais.

  Valor padrão: se não for especificado, é usado o valor padrão

• DefaultDigitGroupingSymbol (opcional) -

  especifica o símbolo de agrupamento de dígitos padrão para números inteiros e campos reais.

  Valor padrão: se não for especificado, é usado o valor padrão

• DataSourceDifferenceFromUTC - indica a diferença de horário entre UTC e o fuso horário do computador da origem de dados.
  • DefaultOffset - especifica o deslocamento do UTC fora do horário de verão.
  • TimeFormat - especifica o formato usado para analisar o horário de verão (descrito em seguida).
  • DayLlightSaving - especifica um período de horário de verão do fuso horário da origem de dados. Este elemento é opcional (o que significa que, se não for selecionado, não há horário de verão) e pode ter mais de uma ocorrência. Quando há mais de um elemento, eles devem ser apresentados por ordem de horário e não devem se sobrepor.
    • From - data de início do período.
    • To - data de término do período.
    • Shift - mudança de horário adicionada a DefaultOffset durante o horário de verão.