Manuale di migrazione

Manuale di riferimento per gli Amministratori di integrazione che desiderano eseguire la migrazione di un LMS esistente all’LMS di Learning Manager

Scenario di utilizzo usagescenario

In generale, le aziende di grandi dimensioni dispongono di un proprio LMS interno o di un sistema di gestione dell’apprendimento legacy fornito da un qualsiasi rivenditore. Un LMS è costituito dai contenuti e dai dati di formazione dell’azienda. Quando un’azienda acquista Learning Manager, potrebbe essere nel suo interesse trasferire i contenuti e i dati LMS esistenti a Learning Manager in modo da sfruttare i vantaggi offerti da un LMS moderno e intuitivo senza perdere i propri dati legacy.

Learning Manager fornisce le specifiche e gli strumenti necessari in modo che l’Amministratore di integrazione dell’organizzazione sia in grado di configurare ed eseguire le attività di migrazione.

A partire da oggi, gli Amministratori di un’organizzazione possono accedere alla funzionalità di migrazione in Learning Manager contattando il team di supporto di Adobe. Per abilitare la funzionalità di migrazione nel tuo account, puoi rivolgerti al team di supporto di Adobe Learning Manager.

Processo di migrazione apidescription

I prerequisiti per la migrazione, i passaggi chiave del processo di migrazione, gli sprint di migrazione, le specifiche, i passaggi per la migrazione dei dati e dei contenuti sono spiegati in questa sezione come esposto di seguito:

Importante avviso sulla migrazione

Tenere presente che le tempistiche della migrazione dipendono in larga misura dalla qualità e dalle dimensioni dei dati. Se hai bisogno di migrazione durante l’onboarding, pianifica questa attività con largo anticipo e collabora strettamente con il team di onboarding di Adobe Learning Manager per evitare ritardi.

Prerequisiti prerequisites

Il team di Adobe Learning Manager prevede che gli Amministratori di integrazione dell’organizzazione effettuino le seguenti operazioni prima di intraprendere il processo di migrazione:

Learning Manager consiglia agli Amministratori di provare a eseguire il processo di migrazione in un account di prova prima di migrare dati e contenuti all’ambiente di produzione di Learning Manager.

Passaggi chiave del processo di migrazione keystepsofmigrationprocess

I passaggi chiave del processo di migrazione di contenuti e dati da un LMS esistente a Learning Manager sono i seguenti:

L’organizzazione può iniziare a utilizzare l’LMS di Learning Manager insieme ai contenuti legacy.

Area di validità degli oggetti di migrazione scopeofmigrationobjects

È possibile migrare i contenuti solo per i seguenti oggetti di apprendimento:

Concetti chiave della migrazione keyconceptsofmigration

Di seguito sono illustrati brevemente alcuni dei concetti chiave del processo di migrazione di Learning Manager, per un riferimento rapido:

Progetto di migrazione

In Learning Manager, un progetto di migrazione è costituito da uno o più sprint. Puoi avviare anche più progetti di migrazione per il tuo account. Il processo di migrazione in Learning Manager inizia con la creazione di un progetto di migrazione.

Sprint

Nel processo di migrazione di Learning Manager, uno sprint definisce un insieme di elementi di migrazione che si desidera migrare dall’LMS esistente. Un elemento di migrazione può essere un modulo del corso, il record di un Allievo o un insieme di corsi. In uno sprint possono essere presenti anche più elementi dati di apprendimento. È possibile eseguire processi di migrazione in ciascuno sprint.

Esecuzioni script

Esecuzione script è il processo di avvio di un processo di migrazione sprint. È possibile interrompere l’esecuzione dello sprint in qualsiasi momento.

Riesecuzioni script

È possibile rieseguire uno sprint di migrazione in seguito al completamento dello stesso in qualsiasi momento. Questa situazione di riesecuzione di uno sprint si verifica quando si desidera aggiungere i dati a una voce sprint ed eseguirne nuovamente la migrazione all’applicazione o correggere gli errori nei CSV.

Specifica CSV

Learning Manager offre un set di specifiche CSV standard. È consigliabile prendere visione delle specifiche CSV prima di avviare il processo di migrazione. L’Amministratore di integrazione della tua organizzazione può analizzare i formati di dati esistenti e mapparli in modo che corrispondano agli elementi del modello CSV forniti da Learning Manager.

