Manual de migração

Última atualização: 2 de junho de 2026

Consulte o manual para administradores de integração que desejam migrar um LMS existente para o LMS do Learning Manager

Cenário de uso usagescenario

Em geral, as grandes empresas têm seu LMS interno ou qualquer sistema de gerenciamento de aprendizagem legado fornecido pelo fornecedor. O LMS é composto de conteúdo de treinamento e dados de treinamento da empresa. Assim como uma empresa, quando você compra o Learning Manager, talvez você queira mover o conteúdo e os dados existentes do LMS para o Learning Manager, porque dessa forma você pode aproveitar os benefícios do moderno e intuitivo LMS sem perder alguns dados legados da sua empresa.

O Learning Manager fornece as ferramentas e especificações necessárias para que o administrador de integração da sua organização possa configurar e executar as tarefas de migração.

A partir de hoje, o recurso de migração do Learning Manager pode ser acessado pelos administradores de uma empresa entrando em contato com a equipe de suporte da Adobe. Para ativar o recurso Migração em sua conta, você pode entrar em contato com a equipe de suporte do Adobe Learning Manager.

Processo de migração apidescription

Os pré-requisitos, as principais etapas envolvidas no processo de migração, os sprints de migração, as especificações, as etapas de migração dos dados e do conteúdo são explicados nesta seção da seguinte forma:

Aviso importante sobre migração

Você deve estar ciente de que os cronogramas de migração dependem muito da qualidade e do tamanho dos dados. Se precisar migrar durante a integração, planeje essa atividade com bastante antecedência e trabalhe em conjunto com a equipe de integração do Adobe Learning Manager para evitar atrasos.

Pré-requisitos prerequisites

A equipe do Learning Manager espera que as tarefas a seguir sejam executadas pelos administradores de integração da sua empresa antes de iniciar o processo de migração:

O administrador de integração extrai os dados e o conteúdo do LMS vigente e transforma os dados em formatos de arquivo, conforme definido pelo Learning Manager.
O Learning Manager não oferece suporte à importação de usuários como parte do processo de migração e espera que a empresa importe os usuários utilizando conectores. A Adobe Systems espera que esses conectores sejam configurados antes do processo de migração. Consulte Ajuda dos conectores do Learning Manager para mais informações.

O Learning Manager recomenda que os administradores testem o processo de migração em uma conta de teste antes de migrar os dados e o conteúdo para o ambiente de produção do Learning Manager.

Principais etapas do processo de migração keystepsofmigrationprocess

As principais etapas envolvidas na migração de conteúdo e dados de um LMS existente para o Learning Manager são as seguintes:

O administrador ou parceiro de integração avalia os dados e o conteúdo existentes do LMS que precisam ser migrados.
O administrador de integração avalia as ferramentas e as especificações que o Learning Manager proporciona para inclusão dos dados e do conteúdo.
O administrador de integração grava o código ou realiza trabalho manual para exportar os dados e o conteúdo de treinamento do LMS mais antigo, com base na funcionalidade fornecida pelo LMS mais antigo.
Quando os dados e o conteúdo do treinamento estiverem disponíveis, o administrador de integração analisa e mapeia os dados e o conteúdo para que correspondam às especificações de migração do Learning Manager.
O administrador de integração usa as ferramentas fornecidas pelo Learning Manager para migrar na seguinte ordem:
1. Transferir os alunos para o Learning Manager
2. Transfira o conteúdo de treinamento para o Learning Manager e
3. Por fim, transfira os dados de treinamento para o Learning Manager.

A empresa pode começar a usar o LMS do Learning Manager juntamente com o conteúdo existente.

Escopo dos objetos de migração scopeofmigrationobjects

Você pode migrar o conteúdo somente para os seguintes objetos de aprendizado:

Módulo
Medalhas
Curso
Versão do módulo
Instância do curso
Módulo do curso
Habilidades
Nível da habilidade
Habilidade do curso
Certificação
Curso de certificação
Participação na certificação
Programa de aprendizado
Curso do programa de aprendizado
Instância do programa de aprendizado
Instância do curso do programa de aprendizado
Material de ajuda
Versão do material de ajuda
Curso do material de ajuda
Habilidades do material de ajuda
Inscrição
Inscrição na certificação
Inscrição no programa de aprendizado
Inscrição no material de ajuda
Notas do curso do usuário

