Documentazione · Riferimento amministratore
Riferimento importatore veicoli
Questo documento rappresenta un riferimento per la schermata Car Importer del plugin ADP Car Market Hub (Car Market Hub → Car Importer). Spiega le due tabelle presenti nella pagina (veicoli in attesa rispetto a quelli importati), le azioni che è possibile intraprendere e il comportamento della ricerca e della paginazione.
Quando usare questo documento
Utilizza questo riferimento quando hai la necessità di importare singoli veicoli, re-importare un veicolo per aggiornarne i dati o rimuovere i veicoli importati da WordPress. Per le importazioni automatiche e pianificate dell'intero inventario, consulta il Riferimento a importazione e limiti.
Panoramica
La schermata Car Importer presenta due tabelle, quando applicabili:
- Veicoli non ancora importati — annunci presenti su AutoScout24 per i Seller ID configurati, ma che non hanno ancora un articolo corrispondente in WordPress. La tabella viene mostrata solo quando esiste almeno un veicolo di questo tipo.
- Veicoli importati — veicoli già importati nel database locale di WordPress (il custom post type
as24ci_car). Queste righe possono essere re-importate (per aggiornare dati e immagini) o eliminate.
Entrambe le tabelle condividono lo stesso layout di tabella condivisa: barra degli strumenti superiore con azioni di gruppo e selettore di elementi per pagina, casella di ricerca, righe paginate e una barra degli strumenti inferiore corrispondente.
Requisiti o prerequisiti
- Credenziali API valide e almeno un Seller ID configurato in Impostazioni.
- Una connessione API funzionante (il banner della Dashboard mostra lo stato corrente).
- Una licenza del plugin attiva. Le importazioni vengono bloccate con un errore di licenza se non è presente una licenza valida (vedi Riferimento impostazioni).
- Autorizzazione a gestire il plugin.
Istruzioni passo dopo passo
Importare singoli veicoli dall'elenco in attesa
- Apri Car Market Hub → Car Importer.
- Individua la scheda Veicoli non ancora importati nella parte superiore della pagina (visibile solo quando esistono annunci in attesa).
- Facoltativamente, utilizza il campo Cerca per filtrare per titolo, ID o Seller ID.
- Per importare un singolo annuncio, fai clic sul pulsante Importa presente su quella riga.
- Per importarne diversi contemporaneamente, seleziona le righe utilizzando le caselle di controllo, scegli Importa selezionati nel menu a discesa delle azioni di gruppo e fai clic su Applica.
- Attendi l'avviso del risultato. Un avviso di successo segnala il numero di elementi inseriti, aggiornati e gli errori.
Re-importare i veicoli importati
- Nella scheda Veicoli importati, fai clic sul pulsante Re-importa (icona di aggiornamento) su una singola riga per aggiornare solo quel veicolo, oppure seleziona più righe, scegli Re-importa selezionati nel menu a discesa delle azioni di gruppo e fai clic su Applica.
- Il plugin recupera i dati aggiornati da AutoScout24 per gli annunci selezionati utilizzando il primo Seller ID configurato.
Eliminare i veicoli importati
- Nella scheda Veicoli importati, fai clic sul pulsante Elimina (icona del cestino) su una singola riga, oppure seleziona più righe, scegli Elimina selezionati nel menu a discesa delle azioni di gruppo e fai clic su Applica.
- Conferma l'azione distruttiva nella finestra modale.
- I veicoli importati e le relative immagini importate vengono rimossi. Gli elementi che non esistevano più vengono segnalati come saltati; gli errori vengono segnalati separatamente.
Importare l'intero inventario a lotti
La schermata Car Importer serve per lavorare con singoli veicoli. Per elaborare l'intero inventario a lotti, utilizza invece la procedura guidata Avvia importazione ora nella schermata Import & Limits. Il riferimento dettagliato per la procedura guidata, la pianificazione e i limiti si trova nel Riferimento a importazione e limiti.
Riferimento di configurazione
Tabella dei veicoli in attesa
| Elemento | Comportamento |
|---|---|
Casella di ricerca (Search Title, ID…) | Filtra per ID annuncio, titolo e Seller ID. L'URL rimane condivisibile. |
| Menu a discesa azioni di gruppo | Include Importa selezionati. |
| Pulsante Importa per riga | Importa solo quel singolo annuncio senza selezionare una casella di controllo. |
| Selettore elementi per pagina | Valori consentiti: 5, 10, 25, 50, 100. La selezione viene salvata per utente WordPress. |
| Paginazione | Paginazione lato server per gli annunci in attesa. |
Tabella dei veicoli importati
| Elemento | Comportamento |
|---|---|
| Casella di ricerca | Stesso comportamento della tabella in attesa, ma effettua la ricerca tra i veicoli importati. |
| Menu a discesa azioni di gruppo | Elimina selezionati e Re-importa selezionati. |
| Pulsante Re-importa per riga | Un'icona di aggiornamento che re-importa solo quel singolo veicolo. |
| Pulsante Elimina per riga | Un'icona del cestino che elimina solo quel singolo veicolo (previa conferma). |
| Selettore elementi per pagina | 5, 10, 25, 50, 100. Salvato per utente WordPress. |
| Paginazione | Paginazione lato server per i veicoli importati. |
| Modale di conferma | Conferma le eliminazioni distruttive (singole e di gruppo). |
La tabella degli elementi importati mostra anche queste colonne per ciascun veicolo:
| Colonna | Significato |
|---|---|
| Ultimo aggiornamento | L'ultima volta che i dati di questo veicolo sono stati sincronizzati da AutoScout24. |
| Modifica / Visualizza | Collegamenti standard di WordPress Modifica e Visualizza per l'articolo del veicolo. |
| Seller ID | Il Seller ID di AutoScout24 a cui appartiene il veicolo. |
| AutoScout ID | L'ID dell'annuncio del veicolo su AutoScout24. |
| Visualizza su AutoScout24 | Apre l'annuncio originale su AutoScout24 in una nuova scheda. |
Risultati delle azioni di gruppo
Dopo un'eliminazione di gruppo, la pagina segnala:
- il numero di elementi eliminati rispetto al totale selezionato,
- il numero di elementi saltati perché non esistevano più,
- il numero di elementi che non è stato possibile eliminare a causa di un errore,
e scrive una voce dettagliata nel registro del plugin quando si verificano errori.
Dopo un'importazione di gruppo, la pagina segnala il numero di elementi inseriti, aggiornati e gli errori.
Modale di avanzamento dell'importazione
Mentre è in corso un'importazione (singola riga o di gruppo), viene visualizzata una finestra modale di avanzamento sopra la pagina. Mostra un indicatore di caricamento, una barra di avanzamento, un conteggio N / N degli elementi elaborati rispetto al totale e un timer del tempo trascorso. Un pulsante Chiudi consente di chiudere la modale una volta terminata l'importazione.
Note operative
- La tabella Veicoli importati legge solo dal database locale di WordPress. Non effettua chiamate alle API a ogni caricamento di pagina.
- Gli annunci in attesa provengono da un'istantanea delle API e potrebbero non essere aggiornati fino alla successiva sincronizzazione. Utilizza la schermata Import & Limits per controllare la frequenza con cui avviene tale sincronizzazione.
- L'importazione di gruppo utilizza sempre il primo Seller ID configurato in Impostazioni. Se gestisci più Seller ID e hai bisogno di importare da uno specifico, assicurati che sia elencato per primo.
- L'eliminazione di un veicolo rimuove i relativi allegati importati. Le immagini caricate manualmente che non sono registrate come allegati importati non vengono rimosse.
- Le preferenze degli elementi per pagina sono memorizzate per utente WordPress, in modo che ogni redattore possa avere la propria densità di tabella.
Risoluzione dei problemi
- La scheda degli elementi in attesa non viene mostrata. Tutti gli annunci conosciuti sono già stati importati, oppure l'API non è stata ancora interrogata. Assicurati che la Dashboard mostri una connessione API corretta e che sia stata eseguita un'importazione almeno una volta.
- "Nessun Seller ID configurato." Aggiungi almeno un Seller ID in Impostazioni → Connessione API e Impostazioni Generali.
- Un'importazione restituisce errori. Apri i Registri (
Car Market Hub → Logs) per visualizzare i dettagli. Le cause comuni sono problemi di rete, credenziali scadute o ID annuncio non validi. - Un'importazione è bloccata con un errore di licenza. Le importazioni richiedono una licenza del plugin attiva. Attiva o verifica nuovamente la tua licenza in Impostazioni → Licenza e Attivazione, quindi riprova.
- Gli elementi vengono mostrati come saltati dopo un'eliminazione di gruppo. Quegli annunci erano già stati rimossi (ad esempio da un altro amministratore o tramite la Sincronizzazione Completa). Non è richiesta alcuna azione.
- Un'eliminazione segnala un errore. Controlla i Registri per il messaggio relativo al singolo annuncio; la pagina indica anche "per i dettagli, consulta il registro" quando applicabile.
- La ricerca non restituisce risultati. La ricerca corrisponde a ID annuncio, titolo e Seller ID. Cancella la ricerca per confermare che la riga esista.