Questo documento fornisce istruzioni su come utilizzare le funzioni di preparazione dei dati nell’interfaccia utente di Adobe Experience Platform per mappare i file CSV su uno schema XDM.
Questa esercitazione richiede una buona comprensione dei seguenti componenti di Platform:
Puoi accedere ai dettagli del flusso di dati selezionando qualsiasi origine dal catalogo origini. Per ulteriori informazioni, consulta la sezione panoramica di origini.
Prima di poter mappare i dati CSV su uno schema XDM, è necessario stabilire i dettagli del flusso di dati.
La Dettaglio flusso di dati La pagina ti consente di selezionare se desideri acquisire i dati CSV in un set di dati di destinazione esistente o in un nuovo set di dati di destinazione. Un set di dati esistente viene fornito con uno schema di destinazione predefinito in cui mappare i dati, mentre un nuovo set di dati richiede la selezione di uno schema esistente o la creazione di un nuovo schema in cui mappare i dati.
Per acquisire i dati CSV in un set di dati esistente, seleziona Set di dati esistente. Puoi recuperare un set di dati esistente utilizzando Ricerca avanzata o scorrendo l’elenco dei set di dati esistenti nel menu a discesa.
Con un set di dati selezionato, fornisci un nome per il flusso di dati e una descrizione facoltativa.
Durante questo processo, puoi anche abilitare Diagnostica degli errori e Acquisizione parziale. Diagnostica degli errori consente la generazione dettagliata dei messaggi di errore per tutti i record errati che si verificano nel flusso di dati, mentre Acquisizione parziale consente di acquisire dati contenenti errori, fino a una determinata soglia definita manualmente. Consulta la sezione panoramica dell’acquisizione parziale in batch per ulteriori informazioni.
Per acquisire i dati CSV in un nuovo set di dati, seleziona Nuovo set di dati e quindi fornisci il nome di un set di dati di output e una descrizione facoltativa. Quindi, seleziona uno schema a cui eseguire il mapping utilizzando Ricerca avanzata oppure scorrendo l’elenco degli schemi esistenti nel menu a discesa.
Con uno schema selezionato, fornisci un nome per il flusso di dati e una descrizione facoltativa, quindi applica il Diagnostica degli errori e Acquisizione parziale impostazioni desiderate per il flusso di dati. Al termine, seleziona Successivo.
La Seleziona dati viene visualizzato un passaggio che fornisce un’interfaccia per caricare i file locali e visualizzarne l’anteprima di struttura e contenuti. Seleziona Scegliere i file per caricare un file CSV dal sistema locale. In alternativa, puoi trascinare e rilasciare il file CSV da caricare nel Trascinamento di file pannello.
Solo i file CSV sono attualmente supportati dal caricamento di file locale. La dimensione massima del file per ciascun file è 1 GB.
Una volta caricato il file, l’interfaccia di anteprima si aggiorna per visualizzare il contenuto e la struttura del file.
A seconda del file, è possibile selezionare un delimitatore di colonna, ad esempio tabulazioni, virgole, barre verticali o un delimitatore di colonna personalizzato per i dati di origine. Seleziona la Delimitatore freccia a discesa, quindi selezionare il delimitatore appropriato dal menu.
Al termine, seleziona Successivo.
La mappatura L’interfaccia di offre uno strumento completo per mappare i campi di origine dallo schema di origine ai campi XDM di destinazione appropriati nello schema di destinazione.
L’interfaccia di mappatura include una dashboard che fornisce informazioni sullo stato dei campi di mappatura nel contesto del flusso di lavoro di acquisizione. Il dashboard visualizza i seguenti dettagli relativi ai campi di mappatura:
Proprietà | Descrizione |
---|---|
Campi mappati | Visualizza il numero totale di campi di origine mappati a un campo XDM di destinazione, indipendentemente dagli errori. |
Campi obbligatori | Visualizza il numero di campi di mappatura richiesti. |
Campi di identità | Visualizza il numero totale di campi di mappatura definiti come identità. Questi campi di mappatura sono rappresentati da un'icona di impronta digitale. |
Errori | Visualizza il numero di campi di mappatura errati. |
L’interfaccia di mappatura offre anche un pannello di opzioni selezionabili per interagire meglio o filtrare attraverso i campi di mappatura.
Per cercare un particolare set di mappatura, seleziona Campi di origine della ricerca e immettere il nome dei dati di origine che si desidera isolare.
Seleziona Tutti i campi di origine per visualizzare un menu a discesa delle opzioni di filtro per limitare meglio la visualizzazione dell’interfaccia di mappatura.
Le opzioni di filtro sono:
Campi di origine | Descrizione |
---|---|
Tutti i campi di origine | Questa opzione visualizza tutti i campi di origine dello schema di origine. Questa opzione è visualizzata per impostazione predefinita. |
Campi obbligatori | Questa opzione filtra lo schema di origine per visualizzare solo i campi necessari per completare la mappatura. |
Campi di identità | Questa opzione filtra lo schema di origine per visualizzare solo i campi contrassegnati per l’identità. |
Campi mappati | Questa opzione filtra lo schema di origine per visualizzare solo i campi che sono già stati mappati. |
Campi non mappati | Questa opzione filtra lo schema di origine per visualizzare solo i campi che devono ancora essere mappati. |
Campi con raccomandazione | Questa opzione filtra lo schema di origine per visualizzare solo i campi che contengono consigli di mappatura. |
Seleziona Campi con errori per visualizzare tutti i campi di mappatura con errori.
Viene visualizzata una visualizzazione isolata dei campi di mappatura errati, che consente di risolvere gli errori tramite raccomandazioni di mappatura intelligente o tramite la struttura di mappatura manuale.
Puoi aggiungere un nuovo campo di mappatura o un campo calcolato selezionando Nuovo tipo di campo.
Per aggiungere un nuovo campo di mappatura, seleziona Nuovo tipo di campo quindi seleziona Aggiungi nuovo campo dal menu a discesa visualizzato.
Quindi, selezionare il campo di origine che si desidera aggiungere dalla struttura dello schema di origine visualizzata, quindi selezionare Seleziona.
L’interfaccia di mappatura viene aggiornata con il campo di origine selezionato e con un campo di destinazione vuoto. Seleziona Campo di destinazione mappa per iniziare a mappare il nuovo campo di origine al relativo campo XDM di destinazione appropriato.
Viene visualizzata una struttura ad albero dello schema di destinazione interattivo, che consente di spostarsi manualmente nello schema di destinazione e trovare il campo XDM di destinazione appropriato per il campo di origine.
Al termine, seleziona l’icona dello schema per chiudere l’interfaccia dello schema di destinazione.
I campi calcolati consentono la creazione di valori in base agli attributi nello schema di input. Questi valori possono quindi essere assegnati agli attributi nello schema di destinazione e ricevere un nome e una descrizione per facilitarne il riferimento. I campi calcolati hanno una lunghezza massima di 4096 caratteri.
Per creare un campo calcolato, seleziona Nuovo tipo di campo quindi seleziona Aggiungi campo calcolato
La Crea campo calcolato viene visualizzato il pannello . La finestra di dialogo a sinistra contiene i campi, le funzioni e gli operatori supportati nei campi calcolati. Seleziona una delle schede per iniziare ad aggiungere funzioni, campi o operatori all’editor di espressioni.
Scheda | Descrizione |
---|---|
Funzione | Nella scheda Funzioni sono elencate le funzioni disponibili per la trasformazione dei dati. Per ulteriori informazioni sulle funzioni che è possibile utilizzare all'interno dei campi calcolati, leggere la guida in utilizzo delle funzioni di preparazione dei dati (mappatore). |
Campo | Nella scheda Campi sono elencati i campi e gli attributi disponibili nello schema di origine. |
Operatore | La scheda operatori elenca gli operatori disponibili per la trasformazione dei dati. |
Puoi aggiungere manualmente campi, funzioni e operatori utilizzando l’editor espressioni al centro. Seleziona l’editor per iniziare a creare un’espressione. Al termine, seleziona Salva per procedere.
Puoi riutilizzare la mappatura di un flusso di dati esistente per ridurre il tempo di configurazione manuale dell’inserimento dei dati e limitare gli errori. Seleziona Mappatura importazione per riutilizzare una mappatura esistente.
La Mappatura importazione viene visualizzata una finestra che fornisce un elenco di flussi di dati tra cui scegliere.
Seleziona l’icona di anteprima per visualizzare in anteprima la mappatura del flusso di dati selezionato.
La finestra di anteprima consente di controllare la mappatura esistente prima di importarla nel flusso di dati. Una volta verificata la mappatura, puoi selezionare Indietro per tornare all'elenco dei flussi di dati ed esaminare un altro set di mappature, oppure puoi selezionare Seleziona per procedere.
In alternativa, è possibile selezionare la mappatura da importare dalla finestra elenco dei flussi di dati. Seleziona il flusso di dati contenente la mappatura da importare, quindi seleziona Seleziona per procedere.
L’interfaccia viene aggiornata con la mappatura importata.
Tutti i set di mappatura esistenti stabiliti o i consigli di mappatura ML vengono sostituiti dalla mappatura importata da un flusso di dati esistente.
Seleziona Anteprima dati per visualizzare i risultati della mappatura di fino a 100 righe di dati di esempio dal set di dati selezionato.
Durante l’anteprima, la colonna Identity ha la priorità come primo campo, in quanto rappresenta le informazioni chiave necessarie per la convalida dei risultati della mappatura. Al termine, seleziona Chiudi.
Per rimuovere tutti i campi di mappatura, seleziona Cancella tutte le mappature.
Platform fornisce automaticamente raccomandazioni intelligenti per i campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai casi d’uso o correggere eventuali campi di mappatura duplicati per cancellare eventuali errori.
Selezionare l'icona lampadina nel campo di destinazione che si desidera regolare.
La Mappatura dei consigli viene visualizzato un pannello a comparsa che visualizza un elenco di campi di destinazione consigliati che possono essere mappati su un particolare campo di origine. Per impostazione predefinita, la prima raccomandazione viene applicata automaticamente.
A volte, per lo schema di origine sono disponibili più consigli. In questo caso, la scheda di mappatura visualizza la raccomandazione più importante, seguita da un'icona che contiene il numero di consigli aggiuntivi disponibili. Selezionando l’icona della lampadina viene visualizzato un elenco dei consigli aggiuntivi. Potete scegliere una delle raccomandazioni alternative selezionando la casella di controllo accanto alla raccomandazione a cui desiderate eseguire la mappatura.
Da qui, puoi modificare il campo di destinazione selezionato per correggere un errore o abbinare il tuo caso d’uso.
In alternativa, è possibile selezionare Seleziona manualmente per utilizzare manualmente la struttura di mappatura dello schema di destinazione interattivo.
L’interfaccia di mappatura dello schema di destinazione viene visualizzata nella stessa visualizzazione dei campi di mappatura, consentendo di modificare le coppie di mappatura all’interno della stessa schermata. Seleziona il campo di destinazione adatto al tuo caso d’uso o corregge gli errori.
Al termine, seleziona Fine per procedere.
Leggendo questo documento, hai mappato correttamente un file CSV su uno schema XDM di destinazione utilizzando l’interfaccia di mappatura nell’interfaccia utente di Platform. Per ulteriori informazioni, consulta i seguenti documenti: