Problemi di importazione file
Assistenza per l'importazione di file di spedizione — caricati manualmente oppure prelevati automaticamente da una cartella o da un server FTP/SFTP.
Per la costruzione del file stesso (colonne, codifica, separatori), consultate Importazione file CSV e Importazione file XML. Questa pagina riguarda le importazioni che non vengono eseguite o i file che spariscono.
Caricare un file manualmente
Messaggi mostrati dalla finestra Importa file sotto Importazioni → Importazioni file.
| Messaggio | Causa | Soluzione |
|---|---|---|
| «Tipo di file non valido. Selezionare un file corrispondente al profilo di importazione.» | L'estensione del file non è ammessa per il profilo selezionato — un profilo CSV accetta .csv e .txt, un profilo XML .xml; molto spesso una cartella di lavoro .xlsx oppure un file XML con un profilo CSV | Selezionate il profilo corrispondente, oppure salvate da Excel come CSV UTF-8, non come cartella di lavoro |
| «Errore durante l'elaborazione del file. Riprova.» | Il contenuto non corrisponde all'estensione — ad esempio con una cartella di lavoro Excel rinominata in .csv; oppure il caricamento è fallito | Controllate che il file sia un CSV di testo o un documento XML, quindi caricatelo di nuovo |
| «L'indirizzo di ritiro è obbligatorio. Seleziona un indirizzo di ritiro.» | Nessun indirizzo di ritiro scelto per l'importazione | Scegliete l'indirizzo di ritiro prima di avviare l'importazione |
I record che non superano la convalida sono elencati con il relativo codice di errore nel pannello dei dettagli del file — selezionate il file.
Rilevare le mappature dei campi in un profilo
Messaggi mostrati dal pulsante Rileva mappature dei campi nel passaggio Mappatura campi di un profilo CSV. Il file di esempio viene letto con la codifica e il delimitatore di colonna impostati nel primo passaggio del profilo.
| Messaggio | Causa | Soluzione |
|---|---|---|
| «Errore durante l'elaborazione del file. Sono consentiti solo file CSV e TXT.» | Il file di esempio ha un'altra estensione — molto spesso .xlsx | Salvate da Excel come CSV UTF-8, non come cartella di lavoro |
| «Nessuna intestazione trovata nel file CSV» | La prima riga non ha prodotto alcuna colonna | La prima riga deve essere la riga di intestazione — oppure la prima riga di dati, per un profilo senza intestazione |
| «Errore durante l'elaborazione del file CSV. Riprova.» | Non è stato possibile leggere il file di esempio | Controllate che la codifica e il delimitatore di colonna del profilo corrispondano al file — vedi Importazione file CSV |
Da controllare per primo: il registro processi
Ogni importazione eseguita dall'applicazione viene registrata sotto Messaggi → Registro processi. Controllatelo prima di modificare qualsiasi impostazione: indica subito se l'importazione è stata eseguita, e questo determina dove cercare in seguito.
Le voci più recenti sono in alto. Usate il pulsante di aggiornamento in alto a destra per ricaricare l'elenco.
| Colonna | Cosa indica |
|---|---|
| Timestamp | Quando è stato eseguito il passaggio |
| Tipo | Quale processo — Importazione automatica per il prelievo da cartella, FTP o SFTP; Importazione manuale per un file caricato da voi |
| Stato | Info, Successo, Avviso o Errore |
| Messaggio | Quale file era coinvolto. Il testo viene abbreviato nella tabella — passateci sopra con il mouse per leggerlo per intero. |
Ogni file produce due voci: Import started for file … con stato Info, quindi Import finished for file … con stato Successo o Errore.
Leggere il risultato
| Cosa vedete per il vostro file | Significato | Dove proseguire |
|---|---|---|
| Nessuna voce | L'applicazione non ha mai prelevato il file. Il contenuto del file non c'entra — non è mai stato letto. | Non viene importato nulla e Permessi delle cartelle qui sotto |
Import started ma nessun Import finished | L'importazione è ancora in corso oppure si è fermata a metà | Aggiornate dopo qualche istante; se non termina mai, contattate il supporto |
Import finished con Errore | Il file è stato letto, ma l'elaborazione non è riuscita | Il registro processi non riporta il motivo — aprite Importazioni, selezionate il file e controllatene gli errori |
Import finished con Successo | Il file è stato importato correttamente | Se mancano ancora spedizioni, controllate i filtri nell'elenco spedizioni anziché l'importazione |
La cosa più preziosa che questa schermata vi dice è ciò che non c'è. Una riga Import started mancante dimostra che il problema riguarda la cartella, i permessi o l'intervallo di controllo — non il formato del file, il profilo di mappatura o i dati. Questo esclude gran parte di questa pagina con un solo sguardo.
La colonna Nome utente viene mostrata solo agli amministratori. Qui compaiono anche altri tipi di processo — Spedizioni -> DPD, Aggiornamento DB di routing, Aggiornamento configurazione — quindi potete usare questa schermata anche per verificare che un'esportazione sia stata eseguita.
Importazioni automatiche da una cartella o da un server
Il prelievo automatico da una cartella monitorata, via FTP o SFTP si configura sotto Importazioni → Origini dati nell'applicazione installata.
Non viene importato nulla
Verificate prima nel registro processi che non ci sia alcuna voce Import started per il vostro file. Se c'è, il file è stato prelevato e questa sezione non si applica — il problema è nel file o nella sua mappatura, non nella cartella.
Una volta confermato, procedete con questi punti nell'ordine indicato: i primi due coprono la maggior parte dei casi.
1. L'origine dati è attiva?
Nell'elenco delle origini dati la colonna Stato deve indicare Attivo. Se indica Inattivo, aprite l'origine dati e attivate Abilita origine dati.
2. È impostato un intervallo di controllo?
Aprite l'origine dati e controllate Usa controllo intervallo (secondi). Un'origine dati senza intervallo non viene mai controllata: resta elencata come attiva, ma non viene mai prelevato nulla. Impostate un intervallo (ad esempio 60) e salvate.
3. Il percorso è corretto e l'applicazione può vederlo?
Controllate che Percorso di importazione non contenga errori di battitura e leggete la sezione qui sotto: in Windows un percorso esistente può comunque risultare invisibile all'applicazione.
4. Sono previsti file semaforo?
Se Usa file semaforo è attivo, un file di dati viene ignorato finché non compare il corrispondente file semaforo. Se il vostro sistema mittente non crea file semaforo, disattivate questa opzione.
Permessi delle cartelle
Questa è la causa più frequente di un'importazione automatica che silenziosamente non fa nulla.
Quale account Windows necessita dell'accesso
L'applicazione legge la cartella con l'account con cui viene eseguita — non con quello dell'utente seduto davanti allo schermo.
| Installazione | Account che necessita dell'accesso |
|---|---|
| Installata per un singolo utente (modalità desktop) | L'utente Windows che ha avviato l'applicazione |
| Installata come servizio Windows | L'account del servizio configurato durante l'installazione |
Una cartella che potete aprire in Esplora risorse non è necessariamente una cartella che il servizio può aprire.
Quale accesso serve e dove
| Cartella | Richiesto |
|---|---|
| Percorso di importazione | Lettura e modifica — il file viene spostato o eliminato dopo l'elaborazione, quindi la sola lettura non basta |
| Cartella archivio | Creare e scrivere file |
| Cartella errori | Creare e scrivere file |
Le cartelle archivio ed errori vengono create automaticamente se non esistono, quindi l'account necessita anche del permesso di creare una cartella nella directory superiore.
Per concedere l'accesso: clic destro sulla cartella → Proprietà → Sicurezza → Modifica → aggiungete l'account e spuntate Modifica.
«Import path does not exist or is not a directory»
In Windows, una cartella che l'applicazione non ha il permesso di vedere è indistinguibile da una cartella che non esiste. Se il percorso è sicuramente corretto e la cartella è sicuramente presente, trattatelo come un problema di permessi, non come un errore di battitura.
Controllate, in quest'ordine:
- L'ortografia del percorso, inclusa la lettera dell'unità
- Se si tratta di un'unità di rete mappata. Le unità mappate come
Z:\Importappartengono a un singolo utente Windows e non esistono per un servizio Windows. Usate invece il percorso di rete completo —\\server\condivisione\Import— e assicuratevi che l'account del servizio abbia accesso alla condivisione. - I permessi sulla cartella, come descritto sopra
- Se il percorso punta a un file anziché a una cartella
Antivirus e accesso controllato alle cartelle
L'accesso controllato alle cartelle di Windows e alcuni prodotti antivirus bloccano la scrittura su Desktop, Documenti e percorsi simili, anche quando i permessi di Windows sembrano corretti. I sintomi sono identici a quelli di un problema di permessi. Aggiungete l'applicazione tra quelle consentite, oppure spostate le cartelle di importazione in una posizione neutra come C:\DPD\Import.
I file vengono prelevati ma non arrivano mai nella cartella archivio
Il file lascia la cartella di importazione, ma nella cartella archivio o errori non compare nulla.
Se la cartella archivio non è scrivibile, il file non può essere spostato fuori dalla cartella di importazione. A seconda della tempistica questo si manifesta con lo stesso file rielaborato a ogni ciclo, oppure con file che si accumulano nella cartella di importazione. Concedete all'account il permesso Modifica sulle cartelle archivio ed errori.
Se l'origine è un server FTP o SFTP, controllate l'opzione «Usa cartella locale per errori/archivio».
Con Usa cartella locale per errori/archivio disattivato, le cartelle archivio ed errori vengono trattate come percorsi sul server remoto. Se vi è stato inserito un percorso Windows locale come C:\DPD\Archivio — frequente nelle configurazioni ereditate da un'installazione più vecchia — il server non può utilizzarlo e il file viene eliminato anziché archiviato. Non viene scritto alcun file di errore e il file non può essere recuperato dall'applicazione.
Lasciate attivo «Usa cartella locale per errori/archivio», a meno che le vostre cartelle archivio ed errori si trovino realmente sul server remoto. Per le nuove origini dati questa è l'impostazione predefinita.
Se in questo modo sono già andati persi dei file, recuperateli dal sistema mittente, correggete l'impostazione e inviateli di nuovo.
Dopo un'importazione non vengono stampate etichette
Se Stampa etichette dopo l'elaborazione è attivo ma non viene stampato nulla:
- Seleziona stampante è facoltativo — se il campo è vuoto viene usata la stampante predefinita. Verificate che sia impostata una stampante predefinita.
- Consultate Problemi di stampa se mancano stampanti nell'elenco o se non viene stampato nulla.