Definizione degli esportatori

Gli esportatori forniscono le istruzioni per la trasmissione dei dati dell’evento.

La funzionalità di trasformazione fornisce tre tipi di esportatori per l'esportazione di file .vsl, file di registro, file XML e dati ODBC come file .vsl, file di testo o file di testo delimitati che possono essere utilizzati dalle routine di caricamento del DataWarehouse, dalle agenzie di controllo o da altre destinazioni.

NOTA

Affinché un esportatore possa funzionare correttamente, l'origine di registro deve soddisfare i requisiti appropriati descritti nella sezione Origini di log di File di configurazione dell'elaborazione di log.

Per definire un esportatore

  1. Apri Transform.cfg in Data Workbench. Vedere Per modificare il file Insight Transform.cfg.

  2. Fai clic con il pulsante destro del mouse su Exporters, quindi fai clic su Add New.

  3. Selezionare una delle opzioni seguenti:

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    NOTA

    Per l'opzione ExportVSLFile, tutti i campi estesi nel file di input e tutti i campi definiti dall'utente del modulo cs(header) sono sempre scritti nel file di output VSL. Se si sovrascrive un campo esteso esistente, il nuovo valore viene scritto nel file di output, anche se il campo è vuoto.

  4. Modifica i parametri degli esportatori nel file di configurazione utilizzando la seguente tabella come guida:

    Parametro Descrizione
    Formato dati

    Solo per ExportTextFile. Il formato di ciascuna riga di output, costituito da escape di nome campo (espresso come %nomecampo%) e qualsiasi altro testo fisso desiderato. Il formato deve includere un separatore di riga, in genere [CR] [LF].

    Un segno di percentuale letterale (%) può essere incorporato nella stringa di formato escape dal carattere come mostrato di seguito: %

    Un esempio di voce per il parametro Data Format è %x-timestring% %x-trackingid%[CR][LF].

    Campi Solo per ExportDelimitedTextFile. Nomi dei campi da trasmettere.
    Delimitatore

    Facoltativo. Solo per ExportDelimitedTextFile. Carattere utilizzato per separare i campi nel file di output.

    Il software non può eseguire l'escape dei delimitatori inclusi nei valori dei dati. Di conseguenza, per Adobe non è consigliabile utilizzare virgole come delimitatori.

    Se tieni premuto il tasto Ctrl e fai clic con il pulsante destro del mouse all'interno del parametro Delimitatore , viene visualizzato un menu Inserisci . Questo menu contiene un elenco di caratteri speciali che vengono spesso utilizzati come delimitatori.

    Separatore di riga Facoltativo. Solo per ExportDelimitedTextFile. I caratteri utilizzati per separare le righe nei file di output. Il valore predefinito è [CR] [LF].
    Nome

    Facoltativo. Identificativo dell’esportatore. Questo nome viene visualizzato nell'interfaccia Detailed Status (Stato dettagliato).

    Per informazioni sull'interfaccia Stato dettagliato, vedere la Guida utente Data Workbench.

    Commenti Facoltativo. Note sull'esportatore.
    Percorso di output

    Percorso in cui memorizzare i file di output. Il percorso è relativo alla cartella di installazione del server di Data Workbench.

    Nota: Il server di Data Workbench che memorizza i dati di output elabora il server #0 nel file profile.cfg .

    Periodo di rotazione file

    Facoltativo. Frequenza con cui i dati vengono esportati nel file di output. Ciascun file di output contiene dati relativi a un periodo di tempo specifico denominato periodo di rotazione. Tutti i calcoli temporali sono in GMT: Un giorno inizia a mezzanotte GMT e termina il giorno successivo a mezzanotte GMT, anche se i dati scritti nel file includono un campo che è stato trasformato in ora locale.

    I valori disponibili sono i seguenti:

    • ANNO. Ogni file contiene dati per un anno civile.
    • MESE. Ogni file contiene dati per un mese di calendario. I mesi sono numerati da 1 (gennaio) a 12 (dicembre).
    • SETTIMANA. Ogni file contiene dati per una settimana. Una settimana inizia lunedì. La settimana che inizia in uno dei primi sette giorni dell’anno è la settimana 1 e la settimana precedente (parziale), se presente, è la settimana 0.
    • GIORNO. Ogni file contiene dati per un giorno di calendario.
    • ORA. Ogni file contiene dati per un'ora.
    • NESSUNO. Non viene eseguita alcuna rotazione. Tutti i dati vengono scritti nello stesso file (o in un insieme di file come determinato da altre impostazioni dei parametri). Vedere il parametro File Name Format in questa tabella.

    Il periodo di rotazione predefinito del file è DAY.

    • Impostare la rotazione dei file su NONE solo quando si lavora in Modalità offline. Vedi la descrizione del parametro Modalità offline .
    Formato nome file

    Facoltativo. Formato del nome del file di output.

    Ogni voce di registro può essere memorizzata in un file il cui nome deriva dall'ora di inizio del periodo di rotazione e, facoltativamente, dai valori dei campi nelle righe in cui è contenuta. I campi da utilizzare nel nome del file vengono incorporati come escape del nome del campo (espresso come %nomecampo%).

    I componenti nome file relativi al periodo di rotazione sono incorporati nella stringa di formato utilizzando le seguenti sequenze di escape:

    • %yyyy% (anno a quattro cifre)
    • %y% (anno a due cifre)
    • %mm% (mese a due cifre, 01 - 12)
    • %ww% (settimana a due cifre, 01 - 52)
    • %dd% (giorno di due cifre, 01 - 31)
    • %HH% (ora a due cifre, 00 - 23)

    Il formato predefinito del nome file è %yyyy%%mm%%dd%-%x-mask%.txt

    • Le sequenze di escape distinguono tra maiuscole e minuscole.
    • Quando il periodo di rotazione file è impostato su NONE, viene sostituita una stringa vuota per ciascuna delle sequenze di escape, se presenti.
    • Viene generato un errore se File Name Format non restituisce un nome di file univoco per ogni periodo di rotazione (vedere il parametro File Rotation Period in questa tabella). Ad esempio, quando si utilizza il periodo di rotazione DAY, nel pattern devono essere presenti le sequenze di escape %dd%, %mm% e %yy% o %yyyy%% per evitare la perdita di dati.
    • Se si utilizzano sequenze di escape dei nomi di campi all'interno del pattern e il campo specificato presenta molti valori distinti, per ogni periodo di rotazione vengono scritti molti file di output. Tieni presente che questo scenario può causare prestazioni scadenti, pertanto devi utilizzare questa funzione con cautela.
    • Tutti i calcoli sono in GMT.
    Esegui su Rollover

    Facoltativo. Quando ogni file è finalizzato, è possibile eseguire un comando esterno (Windows). La riga di comando viene derivata dal nome del file finale sostituendo le seguenti sequenze di escape in questo parametro:

    • %dir%. Parte della directory del nome file finale, inclusa la barra rovesciata finale.
    • %file%. Il nome del file (esclusa la directory e l'estensione) del file finale.
    • %ext%. L'estensione (incluso il "." iniziale) del nome del file finale.
    • %path%. Nome percorso completo del file, equivalente a %dir%%file%%ext%.

    Per impostazione predefinita, questo parametro è vuoto (non viene eseguito alcun comando).

    Limite di memoria

    Facoltativo. Quantità di memoria in byte utilizzata per il buffering dell'output dell'esportatore. Il valore predefinito è 10.000.000 byte.

    Nota: Se si dispone di molti file di output aperti contemporaneamente, è possibile aumentare questo valore, ma è possibile ridurre la quantità di memoria disponibile per l'utilizzo da parte di altri componenti del sistema. Tuttavia, una diminuzione di questo valore potrebbe rallentare il processo di esportazione. Per assistenza, contatta l'Adobe.

    Limite file aperti

    Facoltativo. Numero massimo di file che possono essere aperti contemporaneamente per la produzione dell'esportatore. Se questo numero viene superato, viene registrato un errore nel registro eventi e il server di Data Workbench smette di funzionare. Il valore predefinito è 1000.

  5. Dopo aver definito la funzione di esportazione (e apportato modifiche ad altri parametri) nel file Transform.cfg, salva il file localmente e salvalo nel profilo appropriato nel computer server di Data Workbench.

In questa pagina