UnitusTI Editor de pacotes — Manual do usuário

Este manual é para a equipe do centro com o papel Autor que monta manifestos de pacotes do marketplace: estrutura de cursos, avaliações vinculadas e formulários personalizados publicados.

O editor de pacotes permite:

Criar pacotes e editar o manifesto (título, descrição, rodapé, imagem de capa).
Organizar cursos e unidades , vincular unidades a avaliações e definir miniaturas.
Registrar quais avaliações e formulários pertencem ao manifesto do pacote.
Salvar o manifesto para que alunos e o marketplace usem a estrutura atualizada.

O primeiro item do breadcrumb é Pacotes . O editor abre em Autor → Meus Pacotes (não em Clínica → Meus Pacotes , que só edita metadados básicos do pacote na tela clássica).

1. Abrir o editor de pacotes

Entre na UnitusTI e selecione o centro.
Abra o submenu Autor .
Escolha Meus Pacotes .

O perfil precisa do papel Autor e o módulo de autor habilitado no centro. Se Autor ou Meus Pacotes não aparecer, fale com um administrador.

A lista mostra os nomes dos pacotes como links. O botão no canto superior direito é Adicionar pacote .

2. Antes de começar

2.1 Lista em Autor vs lista no centro

Tela	Caminho do menu	Finalidade
Editor de pacotes (este manual)	Autor → Meus Pacotes	Editar o manifesto : cursos, unidades, lista de avaliações, lista de formulários, capa, rodapé.
Lista de pacotes do centro	Clínica → Meus Pacotes	Editar nome , descrição e tags do pacote no diálogo clássico. Use as duas telas quando precisar de metadados do catálogo e conteúdo do manifesto.

2.2 Quando cada alteração é gravada

Alteração	Quando é armazenada
Cursos, unidades, avaliações no manifesto, detalhes em Editar detalhes , remover formulário da tabela	Ao clicar em Salvar na página do pacote.
Adicionar formulário (aba Formulários)	Imediatamente no servidor; a lista recarrega. Use Salvar para outras mudanças no manifesto.
Miniaturas (capa do pacote, curso, unidade)	Enviadas ao escolher a imagem; entram no manifesto ao Salvar .

Se sair da página do pacote com alterações não salvas no manifesto, o navegador pode avisar. O botão Salvar mostra um ponto quando há mudanças pendentes.

3. Lista de pacotes

O breadcrumb mostra Pacotes .

Clique no nome de um pacote para abrir. Clique em Adicionar pacote para criar um novo.

Enquanto a lista carrega, aparece uma mensagem de carregamento. Se falhar, um aviso de erro aparece na parte inferior da tela.

4. Criar um pacote

Na lista de pacotes, clique em Adicionar pacote .
Em Adicionar pacote , preencha:

Código — identificador único (letras, números, sublinhado _ , hífen - , até 64 caracteres). Não pode ser alterado depois.
Título
Descrição (opcional)
Rodapé (HTML opcional no final da página do pacote)

Clique em Aplicar .

O centro cria o pacote, um manifesto vazio e instala para o seu centro. Você entra no editor do pacote novo. O envio da capa fica disponível depois da criação em Editar detalhes .

5. Layout da página do pacote

O breadcrumb é Pacotes → título do pacote .

5.1 Ações

Controle	O que faz
Editar detalhes	Abre os mesmos campos da criação (código somente leitura), mais a imagem de capa do pacote .
Salvar	Grava o manifesto no servidor. Mensagem de sucesso conforme o idioma da interface.

5.2 Cabeçalho

Se houver imagem de capa, ela aparece como banner largo. O HTML da Descrição pode aparecer abaixo do banner. O HTML do Rodapé aparece abaixo das abas quando definido.

5.3 Abas

Aba	Finalidade
Cursos	Árvore de cursos e unidades, ordem, miniaturas.
Avaliações	Avaliações vinculadas no manifesto.
Formulários	Formulários personalizados publicados vinculados ao pacote.

6. Editar detalhes do pacote

Abra Editar detalhes .

Campo	Notas
Código	Somente leitura após criar.
Título , Descrição	Exibidos na página do pacote.
Rodapé	HTML opcional.
Imagem de capa do pacote	Enviar imagem , Remover imagem . Imagens grandes podem pedir redimensionamento (máx. 256×256 pixels).

Clique em Aplicar para atualizar o manifesto em memória. Clique em Salvar na página do pacote para persistir.

Cancelar fecha o diálogo sem aplicar.

7. Aba Cursos

7.1 Cursos

Clique em Adicionar curso para Adicionar curso . Defina Título , Descrição e opções (veja §8). Clique em Aplicar .

Cada linha de curso tem:

Alça de arrastar (≡) para reordenar cursos.
Menu da linha (⋮): Enviar miniatura , Remover miniatura (se houver), Excluir .
O título (link) para Editar curso .
Código: e o código interno do curso.
Expandir ou recolher para ver unidades.

Reordene arrastando a alça. As mudanças ficam em memória até Salvar .

