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:

  1. 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.
  2. 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

  1. Apri Car Market Hub → Car Importer.
  2. Individua la scheda Veicoli non ancora importati nella parte superiore della pagina (visibile solo quando esistono annunci in attesa).
  3. Facoltativamente, utilizza il campo Cerca per filtrare per titolo, ID o Seller ID.
  4. Per importare un singolo annuncio, fai clic sul pulsante Importa presente su quella riga.
  5. 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.
  6. Attendi l'avviso del risultato. Un avviso di successo segnala il numero di elementi inseriti, aggiornati e gli errori.

Re-importare i veicoli importati

  1. 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.
  2. Il plugin recupera i dati aggiornati da AutoScout24 per gli annunci selezionati utilizzando il primo Seller ID configurato.

Eliminare i veicoli importati

  1. 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.
  2. Conferma l'azione distruttiva nella finestra modale.
  3. 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

ElementoComportamento
Casella di ricerca (Search Title, ID…)Filtra per ID annuncio, titolo e Seller ID. L'URL rimane condivisibile.
Menu a discesa azioni di gruppoInclude Importa selezionati.
Pulsante Importa per rigaImporta solo quel singolo annuncio senza selezionare una casella di controllo.
Selettore elementi per paginaValori consentiti: 5, 10, 25, 50, 100. La selezione viene salvata per utente WordPress.
PaginazionePaginazione lato server per gli annunci in attesa.

Tabella dei veicoli importati

ElementoComportamento
Casella di ricercaStesso comportamento della tabella in attesa, ma effettua la ricerca tra i veicoli importati.
Menu a discesa azioni di gruppoElimina selezionati e Re-importa selezionati.
Pulsante Re-importa per rigaUn'icona di aggiornamento che re-importa solo quel singolo veicolo.
Pulsante Elimina per rigaUn'icona del cestino che elimina solo quel singolo veicolo (previa conferma).
Selettore elementi per pagina5, 10, 25, 50, 100. Salvato per utente WordPress.
PaginazionePaginazione lato server per i veicoli importati.
Modale di confermaConferma le eliminazioni distruttive (singole e di gruppo).

La tabella degli elementi importati mostra anche queste colonne per ciascun veicolo:

ColonnaSignificato
Ultimo aggiornamentoL'ultima volta che i dati di questo veicolo sono stati sincronizzati da AutoScout24.
Modifica / VisualizzaCollegamenti standard di WordPress Modifica e Visualizza per l'articolo del veicolo.
Seller IDIl Seller ID di AutoScout24 a cui appartiene il veicolo.
AutoScout IDL'ID dell'annuncio del veicolo su AutoScout24.
Visualizza su AutoScout24Apre 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.

Documenti correlati