Tag progetto di migrazione

Adobe Systems consiglia di utilizzare una serie di parole chiave come tag per identificare facilmente i progetti di migrazione all’interno dell’applicazione Learning Manager. Questi tag consentono di identificare i progetti all’interno dell’applicazione Learning Manager in qualsiasi momento.

Modulo senza contenuto

Learning Manager consente di caricare un modulo senza contenuto. Adobe Systems lo considera come modulo senza contenuto in Learning Manager. Per eseguire la migrazione di alcuni dati legacy dall’LMS esistente senza la necessità di alcun contenuto, è possibile caricare il file module_version.csv senza riferimento URL.

Specifiche CSV e CSV di esempio csv

Di seguito sono riportate le specifiche CSV aggiornate che puoi utilizzare per mappare i dati di migrazione LMS esistenti. Fai clic su csv-specifications e sample-csvs per scaricare i file zip. Il file csv-specific.zip scaricato contiene sette fogli Excel. I file Excel contengono specifiche accompagnate da descrizioni che illustrano come compilare i file .csv. I file .csv corrispondenti devono contenere i dati per ciascun campo nel formato prestabilito, come spiegato in questi file .xlsx.

Learning Manager supporta solo i valori di data e ora in formato UTF a 8 e 32 bit. È possibile che si verifichino errori durante la migrazione se nei file CSV viene indicata una data fuori intervallo come 2038-07-17T08:53:21.000Z o 1980-04-17T08:13:25.322Z.

È necessario essere consapevoli delle seguenti dipendenze dai file CSV durante l’importazione:

Ordine dei corsi del programma di apprendimento nei file CSV per la migrazione

Nelle versioni precedenti delle specifiche di migrazione, il file learning_program_course.csv includeva una colonna relativa all’ordine, a indicare che era possibile controllare la sequenza dei corsi all’interno di un programma di apprendimento durante la migrazione.

Adobe Learning Manager non utilizza più questa colonna. L’ordine dei corsi in un programma di apprendimento non può essere controllato tramite CSV di migrazione e il sistema ignora eventuali valori forniti nella colonna dell’ordine, anche se orderEnforced è stato impostato su true.

Per evitare confusione, la colonna dell’ordine è stata rimossa dalle specifiche CSV ufficiali. Se disponi di script o strumenti esistenti che generano ancora questa colonna, puoi eliminarla in modo sicuro; ciò non ha alcun impatto sulla creazione o la visualizzazione dei programmi di apprendimento.

Procedura di migrazione migrationprocedure

Prima di avviare la procedura di migrazione, è importante tenere conto dei seguenti aspetti:

Creazione di account FTP e Box creatingftpandboxaccounts

Pianificare il progetto di migrazione è molto importante. È consigliabile suddividere i progetti in più sprint e identificare chiaramente i dati di cui si desidera effettuare la migrazione in ciascuno sprint. Potrebbe inoltre essere una buona idea eseguire una convalida dopo ogni sprint per essere sicuri di aver eseguito la migrazione dei dati corretti nello sprint in questione, anziché limitarsi a un’unica convalida al termine del progetto. Prima di avviare lo sprint come parte del progetto di migrazione, è necessario caricare i file CSV di dati e contenuti nei server FTP e Box rispettivamente. Se non disponi di account per FTP personalizzato e Box, puoi crearli.

Creazione di un account Box

Crea la cartella di caricamento dei contenuti seguendo un procedimento analogo a quello seguito per la creazione della cartella FTP. Fai clic su Migrazione nel riquadro di sinistra e seleziona Richiedi cartella di caricamento contenuti nella parte inferiore della pagina visualizzata.

Riceverai un’e-mail da Box con il link alla cartella condivisa. Se non disponi di un account Box, fai clic su Iscrizione e creane uno. Le istruzioni di accesso vengono inviate all’ID e-mail dell’Amministratore di integrazione.

Caricamento di dati (file .csv) in cartelle FTP o Box

