Criar uma versão do myTrailhead

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Descrever o que é uma versão.
  • Criar e adicionar itens a uma versão.
  • Explicar as operações da versão.
  • Descrever as ações possíveis em cada status das versões.
  • Explicar como o myTrailhead muda quando você publica uma versão.

Introdução

A empresa Pure Aloe cria hidratantes e cremes feitos com aloé vera. Graças ao grande sucesso de seus produtos no mercado, a empresa está crescendo rapidamente. A Pure Aloe quer garantir que todos os seus funcionários possam aprender as habilidades necessárias para alcançar o sucesso. Para isso, a Pure Aloe se inscreveu no myTrailhead. 

A equipe do myTrailhead da Pure Aloe cria e publica conteúdo apenas para funcionários da Pure Aloe. Ela cria módulos, pequenas porções de conteúdo que abordam determinada habilidade ou tópico. Ela também cria trilhas, coleções de módulos relacionados que são organizadas em caminhos de aprendizagem guiados que abordam um tópico mais amplo.

Marisol é a gerente de versão do myTrailhead na Pure Aloe. Ela supervisiona o fluxo de publicação do myTrailhead da empresa. O aplicativo Trailmaker Release é parte integrante de seu trabalho. Com o Trailmaker Release, ela cria, gerencia e publica as versões do conteúdo do myTrailhead da Pure Aloe. 

O que é uma versão?

Essencialmente, uma versão é uma lista de módulos e trilhas que a equipe do myTrailhead planeja publicar. Com uma versão, Marisol pode:

  • Inserir e atualizar (upsert) conteúdo, ou seja, publicar conteúdo novo ou atualizar conteúdo existente
  • Arquivar conteúdo publicado
  • Restaurar conteúdo arquivado anteriormente

As versões são fundamentais para a publicação do conteúdo do myTrailhead. Se um módulo, ou uma trilha, não estiver listado em uma versão, ele não poderá ser publicado.

Neste módulo, assumimos que você é um gerente de versão do myTrailhead com as permissões adequadas para criar e gerenciar versões do myTrailhead. Se não for, você poderá ler mesmo assim para saber como o gerente de versão desempenha seu papel. No entanto, não é possível seguir as etapas em um Trailhead Playground porque o myTrailhead não está disponível em Trailhead Playgrounds.

Como criar uma versão

Vamos começar pelo princípio. Como Marisol cria uma versão? 

  1. Marisol faz login no myTrailhead, clica no avatar ao lado do seu nome e seleciona Trailmaker.
  2. Na barra de navegação, ela clica em Versões.
  3. Na página do namespace, ela clica em Nova versão.

Página do namespace no Trailmaker Release que mostra o botão Nova versão

  1. Ela insere o nome da versão, por exemplo, July Jellybean. O Trailmaker Release gera o nome da API para a versão com base no título, mas, se desejar, Marisol poderá alterá-lo depois.
  2. Ela clica em Criar.

Criar uma tela de versão no Trailmaker Release

É muito fácil.

Como adicionar itens a uma versão

Depois de criar uma versão, Marisol tem duas opções para adicionar módulos e trilhas à lista. Ela pode adicionar esses itens individualmente ou, se tiver uma longa lista de itens, carregar um arquivo .csv. 

Por exemplo, Marisol pode adicionar itens individuais a uma versão antes que Cindy, a redatora do myTrailhead da Pure Aloe, envie o conteúdo. Ela também pode carregar um arquivo .csv que lista 20 itens ou mais para atualização.

Cindy também pode adicionar itens a uma versão. Quando ela carrega um módulo ou trilha em uma versão do Trailmaker Content, adiciona automaticamente o item à lista de versões caso ainda não apareça na lista. Para entender ainda mais esse processo, confira Noções básicas do Trailmaker Content

Como adicionar itens individuais a uma versão

Para adicionar itens a uma versão individualmente, Marisol navega até a versão criada no Trailmaker Release. 

