Trasformazione dei dati (connettori)

Informazioni sulla trasformazione dei dati in Discover

Puoi trasformare i dati in entrata prima che vengano importati in XM Discover. Ciò è utile se è necessario pulire i dati o modificare il formato dei dati.

Per accedere alle trasformazioni dei dati:

1. Durante la configurazione del processo di importazione, fare clic sull’icona a forma di ingranaggio nella colonna Trasformazioni accanto al campo di dati da trasformare.
   
   Consiglio Q: se si desidera aggiornare le trasformazioni dei dati per un processo esistente, selezionare Mappatura dati dal menu delle opzioni dei processi.
   Attenzione: se l’icona dell’ingranaggio ha un numero accanto, ciò significa che esiste già una trasformazione applicata al campo. Se si aggiunge una nuova trasformazione, questa sostituirà quella precedente.
2. Selezionare la trasformazione dei dati. Visitare le sezioni collegate per ulteriori informazioni su ogni trasformazione.
   
   • Nessuna trasformazione: non trasformare il campo importato.
   • Ricerca dinamica: questa opzione è disponibile solo per i campi di ricerca. Se selezionato, questo campo applicherà gli ultimi valori di ricerca per il campo dalla tabella di lookup.
   • Sostituisci valore da tabella di ricerca: definire coppie di valori sorgente e valori di sostituzione.
   • Sostituisci valore con RegEx: definire le espressioni regolari (espressione regolare) per il confronto modelli e i valori di sostituzione.
   • Trasformazione personalizzata: creare la propria trasformazione utilizzando diverse funzioni ed espressioni.

Ricerca dinamica

Questa opzione è disponibile solo per i campi dati che fanno riferimento a una tabella di lookup dalla sorgente dati connessa. È possibile specificare un‘espressione di ricerca dinamica in modo che i dati corretti vengano importati in XM Discover.

Sostituisci valore da tabella di ricerca

Puoi aggiungere ricerche a qualsiasi campo di origine per avere un maggiore controllo sui valori esatti inviati al tuo progetto XM Discover. Una tabella di lookup consente di definire i valori di origine da sostituire quando vengono salvati in XM Discover.

1. Assicurarsi che Replace Value from Lookup Table sia selezionato come trasformazione.
   
2. Fare clic su Esporta ricerca per esportare un file di ricerca in formato .XLSX.
   Consiglio Q: Si consiglia di aggiungere ricerche tramite un file di ricerca. Se si desidera aggiungere ricerche manualmente, passare alla fase 8.
3. Aprire il file in un editor di fogli di calcolo e iniziare ad aggiungere i valori di ricerca al file.
4. Nella colonna della corrispondenza, aggiungere i valori in entrata dal connettore dati.
   
5. Nella colonna ricodificata, aggiungi i valori corrispondenti che desideri salvare in XM Discover.
6. Salvare il file come file XLS o XLSX.
7. In XM Discover, fare clic su Importa ricerca e selezionare il file di ricerca salvato sul computer.
   
8. Se lo si desidera, è possibile modificare le ricerche. La colonna Valore origine contiene il valore del connettore dati, mentre la colonna Valore trasformato contiene il valore che si desidera salvare in XM Discover.
9. È possibile aggiungere ulteriori abbinamenti di ricerca facendo clic sul segno più ( + ) oppure rimuovere gli abbinamenti facendo clic sul segno meno ( – ) accanto all’abbinamento.
10. Fai clic su Salva.

Sostituisci valore con RegEx

È possibile sostituire i valori dei dati in entrata utilizzando espressioni regolari o espressioni regolari, consentendo di pulire i dati prima di caricarli nel progetto XM Discover.

1. Assicurarsi che Sostituisci valore con RegEx sia selezionato come trasformazione.
   
2. Specificare l’espressione regolare della stringa di ricerca nel campo Inserisci espressione regolare per corrispondenza modello.
3. Specificare la stringa di sostituzione regex nel campo Inserisci espressione regolare per valore sostitutivo.
4. Per testare la trasformazione, immettere un esempio dal set di dati nel campo Valore sorgente campione e fare clic su Test. Il risultato della trasformazione viene visualizzato nella casella Esempio di valore trasformato.
5. Fai clic su Salva.

Trasformazione personalizzata

È possibile trasformare i dati in entrata utilizzando le proprie espressioni personalizzate. Le trasformazioni personalizzate consentono molti tipi di manipolazione dei dati, tra cui la modifica dei formati della data, il collegamento dei campi, la rimozione degli zeri iniziali e altro ancora.

1. Assicurarsi che Trasformazione personalizzata sia selezionata come trasformazione dei dati.
   