Principais conceitos da migração keyconceptsofmigration

Alguns dos principais conceitos do processo de migração do Learning Manager são explicados brevemente para rápida referência da seguinte forma:

Projeto de migração

No Learning Manager, um projeto de migração está formado por um ou mais sprints. Você também pode ter vários projetos de migração na sua conta. O processo de migração do Learning Manager começa com a criação de um projeto de migração.

Sprint

Um sprint, no processo de migração do Learning Manager, define um conjunto de itens de migração escolhido para ser migrado do LMS existente. Um item de migração pode ser um módulo do curso, registros do aluno ou um conjunto de cursos. É possível ter vários itens de dados de aprendizado em um sprint. É possível executar tarefas de migração em cada sprint.

Execuções de sprint

Execução de sprint é o processo de iniciar uma tarefa de migração do sprint. É possível interromper a execução do sprint em qualquer ponto de uma execução.

Re-execuções de sprint

É possível executar um sprint de migração novamente a qualquer momento após a conclusão. Essa situação de re-execução de um sprint ocorre quando você quer acrescentar os dados em um item de sprint e migrá-los novamente no aplicativo ou corrigir os erros nos CSVs.

Especificação do CSV

O Learning Manager fornece um conjunto de especificações CSV padrão. A prática recomendada é analisar essas especificações CSV antes de iniciar o processo de migração. O administrador de integração da sua empresa pode analisar os formatos de dados existentes e mapeá-los para que correspondam aos itens de modelo CSV fornecidos do Learning Manager.

Etiquetas do projeto de migração

A Adobe Systems recomenda usar um conjunto de palavras-chave como etiquetas para identificar facilmente os projetos de migração dentro do aplicativo Learning Manager. Essas etiquetas permitem identificar os projetos internamente no aplicativo Learning Manager em qualquer momento específico.

Módulo sem conteúdo

O Learning Manager permite carregar um módulo sem conteúdo. Adobe Systems se considera um módulo sem conteúdo no Learning Manager. Em casos nos quais se deseja migrar alguns dados legados do LMS existente sem a necessidade de conteúdo, é possível carregar o arquivo module_version.csv sem referência de URL.

Especificações do CSV e CSVs de amostra csv

Abaixo encontram-se as especificações CSV padrão que podem ser usadas para mapear os dados de migração do LMS existente. Clique em csv-specifications e sample-csvs para baixar os arquivos zip. O arquivo csv-specifications.zip baixado contém sete arquivos de planilha do Excel. Esses arquivos de planilha do Excel são especificações com descrições para que você entenda como preencher os arquivos .csv. Os arquivos .csv correspondentes devem conter os dados de cada campo no formato prescrito, conforme explicado nesses arquivos .xlsx.

Sl.no

Nome do arquivo

Descrição do conteúdo

Notas

module.xlsx

Metadados para module.csv

badge.xlsx

Metadados para badge.xlsx

course.xlsx

Metadados para course.csv

Indique um nome de autor de um curso específico porque, às vezes, vários nomes de autor não são exibidos corretamente no aplicativo após a migração.

module_version.xlsx

Metadados para module_version.csv

Certifique-se de fornecer o caminho do URL da pasta da conta do Box na qual o conteúdo foi carregado.

course_instance.xlsx

Metadados para course_instance.csv

session.xlsx

Metadados para session.csv

Verifique se todas as entradas no CSV da sessão foram associadas a pelo menos um módulo de sala de aula/sala de aula virtual

course_module.xlsx

Metadados para course_module.csv

skill.xlsx

Metadados para skill.csv

skill_level.xlsx

Metadados para skill_level.csv

skill_course.xlsx

Metadados para skill_course.csv

certification.xlsx

Metadados para Certification.csv

certification_course.xlsx

Metadados para certification_course.csv

certification_commit.xlsx

Metadados para certification_commit.csv

learning_program.xlsx

Metadados para learning_program.csv

learning_program_course.xls

Metadados para learning_program_course.csv

learning_program_instance.xlsx

Metadados para learning_program_instance.csv

learning_program_instance_course_instance.xlsx

Metadados para learning_program_instance_course_instance.csv

job_aid.xlsx

Metadados para job_aid.csv

Cada job_aid migrado precisa ter uma ou mais versões de job_aid.

Job_aid_version.xlsx

Metadados para job_aid_version.csv

job_aid_course.xlsx

