Em vez de adicionar um registro de objeto personalizado por vez, você pode adicioná-los em massa e atualizar muitos registros de uma só vez importando um arquivo CSV (valores separados por vírgula). Você deve ser um administrador para fazer importação em massa de registros de objetos personalizados.
Requisitos e limitações
- O arquivo CSV de importação não pode tamanho maior que 1 GB. Recomendamos um máximo de 500.000 linhas. Ou seja, uma linha de cabeçalho e até 499.999 linhas de dados. Além disso, o tamanho de cada linha deve ser de até 32 KB.
- O arquivo CSV de importação deve ter, no máximo, 102 colunas.
- Não inclua o mesmo registro mais de uma vez em um arquivo CSV. Isso pode causar falha na importação.
- Não há garantia de que os registros são criados ou atualizados na ordem em que são exibidos no arquivo CSV.
- Você só pode importar um arquivo CSV por vez. Portanto, se tiver mais dados do que o número máximo de linhas compatível com o arquivo CSV, você precisará criar arquivos separados para cada lote e importá-los um depois do outro.
- A importação em massa de registros de objetos personalizados não pode ser desfeita. Antes de importar o arquivo CSV que contém as informações de todos os seus registros atuais, teste esse mesmo arquivo CSV com um registro único para se certificar de que o carregamento funcionará como esperado.
Criação de um arquivo CSV de registros de objetos personalizados
- O arquivo deve ser um CSV formatado adequadamente e salvo utilizando codificação de caracteres UTF-8.
- A primeira linha do arquivo CSV é a linha do cabeçalho.
- A linha do cabeçalho deve conter um campo name. Opcionalmente, se desejar atualizar em massa os registros no futuro, você também precisa incluir um campo external_id. Todos os outros nomes de campo na linha do cabeçalho devem corresponder exatamente às chaves de campo no seu objeto personalizado.
- Para importar valores para campos de lista suspensa, use a field_key do campo de lista suspensa personalizado como o cabeçalho da coluna e especifique a tag de opções, não o valor de fácil usabilidade.
- Para importar valores para campos de relacionamento de pesquisa, use a field_key do campo de relacionamento de pesquisa personalizado como o cabeçalho da coluna e forneça o ID ou o ID externo do registro. Se usar o ID do registro, forneça o valor. Se usar o ID externo, use o formato external_id:valor, em que o valor deve ser substituído pelo valor do ID externo do registro.
- Se você não está importando dados para um campo, não os liste na linha do cabeçalho.
- Adicione quebras de linha às observações ou aos campos personalizados multilinha pressionando ALT+ENTER no Windows ou CTRL+OPTION+RETURN no macOS.
Se você está executando um carregamento em massa dos registros para preencher um novo objeto personalizado com seus dados existentes, recomendamos dar uma conferida em Planejamento do seu fluxo de trabalho de objetos personalizados. Durante o processo, recomendamos criar planilhas com esses dados para cada um dos seus objetos personalizados. Se for estruturada cuidadosamente para se alinhar com o objeto personalizado criado no Zendesk e as orientações acima, você poderá exportar a planilha como um arquivo CSV e usá-lo para esse carregamento em massa. Nesse caso, adicione uma coluna para o external_id e um ID para cada registro, se quiser ter a opção de atualizá-los em massa no futuro.
Importação do arquivo CSV de registros de objetos personalizados
Você pode usar o importador de dados para importar um arquivo CSV que cria novos registros de objetos personalizados ou atualiza os registros existentes e coleta registros de todas as tentativas de importação por meio da página Importador de dados.
- Antes de poder carregar em massa os registros de um objeto personalizado, você precisa criar o objeto personalizado no Zendesk.
- Na Central de administração, clique em Objetos e regras na barra lateral e selecione Ferramentas > Importador de dados.
- Clique em Importar.
- Em Tipo de importação, escolha uma destas opções:
- Apenas criar: apenas novos registros de objetos personalizados são criados. Os dados no arquivo CSV relativos a registros existentes são ignorados.
- Apenas atualizar: substitui os dados dos registros de objetos personalizados existentes listados no arquivo CSV. Os dados relativos a novos registros são ignorados.
- Criar e atualizar: cria novos registros de objeto e atualiza os dados dos registros de objetos personalizados existentes listados no arquivo CSV.
- Em Alvo desejado, selecione o nome do objeto personalizado.
- Em Carregamento de arquivo, arraste e solte o arquivo ou clique para carregar e selecione o arquivo CSV no explorador de arquivos.
Se precisar alterar o arquivo selecionado, clique no ícone de apagar () ao lado do nome do arquivo.
- Clique em Next.
- Analise a lista Mapeamento de campos.
- Se o mapeamento de campos estiver correto, clique em Avançar.
- Se o mapeamento de campos não estiver correto, clique em Voltar. Edite o arquivo CSV para ficar de acordo com os requisitos de formato e, em seguida, recarregue o arquivo.
- Analise o resumo de detalhes da importação na janela de confirmação e clique em Começar a importação.
Após o início da importação, as alterações importadas não podem ser revertidas. Para verificar o status de uma importação, confira o histórico de importações.