2. Creare l’espressione di trasformazione dei dati. L’espressione varierà in base ai dati in entrata e all’output desiderato. Consulta la pagina di supporto Espressioni costruttive per maggiori informazioni su come costruire la tua espressione.
3. Se stai creando un nuovo campo, puoi modificare il Tipo di dati del campo. Se si trasforma un campo esistente, non è possibile modificare il tipo di dati.
4. Per testare la trasformazione, immettere un valore dati di test nel campo Valore di prova, quindi fare clic su Test. Il risultato verrà visualizzato accanto al pulsante “Test”.
5. Al termine della creazione e del test dell’espressione, fare clic su Salva.

Generazione automatica di ID naturali

Quando carichi i dati in XM Discover, i documenti potrebbero non contenere un ID univoco da utilizzare come ID naturale, che è un campo importante perché aiuta a identificare documenti duplicati. I dati caricati devono avere un identificatore univoco da utilizzare come ID naturale. Questa sezione illustra come impostare un ID naturale durante il mappaggio dei dati utilizzando trasformazioni personalizzate.

1. Durante la mappatura dei dati, fare clic sul segno più ( + ) nella sezione Mappaggio di origine per aggiungere un nuovo campo personalizzato.
   
2. Fornire le seguenti informazioni per il campo personalizzato:
   • Nome campo: fornire il nome per il campo.
   • Tipo di dati: selezionare Attributo di testo dal menu a discesa.
   • Nome attributo: lasciarlo uguale a “Nome campo”.
   • Nome visualizzato dell’attributo: se lo si desidera, immettere un nome di visualizzazione più intuitivo per il campo.
   • Segnalabile: attivare questa casella di controllo. Questa opzione deve essere selezionata in modo da poter utilizzare l’ID naturale nel reporting.
3. Nella sezione Mappaggio sorgente di default, selezionare l’attributo creato nella fase 2 per l’attribuzione ID naturale.
   
4. Fare clic sull’icona a forma di ingranaggio nella colonna Trasformazioni.
5. Selezionare Trasformazione personalizzata.
   
6. Cercare la funzione GENERATE_ID() e trascinarla dalla sezione Funzioni nella casella Espressione.
7. Fai clic su Salva.
   Consiglio Q: assicurarsi di fare clic su Applica per salvare le mappature.

Ora il documento avrà un ID generato in modo casuale quando viene caricato.

Impostazione di una data documento specifica

Quando carichi i dati in XM Discover, i documenti possono contenere diversi campi data o nessuno. I dati caricati devono avere un campo data da utilizzare come data del documento. Questa sezione illustra come impostare una data del documento durante il mapping dei dati utilizzando trasformazioni personalizzate.

1. Durante la mappatura dei dati, fare clic sul segno più ( + ) nella sezione Mappaggio di origine per aggiungere un nuovo campo personalizzato.
   
2. Fornire le seguenti informazioni per il campo personalizzato:
   • Nome campo: fornire il nome del campo (ad esempio custom_date).
   • Tipo di dati: selezionare Attributo data dal menu a discesa.
   • Nome attributo: lasciarlo uguale a “Nome campo” (ad esempio custom_date).
   • Nome visualizzato dell’attributo: se lo si desidera, aggiungere un nome di visualizzazione più intuitivo per il campo.
   • Segnalabile: attivare questa casella di controllo. Deve essere selezionata per utilizzare la data del documento nel reporting Discover.
3. Nella sezione Mappaggio sorgente predefinito, selezionare l’attributo creato nella fase 2 per il mappaggio della data documento.
   
4. Fare clic sull’icona a forma di ingranaggio nella colonna Trasformazioni.
5. Selezionare Trasformazione personalizzata.
   
6. Nel generatore di espressioni, sono disponibili diverse opzioni per impostare una data in base alle proprie esigenze:
   • Usa tempo di caricamento: per usare la data in cui i documenti vengono caricati in XM Discover, trascina la funzione NOW() dalla sezione Funzioni sulla casella Espressione.
     
   • Utilizzare il valore programmato in maniera fissa: per utilizzare una data specifica, trascinare la funzione TEXTTODATE() dalla sezione Funzioni nella casella Espressione e fornire la data e il formato data all’interno delle parentesi.
     
     Consiglio Q: In entrambi i casi, la data risultante utilizzerà il formato AAAA-MM-GGThh:mm:ssZ.
7. Fare clic su Test per visualizzare il risultato della trasformazione. Se necessario, adattare l’espressione fino a quando il test non fornisce il risultato desiderato.
8. Al termine, fare clic su Salva.

Esempi di trasformazione personalizzata