Metadados para job_aid_course.csv

job_aid_skills.xlsx

Metadados para job_aid_skills.csv

enrollments.xlsx

Metadados para enrollments.csv

certification_enrollement.xlsx

Metadados para certification_enrollement.csv

learning_program_enrollment.xlsx

Metadados para learning_program_enrollment.csv

job_aid_enrollment.xlsx

Metadados para job_aid_enrollment.csv

user_course_grade.xlsx

Metadados para user_course_grade.csv

Forneça os dados necessários de registros do aluno no arquivo .csv mesmo que não sejam obrigatórios. Sem essas informações, o aplicativo Learning Manager pode não refletir nenhum dado, mesmo que o .csv seja processado para migração. O arquivo sample-csvs.zip contém sete arquivos .csv com a convenção de nomenclatura conforme indicado acima.

user_skill.xlsx

Metadados para user_skill.csv

O Learning Manager oferece suporte a valores de data e hora somente no formato UTF 8 e 32 bits. Você pode obter erros durante a migração se mencionar a data em arquivos CSV com uma data fora do intervalo como 2038-07-17T08:53:21.000Z ou 1980-04-17T08:13:25.322Z.

Você deve estar ciente das seguintes dependências dos arquivos CSV durante a importação:

module_version.csv depende de module.csv
course_instance.csv depende de course.csv
course_module.csv depende de course.csv, module.csv e module_version.csv
course_instance.csv depende de course.csv
session.csv depende de course.csv e module.csv
enrollment.csv depende de course.csv
user_course_grade.csv depende de course.csv e module.csv
skill_course.csv depende de course.csv
skill_level.csv depende de skill.csv
learning_program_instance.csv depende de learning_program e learning_program_course.csv
learning_program_course.csv depende de learning_program.csv
learning_program_enrollment.csv depende de learning_program e learning_program_instance.csv
learning_program_instance_course_instance.csv depende de learning_program.csv, learning_program_instance.csv e course_instance.csv
certification_course.csv depende de certification.csv e course.csv
certification_commit.csv depende de certification.csv e certification_course.csv
certification_enrollment.csv depende de certification.csv, certification_course.csv e certification_enrollment.csv

Ordem de cursos do Programa de aprendizado em CSVs de migração

Nas versões anteriores das especificações de migração, o arquivo learning_program_course.csv incluía uma coluna de ordem, sugerindo que você poderia controlar a sequência de cursos em um programa de aprendizado durante a migração.

O Adobe Learning Manager não usa mais esta coluna. A ordem dos cursos em um programa de aprendizado não pode ser controlada por CSVs de migração, e o sistema ignora todos os valores fornecidos na coluna de ordem, mesmo que você defina orderEnforced como true.

Para evitar confusão, a coluna de ordem foi removida das especificações oficiais do CSV. Se você tiver scripts ou ferramentas existentes que ainda geram essa coluna, poderá soltá-la com segurança; não há impacto em como os Programas de aprendizado são criados ou exibidos.

Procedimento de migração migrationprocedure

Antes de dar início ao procedimento de migração, é importante observar os seguintes pontos:

Somente um projeto de migração pode estar ativo em uma conta em um dado momento. Dentro de um projeto, somente um sprint pode estar ativo em um dado momento.
Não é possível desfazer uma execução que já está em processo de migração. No entanto, é possível usar a opção de exclusão existente em cada recurso do Learning Manager para desfazer qualquer migração de dados ou conteúdo.
Assim que o projeto de migração é iniciado, ele passa para o estado de ‘Em migração’. Durante a migração, nenhuma outra função além da função de administrador de integração pode fazer login no Learning Manager.

Criação de contas FTP e Box creatingftpandboxaccounts

É muito importante planejar o projeto de migração. Recomenda-se dividir os projetos em vários sprints e identificar com clareza o que se quer migrar em cada sprint. Pode ser uma boa ideia fazer validações após cada sprint para estar seguro dos dados migrados nesse sprint, em vez de fazer uma grande fase de validação no fim do projeto. Antes de começar o sprint como parte do projeto de migração, é necessário carregar arquivos CSV de dados e conteúdo no FTP e nos servidores do Box respectivamente. Se você não tiver contas para FTP e Box personalizados, é possível criá-las.

Criar conta do Box

Crie a pasta para carregamento de conteúdo de forma semelhante à criação da pasta FTP. Clique em Migração no painel esquerdo e clique em Solicitar uma pasta para carregamento de conteúdo na parte inferior da página exibida.

Você receberá um e-mail do Box com um link para a pasta compartilhada. Se não tiver uma conta do Box, clique em Inscreva-se e crie uma conta. As instruções de login são enviadas à ID de e-mail do administrador de integração.

Carregamento de dados (arquivos .csv) em pastas FTP ou pastas do Box

A criação de contas FTP ou Box é um pré-requisito para criar projetos de migração. Portanto, nesta etapa, você pode criar um projeto e um sprint de migração no aplicativo Learning Manager. Consulte a seção Procedimento de migração de dados e conteúdo nesta página para criar projetos de migração.

Nas contas FTP ou Box, clique no nome da pasta do projeto e clique no nome do sprint. Dentro da pasta de sprint, você pode carregar os arquivos de dados .csv que pretende migrar. Para fazer upload, clique no botão Fazer upload de arquivos na parte superior do servidor FTP ou Box e solte os arquivos .csv. Um instantâneo de exemplo após fazer upload para o FTP é mostrado abaixo para sua referência.

Você pode voltar ao projeto de migração do Learning Manager, clicar em Atualizar e visualizar todos os tipos de dados .csv listados no sprint de migração.

Carregar conteúdo de treinamento nas pastas de conteúdo

Carregue o conteúdo de treinamento do LMS existente na sua conta do Box. Se já tiver cirado o sprint e o projeto de migração, a conta do Box preencherá o nome do sprint e do projeto de migração. Você pode carregar o conteúdo no mesmo caminho. Consulte a seção Procedimento de migração de dados e conteúdo nesta página para criar projetos de migração.

Você pode arrastar e soltar os arquivos de conteúdo ou clicar em Carregar e selecionar os arquivos na área de trabalho. Se o tamanho do arquivo de conteúdo for muito grande, pode ocorrer um atraso ao carregar os arquivos. Dependendo do tamanho do arquivo, o tempo necessário para carregar os arquivos na conta do Box varia.

É mostrada abaixo para referência uma captura de tela da conta do Box após o carregamento do conteúdo:

Conta de arquivos no Box

Depois que os arquivos são carregados na conta do Box, certifique-se de indicar o caminho relativo deste arquivo de conteúdo do Box no arquivo module_version.csv. É obrigatória a etapa de indicar o caminho do conteúdo do módulo.

Após fazer login nos servidores FTP e Box, e carregar o conteúdo, as localizações do CSV aparecem conforme ilustrado na captura de tela abaixo no Learning Manager.

Locais CSV na conta do Box

Migração para Alternativas e Equivalentes

Visão geral

Este tópico descreve o modelo de dados baseado em CSV e o comportamento de migração para introduzir a equivalência do objeto de aprendizado (LO) no sistema.

Arquivos CSV existentes (contexto)

Esses CSVs já existem na plataforma e fornecem o objeto de aprendizado principal, o módulo e o contexto de conclusão (lista não completa):

user_course_grade.csv
moduleversion
module.csv
course.csv
course_module.csv

Esses arquivos continuam a ser usados como estão e não são alterados pelo novo recurso de equivalência, mas formam os dados subjacentes sobre os quais a equivalência funcionará.

Novos arquivos CSV para alternativas

Dois novos CSVs foram introduzidos para oferecer suporte a relacionamentos alternativos de LO e conclusões de usuário relacionadas.

1. equivalence_relationship.csv

Define mapeamentos de equivalência entre os objetos de aprendizado (LOs) de origem e de destino, que podem ser cursos ou caminhos de aprendizado (LPs).

Esquema:

sourceId
sourceloType (curso/LP)
targetId
targetLotype (curso/LP)
dateCreated
relationshipStatus (ATIVO / DELETE)
dateModified

Finalidade:

Representa uma relação de equivalência entre dois OAs.
relationshipStatus controla se a relação está ativa ou excluída no momento.
auditoria de suporte dateCreated e dateModified.

equivalence_user_completion.csv

Captura informações de conclusão no nível do usuário para OAs equivalentes, alinhadas com as relações definidas em equivalence_relationship.csv.

Esquema:

userId
sourceId
sourceloType (curso/LP)
targetId
targetLotype (curso/LP)
dateCompleted

Finalidade:

Registra explicitamente quais conclusões do OA de destino devem ser deduzidas para um usuário com base na relação de equivalência e na conclusão do OA de origem existente.
Funciona como a fonte autoritativa para conclusões de usuário ligadas a dados equivalentes migrados.

Regras de migração e semântica comportamental

1. Não há suporte para aprimoramento de novos CSVs equivalentes

Todos os dados relacionados à equivalência devem ser trazidos via migração.
O sistema não oferecerá suporte a cenários em que:
- Os dados do OA (cursos/LPs) foram criados por meio da interface do usuário e
- As relações de equivalência são importadas posteriormente somente por meio de CSV.

Isto significa:

O padrão suportado é: As definições do LO e suas relações de equivalência são gerenciadas como parte de um fluxo de migração coerente.
Os fluxos híbridos em que os OA criados pela interface do usuário são adaptados com equivalência somente por CSV não são compatíveis.

2. Nenhuma conclusão retroativa/inconclusão de relacionamentos migrados

Quando uma relação de equivalência é introduzida por meio da migração (ou seja, por meio de equivalence_relationship.csv):

O sistema não executará cálculos retroativos de conclusão ou inconclusão baseados apenas nesse relacionamento.
Em vez disso, todos os dados de conclusão do usuário necessários devem ser fornecidos explicitamente por meio do equivalence_user_completion.csv.

Implicação:

equivalence_user_completion.csv é a única fonte confiável para quaisquer conclusões que devem ser reconhecidas no momento da migração como resultado da equivalência.
A plataforma não tentará inferir ou reverter essas conclusões do progresso do curso existente.

3. Comportamento de novas conclusões após a migração

Se:

Uma relação de equivalência foi criada por meio da migração e
Um aluno conclui posteriormente o LO de origem (pós-migração),

depois:

O sistema acionará conclusões alternativas para o OA de destino, ou seja, a equivalência se comporta normalmente daqui para frente para novas conclusões de origem.

Distinção de chave:

No momento da migração: as conclusões devem vir por meio de equivalence_user_completion.csv.
Após a migração: a lógica de tempo de execução nativa tratará de conclusões alternativas quando um LO de origem for concluído recentemente.

4. Impacto em objetos de aprendizado de ordem superior

Conclusões alternativas recebidas por meio de CSV (por exemplo, via equivalence_user_completion.csv) acionarão o recálculo de LOs de ordem superior.

Os OAs de ordem superior podem incluir:

Caminhos de aprendizado

Implicação técnica:

A assimilação de equivalence_user_completion.csv não é uma operação “silenciosa”: ela inicia a mesma lógica de recálculo/roll-up que seria acionada por términos normais de tempo de execução.
Os sistemas que integram ou agendam essa migração devem planejar a carga e o tempo de recálculos.

Webhooks para alternativas

Quando um aluno conclui um curso por meio de uma inscrição alternativa ou por meio de um relacionamento, o Adobe Learning Manager gera um evento de webhook dedicado diferente do webhook de conclusão de curso padrão, permitindo que as integrações apliquem uma lógica de tratamento diferente para conclusões alternativas. Os eventos do webhook também são gerados para conclusão retroativa e inconclusão retroativa, abrangendo alterações históricas no status do curso, incluindo aquelas orientadas por atualizações de relacionamentos, para que os sistemas externos permaneçam sincronizados com o estado de conclusão atual do aluno.

Para obter informações sobre webhooks para Alternativas, exiba Webhooks para Alternativas

Procedimento de migração de dados e conteúdo dataandcontentmigrationprocedure

O procedimento para migrar dados e conteúdo do LMS corporativo para o Learning Manager é descrito como se segue:

Analise os pré-requisitos do processo de migração antes de começar a migração. Consulte a seção Especificações do CSV e CSVs de amostra nesta página e prepare os CSVs para migração de dados e conteúdo.

Faça logon no aplicativo Learning Manager como administrador de integração e clique em Migração no painel esquerdo.

A página inicial Projetos de migração é exibida. Se sua empresa tiver criado projetos de migração, você pode visualizar a lista de todos os projetos de migração nesta página.
Clique em Novo no canto superior direito da página para criar um projeto de migração. Como alternativa, você pode clicar no link Criar um projeto de migração da página para criar um projeto de migração. É exibida a página Criar um projeto de migração.

