Importar e atualizar tíquetes

Visão geral

Importe tíquetes de um arquivo Excel ou CSV para criar muitos tíquetes de uma só vez. Você também pode usar uma importação para atualizar tíquetes que já existem, por exemplo para alterar custos ou status de muitos tíquetes de uma só vez.

Como acessar a importação de tíquetes

Para abrir a importação de tíquetes:

1. Clique em Tíquetes
2. Selecione o projeto no qual deseja importar tíquetes na lista suspensa Projeto
   
3. Abra o menu Mais e clique em Importar tíquetes
   

Preparar o arquivo de importação

O arquivo de importação deve atender aos seguintes critérios:

• Somente arquivos XLSX e CSV são compatíveis.
• Cada importação abrange um único formulário de tíquete. Para importar tíquetes de vários formulários, use um arquivo por formulário.
• Cada linha representa um tíquete e cada coluna um campo do formulário de tíquete.
• Todo tíquete pertence a um nível, portanto o arquivo precisa de uma coluna de nível.

Linhas cuja coluna de nível não corresponde a um nome de nível existente não são importadas.

Nomeie as colunas conforme os campos do formulário de tíquete para facilitar o mapeamento. Sem cabeçalhos de coluna, o mapeamento é feito pelos números de coluna atribuídos automaticamente.

Atualizar tíquetes incluindo o UUID

Todo tíquete tem um UUID, seu identificador único. Quando uma linha do seu arquivo contém um UUID que corresponde a um tíquete existente, esse tíquete é atualizado. Linhas sem UUID criam novos tíquetes, então um mesmo arquivo pode fazer as duas coisas.

Para preparar um arquivo para atualizar tíquetes:

1. Exporte para o Excel os tíquetes que deseja alterar, usando um modelo que inclua o atributo UUID

   A exportação padrão já inclui a coluna UUID. Para adicioná-la ao seu próprio modelo, consulte Criar modelos do Excel para exportação de tíquetes.

2. Altere os valores que deseja atualizar e deixe a coluna UUID intacta
3. Importe o arquivo e mapeie a coluna UUID para o atributo de formulário UUID

Mantenha a coluna de nível no arquivo e mapeada, porque toda importação precisa dela. Nas linhas que atualizam um tíquete existente, o valor dela é ignorado: uma importação nunca move um tíquete para outro nível. Para mover vários tíquetes para outro nível, consulte Editar vários tickets de uma só vez no aplicativo da Web.

Leia mais em Exportar tickets para o Excel no aplicativo da Web.

Importar tíquetes

Para importar tíquetes:

1. Selecione na lista suspensa um formulário de tíquete para os tíquetes importados

2. Clique em Procurar arquivos para carregar o arquivo de tíquetes do seu dispositivo

   Verifique Preparar o arquivo de importação acima.

3. Marque a caixa de seleção A primeira linha é um cabeçalho se a primeira linha do seu arquivo contiver títulos de coluna
4. Mantenha a caixa de seleção Validar tíquetes antes da importação marcada para verificar o arquivo antes que algo seja importado, ou desmarque-a para importar imediatamente
5. Opcional: Marque a caixa de seleção Limpar valores das células vazias para que as células vazias apaguem os valores aos quais estão mapeadas
6. Clique em Avançar
   
7. Mapeie os atributos do arquivo XLSX ou CSV para os atributos do formulário de tíquete selecionado.
   Leia mais abaixo em Mapear colunas para campos de formulário.
8. Clique em Avançar
   
9. Revise o que a importação vai fazer e clique em Importar.
   Leia mais abaixo em Validar tíquetes importados.
   

Limpar valores das células vazias afeta somente as linhas que atualizam um tíquete existente. Quando a caixa de seleção está desmarcada, as células vazias são ignoradas e o tíquete mantém seus valores atuais.

Mapear colunas para campos de formulário

O mapeamento de atributos permite colocar o conteúdo de cada coluna do seu arquivo no campo de formulário correto do tíquete.

