Anziché aggiungere un’organizzazione alla volta, puoi aggiungerne diverse in blocco importando un file CSV. 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 dell’importazione in blocco di utenti e organizzazioni
Puoi importare un set di dati di base relativi a utenti e organizzazioni. Ad esempio, usando l’importazione in blocco, puoi importare i dati descritti nella tabella esposta oltre. Non puoi tuttavia importare fusi orari, foto, preferenze linguistiche e così via. Per importare dati non elencati nella tabella, devi usare l’API REST di Zendesk. Consulta Importazione di utenti con l’API Zendesk o Importazione di organizzazioni con l’API Zendesk.
- Il numero massimo di righe dipende dal metodo di importazione.
- Quando si usano le pagine delle azioni multiple per importare dati di utenti e organizzazioni nuovi ed esistenti, il file di dati CSV di importazione può contenere un massimo di 2.000 righe. In altre parole, una riga di intestazione e fino a 1.999 righe di dati.
- Quando si usa l’importatore di dati (beta) per importare dati di utenti e organizzazioni nuovi ed esistenti, le dimensioni del file CSV 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 128 KB.
- Quando si usa l’importatore di dati, si applicano anche le limitazioni seguenti:
- 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, utilizzerai un file CSV di dati di organizzazioni. Questa sezione descrive come impostare il file di dati CSV.
- Il file deve essere in formato CSV e deve essere 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 |
---|---|
name | 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. |
notes | Le note relative all’organizzazione. Le note sono visibili solo agli agenti, non agli utenti finali. |
domain_names (solo importatore dati) |
Informazioni dettagliate sull’organizzazione, ad esempio l’indirizzo. Queste informazioni sono visibili agli agenti, ma non agli utenti finali. Da usare al posto dell’intestazione predefinita quando si usa l’importatore di dati. |
default (non importatore dati) |
Consente di mappare gli utenti a un’organizzazione. Inserisci uno o più domini email, separati da spazi (ad esempio, organizzazione1.com organizzazione2.com). Da usare al posto dell’intestazione domain_names quando non si usa l’importatore di dati. Consulta Aggiunta automatica di utenti alle organizzazioni in base al relativo dominio email. |
shared | True o False. Imposta l’organizzazione come condivisa. Consulta Configurazione di un’organizzazione condivisa per utenti finali. |
shared_comments | True o False. Consente a tutti gli utenti nell’organizzazione di aggiungere commenti ai ticket di altri utenti. Anche il campo condiviso deve essere impostato su True. Consulta Configurazione di un’organizzazione condivisa per utenti finali. |
group | 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 (consulta Aggiunta di tag e utenti alle organizzazioni), puoi impostare tag per l’organizzazione. Separa ogni tag con spazi. 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> (solo importatore di dati) |
Quando esegui un’importazione in blocco di organizzazioni, puoi importare un campo organizzazione personalizzato specificando il prefisso organization_fields. e la chiave del campo. Ad esempio, per la chiave del campo subscription_date, usa quanto segue per impostare i valori importati per tale campo. organization_fields.subscription_date Per trovare la chiave di un campo organizzazione personalizzato, fai clic sull’icona Amministratore () e seleziona Campi organizzazione, quindi fai clic sul nome di un campo personalizzato. La chiave del campo viene visualizzata nel pannello delle proprietà a destra. 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/AA 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 relazione di ricerca non sono supportati quando si importano organizzazioni nella pagina importatore di dati.
Consulta Aggiunta di campi personalizzati alle organizzazioni. |
custom_fields.<field key> (non importatore di dati) |
Quando esegui un’importazione in blocco di organizzazioni, puoi importare un campo organizzazione personalizzato specificando il prefisso custom_fields. e la chiave del campo. Ad esempio, per la chiave del campo subscription_date, usa quanto segue per impostare i valori importati per tale campo. custom_fields.subscription_date Per trovare la chiave di un campo organizzazione personalizzato, fai clic sull’icona Amministratore () e seleziona Campi organizzazione, quindi fai clic sul nome di un campo personalizzato. La chiave del campo viene visualizzata nel pannello delle proprietà a destra. Se il valore di un campo non è formattato correttamente, l’importazione avrà esito negativo e verrà inviato tramite email un report di errore indicante i record che non sono stati salvati. Per i campi data personalizzati, usa il formato GG/MM/AA o GG-MM-AAAA. Per i campi con casella di spunta, usaTrue o False. Per impostare il valore delle opzioni dell’elenco a discesa, usa il tag aggiunto al momento della creazione dell’elenco a discesa.
Nota: se il campo organizzazione personalizzato che stai importando è un campo relazione di ricerca, inserisci l'ID dell'oggetto correlato come valore per questo campo. Ad esempio, per un’organizzazione, inserisci l’ID dell’organizzazione; per un utente, inserisci l’ID dell’utente; per un record oggetto personalizzato, inserisci l’ID del record. Per trovare l’ID di un’organizzazione, di un utente o di un record oggetto personalizzato, puoi esportare i dati dal tuo account o usare l’API organizzazioni, l’API utenti o l’API record oggetto personalizzato.
I campi relazione di ricerca non sono supportati quando si importano organizzazioni nella pagina Importatore di dati. Consulta Aggiunta di campi personalizzati alle organizzazioni. |
Importazione del file CSV di dati di organizzazioni
Puoi usare un’importazione in blocco per creare nuove organizzazioni o aggiornare le informazioni per quelle esistenti.
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. Consulta Limitazioni dell’importazione in blocco di utenti e organizzazioni.
Utilizzando l’importatore di dati per importare i dati delle organizzazioni
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.
- Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Strumenti > Importatore di dati.
- Fai clic su Importa.
- In Destinazione, seleziona Organizzazioni.
- In Tipo di importazione, scegli una delle seguenti opzioni:
- Solo creazione: vengono create solo le nuove organizzazioni. Tutti i dati nel file CSV relativi a organizzazioni esistenti vengono ignorati.
- Solo aggiornamento: 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: 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.
Utilizzando un’importazione di azioni multiple per importare i dati delle organizzazioni
Ti consigliamo di usare l’importatore di dati, ma puoi comunque usare le pagine delle azioni multiple per importare dati di organizzazioni nuovi e aggiornati. Riceverai un’email al completamento delle importazioni da questa pagina.
- In Centro amministrativo, fai clic su Persone nella barra laterale, quindi seleziona Azioni multiple > Importa organizzazioni.
- Scegli il tipo di importazione da eseguire:
-
Crea nuove organizzazioni
-
Aggiorna organizzazioni esistenti: usa questo tipo di importazione per sostituire i dati esistenti per le organizzazioni elencate nel file CSV.
Il file CSV deve includere l’external_id o il nome delle organizzazioni, per consentirne l’identificazione. Oltre al campo contenente l’identificatore dell’organizzazione, devi includere solo i campi che desideri aggiornare nel file. Se la riga di un’organizzazione presenta un campo vuoto, sovrascriverà i dati esistenti per quell'organizzazione.
-
- Fai clic su Scegli file o sul link Preferisco incollare i dati.
- Fai clic su Importa.
Una volta avviata l’importazione, le modifiche importate non potranno più essere ripristinate.
- (Facoltativo) Visualizza lo stato delle importazioni in corso nella pagina Centro amministrativo > Oggetti e regole > Strumenti > Importatore di dati. Una volta completata, un’importazione viene acquisita nel registro Cronologia delle importazioni qui.