La creazione di un account FTP o Box costituisce un prerequisito ai fini dello sviluppo di un progetto di migrazione. In questa fase puoi creare un progetto di migrazione e uno sprint nell’applicazione Learning Manager. Fai riferimento alla sezione relativa alla Procedura di migrazione di dati e contenuti in questa pagina per creare un progetto di migrazione.

Nell’account FTP o Box, fai clic sul nome della cartella dei progetti e quindi sul nome dello sprint. All’interno della cartella degli sprint, puoi caricare i file di dati .csv di cui desideri eseguire la migrazione. Per caricare, fai clic sul pulsante Carica file in alto nel server FTP o Box e rilascia i file .csv. Di seguito è riportata un’istantanea di esempio dopo il caricamento su FTP come riferimento.

Puoi tornare al progetto di migrazione di Learning Manager, fare clic su Aggiorna e visualizzare tutti i tipi di dati .csv elencati nello sprint di migrazione.

Caricamento dei contenuti di formazione nelle cartelle di contenuto

Carica i contenuti di formazione dell’LMS esistente nel tuo account Box. Se hai già creato lo sprint e il progetto di migrazione, l’account Box popolerà il campo relativo al nome di sprint e progetto di migrazione. Puoi caricare i contenuti nello stesso percorso. Fai riferimento alla sezione relativa alla Procedura di migrazione di dati e contenuti in questa pagina per creare un progetto di migrazione.

È possibile trascinare e rilasciare i file di contenuto oppure fare clic su Carica e selezionare i file dal desktop. Se le dimensioni del file dei contenuti sono troppo grandi, si potrebbe verificare un ritardo nel caricamento dei file. Il tempo necessario per caricare i file nel tuo account Box varia a seconda delle dimensioni del file.

Di seguito viene mostrata, come riferimento, un’istantanea di esempio dell’account Box in seguito al caricamento dei contenuti:

File nell’account Box

Una volta caricati i file nel tuo account Box, assicurati di specificare il percorso relativo di questo file di contenuto Box nel file module_version.csv. Indicare il percorso dei contenuti del modulo è un passaggio obbligatorio.

Una volta effettuato l’accesso ai server FTP e Box e caricato il contenuto, i percorsi CSV vengono visualizzati come mostrato nell’istantanea riportata di seguito in Learning Manager.

Percorsi CSV nell’account Box

Migrazione per alternative ed equivalenti

Panoramica

Questo argomento descrive il modello di dati basato su CSV e il comportamento di migrazione per l’introduzione dell’equivalenza degli oggetti di apprendimento (LO) nel sistema.

File CSV esistenti (contesto)

Questi file CSV esistono già nella piattaforma e forniscono l’oggetto di apprendimento principale, il modulo e il contesto di completamento (elenco non esaustivo):

Questi file continuano a essere utilizzati così come sono e non vengono modificati dalla nuova funzione di equivalenza, ma formano i dati sottostanti su cui opererà l’equivalenza.

Nuovi file CSV per alternative

Sono stati introdotti due nuovi CSV per supportare le relazioni alternative GLI e i relativi completamenti da parte degli utenti.

​1. equivalence_relations.csv

Definisce le mappature di equivalenza tra gli oggetti di apprendimento (LO) di origine e di destinazione, che possono essere corsi o percorsi di apprendimento (LP).

Schema:

Scopo:

equivalence_user_completion.csv

Acquisisce informazioni di completamento a livello di utente per oggetti di apprendimento equivalenti, in linea con le relazioni definite in equivalence_relations.csv.

Schema:

Scopo:

Regole di migrazione e semantica comportamentale

​1. Nessun supporto Retrofit per i nuovi file CSV equivalenti

Ciò significa che:

​2. Nessun completamento/incompletamento retroattivo da relazioni migrate

Quando viene introdotta una relazione di equivalenza tramite migrazione (ovvero tramite equivalence_relations.csv):

Implicazione:

​3. Comportamento per i nuovi completamenti dopo la migrazione

Se:

quindi:

Distinzione chiave:

​4. Impatto sugli oggetti di apprendimento di ordine superiore

I completamenti alternativi in arrivo tramite CSV (ad esempio, tramite equivalence_user_completion.csv) attiveranno la ricalcolo degli LO di ordine superiore.

Gli LO di ordine superiore possono includere:

Implicazioni tecniche:

Webhook per alternative

Quando un Allievo completa un corso tramite un’iscrizione alternativa o una relazione, Adobe Learning Manager genera un evento webhook dedicato distinto dal webhook di completamento del corso standard, che consente alle integrazioni di applicare una logica di gestione diversa per i completamenti alternativi. Gli eventi webhook vengono generati anche per il completamento retroattivo e l’incompletamento retroattivo, che coprono le modifiche storiche allo stato del corso, comprese quelle guidate dagli aggiornamenti delle relazioni, in modo che i sistemi esterni rimangano sincronizzati con lo stato di completamento corrente dell’Allievo.

Per informazioni sui webhook per Alternative, visualizza Webhook per Alternative

Procedura di migrazione di dati e contenuti dataandcontentmigrationprocedure

La procedura per migrare i contenuti e i dati LMS dell’azienda a Learning Manager viene illustrata di seguito:

Prendi visione dei prerequisiti del processo di migrazione prima di avviare la migrazione. Fai riferimento alla sezione Specifiche CSV e CSV di esempio in questa pagina e preparare i CSV per la migrazione dei dati e dei contenuti.

Verifica migrazione registration

Dopo aver eseguito la migrazione dei dati e dei contenuti di formazione dall’LMS legacy della tua organizzazione, verifica i dati e i contenuti importati utilizzando le varie funzionalità degli oggetti di apprendimento. Ad esempio, è possibile accedere all’applicazione Learning Manager come Amministratore e verificare la disponibilità dei dati e dei contenuti relativi ai moduli e ai corsi importati.

Migrazione tramite API

Adobe Learning Manager (ALM) fornisce una funzione di migrazione per il caricamento di dati o contenuti da sistemi esterni, utilizzata principalmente per la migrazione da piattaforme LMS legacy.

Tuttavia, alcune organizzazioni potrebbero richiedere che questo processo venga eseguito regolarmente (ad esempio, di notte o settimanalmente), anziché come importazione singola.

Ad esempio, puoi vedere come un cliente fittizio (NovaFX) si integra con un fornitore esterno fittizio (SquareCorp) e automatizza le migrazioni pianificate. L’integrazione consente di:

Requisiti di integrazione

SquareCorp deve fornire:

Definizioni chiave

Automatizzare l’esecuzione dello sprint

Crea un’app o uno script che esegue quanto segue secondo una pianificazione:

Dettagli API

Avviare un’esecuzione della migrazione

Endpoint: POST /primeapi/v2/bulkimport/startrun

Parametri:

Verifica se la sincronizzazione può iniziare

Assicurati che il contenuto possa essere sincronizzato con la cartella sprint. Non copiare i file di contenuto o metadati nella cartella FTP a meno che questa API non restituisca un oggetto risposta corretto.

Endpoint: GET /primeapi/v2/bulkimport/cansync

Parametri:

Risposta riuscita

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

Risposta riuscita

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

Possibili risposte API

Esempio di flusso di integrazione

Limitazioni

Le API di migrazione non forniscono funzionalità per controllare gli errori relativi alla migrazione direttamente nel file CSV di output dopo l’esecuzione dello sprint. Tuttavia, questi errori possono essere esaminati come righe all’interno del file CSV accedendo all’interfaccia utente dell’Amministratore di integrazione dopo un’esecuzione sprint.

Verifica della migrazione tramite API

L’API di migrazione, runStatus, consente agli amministratori di integrazione di tenere traccia dell’avanzamento delle esecuzioni di migrazione attivate tramite l’API.

L’API runStatus fornisce inoltre un collegamento diretto per scaricare i registri degli errori in formato CSV per le esecuzioni completate. Il collegamento per il download rimane attivo per sette giorni e i registri vengono conservati per un mese.

Curva di esempio

Endpoint

GET /bulkimport/runStatus

Parametri

Risposta

