Dicionário de dados

Chamados de suporte

Registros da Central de Serviços do SUAP. Cada linha representa um chamado, com o serviço solicitado e sua situação no momento da extração.

Estrutura: 14 campos
Unidade de registro: Um chamado
Atualização prevista: Mensal
Arquivos: CSV e JSON · UTF-8

Campos do arquivo

Na mesma ordem do CSV

Nome técnico, tipo lógico, descrição e valores de cada coluna.
Campo	Tipo	Descrição	Valores e ausências
`chamado_id`	Inteiro	Identificador único do chamado no SUAP.	Chave do registro; sem valor nulo.
`ano_referencia`	Inteiro	Ano de abertura do chamado.	Derivado de `data_abertura`; sem valor nulo.
`mes_referencia`	Inteiro	Mês de abertura do chamado.	`1` a `12`; sem valor nulo. Use com o ano para agrupar por mês.
`data_abertura`	Data	Dia em que o chamado foi aberto, sem horário.	`AAAA-MM-DD`; sem valor nulo.
`area`	Texto	Área de atuação à qual o serviço pertence.	Nome do catálogo; pode ser vazio se a relação não estiver disponível.
`grupo_servico`	Texto	Agrupamento do serviço dentro da área de atuação.	Nome do catálogo; pode ser vazio se a relação não estiver disponível.
`servico`	Texto	Serviço do catálogo vinculado ao chamado.	Nome do catálogo; pode ser vazio se a relação não estiver disponível.
`tipo_servico`	Texto	Classificação do serviço solicitado.	`Requisição` ou `Incidente`. Outros códigos são preservados; pode ser vazio.
`campus`	Texto	Nome da unidade do IFMG vinculada ao chamado.	Campus ou Reitoria; pode ser vazio quando a unidade não estiver informada ou disponível.
`status`	Texto	Situação do chamado no momento da extração.	Aberto, Em atendimento, Resolvido, Fechado, Reaberto, Suspenso ou Cancelado. Outros códigos são preservados.
`meio_abertura`	Texto	Canal usado para registrar o chamado.	`web`, `pessoalmente`, `email` ou `telefone`.
`fechado_automaticamente`	Booleano	Indica se o fechamento foi feito pela rotina automática do SUAP.	Verdadeiro, falso ou ausente. Ausência não equivale a falso. Ver interpretação.
`nota_avaliacao`	Inteiro	Nota atribuída pelo requisitante ao atendimento.	`1` (pior) a `5` (melhor). Vazio quando não há nota registrada.
`data_ultima_movimentacao`	Data	Dia da mudança de status mais recente no histórico.	`AAAA-MM-DD`; vazio quando não há histórico. Não representa necessariamente a conclusão.

Datas são publicadas como texto. Os tipos acima descrevem o conteúdo; o CSV usa vírgula como separador e aspas duplas como delimitador de texto.

Como interpretar

O arquivo retrata o estado atual dos chamados. Cada publicação substitui a anterior. A última movimentação é uma mudança de status; a diferença entre as duas datas não mede, por si só, o tempo de atendimento.

Valores ausentes

Um campo vazio indica ausência de valor na saída. Não substitua por zero ou falso. Para médias de avaliação, considere apenas as notas preenchidas.

Fechamento automático

Verdadeiro indica fechamento automático; falso indica que a marcação é negativa. O campo sozinho não informa se o chamado está fechado: consulte também status. A grafia do booleano no CSV depende da exportação.

Tipos de serviço

Requisição: pedido previsto no catálogo, como acesso ou instalação. Incidente: interrupção ou redução da qualidade de um serviço. Área, grupo e serviço formam os níveis do catálogo.

Escopo da extração

Inclui chamados com data de abertura preenchida. Descrições livres, comentários de avaliação, telefones, patrimônio e identificadores de pessoas ficam fora das colunas publicadas.

Origem e transformações dos campos

Fonte: Central de Serviços do SUAP. Extração: Apache Hop, pipeline 10-extrai-transforma. Publicação: CKAN. As relações de catálogo, unidade e histórico são consultadas com LEFT JOIN, que admite ausência de correspondência.

Rastreabilidade dos campos publicados
Campo publicado	Origem ou transformação
`chamado_id`	`centralservicos_chamado.id` (chave primária).
`ano_referencia`	Ano de `centralservicos_chamado.aberto_em`, convertido em inteiro.
`mes_referencia`	Mês de `centralservicos_chamado.aberto_em`, convertido em inteiro.
`data_abertura`	`centralservicos_chamado.aberto_em`, formatado como `YYYY-MM-DD`.
`area`	`comum_areaatuacao.nome`, via `servico.area_id`; remoção de espaços nas extremidades, até 120 caracteres.
`grupo_servico`	`centralservicos_gruposervico.nome`, via `servico.grupo_servico_id`; remoção de espaços nas extremidades, até 80 caracteres.
`servico`	`centralservicos_servico.nome`, via `chamado.servico_id`; remoção de espaços nas extremidades, até 255 caracteres.
`tipo_servico`	`centralservicos_servico.tipo`: `REQ → Requisição`; `INC → Incidente`. Demais códigos mantidos; até 20 caracteres.
`campus`	`unidadeorganizacional.nome`, via `chamado.campus_id`; remoção de espaços nas extremidades, até 255 caracteres.
`status`	`centralservicos_chamado.status`: 1 → Aberto; 2 → Em atendimento; 3 → Resolvido; 4 → Fechado; 5 → Reaberto; 6 → Suspenso; 7 → Cancelado. Demais códigos convertidos em texto; até 20 caracteres.
`meio_abertura`	`centralservicos_chamado.meio_abertura`; remoção de espaços nas extremidades, até 30 caracteres.
`fechado_automaticamente`	`centralservicos_chamado.fechado_automaticamente`, sem substituir nulos.
`nota_avaliacao`	`centralservicos_chamado.nota_avaliacao`, sem substituir nulos.
`data_ultima_movimentacao`	Maior `data_hora` de `centralservicos_historicostatus` por chamado, formatada como `YYYY-MM-DD`.

Compatibilidade: esta estrutura usa campus com o nome da unidade e não inclui campus_id, autorizado nem horas_ate_ultima_movimentacao, presentes em extrações anteriores.