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

Seção TranslatorCollection

A seção Translator Collection descreve como converter o registro da origem de dados analisados e manipulados extraído na seção anterior para um evento do CA Business Service Insight.

Quando o modo da interface é "online", o evento do CA Business Service Insight tem uma estrutura unificada que contém os seguintes campos:

• Timestamp - especifica a data e a hora da ocorrência do evento.
• ResourceId - especifica a ID do recurso do CA Business Service Insight associada ao evento (o recurso medido, etc.).
• EventTypeId - especifica o tipo de evento do CA Business Service Insight associado ao evento e descreve o tipo de evento (tipo de medição no recurso, tipo de ação de ticket, etc.).
• DataSourceId (opcional) - especifica o nome da origem de dados de entrada (nome de arquivo, nome de tabela, etc.).
• Value - especifica o valor do evento (resultado da medição, número do tíquete, etc.). Esse campo pode ser exibido mais de uma vez.

Quando o modo da interface é "offline", não há nenhuma limitação quanto ao número de campos ou quanto ao nome.

Estrutura do XML:

<TranslatorCollection>
   <Translator TranslatorName="events" OnDuplication = "ignore">
	<TranslatorFields>
		<TranslatorField Name="ResourceId" SourceType="table"
		    SourceName="ResourcesTranslateTable" Iskey="yes"/>
		<TranslatorField Name="EventTypeId"	SourceType="constant"
		    ConstantValue="1002" Iskey="yes"/>
		<TranslatorField Name="Timestamp"  	SourceType="field"
                SourceName="timestamp" Iskey="yes"/>
		<TranslatorField Name="Value" 	SourceType="table"
                SourceName="valueUpDownTranslateTable" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="nodeName" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="constant"
                Type="integer" ConstantValue="1000" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="timestamp" TimeShift="-3600"
                TimeShiftFieldName="createDate"	Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="lookup"
                SourceName ="ServiceTable" LookupValue="word"
                Iskey="yes"/>
      </TranslatorFields>
   </Translator>
</TranslatorCollection>

• Translator - descreve como converter o conjunto de campos recebidos no evento de saída.
  • TranslatorName - especifica o nome usado por InputFormat para enviar conjuntos de campos ao conversor.
  • OnDuplication - especifica o integrante com o valor "ignore","add", "update", ou "updateAlways" para determinar a medida a ser tomada mediante um evento de duplicação (consulte o tópico Singularidade do evento).
  • TranslatorFields - contém a lista dos elementos de TranslatorField. Cada um deles contém os seguintes atributos:
  • Name - especifica o nome do campo. Na interface online, o nome deve ser Timestamp, ResourceId, EventTypeId,Value ou DataSourceId.
  • SourceType:

    field - o valor deste campo é obtido do campo no formato de entrada. O atributo SourceName contém o nome do campo.

    table - o valor do campo é obtido da tabela de conversão. O atributo SourceName contém o nome de tabela.

    lookup - o valor deste campo é obtido da tabela de conversão. O atributo SourceName contém o nome de tabela. O valor a ser convertido é obtido do atributo e não do formato de entrada.

    constant - o valor do campo é constante e está presente no atributo ConstantValue.

  • SourceName - contém o nome do campo para o nome da tabela de conversão.
  • Type [integer/real/string/time] - é necessário apenas quando o tipo do campo não é predefinido (pelo nome do campo ou por SourceType). Na interface online, é necessário apenas para o campo Value com SourceType=constant. Na interface offline, é necessário apenas para cada campo com SourceType=constant.
  • IsKey - representa a chave exclusiva do evento. Essa chave é coletada dos campos marcados com TranslatorFields?IsKey = "yes".

    (consulte o tópico Singularidade do evento)

  • LookupValue - contém o valor de pesquisa mediante SourceType="lookup".
  • ConstantValue - contém o valor da constante mediante SourceType=constant. Quando o campo é de data e hora, o valor da constante é um texto formatado de acordo com TimeFormat ou "Now" ou "NowUtc", em que "Now" refere-se à data e à hora atuais na localidade de origem dos dados e "NowUtc" refere-se à data e à hora atuais em UTC.
  • TimeFormat - contém o formato de data e hora, necessário apenas aos campos com SourceType=constant e Type=time.
  • TimeShift - define o tempo que a mudança leva em segundos. Destina-se apenas a campos de tempo.
  • TimeShiftFieldName (opcional) - contém o nome do campo, proveniente do formato de entrada, especificando o tempo levado em segundos. TimeShift e TimeShiftFieldName podem ser usados juntos.