{
  "sprintId": 2510080,
  "sprintRunId": 2740845,
  "migrationProjectId": 2509173,
  "startTime": 1746524711052,
  "endTime": 1746524711052,
  [
    {
      "id": 2609923,
      "lastHeartbeatTime": 1746524711052,
      "objectName": "content",
      "jobState": "COMPLETED",
      "errorCsvLink": "",
      "errorLogLink": "migration/5830/2509173/2510080/2740845/content_err.csv",
      "sequenceNumber": 1
    },
    {
      "id": 2609922,
      "lastHeartbeatTime": 1746524713577,
      "objectName": "course",
      "jobState": "WAITING_IN_QUEUE",
      "errorCsvLink": "",
      "errorLogLink": null,
      "sequenceNumber": 2
    }
  ]
}

Inoltre, la risposta API startRun ora include l’ID del progetto di migrazione, l’ID dello sprint e l’ID dell’esecuzione dello sprint, necessari per eseguire una query sul nuovo endpoint di stato.

curl -X GET --header 'Accept: text/html' 'https://learningmanager.adobe.com/primeapi/v2/bulkimport/runStatus?migrationProjectId=001&sprintId=10001&sprintRunId=7'

Fornisce la seguente risposta. La risposta contiene:

Risposta

{
  "status": "OK",
  "title": "BULKIMPORT_RUN_INITIATED_SUCCESSFULLY",
  "source": {
    "info": "Success",
    "migrationInfo": {
      "migrationProjectId": "001",
      "sprintId": "10001",
      "sprintRunId": "7"
    }
  }
}

Aggiornamento nella migrazione retrofittinginmigration

Questa funzionalità di integrazione consente di trasformare i dati storici di un oggetto di apprendimento da un sistema di gestione dell’apprendimento legacy a un corso attivo creato in Learning Manager.

Di seguito sono riportate le specifiche CSV aggiornate che puoi utilizzare per mappare i dati di migrazione LMS esistenti. Fai clic su csv-specifications e sample-csvs per scaricare i file zip. Il file csv-specifications.zip scaricato contiene quattro file Excel. I file Excel contengono specifiche accompagnate da descrizioni che illustrano come compilare i file .csv. I file .csv corrispondenti devono contenere i dati per ciascun campo nel formato prestabilito, come spiegato in questi file .xlsx.

1-enrollment.xlsx contiene le descrizioni dei metadati richiesti per il file retrofit_enrollment.csv.

2-certification_enrollment.xlsx contiene le descrizioni dei metadati richiesti per il file retrofit_certification_enrollment.csv.

3-learning_program_enrollment.xlsx contiene le descrizioni dei metadati richiesti per il file retrofit_learning_program_enrollment.csv.

4-user_course_grades.xlsx-contiene le descrizioni dei metadati richiesti per il file retrofit_user_course_grades.csv.
csv-specific.zip

Risoluzione dei problemi di migrazione troubleshootingmigrationissues

Consulta questo articolo per conoscere la soluzione ai problemi affrontati dagli Amministratori di integrazione durante la migrazione di dati e contenuti dall’LMS esistente all’applicazione Learning Manager.

Suggerimenti per la gestione degli utenti usermanagement

In questo argomento vengono forniti alcuni suggerimenti utili per capire in che modo vengono considerati e gestiti gli utenti in Learning Manager. Questi concetti ti aiuteranno a gestire meglio gli utenti durante l’utilizzo dell’importazione CSV, dei connettori e delle funzionalità di migrazione di Learning Manager.

ID Learning Manager captivateprimeids

Learning Manager fornisce due tipi di ID univoci per gli utenti:

Learning Manager supporta UUID per fornire flessibilità alle organizzazioni nel controllo degli account utente. Come amministratore, se disponi di un UUID degli utenti in un account, puoi modificare gli ID e-mail degli utenti per quell’account.

Scenario di utilizzo dell’UUID in un’organizzazione

Consideriamo uno scenario in cui un dipendente A entra a far parte di un’azienda denominata Learning Manager, come appaltatore. Durante il periodo del contratto, l’azienda di Learning Manager potrebbe non fornire l’ID e-mail dell’azienda come A@example.com, ma considerare solo l’account e-mail personale del dipendente, ad esempio A@gmail.com. Dopo aver completato 6 mesi di periodo di contratto, se lo stesso dipendente A si aggiunge a Learning Manager come dipendente a tempo pieno, Learning Manager potrebbe voler modificare il suo ID e-mail con l’ID e-mail dell’azienda: A@example.com.

