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.
