Gerenciar itens em uma versão
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Identificar os dados que são necessários para adicionar conteúdo a uma versão.
- Criar e adicionar itens a uma versão.
- Explicar as operações da versão.
Reunir seu conteúdo
Marisol, gerente de versão da Pure Aloe, criou uma versão, mas até agora não há conteúdo associado a essa versão. Agora, a Marisol está pronta para adicionar módulos ou trilhas específicas à lista da versão.
Primeiro, vamos olhar mais de perto a relação entre módulos, trilhas e uma versão. Para publicar conteúdo em uma versão, são necessários dois itens de dados.
- O manifesto, que é uma lista das trilhas e módulos a processar na versão. Cada trilha ou módulo é um item de manifesto. Um item de manifesto faz referência à trilha ou módulo pelo nome de API do conteúdo.
- Os backpacks, que contêm o conteúdo de fato a publicar na versão.
O Trailmaker oferece algumas opções para estabelecer a relação entre o manifesto e o conteúdo do backpack.
- No Trailmaker Content, você pode adicionar um módulo ou trilha a uma versão diretamente. Esta ação fornece tanto o item de manifesto quanto o backpack.
- No Trailmaker Release, você pode adicionar um ou mais módulos ou trilhas a uma versão. Esta ação fornece apenas o item de manifesto para a trilha ou módulo. O backpack do conteúdo ainda está ausente. A página da versão relata um erro até que o backpack seja fornecido. A única maneira de adicionar o backpack é retornar ao Trailmaker Content e adicionar o conteúdo à versão.
Cada opção permite um fluxo de trabalho diferente para a publicação de conteúdo. Algumas empresas querem manter limites rígidos entre funções: querem que os criadores de conteúdo escrevam e que os gerentes de versão, bem, gerenciem as versões.
Pense nisso desta forma. Quando planeja ir às compras no supermercado, você pode fazer uma lista de itens que deseja comprar com antecedência. Talvez você dê a lista para outra pessoa, como um parceiro carinhoso e responsável, que faz as compras de verdade. Quando você está na loja, adiciona esses itens ao seu carrinho, e então segue para o caixa.
O que as compras de supermercado têm a ver com a liberação de conteúdo no seu site de capacitação?
No Trailmaker Content, adicionar itens a uma versão é como adicionar compras ao seu carrinho sem uma lista. Adicionando compras ao seu carrinho, você está fazendo a lista à medida que avança. No Trailmaker Content, você está adicionando seus itens de manifesto (a lista) e seus backpacks de conteúdo (mantimentos) na mesma ação, mas não havia uma lista quando começou.
No Trailmaker Release, adicionar itens a uma versão é como fazer sua lista de compras com antecedência. Você sabe os itens de manifesto que deseja (a lista), mas os backpacks de conteúdo real (as compras) ainda não estão na versão (seu carrinho). A pessoa que faz a lista não é necessariamente a pessoa que adiciona o conteúdo.
Um gerente de versão, como Marisol, frequentemente faz uma lista dos itens que deseja incluir em uma versão com antecedência. Ela pode fazer essa lista a qualquer momento, mesmo antes do conteúdo estar pronto, e o Trailmaker Release relata um erro, impedindo que ela publique até que o conteúdo também seja adicionado.
Se houver uma longa lista de itens a serem adicionados, Marisol pode adicionar vários itens ao mesmo tempo, carregando um arquivo CSV que contém os nomes de API e os tipos de conteúdo.
Vamos ver como essas ideias funcionam quando Marisol realmente tenta adicionar itens a uma versão.
Adicionar um item individual a uma versão
Digamos que Marisol deseja adicionar apenas um único módulo a uma versão, e ela já está no Trailmaker Release. Vejamos como ela vai fazer isso.
- No Trailmaker Release, navegue até a versão criada.
- Na página da versão, clique em Add Content (Adicionar conteúdo).
- Na página Adicionar à versão, digite essas informações:
- O nome da API do módulo ou trilha a adicionar (1). Por exemplo, para adicionar o módulo Estratégias de vendas da Pure Aloe, que Cindy criou, Marisol digita pure-aloe-sales-strategies.
- O tipo de conteúdo a adicionar (2), como Módulo ou Trilha.
- A operação a ser realizada sobre o conteúdo (3): Arquivar, Restaurar ou Inserir e atualizar. Para adicionar novo conteúdo a um subdomínio, Marisol seleciona Upsert (Inserir e atualizar). Para saber mais sobre as operações disponíveis, continue lendo!
Vamos parar por um momento e falar sobre nomes de API. Cada conteúdo que você publica no site de capacitação tem um nome de API exclusivo, e cada coleção de conteúdo e versão também têm um nome de API exclusivo. Todos esses valores trabalham juntos para criar uma URL para o conteúdo, depois de publicado. Lembre-se que ao adicionar conteúdo a uma versão do Trailmaker Release, você adiciona um item de manifesto, que faz referência ao nome de API do conteúdo que deseja adicionar.
Marisol salva suas alterações, e o conteúdo é incluso na lista de itens na página da versão. Mas o trabalho da Marisol acabou? Lembre-se que uma versão requer tanto o item de manifesto quanto o backpack do conteúdo para poder publicar o conteúdo. Até agora, Marisol só adicionou o item de manifesto de um módulo. Para adicionar o backpack do conteúdo, ela (ou outro usuário com a permissão de gerenciamento da versão) deve retornar ao Trailmaker Content, importar o backpack para seu espaço de trabalho e adicionar o conteúdo à versão. Para obter uma atualização sobre este fluxo de trabalho, visite novamente o módulo Noções básicas do Trailmaker Content.
Este fluxo de trabalho faz o trabalho, mas exige alguns cliques extras para colocar tudo no lugar. Para manter as coisas simples, recomendamos usar o Trailmaker Content sempre que quiser adicionar um item individual a uma versão. Dessa forma, você adiciona todos os dados que uma versão exige para poder publicar o conteúdo.
Adicionar vários itens a uma versão simultaneamente
Para adicionar vários itens a uma versão de uma só vez, Marisol cria um arquivo CSV onde cada linha especifica o nome da API, o tipo de conteúdo e a operação a executar para cada item que deseja modificar na versão. Por exemplo, talvez a Marisol deseje modificar esses módulos e trilhas nesta versão:
api_name,type,operation
pure-aloe-sales-goals,module,upsert
sell-well-at-pure-aloe,trail,upsert
navigate-your-pure-aloe-career,trail,upsert
pure-aloe-sales-challenges,module,archive
pure-aloe-annual-meeting-prep,module,restore
Para importar dados de um arquivo CSV com sucesso, a primeira linha do arquivo CSV deve incluir os rótulos das colunas api_name, type e operation.
Marisol começa na página da versão no Trailmaker Release.
- Na página da versão, clique em Add Content (Adicionar conteúdo).
- Na página Adicionar à versão, clique em Import (Importar).
- Selecione o arquivo CSV com o conteúdo a ser alterado.
A página Adicionar à versão é preenchida com o conteúdo do arquivo CSV.
Depois que Marisol salva suas alterações, todos esses itens aparecem na página da versão no Trailmaker Release. Mas, assim como ao adicionar um item individual, cada item da lista representa apenas o item de manifesto do conteúdo. Para itens com as operações Arquivar e Restaurar, Marisol não precisa seguir nenhuma etapa extra. Para itens com a operação Inserir e atualizar, Marisol ainda deve retornar ao Trailmaker Content, importar o backpack de cada trilha ou módulo para seu espaço de trabalho e, em seguida, adicionar cada trilha ou módulo à versão.
Selecionar uma operação para a versão
Quando um gerente de versão adiciona um item de manifesto à lista da versão, ele deve selecionar uma operação para o conteúdo. A operação especifica como a versão processa o item específico.
Operação |
Descrição |
|---|---|
Inserir e atualizar (upsert) |
Adiciona conteúdo ao seu site de capacitação ou atualiza conteúdo que já foi publicado. Lembre-se: Quando você adiciona a uma versão no Trailmaker Release, selecionar esta operação requer que você também adicione o conteúdo novo ou atualizado à versão no Trailmaker Content, para que o backpack do conteúdo seja processado com a versão. Nota: Quando você adiciona a uma versão no Trailmaker Content, esta operação é selecionada por padrão. |
Arquivar |
Oculta conteúdo que já foi publicado em seu site de capacitação. Esta operação não requer nenhum trabalho no Trailmaker Content. |
Restaurar |
Revela conteúdo arquivado. Esta operação não requer nenhum trabalho no Trailmaker Content. |
A operação selecionada para cada item da versão é exibida na página da versão.
Na maioria das vezes, Marisol está publicando conteúdo novo ou correções para o conteúdo existente. Então, geralmente, ela seleciona a operação Upsert (Inserir e atualizar).
Às vezes, o conteúdo se torna obsoleto, por exemplo, quando os processos ou ferramentas da empresa mudam. Para remover conteúdo desatualizado do site de capacitação, Marisol seleciona Archive (Arquivar). E para recuperar conteúdo arquivado, ela seleciona Restore (Restaurar).
A operação Arquivar não é destrutiva, o que significa que não remove os pontos ou emblemas de qualquer aluno que os ganhou antes do arquivamento do conteúdo.
Às vezes, o conteúdo arquivado se torna relevante novamente: por exemplo, os módulos que preparam os representantes de vendas da Pure Aloe para sua reunião anual. Marisol arquiva os módulos depois de cada reunião anual. Nas semanas que antecedem a reunião anual seguinte, ela recupera-os selecionando Restaurar.