1. Na página da versão, ela clica em Adicionar conteúdo.

2. Ela insere o nome da API no módulo ou na trilha que está adicionando. Por exemplo: pure-aloe-sales-goals.

3. Ela seleciona o tipo de conteúdo. Por exemplo: Módulo.

4. Ela seleciona a operação. Por exemplo: Inserir e atualizar (upsert).

5. Para adicionar outro módulo (ou trilha) isoladamente, ela clica em Adicionar. Ou clica em Salvar.

Tela Adicionar à versão no Trailmaker Release que mostra um item individual a ser adicionado à versão

Como adicionar vários itens a uma versão simultaneamente

Para adicionar vários itens a uma versão de uma só vez, Marisol precisa do nome da API para cada item que deseja adicionar. Nome da API é um código exclusivo que aponta para um conteúdo. Quando Cindy cria um módulo ou uma trilha, o Trailmaker Content cria o nome da API baseando-se no título do conteúdo. No myTrailhead, o nome da API de cada módulo e trilha é exibido na URL do conteúdo após a barra final.

Depois de obter os nomes das APIs, Marisol cria uma tabela em um arquivo .csv com cabeçalhos de coluna para api_name, type e operation. Na tabela, ela lista cada módulo e trilha que deseja adicionar à versão. Por exemplo:

api_name
type
operation
pure-aloe-sales-goals
módulo
inserir e atualizar (upsert)
sell-well-at-pure-aloe
trilha
inserir e atualizar (upsert)
navigate-your-pure-aloe-career
trilha
inserir e atualizar (upsert)
pure-aloe-sales-challenges
módulo
arquivar
pure-aloe-annual-meeting-prep
módulo
restaurar

Em seguida, ela vai para a página da versão no Trailmaker Release. 

1. Na página da versão, ela clica em Adicionar conteúdo.

2. Ela clica em Importar.

Tela Adicionar à versão no Trailmaker Release que mostra o botão Importar para adicionar vários itens à versão oriundos de um arquivo CSV

3. Ela navega até o arquivo .csv, seleciona-o e clica em Abrir. Todos os itens no arquivo .csv são exibidos na tela Adicionar à versão.

Tela Adicionar à versão no Trailmaker Release mostrando vários itens adicionados à versão oriundos de um arquivo CSV carregado

4. Ela clica em Salvar.

Nos dois casos, Marisol está compilando a lista de versões. Para concluir o processo de inserir e atualizar (upsert) conteúdo novo ou revisado, Cindy ainda precisa carregar o conteúdo do Trailmaker Content.

Operações de versões

Cada item da lista de versões tem uma das três operações. Marisol seleciona a operação quando adiciona cada item à lista de versões.

  • Inserir e atualizar (upsert): adiciona conteúdo novo ao myTrailhead ou atualiza conteúdo existentes.
  • Arquivar: oculta conteúdo existente no myTrailhead.
  • Restaurar: revela conteúdo arquivado.

A operação selecionada para cada item da versão é exibida na página da versão.

Página da versão no Trailmaker Release mostrando a operação selecionada para cada item da versão

Na maioria das vezes, Marisol está publicando conteúdo novo ou correções do conteúdo existente. Então, na maioria das vezes, ela seleciona Inserir e atualizar (upsert). (Quando Cindy adiciona conteúdo a uma versão do Trailmaker Content, o padrão da operação é Inserir e atualizar – Upsert.)

Às vezes, o conteúdo se torna obsoleto, por exemplo, quando os processos da empresa mudam. Para remover conteúdo desatualizado do myTrailhead, Marisol seleciona Arquivar. (No entanto, os Trailblazers que receberam o emblema de um módulo arquivado poderão mantê-lo.)

À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.

Status da versão e o que ele significa

