Importazione di dati supplementari
Importante: questo argomento è valido per gli utenti della versione più recente di Connect. Se il proprio account ancora utilizza Connect versione classica, scaricare la Guida per l'utente di Connect versione classica.
È possibile utilizzare Connect per importare record in una tabella Dati supplementari in Oracle Responsys.
Dopo l'esecuzione di un job di importazione, il file di caricamento viene archiviato sul server. Se il job viene eseguito correttamente, il file di caricamento viene eliminato. Se il job non viene eseguito correttamente, il file di caricamento viene eliminato solo nelle seguenti circostanze:
- Il file è vuoto
- Il file contiene errori di dati, ad esempio un formato dati non valido
- Il file di caricamento e il file dei conteggi contengono una diversa quantità di record.
Per creare un job di importazione di dati supplementari:
- Fare clic su
Dati nella bara di navigazione laterale e selezionare Connetti. - Fare clic su Crea job nella pagina Gestisci Connect.
- Selezionare Importa dati supplementari nell'elenco a discesa e fornire il nome e la descrizione del job di importazione.
I nomi job non possono superare i 100 caratteri e possono includere solo i caratteri seguenti: A-Z a-z 0-9 spazio ! - = @ _ [ ] { }
- Fare clic su Fine.
Viene visualizzata la procedura guidata Connect. È possibile completare i passi in qualsiasi ordine nonché salvare le modifiche e continuare in un secondo momento.
- Completare i passi riportati di seguito.
- Dopo aver configurato tutti i passi, fare clic su Salva. Per salvare e attivare il job, fare clic su Attiva.
Importante: prima di poter salvare o attivare il job, è necessario impostare una data di scadenza oppure impostare il job in modo che non scada mai. Per impostare una data di scadenza, fare clic su Modifica
accanto a Scadenza. Quando il job scade, viene eliminato e non può essere recuperato. Ulteriori informazioni sulla gestione della data di scadenza.
Al termine della procedura:
- Dopo aver salvato il job, è possibile utilizzare la pagina Gestisci Connect per gestirlo. Ulteriori informazioni sulla gestione dei job.
- È possibile che Connect restituisca errori quando si salva il job. Fare clic su Mostra errori per esaminare gli errori e passare rapidamente alla pagina da correggere. È necessario correggere tutti gli errori per poter attivare il job.
Passo 1: connettività di origine
In questo passo l'utente fornisce le specifiche del file server per il recupero del file di origine.
Selezionare una delle seguenti opzioni:
- File server Responsys: i job di Connect possono importare i dati tramite il file server dell'account Responsys SCP (Secure Copy Protocol). Questo account include tre directory, ovvero upload, download e archive.
Importante: se non è già stato stabilito in precedenza, il personale del Supporto Oracle Responsys deve collaborare con il team IT per generare una coppia di chiavi pubblica-privata SSH-2. In questo modo viene garantito l'accesso sicuro all'account SCP mediante un client SSH/SCP. È inoltre possibile creare directory personalizzate utilizzando un client SSH (Secure Shell).
- Se si seleziona questa opzione, fare clic su Modifica per specificare la directory in cui si trovano i file.
- Server esterno per SFTP: quando si seleziona questa opzione, è necessario fornire le informazioni riportate di seguito.
- Nome host: selezionare il nome host dall'elenco a discesa.
- Percorso directory: immettere il percorso della directory associata.
- Nome utente: immettere il nome utente per l'accesso alla connessione SFTP.
- Autenticazione: a seconda delle modalità di impostazione del server, selezionare Password o Chiave.
Se si tratta del primo job che utilizza l'autenticazione tramite chiave, fare clic su Accedi o genera informazioni chiave e immettere l'indirizzo e-mail per ricevere le chiave pubblica e le istruzioni per l'aggiunta della chiave all'account SFTP. Dopo aver installato la chiave pubblica, fare clic su Test connessione per confermare la validità della configurazione della connessione SFTP.
Suggerimento: per informazioni sull'autenticazione con chiave, vedere Selezione, importazione o generazione di chiavi pubbliche.
Passo 2: specifica dell'origine
In questo passo l'utente fornisce le informazioni sul file da importare.
- File da caricare: il nome completo e l'estensione del file da importare. È possibile aggiungere la data di creazione del file come prefisso o suffisso.
- Set di caratteri: il set di caratteri del file. Se il file contiene emoji, sarà necessario selezionare Unicode (UTF-8) come set di caratteri.
- Delimitatore campo: il delimitatore che divide i campi (le colonne) del file.
- Delimitatore di inclusione campo: specificare se le colonne di testo e i valori sono racchiusi tra apici o virgolette.
- Formato data: selezionare il formato della data del file di importazione. Per informazioni sui formati data supportati, vedere Formati data supportati in Connect.
- La prima riga contiene nomi di colonna: selezionare questa casella di controllo se la prima riga del file contiene nomi di campo.
- Il file è cifrato con la chiave PGP/GPG: selezionare questa casella di controllo se il file è stato cifrato con una chiave e deve essere decifrato prima del caricamento.
- Il file è firmato con la chiave PGP/GPG: selezionare questa casella di controllo se il file è stato firmato con una chiave.
- File per confermare conteggio record previsto: selezionare facoltativamente questa casella di controllo e specificare il file da utilizzare per confrontare il conteggio dei record con il numero dei record importati. Ad esempio, se il conteggio record previsto nel file è 300, ma il file importato contiene solo 100 record, viene trascritto un errore di trasferimento e il processo di caricamento viene interrotto.
Passo 3: definizione della destinazione
In questo passo l'utente seleziona la tabella Dati supplementari in cui desidera importare i dati.
Nota: sarà inoltre necessario selezionare le tabelle di destinazione durante la mappatura dei campi nel Passaggio 4.
Per aggiungere una definizione destinazione:
- In Definizione target fare clic su Aggiungi (+) e selezionare la tabella Dati supplementari in cui importare i dati.
- Specificare le opzioni indicate di seguito nella sezione Configurazione.
- Rimuovi tutti i record esistenti e carica: selezionare questa casella di controllo per sostituire i record esistenti con i record caricati.
- Unisci nella tabella utilizzando il campo seguente: se non si sceglie di rimuovere tutti i record esistenti, selezionare il campo per l'unione dei nuovi record nei record esistenti.
- Se esiste una corrispondenza - Sovrascrivi tutti i campi mappati nel record esistente: selezionare questa casella di controllo per sostituire i record esistenti con i nuovi dati quando un record corrisponde. Se non si seleziona la casella di controllo, il record in entrata verrà ignorato.
- In mancanza di corrispondenza, importa il nuovo record: selezionare questa casella di controllo per importare i record se non esistono corrispondenze. Se non si seleziona la casella di controllo, il record in entrata verrà ignorato.
Passo 4: mapping dei campi
In questo passo l'utente esegue il mapping delle colonne dal file di origine ai campi della tabella target. Il mapping specifica il campo di origine che corrisponde al campo target.
È possibile eseguire il mapping dei campi manualmente, utilizzando un file di caricamento oppure tramite la generazione automatica.
Tenere presente quanto riportato di seguito.
- I nomi di campi lunghi vengono troncati a 30 caratteri.
- I nomi dei campi devono iniziare con una lettera o un numero e possono contenere solo lettere, cifre e _ (carattere di sottolineatura).
- Una volta creati, i nomi di campo non fanno distinzione tra maiuscole e minuscole, ma in seguito vengono convertiti in formato tutto maiuscolo.
- Se le modifiche apportate generano nomi di campo duplicati, sarà necessario rinominare i nomi duplicati manualmente.
- Tutti i nomi di campo di sistema (definiti e riservati da Oracle Responsys) terminano con un carattere di sottolineatura, ad esempio EMAIL_ADDRESS_. Come procedura consigliata, i nomi di campo caricati non devono terminare con un carattere di sottolineatura. Questo carattere è riservato ai campi di sistema.
- Quando possibile, abbinare campi in entrata con nome simile a campi elenco esistenti, ad esempio abbinare CUST_ID a CUSTOMER_ID_.
Per ulteriori informazioni sui requisiti relativi ai tipi di dati e ai nomi di campo, vedere Tipi di dati e nomi di campo.
Per caricare un file di mapping
- In Mapping campi fare clic su Carica file.
- Selezionare il file di mapping e completare i dettagli.
- I campi sono delimitati da: selezionare il delimitatore, in genere una tabulazione o una virgola, utilizzato per suddividere le colonne nel file.
- I campi sono racchiusi tra: specificare se le colonne di testo e i valori sono racchiusi tra apici o virgolette.
- La prima riga contiene nomi di colonna: selezionare la casella di controllo se la prima riga contiene nomi di colonna.
Per eseguire il mapping dei campi:
- In Mapping campi fare clic su Aggiungi (+).
- Accertarsi di selezionare anche la tabella di destinazione del campo.
- Specificare il campo in entrata e il campo a cui corrisponde. Se non si desidera definire la corrispondenza per un campo, selezionare ignora questo campo.
- Fare clic su Aggiorna.
Passo 5: post-elaborazione
In questo passo l'utente lancia le campagne dopo l'esecuzione riuscita del job. È possibile selezionare fino a 40 campagne.
Per ricevere le notifiche relative all'avanzamento dei lanci delle campagne, assicurarsi che le impostazioni di ogni campagna specifichino uno o più indirizzi e-mail per la ricezione di tali notifiche.
Passo 6: notifica
In questo passo l'utente imposta le notifiche e-mail per il job. È possibile scegliere di inviare le notifiche dopo un'esecuzione con esito positivo o negativo di un job.
Passo 7: schedulazione
In questo passo l'utente schedula il job. Il job può essere eseguito in una data e ora specifiche oppure in base a una schedulazione ricorrente. Per eseguire il job su richiesta, utilizzare l'opzione Non schedulare.
Importante: per evitare che gli anni bisestili e i mesi con 31 giorni generino problemi, non è possibile schedulare un'esecuzione mensile periodica nei giorni 29, 30 o 31 di un mese. È possibile schedulare il job in modo che venga eseguito in un giorno della settimana corrispondente all'ultimo del mese, ad esempio nell'ultimo venerdì del mese.
Durante l'impostazione dell'ora di inizio di un job, selezionare uno dei quattro intervalli di tempo disponibili all'interno dell'ora, ovvero 0-14, 15-29, 30-44, 45-59. Per ogni job schedulato, il sistema seleziona casualmente un minuto, ad esempio il minuto 12 all'interno del segmento 0-14. In questo modo le ore di inizio dei job vengono distribuite in modo uniforme.
Il job verrà avviato in orari casuali entro l'intervallo di tempo selezionato. Se si tenta di impostare un nuovo job in un intervallo che si sovrappone all'ora corrente, è possibile che venga visualizzato un messaggio di errore indicante che l'ora selezionata è passata. È pertanto consigliabile di scegliere un intervallo di tempo successivo all'intervallo corrente.