In questa sezione vengono illustrati alcuni esempi di come è possibile manipolare i dati utilizzando trasformazioni personalizzate.

Attribuisci un valore sorgente personalizzato

Obiettivo: Assegnare un valore di testo personalizzato (“Sondaggi di aprile”) all’attributo “Origine”.

Come: Applicare la seguente trasformazione al campo “Origine” (semplicemente inserire il valore di testo tra virgolette):

Modifica “Cognome,Nome” in “Nome Cognome”

Obiettivo: modificare il formato del nome da “cognome, nome” a “nome cognome” e maiuscolo per la prima lettera di ogni parola.

Come: Applicare la seguente trasformazione al campo nome:

PROPERCASE(REPLACEBYREGEXP(NAME, “(.*),(.*)”, “$2 $1”))

Converti una data da UTC in CST

Obiettivo: convertire un campo data da un fuso orario UTC in CST.

Come: applicare la seguente trasformazione al campo END_DATE:

CONVERT_TO_TIMEZONE(END_DATE, “Etc/UTC”, “America/Chicago”)

Converti hh:mm:ss in minuti

Obiettivo: Convertire il tempo dal formato hh:mm:ss al numero di minuti.

Come: Applicare la seguente trasformazione:

GETMINUTESBETWEEN(TEXTTODATE(“1970-01-01”, “YYYY-MM-DD”), CONCAT(“1970-01-01T”, MY_TIME))

Converti tempo epocale Unix in secondi in ISO 8601

Obiettivo: convertire un timestamp Unix epoch in secondi nel formato data ISO 8601.

Come: La seguente trasformazione fa due cose: trasforma i secondi in millisecondi e poi trasforma i millisecondi in una data ISO 8601:

NUMBERTODATE(TEXTTONUMBER(CONCAT(MY_DATE, “000”)))

Derivare il valore in base all’eventuale presenza di qualcosa in un array

Obiettivo: controllare il nome dello stato e assegnare un valore “Area DMV” se corrisponde a uno degli stati elencati. In caso contrario, impostare “Altri stati”.

Come: aggiungere un campo di testo personalizzato denominato AREA e applicare la seguente trasformazione:

IF(LOWER(STATE) in [“md”, “dc”, “va”], “DMV Area”, “Other States”)

Estrai nome articolo da un titolo pagina

Obiettivo: estrarre il nome dell’articolo dopo l’ultimo divisore “|” in un titolo di pagina.

Come: Applicare la seguente trasformazione al campo titolo pagina:

TRIMRIGHT(MID(PAGE_TITLE,FINDLAST(PAGE_TITLE,”|”)+1,1000))

Unisci nome e cognome in un singolo campo

Obiettivo: combinare i campi FIRST_NAME e LAST_NAME in un nuovo campo FULL_NAME e maiuscolo la prima lettera di ogni parola.

Come: aggiungere un campo di testo personalizzato denominato FULL_NAME e applicare la seguente trasformazione:

PROPERCASE(CONCAT(FIRST_NAME, ” “, LAST_NAME))

Unisci due verbatimi e carica solo il verbatim combinato

Obiettivo: Unisci due campi verbatim VERBATIM1 e VERBATIM2 in un nuovo campo VERBATIM3 e carica solo il testo combinato in XM Discover.

Come: Eseguire queste fasi:

1. Creare un campo testuale denominato VERBATIM3 e applicarvi la seguente trasformazione: CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Per i campi VERBATIM1 e VERBATIM2, impostare Tipo di dati su Non mappare.

Rollup variabile multipla

Obiettivo: Crea un rollup multivariabile per le risposte a una singola domanda che sono suddivise tra diversi attributi. Si supponga che l’insieme di dati contenga più attributi “sì o no” per indicare i diversi livelli di appartenenza di un cliente:

• QID2_1 per argento
• QID2_2 per Oro
• QID2_3 per Platinum

È possibile trasferire tutte le risposte “sì” in un unico nuovo attributo per indicare il livello di appartenenza del cliente.

Come: applicare la seguente trasformazione:

TRIMRIGHT(CONCAT(IF(QID2_1==”Yes”, “Silver”, “”), IF(QID2_2==”Yes”, “Gold”, “”), IF(QID2_3==”Yes”, “Platinum”, “”)))

Rimuovi carattere principale

Obiettivo: rimuovere il primo carattere di una stringa.

Come: Applicare la seguente trasformazione:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Elimina zeri iniziali

Obiettivo: eliminare gli zeri iniziali in un numero.

Come: per un valore di testo, applicare la seguente trasformazione:

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

Per un valore numerico, applicare la seguente trasformazione:

TEXTTONUMBER(MY_NUMBER)