Guida all'implementazione › Specifiche di configurazione dell'adapter › Sezione TranslatorCollection

Sezione TranslatorCollection

La sezione TranslatorCollection descrive come convertire i record dell'origine dati analizzati e modificati estratti nella sezione precedente in un evento CA Business Service Insight.

Quando la modalità dell'interfaccia è "online" (in linea), l'evento CA Business Service Insight dispone di una struttura unificata che contiene i seguenti campi:

• Timestamp: ora in cui si è verificato l'evento.
• ResourceId: ID risorsa CA Business Service Insight associato all'evento (la risorsa che è stata misurata, ecc.).
• EventTypeId: ID del tipo di evento CA Business Service Insight associato all'evento che descrive il tipo di evento (il tipo di misurazione applicato alla risorsa, tipo di azione di ticket, ecc.).
• DataSourceID: (facoltativo) nome dell'origine dati di input (nome file/nome tabella…).
• Value: il valore dell'evento (risultato della misurazione, numero di ticket, ecc.). Questo campo può essere visualizzato più di una volta.

Quando la modalità interfaccia è "offline" (non in linea), non sono presenti limitazioni sul numero dei campi o sul relativo nome.

Struttura 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: descrive come convertire il set di campi ricevuti nell'evento di output.
  • TranslatorName: nome utilizzato da InputFormat per inviare i gruppi di campo a tale convertitore.
  • OnDuplication: membro che contiene il valore "ignore", "add", "update" o "updateAlways" per determinare le azioni da svolgere con l'evento di duplicazione (consultare la sezione Univocità dell'evento)
  • TranslatorFields: contiene un elenco di elementi TranslatorField, ognuno dei quali contiene i seguenti attributi:
  • Name: nome di campo. Nell'interfaccia in linea deve essere Timestamp, ResourceId, EventTypeId, Value o DataSourceId.
  • SourceType:

    field: il valore di questo campo è ottenuto dal campo nel formato di input. L'attributo SourceName contiene il nome del campo.

    table: il valore del campo è ottenuto dalla tabella di conversione. L'attributo SourceName contiene il nome della tabella.

    lookup: il valore del campo è ottenuto dalla tabella di conversione. L'attributo SourceName contiene il nome della tabella. Il valore da convertire è ottenuto dell'attributo LookupValue e non dal formato di input.

    constant: il valore del campo è costante e il relativo valore è nell'attributo ConstantValue.

  • SourceName: contiene il nome del campo o della tabella di conversione.
  • Type: [numero intero/reale/stringa/ora] richiesto solo quando il tipo di campo non è predefinito (dal nome di campo o da SourceType). Nell'interfaccia in linea è necessaria solo per il campo Value con SourceType=constant. Nell'interfaccia non in linea è necessario per ogni campo con SourceType=constant.
  • IsKey: rappresenta la chiave univoca dell'evento. Questa chiave è costituita da campi, che sono stati contrassegnati come TranslatorFields?IsKey = "yes".

    Consultare la sezione Univocità dell'evento.

  • LookupValue: contiene il valore di ricerca quando SourceType="lookup".
  • ConstantValue: contiene il valore costante quando SourceType=constant. Quando il campo è di tipo ora, il valore costante è una stringa formattata in base a TimeFormat oppure "Now" o "NowUtc", in cui "Now" è l'ora corrente nelle impostazioni internazionali dell'origine dati e "NowUtc" è l'ora corrente in UTC.
  • TimeFormat: contiene TimeFormat, obbligatorio solo per i campi con SourceType=constant e Type= time.
  • TimeShift: definisce le ore di differenza in secondi, solo per i campi di ora.
  • TimeShiftFieldName: (facoltativo) contiene un nome di campo, dal formato di input, che contiene le ore di differenza in secondi. TimeShift e TimeShiftFieldName possono essere utilizzati insieme.