Se você já não tiver criado uma pasta FTP, será solicitado que você crie uma pasta FTP na conta. Essa etapa é obrigatória para começar a criar um projeto de migração.

Criar pasta FTP

Forneça o nome do projeto, a etiqueta do projeto, o catálogo do curso e a descrição do seu projeto de migração. Clique em Criar.

Os itens de dados de migração são identificados usando essa etiqueta de projeto de migração. Se não tiver nenhum catálogo específico do curso, escolha o catálogo padrão na lista suspensa. Todos os cursos migrados usando um projeto de migração serão incluídos no catálogo escolhido nesse estágio. Se nenhum catálogo for escolhido, todos os cursos migrados farão parte do catálogo padrão.
A página de configuração do sprint é exibida conforme mostrada na seguinte captura de tela. Você deve criar um sprint como parte do projeto de migração. Escolha o nome do sprint e forneça uma breve descrição do sprint. Você pode escolher Sim se desejar migrar o conteúdo como parte desse sprint. Clique em Avançar.

Migração de sprint

Selecione a caixa de seleção com o título Os usuários foram adicionados ou modificados desde a última execução para sincronizar a lista de usuários com o aplicativo Learning Manager. Se estiver migrando dados e conteúdo para o aplicativo Learning Manager, talvez isso não seja obrigatório. Mas, se houver um lapso de tempo entre a migração anterior do sprint em relação à migração mais recente, a prática recomendada é optar por sincronizar a lista de usuários. Essa etapa permite que o banco de dados do Learning Manager esteja em sincronia com os usuários do LMS.

Essa etapa de sincronização é recomendada quando enrollment.csv e user_course_grade.csv são migrados. Essa etapa permite que o banco de dados do Learning Manager esteja em sincronia com o banco de dados de migração e garante que todos os usuários cujos registros a serem migrados no sprint estejam disponíveis no banco de dados de migração.
Você pode iniciar a migração do sprint com os dados e conteúdo carregados. Clique no link Atualizar antes de iniciar a Execução do sprint para sincronizar as pastas FTP e Conteúdo com o aplicativo Learning Manager.

Iniciar migração do sprint

Clique em Iniciar no canto superior direito da página. Você pode clicar em Parar a qualquer momento durante o processo de migração do sprint para anular a migração do sprint.

O status de migração é exibido em cada um dos itens de dados e conteúdo do sprint. Verifique o número de itens falhos e bem-sucedidos como parte da execução do sprint de migração.

Se estiver carregando o conteúdo do módulo, certifique-se de que o caminho da pasta de conteúdo seja fornecido no module_version.csv. Se não realizar essa etapa, podem ocorrer erros durante a migração. Por exemplo, se estiver carregando o conteúdo de um módulo de ritmo individualizado como vídeos, você precisa especificar o caminho relativo do URL do Box no module_version.csv. Para o conteúdo do módulo de atividade, você pode especificar o nome do URL.

É fornecida abaixo para referência a captura de tela da caixa de diálogo de andamento. Conforme mostrado na captura de tela, é possível ver o número de registros processados de cada item de dados de migração juntamente com o status de falha e êxito dos itens. Clique em Baixar registros de erro nos itens falhos para baixar e visualizar os registros de erro. É possível corrigir os problemas no CSV e carregá-lo novamente no FTP.

Exibir progresso do sprint

Clique na lista de sprints no painel esquerdo se quiser ver a lista de todos os sprints de um projeto de migração. Você pode exibir uma lista de todos os sprints, o número de execuções de cada sprint, a data de início, a duração e o status de conclusão, conforme mostrado na captura de tela abaixo.

Exibir lista de sprints
Após carregar os CSVs atualizados mais recentes, você pode clicar em Re-executar no canto superior direito da página. A opção Re-executar processa novamente todos os itens de dados, ignorando os itens que não possuem alterações. Quando estiver satisfeito com a migração dos itens de dados em um sprint, você pode marcar a migração do sprint como concluída clicando no botão na parte superior da página. Você pode iniciar um novo sprint com mais itens de dados mais tarde. Quando um sprint está marcado como concluído, você não pode executá-lo novamente. Da mesma forma, em um projeto de migração, é possível ter qualquer número de sprints. Quando estiver satisfeito com o status de migração de todos os sprints, você pode marcar o projeto de migração como concluído clicando no link Marcar projeto como concluído na página Lista de sprints.

