Guida all'implementazione › Implementazione › Raccolta dei dati (esperto delle sorgenti dati) › Configurazione di adapter e conversioni › Case study dell'adapter per file › Sezione TranslatorCollection del file di configurazione

Sezione TranslatorCollection del file di configurazione

La sezione TranslatorCollection definisce come i record dell'origine dati analizzati e modificati, estratti nelle sezioni precedenti, verranno convertiti in un evento CA Business Service Insight.

Questa sezione definisce inoltre le modalità di gestione degli eventi duplicati e di utilizzo del meccanismo di univocità dell'evento (per ulteriori informazioni, consultare il capito Univocità dell'evento).

Quando la modalità dell'interfaccia è impostata su 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 associato all'evento (la risorsa misurata in tale evento).
• EventTypeId: tipo di evento associato all'evento, descrive il tipo di evento (tipo di misurazione della risorsa, tipo di azione del ticket, e così via).
• DataSourceID (facoltativo): qualsiasi valore. Fornisce ulteriori criteri di filtro per gli eventi di dati non elaborati.
• Value (multipli): valori dell'evento (risultato della misurazione, numero di ticket, e così via). Questo campo spesso viene visualizzato più di una volta.

La struttura del convertitore corrisponde alla struttura del tipo di evento all'interno di CA Business Service Insight, e anche alla tabella di database T_RAW_DATA in cui è archiviato l'evento, come illustrato nella figura seguente:

• 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. In questo esempio viene utilizzato il nome Translator1. Consultare la figura precedente per i valori che possono essere utilizzati in questo scenario.
• 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, ResourceId o Value.
  • SourceType: specifica l'origine del valore di campo. Può trattarsi di uno dei seguenti tipi:
    • Field: il valore di questo campo è ottenuto dal campo nel formato di input. L'attributo SourceName contiene il nome del campo InputFormat.
    • Table: il valore del campo è ottenuto dalla tabella di conversione. L'attributo SourceName contiene il nome della tabella di conversione che fa riferimento a un nome definito nella sezione successiva di TranslationTableCollection. Questo tipo viene utilizzato per i valori selezionati per la conversione in risorse e tipi di evento nell'evento.
    • Lookup: il valore del campo è ottenuto dalla tabella di conversione. L'attributo SourceName contiene il nome della tabella. Il valore da convertire dall'attributo LookupValue e non dal formato di input. Solitamente viene utilizzato quando è necessario un valore costante ai fini delle conversioni.
    • Constant: il valore di campo è costante e il relativo valore è nell'attributo ConstantValue. Quando si utilizza un valore costante, è necessario specificare il tipo di campo utilizzando l'attributo Type.
  • SourceName: contiene il nome del campo o della tabella di conversione.
  • 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 (impostato nella sezione General dell'adapter) oppure "Now" o "NowUtc", in cui "Now" è l'ora corrente nelle impostazioni internazionali dell'origine dati e "NowUtc" è l'ora corrente in UTC.

Questa sezione contiene inoltre le tabelle di mapping che definiscono il mapping dei valori di origine dati nei campi Evento di CA Business Service Insight e contiene la definizione della tabella con il valore dell'origine dati di riferimento da convertire.

• LoadingMode: il valore predefinito per l'interfaccia in linea è "remote" (remota), mentre per l'interfaccia non in linea è "standalone" (autonoma).

  Di seguito il metodo di caricamento delle tabelle di conversione specificato:

  • Standalone: l'adapter carica le tabelle di conversione in locale. Non è presente alcuna connessione al server CA Business Service Insight per la conversione. Le modifiche nelle tabelle di conversione vengono archiviate solo nel file locale.
  • Remote: l'adapter invia una richiesta di caricamento di tutte le tabelle dal server CA Business Service Insight. Le modifiche apportate nelle tabelle di conversione vengono memorizzate anche localmente.
• TranslationTable: collega il valore dell'evento alla tabella di mapping.
  • Name: nome della tabella di conversione utilizzato e indicato dal convertitore.
  • DestinationType: [resource, event_type, contract_party, service, time_zone, value]. Contiene il tipo di tabella di conversione. In questo esempio, la colonna Server nel file di origine dati viene convertita in una risorsa CA Business Service Insight. Pertanto, il tipo di tabella di conversione è Risorsa, e contiene le conversioni dei valori in ID risorsa in CA Business Service Insight.
  • TranslationField: nome di campo da cui eseguire la conversione e che è ottenuto dai campi del formato di input. Può contenere al massimo cinque campi.

Ciascuna tabella di conversione definita nel file di configurazione deve avere una definizione corrispondente nell'interfaccia utente CA Business Service Insight.

Di seguito viene riportata la rappresentazione XML di un file di configurazione di esempio:

<?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>