Excluir remove o curso e suas unidades do manifesto.

7.2 Unidades

Expanda um curso. Clique em Adicionar unidade para Adicionar unidade (veja §9).

Cada unidade segue o mesmo padrão: arrastar dentro do curso, menu de miniatura e Excluir , link do título para editar.

O chip mostra Avaliação: id ou Conteúdo não definido quando não há avaliação vinculada.

8. Diálogo de curso

Adicionar curso ou Editar curso .

Campo	Significado
Título , Descrição	Exibidos na interface do pacote.
Não pontuável	O curso não entra na pontuação.
Renderizar como grupo de links	Apresenta o curso como grupo de links.

Aplicar atualiza o manifesto em memória. Cancelar fecha sem salvar o diálogo.

9. Diálogo de unidade

Adicionar unidade ou Editar unidade .

9.1 Título e descrição

Você pode digitar Título e Descrição , ou marcar:

Usar título da avaliação vinculada
Usar descrição da avaliação vinculada

Com a caixa marcada, o campo segue a avaliação em Fonte de conteúdo . Se o id não estiver no manifesto, aparece um aviso.

9.2 Fonte de conteúdo

ID da avaliação — escolha uma avaliação já listada na aba Avaliações . Limpar seleção para nenhuma. Se o manifesto não tiver avaliações, o texto de ajuda pede para adicionar em Avaliações primeiro.

9.3 Configurações da unidade

Não pontuável — a unidade não entra na pontuação.

Clique em Aplicar , depois Salvar na página do pacote.

10. Aba Avaliações

Colunas: ID da avaliação , Título , Descrição , Tipo .

Clique em Adicionar avaliação para buscar e selecionar avaliações do centro. Os itens escolhidos entram no manifesto em memória. Clique em Salvar para persistir.

Para remover uma avaliação:

Menu da linha → Excluir .
Confirme.

Se alguma unidade ainda usa esse id, a exclusão é bloqueada e os títulos das unidades são listados. Altere ou remova essas unidades primeiro.

11. Aba Formulários

Colunas: ID , Título , Descrição , Versão .

Clique em Adicionar formulário para buscar formulários personalizados publicados . Cada formulário selecionado é vinculado ao pacote no servidor na hora; a tabela recarrega.

Para remover um formulário do manifesto, menu da linha Excluir e confirme. Clique em Salvar se houver outras alterações pendentes.

Os formulários precisam estar publicados em Clínica → Formulários antes de aparecer na busca.

12. Miniaturas

Local	Como
Capa do pacote	Editar detalhes → enviar ou remover imagem
Curso ou unidade	Menu da linha → Enviar miniatura / Remover miniatura

Imagens maiores que 256×256 pixels podem pedir redimensionamento automático. Os caminhos são gravados no manifesto ao Salvar .

13. Fluxo de trabalho típico

Abra Autor → Meus Pacotes .
Adicionar pacote ou abra um pacote existente.
Editar detalhes para título, descrição, rodapé e capa. Salvar .
Em Avaliações , Adicionar avaliação e Salvar .
Em Cursos , adicione cursos e unidades; vincule avaliações. Salvar .
Em Formulários , Adicionar formulário para formulários publicados.
Reordene com as alças de arrastar. Salvar após mudanças estruturais.

14. Solução de problemas

Problema	O que tentar
Falta Autor ou Meus Pacotes	É preciso o papel Autor e o módulo de autor no centro.
O Código não valida	Apenas letras, números, _ e - , no máximo 64 caracteres.
Salvar parece não funcionar	Veja o aviso de erro. Confirme Salvar na página, não só Aplicar em um diálogo.
O ponto em Salvar não some	Houve outra edição ou a gravação falhou. Recarregue o pacote.
Não é possível excluir uma avaliação	Uma unidade ainda a referencia. Edite em Cursos .
A lista ID da avaliação está vazia	Adicione avaliações em Avaliações e Salvar .
Adicionar formulário não encontra nada	Publique o formulário em Formulários primeiro.
Falha na miniatura	Use um arquivo de imagem válido. Tente de novo.
O pacote não carrega	Verifique o código e se o centro é o proprietário.

15. Glossário

Termo	Significado
Pacote	Produto do marketplace que o centro autoria; identificado por código .
Manifesto	Estrutura JSON: metadados, cursos, unidades, lista de avaliações, lista de formulários.
Curso	Seção dentro de um pacote que contém unidades.
Unidade	Item de aprendizagem em um curso; pode vincular a uma avaliação .
Avaliação (linha do manifesto)	Id de avaliação registrado no manifesto para unidades e entrega.
Formulário (linha do manifesto)	Formulário personalizado publicado vinculado ao pacote.

Este manual descreve o editor de pacotes (MPPackageEditor) na UnitusTI. Os rótulos seguem a interface em português quando disponível: Pacotes, Adicionar pacote, Editar detalhes, Salvar, Cursos, Avaliações, Formulários, Aplicar, Cancelar, Excluir.