Sezione General

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

Sezione General

La sezione General è composta dagli attributi e dai sottonodi seguenti:

Struttura XML:

<General	
MajorVersion="2345"
MinorVersion="01245"
WorkingDirectoryName=" output"
DataSourceControlFileName="DatasourceControl.xml"
SendFileName="Send.txt"
SendControlFileName="SendControl.xml"
LogDebugMode="no"
ConsoleDebugMode="no"
RunOnce="yes"	
RepeatUntilDry="yes"
RuntimeErrorLimit="1"	
RetryRejectedEvents="yes"
RejectedEventsFileName="rejectedEvents.txt"
RejectedEventsUpperLimit="1000"
RegExUnlimitedSearch (V3.1 Patch)="no"
HoldRejectedEventsSpan="24"
GenerateStatistics="yes"
StatisticsFileName="MyStatistics.txt" >
KeepHistoricState="yes" >
DefaultTimeFormat="%Y/%m/%d-%H:%M:%S"
DefaultDecimalSymbol="."
DataSourceIdMaxLength="60"
DefaultDigitGroupingSymbol=","
SaveIllegalEvents ="no"
WriteEventErrorToLog ="yes"
IllegalEventsDirectoryName="xxxpath"
<DataSourceDifferenceFromUTC 
	DefaultOffset="2"
	TimeFormat="%Y/%m/%d-%H:%M:%S">
	<DayLightSaving 
		From="2001/04/09-12:00:00"
		To="2001/09/01-12:00:00"
		Shift="1"/>
</ DataSourceDifferenceFromUTC >
</General>

MajorVersion: specifica il numero di versione principale.
MinorVersion: specifica il numero di versione secondaria.
WorkingDirectoryName: (facoltativo)
Specifica il percorso predefinito per i file di output dell'adapter (controllo origine dati, conversioni, invii).

Valore predefinito: la directory di output (cartella) nella directory contenente il file di configurazione.
DataSourceControlFileName: (facoltativo)
Nome del file che l'adapter utilizzata per tenere traccia dell'ultimo record di dati recuperati dall'origine dati.

Valore predefinito: DataSourceControl.xml (se non altrimenti specificato, viene utilizzato il valore predefinito).
SendFileName: (facoltativo)
Nome del file che contiene gli eventi prima che vengano inviati a CA Business Service Insight.

Valore predefinito: Send.txt (se non altrimenti specificato, viene utilizzato il valore predefinito).
SendControlFileName: (facoltativo)
Nome del file che l'adapter utilizza per tenere traccia del processo di invio.

Valore predefinito: SendControl.xml (se non altrimenti specificato, viene utilizzato il valore predefinito).
DataSourceIdMaxLength:
Lunghezza massima per il campo DataSourceID nella tabella t_raw_data. Se l'utente inserisce una stringa con lunghezza superiore, riceve un errore nell'adapter.

Il valore deve essere minore o uguale alla dimensione reale della tabella.

Valore predefinito: 60
SaveIllegalEvents: se selezionato, questo attributo indica che gli eventi non validi devono essere scritti nel file.
Valore predefinito: "no"
WriteEventErrorToLog: guida se errori di dati vengono scritti nella tabella T_Log
Valori validi: [sì/no]

Valore predefinito: sì
IllegalEventsDirectoryName: (nessun valore predefinito)
SendFileName: (facoltativo)
Nome del file che contiene i record prima che vengano inviati a CA Business Service Insight.

Valore predefinito: Send.txt (se non altrimenti specificato, viene utilizzato il valore predefinito).
§SendControlFileName: (facoltativo)
Nome del file che l'adapter utilizza per tenere traccia del processo di invio.

Valore predefinito: SendControl.xml (se non altrimenti specificato, viene utilizzato il valore predefinito).
LogDebugMode: (facoltativo)
Valori validi: [sì/no]

Se impostato su "yes" (sì), al log vengono inviati i seguenti elementi: riga originale dall'origine dati, risultati di analisi, evento unificato CA Business Service Insight.
ConsoleDebugMode: (facoltativo)
Valori validi: [sì/no]

Se impostato su "yes" (sì), sulla console vengono visualizzati i messaggi di debug.
- Indicatori per la lettura e la conversione dei record:
  - .: per un record che è stato letto e convertito in un evento di output.
  - i: per un record che è stato ignorato dal parser di espressione regolare.
  - I: per un record che è stato letto e ignorato dalle tabelle di conversione.
  - R: per un record che è stato letto ma rifiutato dalla tabella di conversione (non può essere convertito dalle tabelle di conversione).
  - X: per un record per cui si è verificato un problema durante l'analisi. Verrà ignorato e andrà perso o verrà salvato nella directory degli eventi non validi.
Nota: quando il record letto passa attraverso più convertitori, l'indicazione del record verrà racchiusa tra parentesi. Ad esempio: [...] o [RRI].
- Indicatori di stato dell'adapter:
  - 0: l'adapter è attivo e non legge alcun record nell'ultimo secondo.
  - E: stato di errore.
  - P: stato di sospensione.
  - S: comando di interruzione ricevuto da CA Business Service Insight.
  - B: stato bloccato, la tabella degli eventi rifiutati è piena.
  - Indicatori delle tabelle di conversione:
  - L: in attesa delle tabelle di conversione.
  - T: tabella di conversione inviata o ricevuta da CA Business Service Insight.
  - t: modifiche nella tabella di conversione inviata o ricevuta da CA Business Service Insight.
  - Indicatori di connessione:
  - <Connecting CA Business Service Insight: tentativo di connettere CA Business Service Insight.
  - <Connecting CA Business Service Insight>: connessione stabilita.
  - <Connecting DataSource: tentativo di connettere l'origine dati.
  - <Connecting DataSource>: connessione stabilita.
