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

Sezione DataSourceInterface del file di configurazione

La sezione DataSourceInterface è costituita dagli attributi che specificano la connessione e il tipo di connessione tra l'adapter e l'origine dati. Esistono due tipi di interfaccia, file e SQL. La principale differenza tra i due è che per file è obbligatorio l'insieme dei file, mentre per SQL è obbligatorio l'insieme delle query.

La sezione DataSourceInterface consente inoltre di definire il modo in cui l'adapter gestisce il file di origine (se elimina il file originale quando è stato creato solo per l'adapter, o se mantiene i dati quando è necessario per altri usi, e così via).

Per consentire agli adapter per file di leggere e analizzare i file ASCII, viene utilizzata l'interfaccia dei file come illustrato nella seguente figura. Selezionare i seguenti valori per le impostazioni come segue:

La sezione Files nel nodo DataSource Interface fa riferimento alla connessione all'origine dati. Configurare gli attributi seguenti.

Nota: questa sezione è completamente diversa per un adapter SQL.

• DeleteFileAfterProcessing: imposta il modo in cui l'adapter gestisce il file di origine e determina il modo in cui l'adapter controlla la lettura in modo da leggere solo i nuovi record. In questo caso, i file di origine vengono conservati sul server e il valore viene impostato su "no".

  Nel caso in cui viene creato un file solo per l'adapter e tale file può essere eliminato dopo l'elaborazione, deve essere impostato su "yes" (sì). Il file viene quindi rinominato, elaborato ed eliminato.

  Quando è impostato su "no", il file viene copiato e l'elaborazione viene eseguita utilizzando il file copiato. Se i nuovi record vengono aggiunti alla fine di questo file, l'adapter copia questi nuovi record nel file di lavoro durante il successivo ciclo. Se i nuovi record non vengono aggiunti al file, l'adapter cerca il prossimo file con lo stesso modello e nome maggiore (in ordine lessicografico) del file corrente. Se l'adapter trova il file, l'elaborazione continua su questo file. L'adapter non ripristina il file precedente, anche se i nuovi record vengono aggiunti.

  Impostare su "no" quando è necessario mantenere l'integrità del file di origine e quando il file deve essere aggiunto.

• InputFormat: indica il nome specificato per l'elemento InputFormat nel successivo InputFormatCollection che gestisce i dati dalla connessione a questa origine dati. Il formato di input è la struttura dei campi dei dati di input provenienti dall'origine dati dopo l'analisi eseguita dall'adapter. Il metodo di analisi viene specificato nell'attributo dei delimitatori come indicato di seguito. Durante la gestione di più connessioni tramite diversi formati di interfaccia, questo campo diventa più importante e determina quale struttura del formato di input gestisce i dati di ciascuna origine dati.
• Path: ubicazione fisica dei file di origine dati. Ad esempio: C:\Program Files\CA\Cloud Insight\Adapters\ServersAdapter\data\.
• NamePattern: indica il nome del file di origine dati. È possibile utilizzare caratteri jolly se più file utilizzano lo stesso formato di input. Se un nome di file viene specificato senza caratteri jolly, l'adapter ricerca solo il file con questo nome. Con l'utilizzo dei caratteri jolly, l'adapter cerca tutti i file corrispondenti al modello, li mette in ordine lessicografico, quindi li legge uno a uno. Durante la prossima esecuzione, cerca i nuovi record nell'ultimo file prima di passare al successivo.

  In questo esempio, se viene utilizzato il carattere jolly *, il valore di attributo è ServerData*.csv. (L'adapter legge tutti i file con nomi che iniziano con ServerData e con estensione .csv.)

  Importante: È consigliabile aggiungere la data e l'ora alla fine dei nomi di file utilizzando il formato seguente YYYYMMDD-HHMISS per assicurarsi che i file siano ordinati correttamente, letti nell'ordine corretto e che nessuno dei file sia escluso. È possibile inoltre aggiungere la porzione di tempo se sono presenti più file generati ogni giorno.

• Delimiters: metodo di determinazione della modalità di analisi del file. È possibile specificare uno o più caratteri come delimitatori, in base alle righe di dati da analizzare nei campi. Se non specificato, il valore predefinito è /t.

Il file dell'origine dati in questo esempio è un file CSV (separato da virgola). Il modo più semplice di analisi di tali file è specificare la virgola come delimitatore.

Altri metodi disponibili per l'analisi sono:

• RegExForParser: utilizza un'espressione regolare per impostare la regola di analisi.
• LogicLineDefinition: utilizzato quando una riga nel file è costituita da più righe.
• TitleExists (facoltativo): indica se la prima riga non vuota nel file di origine dati è una riga di titolo. Il titolo può essere utilizzato dall'adapter durante l'analisi dei dati. In questo esempio, ogni file di dati contiene la riga di titolo, pertanto è necessario specificare "yes" (sì) per questo attributo.