Na janela de mapeamento de atributos, a parte superior tem uma tabela para o mapeamento e a parte inferior mostra a tabela do arquivo que você carregou:

1. A coluna Atributo do formulário lista todos os campos do formulário selecionado anteriormente, mais UUID.
2. A coluna Atributo importado permite mapear seu arquivo para os campos do formulário.
3. A coluna Atributo detalhado é necessária somente para campos de usuário, como autor ou carregado por.
4. As linhas do seu arquivo são mostradas abaixo para ajudar a encontrar as colunas certas, caso você não tenha usado cabeçalhos de coluna correspondentes aos nomes dos campos do formulário.
   

Para mapear atributos:

1. Na coluna Atributo importado, digite o valor ou selecione na lista suspensa a coluna que corresponde ao campo na coluna Atributo do formulário
   

   Com a caixa de seleção A primeira linha é um cabeçalho marcada, as listas suspensas mostram os títulos das suas colunas e você pode digitar um título de coluna como Nível, Usuário ou Autor. Sem ela, mostram números de coluna como Coluna1 ou Coluna5.

2. Para campos de formulário que se referem a um usuário, como autor ou responsável, digite o valor ou selecione na lista suspensa da coluna Atributo detalhado o tipo de valor a ser registrado, como o nome do usuário, ID, empresa ou e-mail
   

Validar tíquetes importados

Com a caixa de seleção Validar tíquetes antes da importação marcada, após o mapeamento de atributos aparece uma janela que mostra o que a importação vai fazer. Ela informa quantos tíquetes serão criados, quantos serão atualizados e quantas linhas têm erros, seguidos pelos próprios erros.

Uma linha pode falhar pelos seguintes motivos:

Enquanto a janela relatar erros, Importar permanece indisponível. Corrija o arquivo ou escolha importar apenas as linhas válidas.

Corrigir erros

Para corrigir erros:

1. Clique em Voltar
   
2. Corrija o mapeamento de atributos ou clique em Voltar novamente para carregar um arquivo corrigido
3. Clique em Avançar
   
4. Quando não houver mais erros, clique em Importar
   

Importar apenas as linhas válidas

Para importar tudo o que não tem erros e deixar o resto de fora:

1. Marque a caixa de seleção Ignorar erro(s) de validação e importar apenas tíquetes válidos
2. Clique em Importar
   

As linhas com erros são ignoradas. O resultado da importação informa quantos tíquetes foram criados, quantos foram atualizados e quantas linhas foram ignoradas.

Criar tíquetes para UUIDs sem correspondência

Linhas cujo UUID não corresponde a nenhum tíquete do projeto podem se tornar novos tíquetes em vez de serem ignoradas. Isso é útil quando você importa um arquivo que foi exportado de outro projeto.

Para criar tíquetes para UUIDs sem correspondência:

1. Marque a caixa de seleção Ignorar erro(s) de validação e importar apenas tíquetes válidos
2. Marque a caixa de seleção Importar UUIDs não correspondentes e criar novos UUIDs
3. Clique em Importar

Cada uma dessas linhas se torna um novo tíquete com um UUID recém-gerado: o valor do seu arquivo nunca é reutilizado. As linhas que falharam por qualquer outro motivo continuam sendo ignoradas.

O que uma atualização altera

Quando uma linha atualiza um tíquete existente:

• As colunas mapeadas que contêm um valor substituem o valor atual do tíquete.
• As colunas que você não mapeou permanecem inalteradas.
• As células vazias são ignoradas, a menos que você tenha marcado Limpar valores das células vazias.
• O nível nunca muda, mesmo quando a coluna de nível contém um valor diferente.
• O tíquete mantém sua data de criação, seu criador e seu número. Você passa a ser a última pessoa a tê-lo editado.

Cada tíquete atualizado registra "O tíquete foi atualizado por importação." em seu diário, junto com uma etiqueta que identifica a importação de onde ele veio. Leia mais em Acompanhar a atividade em um tíquete no diário.