RunOnce: (facoltativo)
Valori validi: [sì/no]

Se impostato su "no", l'adapter viene eseguito di continuo.

Se impostato su "yes" (sì), l'adapter per file di testo viene eseguito, legge i record e si interrompe automaticamente. L'adapter per file legge i file interi, attende alcuni secondi, tenta di leggere i nuovi record (a seconda di SleepTime). Se non sono presenti tali record, si interrompe.

Un adapter SQL esegue ogni singola query solo una volta. Se RepeatUntilDry è impostato su "no", si interrompe immediatamente. Se RepeatUntilDry è impostata su "yes" (sì), attende (a seconda di SleepTime), prova nuovamente a eseguire le query (a seconda di SleepTime della query) e, se non sono presenti nuovi record, si interrompe.
RepeatUntilDry: (facoltativo)
Valori validi: [sì/no] Valore predefinito: "yes" (sì)

Fare riferimento all'attributo RunOnce descritto sopra.
RuntimeErrorsLimit: (facoltativo)
Determina il limite di errori (ad esempio, errori negli eventi di input) prima che l'adapter sia bloccato. Quando è uguale a 0, l'adapter non è bloccato.

Valore predefinito: 1 (indica che l'adapter è bloccato dopo il primo errore).
RetryRejectedEvents: (facoltativo)
Valori validi: [sì/no] Valore predefinito: "yes" (sì)

Se impostato su "yes" (sì), i record che necessitano di conversione sono tenuti nel file degli eventi rifiutati, in attesa di conversione.

Non è consigliato impostare l'attributo su "no", perché si potrebbero perdere dati importanti.
RejectedEventsFileName: (facoltativo)
Nome del file che l'adapter utilizza per tenere traccia dei record di dati recuperati dall'origine dati e in attesa di conversione.

Valore predefinito: rejected.txt (se non altrimenti specificato, viene utilizzato il valore predefinito).
RejectedEventsUpperLimit- (facoltativo)
Determina il limite di record rifiutati che sono riportati nel file rejected.txt. Quando l'adapter raggiunge tale limite superiore, si interrompe ed entra in stato bloccato finché questi record non vengono convertiti.

Valore predefinito: 1000
RegexUnlimitedSearch: guida l'adapter per eseguire la ricerca completa in base all'espressione regolare.
Valori validi: [sì/no]

Valore predefinito: "no"
HoldRejectedEventsSpan: (facoltativo)
Determina il numero di ore per cui salvare il file degli eventi rifiutati. Se questo attributo non viene specificato, l'adapter non cancella alcun evento che deve essere gestito prima che l'adapter possa avviarsi nuovamente.

Non è consigliato utilizzare questo attributo, perché si potrebbero perdere dati importanti.
GenerateStatistics: (facoltativo)
Valori validi: [sì/no] Valore predefinito: "yes" (sì)

Se impostato su "yes" (sì), l'adapter crea un file di statistiche contenente informazioni statistiche per ogni minuto.
StatisticsFileName: (facoltativo)
Nome del file di statistiche.

Valore predefinito: statistics.txt (se non altrimenti specificato, viene utilizzato il valore predefinito).
KeepHistoricState: (facoltativo)
Valori validi: [sì/no] Valore predefinito: "no"

Se impostato su "yes" (sì), l'adapter consente di salvare tutti i file, escluso il file di log, in una nuova directory denominata Historic state yyyymmdd-hhmmss, in cui yyyymmdd e hhmmss sono i formati di data e ora di creazione.
DefaultTimeFormat: (facoltativo)
Formato ora predefinito. Se questo attributo è specificato, viene utilizzato come formato ora in qualsiasi posizione in cui l'attributo TimeFormat è omesso. Se non è specificato, l'attributo TimeFormat in altri elementi è obbligatorio.
DefaultDecimalSymbol: (facoltativo)
Simbolo decimale per campi di tipo reale.

Valore predefinito: (se non altrimenti specificato, viene utilizzato il valore predefinito).
DefaultDigitGroupingSymbol: (facoltativo)
Simbolo di raggruppamento cifre predefinito per i campi di tipo numero intero e reale.

Valore predefinito: (se non altrimenti specificato, viene utilizzato il valore predefinito).
DataSourceDifferenceFromUTC: indica la differenza di tempo tra l'ora UTC e il fuso orario dell'origine dati nel computer.
- DefaultOffset: differenza da UTC durante i periodi senza ora legale.
- TimeFormat: specifica il formato in base al quale devono essere analizzate le informazioni sull'ora legale (descritte in seguito).
- DayLlightSaving: specifica un periodo di ora legale del fuso orario dell'origine dati. Questo elemento è facoltativo (ovvero, se non è selezionato, non sono presenti periodi di ora legale) e può esistere più di una volta. Quando sono presenti alcuni elementi, devono essere ordinati per ora e i periodi non devono sovrapporsi.
  - From: data di inizio del periodo.
  - To: data di fine del periodo.
  - Shift: ore di differenza aggiunte a DefaultOffset nel periodo di ora legale.