Várias pessoas podem contribuir para uma versão, por exemplo, o redator, o designer de emblemas e o gerente de localização. Marisol controla o fluxo de conteúdo e determina quando cada conteúdo será publicado. Para ajudá-la a direcionar esse fluxo, ela usa o status da versão.

Uma versão pode ter um dos três status a seguir.

  • Aberta
  • Bloqueada
  • Publicada

Marisol pode alternar o status de uma versão entre Aberta e Bloqueada.

Página da versão no Trailmaker Release que mostra a lista de opções Status

Versões abertas

Quando o status de uma versão é Aberta, Marisol pode adicionar itens à versão e Cindy pode carregar conteúdo nela. O gerente de localização da Pure Aloe também pode. E todos eles podem ver o conteúdo no modo de visualização. (No modo de visualização, os usuários podem visualizar o conteúdo não publicado no myTrailhead. Eles podem revisar o conteúdo, verificar o tamanho e a legibilidade das imagens e verificar os testes.)

Mas e se Marisol estiver pronta para publicar uma versão e Cindy ainda estiver trabalhando em um dos módulos? Quando o status da versão é Aberta, Marisol pode excluir o módulo dessa versão e adicioná-lo à próxima versão. Quando Cindy termina de trabalhar no módulo, ela pode usar o Trailmaker Content a fim de enviá-lo para a versão seguinte.

Versões bloqueadas

O status Bloqueada ajuda Marisol a fazer com que uma versão contenha apenas conteúdo pronto para ser publicado. Quando o status de uma versão é Bloqueada, os usuários ainda podem visualizar o conteúdo na versão, mas ninguém pode adicionar conteúdo a ela. Quando Marisol está se preparando para publicar uma versão, ela muda o status para Bloqueada a fim de garantir a segurança.

Versões publicadas

Depois que Marisol publica uma versão, seu status muda permanentemente para Publicada. Se o conteúdo publicado precisar ser alterado, por exemplo, para corrigir erros, Cindy adicionará o conteúdo corrigido a uma nova versão e Marisol publicará a versão corrigida.

O que muda no myTrailhead quando uma versão é publicada?

Quando Marisol cria uma versão, o Trailmaker Release faz uma cópia nos bastidores de todo o conteúdo existente no myTrailhead e reserva-a. Depois, Cindy adiciona seu conteúdo novo e revisado à versão. Quando Marisol publica a versão, o Trailmaker Release substitui todo o conteúdo do myTrailhead pelo conteúdo da versão. Ou seja, o Trailmaker Release republica o conteúdo duplicado e publica o conteúdo novo e revisado.

Veja exemplos do que muda no myTrailhead quando uma versão é publicada, dependendo da operação selecionada por Marisol.

Alterações do conteúdo
Operação selecionada
Resultado publicado
Adicionar um novo módulo a uma versão
Inserir e atualizar (upsert)
O novo módulo é exibido no myTrailhead
Atualizar um módulo existente com novas informações e adicionar o módulo a uma versão
Inserir e atualizar (upsert)
O módulo atualizado com as novas informações é exibido no myTrailhead
Adicionar um módulo existente a uma versão
Arquivar
O módulo desaparece do myTrailhead (mas os usuários que ganharam o emblema desse módulo não o perdem)
Adicionar um módulo arquivado a uma versão
Restaurar
O módulo é exibido novamente no myTrailhead
Excluir uma unidade de um módulo e adicionar o módulo a uma versão
Inserir e atualizar (upsert)
O módulo permanece no myTrailhead, mas a unidade excluída desaparece

Na próxima unidade, Marisol usará o Trailmaker Release para gerenciar suas versões.

Recursos

Continue a aprender de graça!
Inscreva-se em uma conta para continuar.
O que você ganha com isso?
  • Receba recomendações personalizadas para suas metas de carreira
  • Pratique suas habilidades com desafios práticos e testes
  • Monitore e compartilhe seu progresso com os empregadores
  • Conecte-se a orientação e oportunidades de carreira