Guia de Implementação › Implementação › Coleta de dados (Especialista em fonte de dados) › Como configurar conectores e conversões › Estudo de caso do conector de arquivo › Seção TranslatorCollection do arquivo de configuração

Seção TranslatorCollection do arquivo de configuração

A seção do conjunto de conversores define como os registros da fonte de dados analisados e manipulados extraídos nas seções anteriores serão convertidos em um evento do CA Business Service Insight.

Essa seção também define como lidar com eventos duplicados e como usar o mecanismo de singularidade do evento (para obter mais detalhes, consulte Singularidade do evento).

Quando o modo de interface estiver definido como online, o evento do CA Business Service Insight terá uma estrutura unificada que contém os seguintes campos:

• Timestamp: a hora da ocorrência do evento.
• ResourceId: a ID do recurso associada ao evento (o recurso que foi avaliado nesse evento).
• EventTypeId: o tipo de evento associado ao evento e descreve o tipo de evento (tipo de medição do recurso, tipo de ação do ticket, etc.).
• DataSourceId (opcional): qualquer valor. Fornece outros critérios de filtragem para eventos de dados brutos.
• Value (vários): valores do evento (resultado da medição, número do ticket, etc.). Esse campo normalmente aparece mais de uma vez.

A estrutura do conversor corresponde à estrutura do evento no CA Business Service Insight e também à tabela de banco de dados T_RAW_DATA que armazena o evento, conforme mostrado na figura a seguir:

• Translator: descreve como converter o conjunto de campos que recebe no evento de saída.
• TranslatorName: nome usado pelo InputFormat para enviar conjuntos de campos para esse conversor. Esse exemplo usa o nome "Translator1". Consulte a figura anterior para encontrar os valores que podem ser usados para esse cenário.
• TranslatorFields: contém uma lista de elementos TranslatorField, cada um dos quais contém os seguintes atributos:
  • Name: o nome do campo. Na interface online, deve ser Data e hora, ResourceId, EventTypeId, ResourceId ou Valor.
  • SourceType: especifica a origem do valor do campo. Pode ser um dos seguintes tipos:
    • Field: o valor desse campo é obtido do campo no formato de entrada. O atributo SourceName contém o nome do campo InputFormat.
    • Table: o valor do campo é obtido da tabela de conversões. O atributo SourceName contém o nome da tabela de conversões que faz referência a um nome que é definido na próxima seção de TranslationTableCollection. Esse tipo é usado para valores que são escolhidos para serem convertidos em recursos e eventos no evento.
    • Lookup: o valor desse campo é obtido da tabela de conversões. O atributo SourceName contém o nome da tabela. O valor a ser convertido do atributo LookupValue e não do formato de entrada. Normalmente, é usado quando um valor constante é necessário para fins de conversão.
    • Constant: o valor do campo é constante e seu valor está no atributo ConstantValue. Ao usar um valor constante, é necessário especificar o tipo de campo, usando o atributo Tipo.
  • SourceName: contém o nome do campo ou da tabela de conversões.
  • LookupValue: contém o valor de pesquisa quando SourceType="lookup".
  • ConstantValue: contém o valor constante quando SourceType=constant. Quando o tipo de campo for hora, o valor constante será um texto formatado de acordo com TimeFormat (definido na seção Geral do conector) ou "Agora" ou "NowUtc", onde "Agora" é a hora atual no local da fonte de dados e "NowUtc" é a hora atual em UTC.

Essa seção também contém as tabelas de mapeamento que definem o mapeamento dos valores da fonte de dados em campos de evento no CA Business Service Insight e armazenam a definição da tabela com o valor da fonte de dados referido a ser convertido.

• LoadingMode: o padrão para uma interface online é "remoto" e para interface offline é "independente".

  O método de carregamento especificado das tabelas de conversões é o seguinte:

  • Independente: o conector carrega as tabelas de conversões localmente. Não há conexão com o servidor do CA Business Service Insight relacionada à conversão. Alterações nas tabelas de conversões são armazenadas apenas no arquivo local.
  • Remoto: o conector envia uma solicitação para carregar todas as tabelas do servidor do CA Business Service Insight. As alterações feitas nas tabelas de conversões também são armazenadas localmente.
• TranslationTable: vincula o valor do evento com a tabela de mapeamento.
  • Nome: nome da tabela de conversões usado e referido pelo conversor.
  • DestinationType: [recurso, event_type, contract_party, service, time_zone, valor]. Contém o tipo da tabela de conversões. Nesse exemplo, a coluna Servers no arquivo de fonte de dados é convertida em um recurso do CA Business Service Insight. Portanto, o tipo da tabela de conversões é Recurso, e contém conversões de valores para IDs do recurso no CA Business Service Insight.
  • TranslationField: o nome do campo a ser convertido e que é obtido dos campos do formato de entrada. Pode conter no máximo cinco campos.

Cada tabela de conversões definida no arquivo de configuração deve ter uma definição correspondente na interface com o usuário do CA Business Service Insight.

A representação XML de um arquivo de configuração de exemplo é a seguinte:

<?xml version="1.0" encoding="utf-8"?>
<AdapterConfiguration>
     <General MajorVersion="4" MinorVersion="0" RunOnce="yes" LogDebugMode="yes"
ConsoleDebugMode="yes" WorkingDirectoryName="output" RejectedEventsUpperLimit="10000">
     <DataSourceDifferenceFromUTC DefaultOffset="0" TimeFormat="%d/%m/%Y %H:%M">
          <DaylightSaving From="20/04/2001 00:00" To="15/10/2001 00:00" Shift="1"/>
     </DataSourceDifferenceFromUTC>
</General>
     <OblicoreInterface Mode="online">
          <OnlineInterface Port="5555" SecurityLevel="none"/>
     </OblicoreInterface>
     <DataSourceInterface>
          <Files>
               <File DeleteFileAfterProcessing="no" InputFormat="InputFormat1" NamePattern="servers*.csv" Path=" C:\Program Files\Oblicore\Adapters\ServersAdapter\data\" TitleExists="yes" SleepTime="60" Delimiters=","/>
      </Files>
</DataSourceInterface>
<InputFormatCollection>
     <InputFormat InputFormatName="InputFormat1">
          <InputFormatFields>
               <InputFormatField Name="resource" Type="string"/>
                    <InputFormatField Name="timestamp" Type="time" TimeFormat="%d.%m.%Y %H:%M"/>
                        <InputFormatField Name="memory_util" Type="real"/>
                        <InputFormatField Name="cpu_util" Type="real"/>
                </InputFormatFields>
     <TranslatorSwitch DefaultTranslator="Translator1"/>
     </InputFormat>
</InputFormatCollection>
<TranslatorCollection>
<Translator TranslatorName="Translator">
         <TranslatorFields>
            <TranslatorField Name="ResourceId" SourceType="table" SourceName="ResourceTable"/>
            <TranslatorField Name="EventTypeId" SourceType="lookup" SourceName="EventTable" LookupValue="PerformanceEvent"/>
            <TranslatorField Name="Timestamp" SourceType="field" SourceName="timestamp"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="memory_util"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="cpu_util"/>
         </TranslatorFields>
      </Translator>
   </TranslatorCollection>
   <TranslationTableCollection LoadingMode="remote">
      <TranslationTable Name="ResourceTable" DestinationType="resource">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
      <TranslationTable Name="EventTable" DestinationType="event_type">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
   </TranslationTableCollection>
</AdapterConfiguration>