Trasformazione dei dati (Connettori)

Informazioni sulla trasformazione dei dati in Discover

Puoi trasformare i dati in entrata prima che vengano importati in XM Discover. È utile se devi pulire i dati o modificarne il formato.

Per accedere alle trasformazioni dei dati:

1. Quando imposti il lavoro di importazione, fai clic sull’icona dell’ingranaggio nella colonna Trasformazioni vicino al campo dati che desideri trasformare.
   
   Consiglio Q: se desideri aggiornare le trasformazioni dei dati per un lavoro esistente, seleziona Mappatura dati dal menu delle opzioni dei lavori.
   Attenzione: se l’icona dell’ingranaggio ha un numero accanto a essa, significa che al campo è già stata applicata una trasformazione. Se aggiungi una nuova trasformazione, questa sostituirà quella precedente.
2. Scegli la trasformazione dei dati. Per maggiori informazioni su ciascuna trasformazione, visita le sezioni collegate.
   
   • Nessuna trasformazione: non trasformare il campo importato.
   • Ricerca dinamica: questa opzione è disponibile solo per i campi di ricerca. Se selezionato, questo campo applica i valori di ricerca più recenti per il campo dalla tabella di ricerca.
   • Sostituire il valore dalla tabella di ricerca: definisci coppie di valori di origine e valori di sostituzione.
   • Sostituire il valore con RegEx: definisci le espressioni regolari (regex) per la corrispondenza dei modelli e i valori di sostituzione.
   • Trasformazione personalizzata: crea la tua trasformazione utilizzando diverse funzioni ed espressioni.

Ricerca dinamica

Questa opzione è disponibile solo per i campi dati che fanno riferimento a una tabella di ricerca dall’origine dati collegata. Puoi specificare un’espressione di ricerca dinamica per importare i dati corretti in XM Discover.

Sostituire il valore dalla tabella di ricerca

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

1. Assicurati che come trasformazione sia selezionata la voce Sostituisci valore da tabella di ricerca.
   
2. Fai clic su Esporta lookup per esportare un file di lookup in . formato XLSX.
   Consiglio Q: aggiungi i lookup tramite un file di lookup. Se desideri aggiungere manualmente i lookup, passa al punto 8.
3. Apri il file in un editor di fogli di calcolo e inizia ad aggiungere i valori di ricerca al file.
4. Nella colonna match, aggiungi i valori in entrata dal connettore dati.
   
5. Nella colonna ricodifica, aggiungi i valori corrispondenti che desideri salvare in XM Discover.
6. Salva il file come file XLS o XLSX.
7. In XM Discover, fai clic su Importa lookup e seleziona il file di lookup salvato sul computer.
   
8. Se vuoi, puoi modificare i lookup. La colonna Origine dati contiene il valore del connettore dati, mentre la colonna Valore trasformato contiene il valore che desideri salvare in XM Discover.
9. Puoi 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.

Sostituire il valore con RegEx

Puoi sostituire i valori dei dati in entrata utilizzando espressioni regolari, o regex, che consentono di pulire i dati prima di caricarli nel progetto XM Discover.

1. Assicurati che Sostituisci valore con RegEx sia selezionato come trasformazione.
   
2. Specifica il modello di ricerca regex nel campo Inserisci l’espressione regolare per la corrispondenza del modello.
3. Specifica la stringa di sostituzione regex nel campo Inserisci l’espressione regolare per il valore di sostituzione.
4. Per testare la trasformazione, inserisci un esempio dal set di dati nel campo Campione valore origine e fai clic su Test. Il risultato della trasformazione viene visualizzato nella casella Campione valore trasformato.
5. Fai clic su Salva.

Trasformazione personalizzata

Puoi trasformare i dati in arrivo utilizzando le tue espressioni personalizzate. Le trasformazioni personalizzate consentono molti tipi di manipolazione dei dati, tra cui la modifica del formato delle date, l’unione dei campi, la rimozione degli zeri iniziali e altro ancora.

1. Assicurati che la trasformazione dei dati sia selezionata come Trasformazione personalizzata.
   
2. Costruisci l’espressione di trasformazione dei dati. L’espressione varia a seconda dei dati in entrata e dell’output desiderato. Per ulteriori informazioni su come costruire l’espressione, consulta la pagina di supporto Costruire espressioni.
3. Se crei un nuovo campo, puoi modificare il Tipo di dati del campo. Se trasformi un campo esistente, non puoi modificare il tipo di campo.
4. Per testare la trasformazione, inserisci un valore di prova nel campo Valore di prova e fai clic su Test. Il risultato apparirà accanto al pulsante “Test”.
5. Una volta terminata la costruzione e la verifica dell’espressione, fai clic su Salva.

Generazione automatica di ID naturali

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

1. Durante la mappatura dei dati, fai clic sul segno più ( + ) nella sezione Mappatura origine per aggiungere un nuovo campo personalizzato.
   
2. Fornisci le seguenti informazioni per il campo personalizzato:
   • Nome campo: fornisci il nome del campo.
   • Tipo di dati: seleziona Attributo testo dal menu a discesa.
   • Nome dell’attributo: lascialo lo stesso valore di “Nome campo”.
   • Nome visualizzato dell’attributo: se lo desideri, inserisci un nome di visualizzazione più semplice per il campo.
   • Rapporti: attiva questa casella di controllo. Questa opzione deve essere selezionata per poter utilizzare l’ID naturale nei rapporti.