L’accesso UUID all’account utente rappresenta un vantaggio per Learning Manager nello scenario sopra citato. Learning Manager può facilmente sostituire l’ID e-mail personale del dipendente A con un ID e-mail ufficiale. I record del dipendente rilevanti per questo account non sono interessati da questa modifica.

Identificazione utente singolo singleuseridentification

Learning Manager identifica e ricorda la modalità con cui viene aggiunto un utente singolo, ad esempio mediante registrazione automatica, tramite caricamento CSV, oppure utilizzando l’interfaccia utente o tramite API.

Assegnazione del ruolo di Manager assigningmanagerrole

Non è possibile assegnare direttamente un ruolo di Manager a un qualsiasi utente in Learning Manager. Un utente X può diventare Manager Learning Manager solo se viene impostato un attributo Manager di qualsiasi utente (ad esempio, Y) in quell’account come X.

In uno scenario in cui X è Manager degli utenti, ad esempio, A, B e C, se X lascia l’organizzazione, è necessario assicurarsi che l’attributo Manager di A, B e C sia impostato sul nuovo Manager. In alternativa, è possibile impostare temporaneamente l’attributo Manager di questi utenti come ROOT e assegnare il nuovo nome Manager in un secondo momento.

Per ulteriori informazioni su questo argomento, consulta il seguente contenuto della Guida:

Modifiche API

La versione di aprile 2026 di Adobe Learning Manager offre miglioramenti mirati all’API pubblica nelle aree delle alternative e degli equivalenti, dell’accesso ai contenuti con finestra di tempo, dei tentativi di quiz basati sui contenuti, delle esperienze degli Allievi non registrate e della gestione delle risorse formative. Questi aggiornamenti sono progettati per rimanere ampiamente compatibili con le versioni precedenti, consentendo al contempo modelli di integrazione più precisi ed estensibili.

Per le modifiche API, visualizza Modifiche API.

Migrazione della sessione VILT a Adobe Learning Manager migrationofviltsessiontoalm

Adobe Learning Manager supporta la migrazione in blocco e l’aggiornamento dei dati delle sessioni di formazione con istruttore virtuale (VILT) tramite file CSV. Utilizza questo flusso di lavoro per configurare le date di inizio dell’istanza, associare le istanze del percorso di apprendimento alle istanze del corso e configurare le sessioni in aula virtuale per Microsoft Teams, Adobe Connect e Zoom.

Migrazione di sessioni VILT basate su CSV

La migrazione a Adobe Learning Manager consente agli amministratori di creare o aggiornare in blocco i contenuti di apprendimento utilizzando file CSV strutturati. Puoi applicare questi flussi di lavoro CSV sia ai corsi di migrazione (contenuti importati da un sistema esterno) che ai corsi di adeguamento (contenuti creati direttamente nell’app Autore ALM).

Quattro file CSV sono coinvolti nella migrazione delle sessioni VILT:

Scarica i file sopra riportati qui.

Tutti e quattro i file CSV accettano almCourseID come riferimento ai corsi e almModuleID come riferimento ai moduli. Questi ID sono gli identificatori univoci assegnati da ALM quando viene creato un corso o un modulo.

Impostare la data di inizio per le istanze del corso e del percorso di apprendimento

Utilizza il file CSV e il file CSV dell’istanza del corso per aggiungere o aggiornare la data di inizio di un’istanza. Questo vale sia per le istanze create tramite migrazione che per quelle create tramite interfaccia utente (retrofit).

CSV istanza corso: aggiungere una data di inizio

CSV istanza LP: aggiungere una data di inizio

Associare le istanze del percorso di apprendimento alle istanze del corso

Utilizza il file CSV di associazione LP a istanza di corso per collegare un’istanza del percorso di apprendimento a un’istanza di corso specifica. Questo passaggio è richiesto per i corsi VILT che fanno parte di un percorso di apprendimento.

Scenari di associazione supportati

Non tutte le combinazioni di origini di migrazione e retrofit sono supportate. Prima di creare il file CSV, consulta la tabella riportata di seguito.

Configurazione dei dettagli della sessione aula virtuale

Utilizza il file CSV sessione per creare o aggiornare le sessioni VILT con i dettagli delle conferenze in aula virtuale. Per supportare questa operazione, nel file CSV della sessione sono state aggiunte quattro colonne:

Formato dei metadati per sistema di conferenza

Il campo metadata accetta un oggetto JSON. La struttura varia a seconda del sistema di conferenza. Tutti i nomi chiave sono con distinzione tra maiuscole e minuscole e devono utilizzare camelCase esattamente come mostrato.

Microsoft Teams

{
  "organizerEmail": "user@example.com",
  "coOrganizerEmail": "user2@example.com",
  "lobbyBypass": true,
  "isCompletionCriteria": false
}

Tutti i campi dei metadati Teams sono facoltativi. Se non fornisci organizerEmail, ALM utilizza l’e-mail di amministratore Teams configurata nel tuo account ALM come organizzatore predefinito.

Adobe Connect

{
  "primaryInstructor": "instructor@example.com",
  "persistentRoom": true,
  "templateID": "template-id-value"
}

Il campo primaryInstructor è obbligatorio per le sessioni Adobe Connect. Tutti gli altri campi sono facoltativi. Puoi fornire persistentRoom o templateID. Se fornisci templateID, ALM crea la room utilizzando tale modello.

Zoom

Zoom non richiede un oggetto JSON metadati. Passa l’istruttore della sessione utilizzando la colonna dell’istruttore standard nel file CSV della sessione.

Carica il file CSV della sessione

Risoluzione degli errori di migrazione più comuni

Migrazione dei moduli LTI migrationofltimodules

Panoramica

La migrazione LTI estende il flusso di lavoro di migrazione esistente e non richiede file di migrazione aggiuntivi. I record esistenti relativi alle associazioni di corsi, moduli e moduli continuano a utilizzare il formato di migrazione standard. Le informazioni specifiche dell’LTI vengono fornite tramite i dati di versione del modulo.

Utilizza i file per la migrazione LTI

I moduli LTI vengono migrati utilizzando i file di migrazione standard.

I seguenti file continuano a utilizzare il formato di migrazione esistente:

In questi file non sono richiesti campi specifici dell’LTI. Le impostazioni specifiche dell’LTI sono configurate nel file module_version.csv.

Configurare una versione del modulo LTI

Utilizzare il file module_version.csv per definire le proprietà di una versione del modulo LTI.

Oltre ai campi esistenti supportati in module_version.csv, Adobe Learning Manager supporta valori e attributi specifici dell’LTI.

contentType

Utilizzare il valore LTI nel campo contentType per identificare la versione del modulo come modulo LTI.

Campo e valore utilizzati per identificare una versione del modulo LTI

ltiLaunchUrl

Specifica l’URL di avvio del provider LTI esterno.

Quando un Allievo avvia il modulo in Adobe Learning Manager, viene reindirizzato all’endpoint LTI configurato.

Campo utilizzato per specificare l’URL di avvio del provider LTI esterno

ltiCustomParams

Specifica i parametri di avvio personalizzati passati al provider LTI durante l’avvio.

Utilizza questo campo quando la piattaforma esterna richiede un contesto di avvio o parametri di configurazione aggiuntivi.

Campo utilizzato per passare parametri di avvio personalizzati al provider LTI

tpName

Specifica il nome del provider LTI di terze parti associato al modulo.

Campo utilizzato per identificare il provider LTI di terze parti

Versione del modulo LTI di esempio

Nell’esempio seguente viene illustrato un record di versione del modulo configurato per un modulo LTI:

moduleId,moduleVersion,contentType,dateCreated,duration,desiredDuration,contentUrl,hasQuiz,ltiLaunchUrl,ltiCustomParams,tpName
2024101905,1,LTI,2024-10-19T09:55:21.123Z,60,60,,,https://m42almintegrationsv01.moodlecloud.com/enrol/lti/launch.php,"id=8600f9a1-256f-4a0c-bcfc-36377eba8ae1
param=1",DND_Moodle_isProducer

In questo esempio:

Migrare un modulo LTI

Per migrare un modulo LTI:

Il framework di migrazione elabora il modulo LTI come parte del flusso di lavoro di migrazione standard.

Convalida versioni modulo LTI

Quando si creano le versioni del modulo LTI:

