Riepilogo: ◀ ▼
Puoi importare o aggiornare in blocco più organizzazioni usando un file CSV, risparmiando tempo rispetto all’aggiunta di singole organizzazioni. Il file CSV deve seguire regole di formattazione e limiti di dimensioni specifici e devi essere un amministratore per eseguire le importazioni. Il processo supporta i dati dell’organizzazione di base e i campi personalizzati, ma presenta limitazioni come nessun ordine di importazione garantito e voci duplicate in un file. I registri della cronologia delle importazioni tengono traccia dello stato di avanzamento.
Anziché aggiungere le organizzazioni una alla volta, puoi aggiungere in blocco più organizzazioni contemporaneamente importando un file CSV (valori separati da virgola). L’importazione in blocco ti consente di aggiungere o aggiornare organizzazioni, ma puoi eseguire l’importazione solo se sei un amministratore. Puoi anche aggiungere o aggiornare più utenti e più record di oggetti personalizzati contemporaneamente.
L’importazione in blocco delle organizzazioni è irreversibile. Prima di importare il file CSV contenente le informazioni di tutte le organizzazioni, provalo con un singolo record di organizzazione per assicurarti che il caricamento funzioni come previsto.
Limitazioni per l’importazione in blocco con l’ importatore di dati
Puoi importare un set di dati di base relativi a utenti e organizzazioni. Per importare dati non elencati nella tabella, devi usare l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk.
- Quando si usa l’importatore di dati, le dimensioni del file CSV di importazione non possono superare 1 GB. Consigliamo un massimo di 500.000 righe. Questa è una riga di intestazione e un massimo di 499.999 righe di dati. Inoltre, le dimensioni di ogni riga non possono superare i 128 KB.
- Il file CSV di importazione può contenere un massimo di 200 colonne.
- Il file CSV di importazione non può garantire l’ordine di importazione delle righe.
- Non includere lo stesso utente o la stessa organizzazione più di una volta in un file CSV. In caso contrario, l’importazione potrebbe non riuscire.
- Non vi è alcuna garanzia che i record verranno creati o aggiornati nell’ordine in cui vengono mostrati nel file CSV.
- Puoi importare un solo file CSV alla volta. Pertanto, se disponi di un numero di dati superiore al numero massimo di righe supportate per il file CSV, devi creare file separati per ciascun batch e importarli uno dopo l'altro. Quando non usi l’ importatore di dati, fino a due batch vengono accodati ed eseguiti in background. Se vuoi importare più di due batch, devi attendere il completamento dell’importazione dei primi batch per aggiungerne altri.
- Non puoi usare l’importazione in blocco per importare informazioni di contatto dagli account Facebook o Twitter degli utenti finali. Per questa operazione, usa l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk.
Creazione del file CSV di dati di organizzazioni
Per importare in blocco le organizzazioni, usa un file di dati CSV. Questa sezione spiega come configurare il file di dati CSV.
- Il file deve essere un file CSV formattato correttamente e salvato usando la codifica dei caratteri UTF-8.
- La prima riga del file CSV è la riga dell’intestazione.
- La riga dell’intestazione deve contenere tutti i campi obbligatori della tabella esposta di seguito, oltre a qualsiasi altro campo elencato nella tabella che desideri includere.
- Nella riga dell’intestazione, usa domain_names o default, a seconda del metodo di importazione. Non possono essere usati insieme.
- Se non stai importando dati per un campo, non elencarlo nella riga dell’intestazione.
- Le colonne di dati vuote nel file sovrascriveranno i dati esistenti per quell’organizzazione.
- Aggiungi interruzioni di riga alle note o ai campi personalizzati multilinea premendo ALT+INVIO su un computer Windows o CTRL+OPZIONE+INVIO su macOS.
| Campo | Descrizione |
|---|---|
| nome | Obbligatorio. Il nome dell’organizzazione. |
| external_id | Facoltativo, ma consigliato; obbligatorio se intendi usare l’importatore di dati per aggiornare questi record in futuro. Un valore identificativo univoco, come il numero identificativo di un impiegato o di un cliente in un sistema esterno. |
| note | Le note sull'organizzazione. Le note sono visibili solo agli agenti, non agli utenti finali. |
| dettagli | Informazioni dettagliate sull’organizzazione, ad esempio l’indirizzo. Queste informazioni sono visibili solo agli agenti, non agli utenti finali. Usa questo campo al posto dell’intestazione predefinita quando usi l’ importatore di dati. |
| nomi_dominio | I nomi di dominio dell’organizzazione per la mappatura degli utenti. Se stai includendo più di un nome di dominio per un’organizzazione, separali con un carattere pipe (|). |
| group_id | Inserisci un gruppo predefinito per l’organizzazione. Consulta Mappatura di un gruppo a un'organizzazione. |
| tag | Quando la funzionalità di assegnazione di tag a utenti e organizzazioni è abilitata per Zendesk Support, puoi impostare tag per l’organizzazione. Separa i singoli tag con una barra verticale ( | ). Quando importi in blocco le organizzazioni, i tag nel file CSV sostituiscono i tag esistenti. Per evitare che ciò accada, puoi usare l’API dei tag per aggiornare i tag. |
| organization_fields.<field key> | Quando esegui un’importazione in blocco di un’organizzazione, puoi importare un campo organizzazione personalizzato specificando organization_fields. prefisso e la chiave del campo. Ad esempio, per la chiave del campo data_abbonamento , usa quanto segue per impostare i valori importati per questo campo. organization_fields.subscription_date Per individuare la chiave del campo per un campo dell’organizzazione, consulta Ricerca della chiave del campo o dell’ID campo per un campo personalizzato. Se il valore di un campo non è formattato correttamente, l’importazione avrà esito negativo e i dettagli relativi all’errore saranno visualizzati nel registro della cronologia delle importazioni. Per i campi data personalizzati, usa il formato GG/MM/AAAA o GG-MM-AAAA. Per i campi con casella di spunta, usaTrue o False. Per impostare il valore del campo a discesa, usa il tag aggiunto quando hai creato l’elenco a discesa.
Nota: I campi di relazione di ricerca non sono supportati quando si importano organizzazioni nella pagina importatore di dati .
Consulta Aggiunta di campi personalizzati alle organizzazioni . |
Importazione delle organizzazioni con l’importatore di dati
Puoi usare l’importatore di dati per importare un file CSV che crea nuove organizzazioni o aggiorna le organizzazioni esistenti e per acquisire i registri di tutti i tentativi di importazione tramite la pagina Importatore di dati.
L’importazione viene aggiunta alla coda e le organizzazioni vengono aggiunte a Zendesk Support al termine del processo di importazione. Il tempo necessario per l’importazione di ogni file è di circa un’ora, ma può variare a seconda delle dimensioni dei file e della coda.
- Nel Centro amministrativo, fai clic su Oggetti e regole
nella barra laterale, quindi seleziona Strumenti > Importatore di dati. - Fai clic su Importa.
- In Destinazione di destinazione , seleziona Organizzazione .
- In Opzioni di importazione , seleziona una delle opzioni seguenti:
- Solo creazione record : vengono create solo le nuove organizzazioni. Tutti i dati nel file CSV relativi a organizzazioni esistenti vengono ignorati.
- Aggiorna solo record : sostituisci i dati delle organizzazioni esistenti elencate nel file CSV. Il campo external_id è obbligatorio per aggiornare le organizzazioni. Tutti i dati relativi alle nuove organizzazioni vengono ignorati.
- Crea e aggiorna i record : crea nuove organizzazioni e aggiorna i dati delle organizzazioni esistenti elencate nel file CSV.
- In Caricamento file, trascina il file oppure fai clic per caricare e seleziona il file CSV nel browser di file.
Se devi cambiare il file che hai selezionato, fai clic sull’icona di eliminazione (
) accanto al nome del file. - Fai clic su Avanti.
- Consulta l’elenco di mappatura dei campi.
- Se la mappatura dei campi è corretta, fai clic su Avanti.
- Se la mappatura dei campi non è corretta, fai clic su Indietro. Modifica il file CSV in modo che soddisfi i requisiti di formato, quindi carica di nuovo il file.
- Consulta il riepilogo dei dettagli dell’importazione nella finestra di dialogo di conferma, quindi fai clic su Avvia importazione.
Una volta avviata l’importazione, le modifiche importate non potranno più essere ripristinate. Per controllare lo stato di un’importazione, controlla la cronologia delle importazioni.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.