3. Nella sezione Mappatura origine predefinita, seleziona l’attributo creato al punto 2 per la mappatura dell’ID naturale.
   
4. Fai clic sull’icona dell’ingranaggio nella colonna Trasformazioni.
5. Seleziona Trasformazione personalizzata.
   
6. Cerca la funzione GENERATE_ID() e trascinala dalla sezione Funzioni alla casella Espressione.
7. Fai clic su Salva.
   Consiglio Q: assicurati di fare clic su Applica per salvare le mappature.

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

Impostazione di una data specifica per il documento

Quando carichi 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 spiega come impostare una data del documento durante la mappatura dei dati utilizzando trasformazioni personalizzate.

1. Durante la mappatura dei dati, fai clic sul segno più ( + ) nella sezione Mappatura origine per aggiungere un nuovo campo personalizzato.
   
2. Fornisci le seguenti informazioni per il campo personalizzato:
   • Nome campo: fornisci il nome del campo (ad esempio, data_personalizzata).
   • Tipo di dati: seleziona Attributo data dal menu a discesa.
   • Nome dell’attributo: lascia il nome “Nome campo” (per esempio, data_personalizzata).
   • Nome visualizzato dell’attributo: se lo desideri, aggiungi un nome di visualizzazione più semplice per il campo.
   • Rapporti: attiva questa casella di controllo. Questa opzione deve essere selezionata per documentare la data utilizzata nei rapporti Discover.
3. Nella sezione Mappatura origine predefinita, seleziona l’attributo creato nel punto 2 per la mappatura della Data del documento.
   
4. Fai clic sull’icona dell’ingranaggio nella colonna Trasformazioni.
5. Seleziona Trasformazione personalizzata.
   
6. Nel costruttore di espressioni sono disponibili diverse opzioni per impostare una data in base alle tue esigenze:
   • Usa ora di caricamento: per utilizzare la data di caricamento dei documenti in XM Discover, trascina la funzione NOW() dalla sezione Funzioni alla casella Espressione.
     
   • Usa valore codificato: per utilizzare una data specifica, trascina la funzione TEXTTODATE() dalla sezione Funzioni alla casella Espressione e indica la data e il formato della data all’interno della parentesi.
     
     Consiglio Q: in entrambi i casi, la data risultante utilizzerà il formato AAAA-MM-DDThh:mm:ssZ.
7. Fai clic su Testper vedere il risultato della trasformazione. Se necessario, modifica l’espressione finché il test non dà i risultati desiderati.
8. Fai clic su Salva una volta terminato.

Esempi di trasformazione personalizzata

Questa sezione illustra alcuni esempi di come si possono manipolare i dati utilizzando trasformazioni personalizzate.

Assegnare un valore sorgente personalizzato

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

Come: applica la seguente trasformazione al campo “Origine” (basta mettere il valore del testo tra virgolette):

Cambiare “Cognome, Nome” in “Nome, Cognome”

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

Come: applica la seguente trasformazione al campo nome:

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

Convertire una data da UTC a CST

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

Come: applica la seguente trasformazione al campo END_DATE:

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

Convertire hh:mm:ss in minuti

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

Come: applica la seguente trasformazione:

GETMINUTESBETWEEN(TEXTTODATE(“1970-01-01”, “AAAA-MM-GG”), CONCAT(“1970-01-01T”, MY_TIME))

Convertire Unix Epoch Time 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 quindi trasforma i millisecondi in una data ISO 8601:

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

Derivare il valore in base alla presenza di qualcosa in un array

Obiettivo: controllare il nome dello Stato e assegnare un valore “Area DMV” se corrisponde a uno degli Stati della lista. Altrimenti, imposta come “Altri Stati”.

Come: aggiungi un campo di testo personalizzato chiamato AREA e applica la seguente trasformazione:

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

Estrarre il nome dell’articolo dal titolo della pagina

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

Come: applica la seguente trasformazione al campo del titolo della pagina:

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

Unire nome e cognome in un unico campo

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

Come: aggiungi un campo di testo personalizzato chiamato FULL_NAME e applica la seguente trasformazione:

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

Unire due campi testuali e caricare solo il campo testuale combinato

Obiettivo: unire due campi testuali VERBATIM1 e VERBATIM2 in un nuovo campo VERBATIM3 e caricare solo il campo testuale combinato in XM Discover.

Come: esegui le seguenti operazioni:

1. Crea un campo testuale chiamato VERBATIM3 e applica la seguente trasformazione: CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Per i campi VERBATIM1 e VERBATIM2, imposta Tipo di dati su Non mappare.

Rollup multivariabile

Obiettivo: creare un rollup multivariabile per le risposte a una singola domanda che sono suddivise in diversi attributi. Supponiamo che il set di dati contenga più attributi “sì o no” per indicare diversi livelli di appartenenza di un cliente:

• QID2_1 per Argento
• QID2_2 per Oro
• QID2_3 per Platino

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

Come: applica la seguente trasformazione:

TRIMRIGHT(CONCAT(IF(QID2_1==”Sì”, “Argento”, “”), IF(QID2_2==”Sì”, “Oro”, “”), IF(QID2_3==”Sì”, “Platino”, “”)))

Rimuovere il carattere di testa

Obiettivo: rimuovere il primo carattere di una stringa.

Come: applica la seguente trasformazione:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Tagliare gli zeri iniziali

Obiettivo: eliminare gli zeri iniziali in un numero.

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

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

Per un valore numerico, applica la seguente trasformazione:

TEXTTONUMBER(MY_NUMBER)