Il sistema di migrazione applica il flusso di lavoro di elaborazione della migrazione standard oltre ai campi specifici dell’LTI.

Migrazione della gerarchia di cartelle dei contenuti migratecontentfolderhierarchy

Se stai eseguendo la migrazione dei contenuti di apprendimento da un’altra piattaforma a Adobe Learning Manager e desideri mantenere l’organizzazione delle cartelle esistente, puoi utilizzare i file CSV per creare una struttura gerarchica di cartelle e associare i file di contenuti alle cartelle appropriate.

Questa migrazione viene in genere eseguita come parte di una migrazione di piattaforma più ampia, dopo che utenti, corsi, moduli e file di contenuti sono già stati importati in Adobe Learning Manager. Questo passaggio di migrazione riorganizza il contenuto nella struttura di cartelle presente nel sistema di origine.

Funzionalità della migrazione

La migrazione delle cartelle dei contenuti crea fino a tre livelli di cartelle nidificate nella Libreria dei contenuti di Adobe Learning Manager e associa i file di contenuto esistenti alle sottocartelle corrette. I collegamenti del corso e del modulo ai file dei contenuti non sono interessati. Viene modificata solo l’organizzazione della cartella.

La migrazione viene eseguita come processo in background asincrono. Carichi un file CSV, i processi di migrazione in background e puoi monitorare l’avanzamento durante il funzionamento del sistema. La migrazione può essere rieseguita se sono necessarie correzioni; le righe che sono già state elaborate correttamente vengono automaticamente ignorate in un’esecuzione successiva.

Due fasi della migrazione

La migrazione della cartella dei contenuti ha due fasi indipendenti. Ciascuno può essere eseguito e convalidato separatamente.

La fase 2 non richiede un file CSV separato: aggiungi una colonna del percorso della cartella al file module_version.csv esistente.

Fase 1: creazione della gerarchia di cartelle

Pianificare prima la gerarchia delle cartelle

Prima di preparare il file CSV, mappa la struttura di cartelle o categorie del sistema di origine alla gerarchia a tre livelli di Adobe Learning Manager. Adobe Learning Manager supporta una profondità massima di tre livelli (Livello 1 → Livello 2 → Livello 3). Se il sistema di origine ha una nidificazione più profonda, uniscilo a tre livelli prima di eseguire la migrazione.

content_folder.csv

Utilizzare content_folder.csv per definire la gerarchia delle cartelle di destinazione. Ogni riga del file rappresenta una cartella.

Riferimento colonna:

Esempio:

id,name,description,parentExternalId,action
folder_001,Training,,, CREATE_FOLDER
folder_002,Sales,,folder_001,CREATE_FOLDER
folder_003,Onboarding,,folder_002,CREATE_FOLDER
folder_004,HR,,,CREATE_FOLDER
folder_005,Compliance,,folder_004,CREATE_FOLDER

In questo esempio:

Regole di convalida:

Fase 2: Associare i contenuti alle cartelle

I file di contenuto sono associati alle cartelle tramite la colonna folder nel file module_version.csv. Per questa fase non è richiesto alcun file CSV separato.

Aggiornamento della colonna module_version.csv: folder

La colonna folder in module_version.csv ora supporta i percorsi di cartella oltre ai nomi di cartella semplici.

Esempio:

moduleId,moduleVersion,contentType,...,folder
MOD001,1,content,...,Training/Sales/Onboarding
MOD002,1,content,...,HR/Compliance
MOD003,1,content,...,"Training/Sales,HR/Compliance"
MOD004,1,content,...,Marketing

Ordine di migrazione

Quando esegui una migrazione completa dei contenuti, carica ed elabora i file nel seguente ordine:

Convalida e riferimento di errore

Adobe Learning Manager convalida ogni riga in content_folder.csv prima dell’elaborazione. Le righe che non superano la convalida vengono ignorate e segnalate come errori. Le righe valide nello stesso file continuano a essere elaborate.

Compatibilità con le versioni precedenti

Se utilizzi già content_folder.csv o module_version.csv nei flussi di lavoro di migrazione, i file esistenti continueranno a funzionare senza modifiche.

Procedure ottimali

Preparazione di content_folder.csv

Preparazione di module_version.csv con percorsi di cartella

Esecuzione della migrazione