Importação e exportação de campos e valores personalizados

Qual é o meu plano?

Suite

Qualquer plano

Support

Qualquer plano

Ao criar um novo campo suspenso ou de seleção múltipla para tickets, usuários, organizações ou objetos personalizados, você pode ter um grande número de valores de campo para incluir. Por exemplo, um novo campo que permite que os agentes escolham uma versão do software ou um tipo do produto pode incluir inúmeras opções. Em vez de adicionar os valores de campo manualmente, um de cada vez, é possível adicionar vários com o recurso de importação em massa. Também é possível exportar campos e valores personalizados de lista suspensa e seleção múltipla para arquivar ou usar em outros aplicativos.

A importação de valores só está disponível durante a criação de um novo campo de lista suspensa ou de seleção múltipla. Não é possível importar valores para campos existentes.

Este artigo abrange as seguintes seções:

• Criação de um arquivo CSV de valor de campo
• Importação do arquivo CSV de valor de campo para um novo campo personalizado
• Exportação de campos e valores para campos personalizados de lista suspensa e seleção múltipla

Artigos relacionados:

• Sobre os tipos de campo personalizado

Criação de um arquivo CSV de valor de campo

Se quiser importar valores para campos personalizados de lista suspensa e seleção múltipla, você deve primeiro criar um arquivo de valores separados por vírgulas (CSV) que contenha os valores que deseja adicionar. Se preferir, baixe um modelo de arquivo CSV e use-o como base para adicionar seus próprios valores de campo. Veja o exemplo abaixo.

A tabela a seguir lista os campos a serem incluídos no arquivo. A primeira linha do arquivo CSV corresponde à linha do cabeçalho e você deve incluí-la no arquivo.

Campo	Descrição
value	(Obrigatório) Valor que é exibido no campo de lista suspensa ou de seleção múltipla para tickets, usuários, organizações e objetos personalizados.
tag	(Recomendado) Tag associada ao valor do campo. A tag é usada como uma propriedade de ticket que pode ser utilizada em gatilhos e outras regras de negócios.
default	(Obrigatório somente para campos de ticket) Identifica o valor padrão para o campo de lista suspensa ou de seleção múltipla. Use true para identificar o valor padrão. Use false para os demais valores.

Ao criar uma lista de valores de campo para importação, você provavelmente gerará essa lista de valores de algum outro sistema. Muitos destes sistemas possuem um recurso de criação do arquivo de exportação CSV. Se precisar criar a lista do zero, use um programa como o Microsoft Excel ou as Planilhas Google.

O arquivo deve ser um CSV formatado adequadamente e salvo utilizando codificação de caracteres UTF-8. O número real de valores suportados depende do tipo de campo, mas o arquivo de dados CSV para importação pode conter no máximo 3.500 linhas de dados (uma linha para o cabeçalho e o restante para valores de campo).

Importação do arquivo CSV de valor de campo para um novo campo personalizado

Depois de criar o arquivo CSV, você pode importar esses valores para um novo campo de lista suspensa ou de seleção múltipla. Não é possível carregar um arquivo CSV para campos existentes de lista suspensa e de seleção múltipla.

Como importar o CSV de valores de campo

1. Na Central de administração, navegue até o local correto para adicionar seu novo campo personalizado de lista suspensa ou de seleção múltipla:
   • • Na Central de administração, clique em Objetos e regras na barra lateral e selecione Tickets > Campos.
     • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos do usuário.
     • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos da organização.
     • Na Central de administração, clique em Objetos e regras na barra lateral e selecione Objetos personalizados > Objetos. Clique no nome do objeto que contém o campo de lista suspensa ou de seleção múltipla que você deseja exportar e clique na aba Campos.
2. Clique em Adicionar campo e selecione Lista suspensa ou Seleção múltipla.
3. Em Valores do campo, clique em Carregar CSV.

   

4. Clique em Selecionar arquivo, abra o arquivo CSV que deseja importar e clique em Carregar. Como alternativa, você pode arrastar e soltar o arquivo que deseja importar.
5. Após carregar o arquivo CSV com sucesso, os Valores do campo são atualizados para que novos dados sejam incluídos.

   

6. Quando você terminar a inclusão de informações sobre o seu novo campo, Salve suas alterações.

Exportação de campos e valores para campos personalizados de lista suspensa e seleção múltipla

Uma vez que sua lista de campos e valores de campos personalizados de ticket, usuário, organização ou objeto personalizado aumenta conforme a sua necessidade, pode ser útil exportar seus campos e valores personalizados para um arquivo CSV. Por exemplo, você pode usar o arquivo CSV como uma lista de verificação para consultar os tipos do produto ou as versões do software mais recentes que estão disponíveis em seus tickets.

Observação: para tickets, usuários e organizações, é possível exportar uma lista de todos os campos e valores personalizados para campos personalizados de lista suspensa e de seleção múltipla. Para objetos personalizados, você pode exportar da Central de administração uma lista de valores para campos personalizados de lista suspensa e de seleção múltipla, mas a exportação de uma lista de campos para um objeto personalizado só é possível por meio da API Custom Objects.

Como exportar uma lista de valores para um campo personalizado

1. Navegue até a lista de campos personalizados:
   • Na Central de administração, clique em Objetos e regras na barra lateral e selecione Tickets > Campos.
   • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos do usuário.
   • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos da organização.
   • Na Central de administração, clique em Objetos e regras na barra lateral e selecione Objetos personalizados > Objetos. Clique no nome do objeto que contém o campo de lista suspensa ou de seleção múltipla que você deseja exportar e clique na aba Campos.
2. Na lista de campos personalizados, clique no nome de um campo de lista suspensa ou de seleção múltipla.
3. Ao lado de Valores de campo para o ticket, clique em Baixar CSV para exportar uma lista de valores no formato CSV.

   

   Veja o exemplo abaixo.

   

Como exportar uma lista de campos personalizados de ticket, usuário ou organização

1. Navegue até a lista de campos personalizados:
   • Na Central de administração, clique em Objetos e regras na barra lateral e selecione Tickets > Campos.
   • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos do usuário.
   • Na Central de administração, clique em Pessoas na barra lateral e selecione Configuração > Campos da organização.
2. (Opcional) Filtre ou classifique a lista ou altere as colunas que são exibidas. Isso altera o que está incluído no arquivo CSV exportado.
3. Clique em Ações no topo da página e selecione Baixar CSV para exportar uma lista de campos de ticket no formato CSV.

   

   Por padrão, o arquivo exportado inclui as informações a seguir para cada campo de ticket: Nome de exibição, Tipo, ID do campo, Data da modificação e Tags. Por exemplo:

   

   O arquivo pode ser aberto em editores de texto e aplicativos de planilhas, como Microsoft Excel ou Planilhas Google, para processamento posterior.