Antes de marcar o projeto de migração como concluído, você deve garantir que todos os sprints do projeto estejam completos. Depois de marcar o projeto de migração como concluído, você não poderá voltar atrás e nem criar sprints nem fazer qualquer modificação nesse projeto. Você precisa criar outro projeto de migração e adicionar sprints a ele.

Verificação da migração registration

Depois de migrar os dados e o conteúdo de aprendizado do LMS legado da sua empresa, você pode verificar os dados e o conteúdo importados usando vários recursos do objeto de aprendizado. Por exemplo, você pode fazer login no aplicativo Learning Manager como administrador e verificar a disponibilidade dos dados e do conteúdo dos módulos e cursos importados.

Migração usando APIs

O Adobe Learning Manager (ALM) fornece um recurso de migração para assimilar dados ou conteúdo de sistemas externos, usado principalmente para migrar de plataformas LMS legadas.

No entanto, algumas organizações podem exigir que esse processo seja executado regularmente (por exemplo, durante a noite ou semanalmente), em vez de como uma importação única.

Como exemplo, você verá como um cliente fictício (NovaFX) se integra a um provedor externo fictício (SquareCorp) e automatiza migrações agendadas. A integração permite:

Os cursos da SquareCorp aparecem como objetos de aprendizado no ALM para alunos da NovaFX.
O NovaFX acompanha o progresso do aluno nos cursos hospedados pela SquareCorp diretamente no ALM.

Requisitos de integração

A SquareCorp deve fornecer:

Informações de metadados do curso: uma API para compartilhar metadados do curso à qual a NovaFX tem acesso.
Informações de dados de progresso: uma API para compartilhar informações periódicas sobre o progresso e a conclusão do aluno.

Definições de chave

Projeto ativo: um projeto estará ativo se estiver “Em andamento” ou “Inicializado”.
Sprint ativo: um sprint estará ativo se estiver “Em andamento” ou “Inicializado”.

Automatizar a execução do sprint

Crie um aplicativo ou script que execute o seguinte em um cronograma:

Buscar metadados do curso, inscrições do usuário e notas do aluno na SquareCorp.
Gere os arquivos CSV.
Carregue os arquivos no Box ou FTP.
Acione o sprint usando as APIs de migração.

Detalhes da API

Iniciar uma execução de migração

Ponto de extremidade: POST /primeapi/v2/bulkimport/startrun

Parâmetros:

lockaccount (booleano): o parâmetro determina se a conta deve ser bloqueada no início da execução. Por padrão, é definido como falso. Recomenda-se que os usuários evitem usar esse parâmetro, a menos que haja um motivo válido para bloquear a conta.
catalogid (Inteiro): Esse parâmetro permite selecionar o catálogo de destino durante a migração. Normalmente, é definido ao criar o projeto de migração, mas pode ser ajustado para execuções individuais. Quando a identificação do catálogo é alterada, os objetos de aprendizado adicionados em execuções futuras serão colocados no catálogo escolhido mais recentemente. Se for necessário voltar ao catálogo selecionado durante a criação do projeto de migração, isso também deverá ser especificado explicitamente.
migrationProjectId (Inteiro): O parâmetro é necessário para disparar um projeto de migração específico quando várias execuções habilitadas por API estiverem habilitadas na conta.

Verificar se a sincronização pode começar

Verifique se o conteúdo pode ser sincronizado com a pasta do sprint. Não copie conteúdo ou arquivos de metadados para a pasta FTP, a menos que essa API retorne um objeto de resposta bem-sucedido.

Ponto de extremidade: GET /primeapi/v2/bulkimport/cansync

Parâmetros:

migrationProjectId (Inteiro) O parâmetro é necessário para disparar um projeto de migração específico quando várias execuções habilitadas por API estiverem habilitadas na conta.

Êxito na resposta

{
    "status": "OK",
    "title": "BULKIMPORT_CAN_SYNC_NOW",
    "source": {
        "info": "Yes"
    }
}

Êxito na resposta

{
    "status": "BAD_REQUEST",
    "title": "BULKIMPORT_ERROR_CANNOT_SYNC",
    "source": {
        "info": "Error, No active projects"
    }
}

Possíveis respostas de API

Ação

Tipo

Mensagem

BULKIMPORT_RUN_INITIATED_SUCCESSFULLY

Êxito

Execução iniciada com êxito