Loading

Domande frequenti sullo Strumento di migrazione a Lightning Knowledge

Data pubblicazione: Mar 2, 2022
Risoluzione

Perché l'Assistente di migrazione a Lightning Experience non è disponibile in Imposta in Lightning anche se lo strumento è disponibile in versione definitiva?
Come si abilita e si avvia il test della funzione?

Tutti i clienti devono leggere attentamente e per intero tutta la documentazione esistente, Strumento di migrazione a Lightning Knowledge per assicurarsi di essere candidati idonei e comprendere completamente le funzioni e la funzionalità dello strumento prima di utilizzarlo.

In una situazione ideale, i clienti hanno a disposizione un Sandbox copia completa recente utilizzabile per l'esecuzione dello strumento. Prendere in considerazione il provisioning di una licenza Sandbox copia completa temporanea per il team account, se attualmente non ne è disponibile alcuna.


Come si abilita il test in produzione?
 

Al termine del test completo nel Sandbox, prima che sia possibile abilitare il test in produzione, il team di gestione del prodotto deve eseguire il processo di revisione e approvazione. Registrare un nuovo caso di assistenza facendo riferimento alle istruzioni in Lightning Knowledge Migration Tool availability (Disponibilità dello Strumento di migrazione a Lightning Knowledge) per avviare il processo.

Nota: non è disponibile un SLA per la revisione, l'approvazione e l'abilitazione della funzione in produzione. Avviare il processo e comunicare tempistiche approssimative con buon anticipo rispetto alle date pianificate, poiché il completamento del processo di revisione per l'ambiente di produzione può richiedere 1 - 2 settimane. Le nuove richieste di approvazione inviate durante i week-end o le ferie vengono esaminate o elaborate solo il giorno lavorativo successivo. I team di assistenza e di gestione del prodotto fanno del proprio meglio per evadere le richieste in modo tempestivo, ma non vi è alcuna garanzia che l'abilitazione avvenga entro le tempistiche stabilite.



Esiste un modo per identificare gli articoli di cui non è stata eseguita la migrazione nella pagina 'Conferma i risultati della migrazione'?

Secondo quanto indicato dalla documentazione, "Durante la migrazione, un file di risultati denominato LightningKnowledgeMigrationResultIndicazioneOraria.txt viene generato nell'oggetto File standard. Il proprietario di questo file è l'amministratore che ha avviato la migrazione". Riferimento: Esecuzione della migrazione: organizzazioni di più tipi di articoli

È possibile trovare il file contenente gli articoli e le versioni degli articoli la cui migrazione non è riuscita cercando File tramite la ricerca globale. Il nome del file o dei file dovrebbe avere il formato 'LightningKnowledgeMigrationResult*', che deve essere utilizzato come termine di ricerca per individuare i file all'interno dell'organizzazione.

Nota: questo file, generato se non è stata effettuata la migrazione di articoli o di versioni di articoli, fornisce solo i primi 1000 ID record a scopo di esame e riferimento. Lo strumento non comprende né fornisce i motivi della mancata migrazione degli articoli. Questi dettagli non sono disponibili presso l'Assistenza e il clienti devono esaminare manualmente gli articoli in questione per rilevare discrepanze e problemi. Se per alcuni articoli e versioni di articoli la migrazione risulta riuscita, nel file è riportata questa informazione, indipendentemente dal fatto che per altri dati aggiuntivi la migrazione possa non essere riuscita.

Se si desidera visualizzare dettagli aggiuntivi della migrazione rilevati dallo strumento, considerare la creazione o la promozione di un'Idea in IdeaExchange per favorirne la visibilità e la considerazione presso il pubblico più ampio della Trailblazer Community e per tenere traccia di possibili ottimizzazioni delle funzioni dello strumento.


È possibile mantenere la numerazione precedente degli articoli?

No. Se si esegue una migrazione di più articoli a Lightning Knowledge, non è possibile controllare la modifica dei numeri degli articoli. L'opzione per il mantenimento della numerazione precedente degli articoli non è disponibile a causa dei limiti del codice dell'applicazione relativa al tipo di file numerazione automatica standard.

Nota: per le migrazioni di articoli singoli, la numerazione viene mantenuta e non cambia. Per la migrazione di articoli singoli, infatti, il processo di migrazione non ricrea gli articoli.


Che cosa avviene quando si esegue una migrazione di articoli singoli?

In base alla progettazione, è previsto che le migrazioni di articoli singoli mostrino i seguenti comportamenti, a seconda delle selezioni effettuate al punto 4 della documentazione Migrazione di un solo tipo di articolo:
 
  • 'Assegna a un nuovo tipo di record chiamato...' - Il nome del tipo di articolo esistente viene utilizzato per il nome API dell'oggetto. Tuttavia, l'etichetta dell'oggetto Knowledge viene modificata in 'Knowledge'.
 
  • 'Crea manualmente nuovi tipi di record in un secondo momento' - Il nome del tipo di articolo esistente viene utilizzato per l'etichetta e il nome API dell'oggetto Knowledge e NON viene modificato in Knowledge (Knowledge__kav).

Dopo che si è fatto clic su 'Inizia', nell'interfaccia utente dello strumento non sono visualizzati ulteriori passaggi, pagine di conferma o indicazioni di avanzamento e in Imposta non è più presente alcuna visualizzazione. La migrazione viene eseguita in background. Gli amministratori dovrebbero ricevere una notifica via email al termine del processo di migrazione.
 

Come si risolvono i problemi di altri dati la cui migrazione non è riuscita?
 
In base alla progettazione corrente, lo strumento indica solo gli ID degli articoli e delle versioni per i quali la migrazione non è riuscita. Non sono disponibili dettagli specifici sui motivi per cui la migrazione di articoli o di altri aspetti non è riuscita. L'Assistenza Salesforce non è in grado di fornire ai clienti i dettagli sui motivi per cui la migrazione di dati specifici ha avuto esito negativo. Questo livello di dettaglio non fa parte delle informazioni di output dello strumento e non viene fornito dalla funzionalità corrente dello strumento stesso.

Lo Strumento di migrazione non garantisce un tasso di riuscita del 100% e la mancata migrazione di alcuni dati non indica necessariamente un problema imprevisto risolvibile direttamente con modifiche specifiche all'organizzazione o modifiche all'interno dello strumento stesso. L'intento dello strumento è di aiutare i clienti nella migrazione a Lightning Knowledge. Lo strumento non è una soluzione end-to-end garantita. Se i risultati non sono soddisfacenti, annullare l'operazione per poterla ritentare assicurandosi di aver seguito tutti i consigli riportati nella documentazione disponibile dello strumento e di utilizzare un Sandbox completo aggiornato di recente.

I potenziali errori di migrazione richiedono un intervento da parte del cliente, che deve eseguire un'attenta analisi e assicurarsi che i risultati siano soddisfacenti per i propri requisiti particolari. È compito del singolo cliente esaminare i risultati della migrazione ed eseguire una propria analisi per determinare se è opportuno procedere o meno. Lo strumento viene fornito così com'è, non intende essere una soluzione completa ma è invece solo un mezzo per offrire assistenza ai clienti per la migrazione a Lightning Knowledge.

Il controllo e la verifica manuale dei dati per l'accettazione o l'annullamento dei risultati della migrazione in base ai dettagli disponibili dello strumento o al comportamento del cliente non sono compresi nell'ambito dei servizi offerti dall'Assistenza.


Chi riceve l'email di riepilogo della migrazione?

Tutti gli utenti attivi a cui è assegnato un profilo con l'autorizzazione 'Modifica tutti i dati' nell'organizzazione in cui lo strumento viene eseguito ricevono l'email di riepilogo. Non esiste un metodo con cui modificare questo comportamento, che è una funzionalità codificata dello strumento.

Se gli amministratori non ricevono le email, assicurarsi di controllare la validità dell'indirizzo email specificato nel record utente e impostare la consegna messaggio email almeno su "Solo email di sistema". Per maggiori dettagli, vedere Linee guida per la configurazione delle impostazioni di consegna per i messaggi inviati da Salesforce. 


Perché la migrazione richiede così tanto tempo?

Il tempo di completamento dipende dalla dimensione della Knowledge Base in corso di migrazione e dal numero di altri processi in esecuzione in quel momento.

Non è definito un periodo di tempo previsto o un SLA per il completamento della migrazione e il processo può impiegare da diversi giorni fino a oltre una settimana e più, a seconda della dimensione e del grado di personalizzazione della Knowledge Base.

I processi di migrazione sono un sistema chiuso e non è possibile per l'Assistenza o il team di prodotto accelerare o ridurre il tempo di elaborazione. Tuttavia, se si ritiene che si stia verificando un problema imprevisto, registrare un caso con l'Assistenza Salesforce per controllare lo stato attuale della migrazione.


Perché quando si tenta di annullare la migrazione viene visualizzato il messaggio 'I tipi di articoli non hanno lo stato corretto per l'annullamento' o 'Il tipo di articolo Knowledge non si trova nello stato corretto'?

È noto che questi errori si verificano quando i tipi di articolo precedenti o nuovi sono stati modificati manualmente durante la migrazione, ad esempio se alcuni tipi di articolo sono stati eliminati o se lo stato della distribuzione di questi è stata modificata manualmente in Imposta durante la migrazione.

Esaminare Itinerario di controllo impostazioni dell'organizzazione per annullare eventuali modifiche correlate all'impostazione di Knowledge e ritentare l'annullamento. Per maggiori dettagli, vedere Monitoraggio delle modifiche alle impostazioni.

Se durante la migrazione sono stati eliminati tipi di articolo, non è disponibile alcuna soluzione temporanea ed è necessario aggiornare il Sandbox e iniziare di nuovo da zero. Se l'aggiornamento non è possibile, contattare l'Assistenza per verificare se sia possibile reimpostare manualmente la migrazione.


Perché l'annullamento della migrazione richiede così tanto tempo?

Non è disponibile un valore approssimato, una stima o un SLA sulla durata del processo di annullamento, dato che il grado di personalizzazione di Knowledge e il processo sottostante sono variabili. Non è raro che il completamento dell'annullamento richieda diversi giorni e fino a oltre una settimana e più.

Se si è in attesa del completamento dell'annullamento già da un lungo periodo di tempo:

1) Controllare Imposta itinerario di controllo per verificare che non siano state apportate modifiche a Knowledge. Secondo la documentazione, "ATTENZIONE Non apportare alcuna modifica all'oggetto Knowledge nel Gestore oggetti prima di accettare o annullare la migrazione. In caso contrario, l'annullamento cesserà di funzionare". Riferimento: Migrazione di più tipi di articoli.

Se si riscontrano modifiche in Imposta itinerario di controllo, può essere necessario invertirle per consentire il completamento dell'annullamento.

2) Controllare se si è ricevuta una notifica via email con oggetto "Operazione di ANNULLAMENTO della migrazione a Knowledge non riuscita"

Se l'organizzazione ha creato dipendenze per il nuovo oggetto Knowledge__kav, il processo di annullamento non potrà essere completato. Rivedere l'email, che dovrebbe fornire dettagli sulle dipendenze che non consentono l'annullamento.

Dopo la rimozione delle dipendenze, perché l'annullamento possa continuare può essere necessario rimuovere manualmente in modo definitivo il tipo di articolo Knowledge__kav creato durante il processo di migrazione.

Passare a Impostazioni di gestione degli oggetti in Lightning Experience o in Classic aprire Imposta, digitare 'Tipi di articoli Knowledge' nella casella Ricerca veloce, quindi selezionare la sezione di Imposta 'Tipi di articoli Knowledge'.
 
  • Se una delle due posizioni contiene un oggetto 'Knowledge__kav' in stato non distribuito, eliminarlo manualmente, quindi eliminarlo in modo definitivo, per consentire il completamento del processo di annullamento. Vedere Eliminazione di un tipo di articolo per le istruzioni per l'eliminazione dell'oggetto 'Knowledge__kav', quindi nella pagina di impostazione dei tipi di articolo individuare l'elenco 'Oggetti eliminati' e fare clic su 'Cancella' per rimuovere in modo permanente o eliminare in modo definitivo l'oggetto.
 
  • È possibile monitorare lo stato del processo di eliminazione definitiva mediante il monitoraggio dei processi in background. La voce 'Tipo di processo' corrispondente dovrebbe essere: 'Cleanup of custom entity data when a custom entity definition is hard deleted' (Pulitura dei dati di un'entità personalizzata quando la definizione dell'entità personalizzata viene eliminata in modo definitivo). Quando lo stato del processo è Completato, l'annullamento è terminato. In alcune circostanze impreviste, lo stato del processo è Completato ma l'oggetto Knowledge eliminato in modo definitivo è ancora persistente. Se si ritiene che questo sia il proprio scenario, registrare un caso per aprire un'indagine più approfondita. Chiedere all'Assistenza di fare riferimento alla sezione Informazioni interne di questo articolo e concedere all'Assistenza l'autorizzazione a eseguire manualmente il processo per eliminare l'oggetto Knowledge ancora presente.
 
3) Se la migrazione includeva file, può essere necessario attendere l'esecuzione del processo di eliminazione fisica pianificato nell'organizzazione perché il processo di annullamento possa efficacemente eliminare i file creati nell'ambito del processo di migrazione.
 
  • Se non è possibile attendere che il processo di eliminazione fisica si svolga naturalmente o non si è in grado di procedere con l'annullamento, registrare un caso con l'Assistenza per svolgere ulteriori indagini. L'Assistenza può verificare se sono possibili problemi imprevisti o se il processo è in attesa dell'esecuzione di un'eliminazione fisica. L'Assistenza può avviare manualmente un'eliminazione fisica se si fornisce in modo documentato l'autorizzazione esplicita a eseguirla per l'organizzazione.
 
 
Perché si riceve il messaggio 'Questo oggetto personalizzato è utilizzato da un'altra funzione' quando si tenta di accettare la migrazione?

Impossibile completare la migrazione per i seguenti motivi:

Impossibile completare questa operazione. Questo oggetto personalizzato è utilizzato da un'altra funzione. Rimuovere l'utilizzo e riprovare. <Riferimento>

Si riceve questo errore quando il processo di migrazione non è in grado di eliminare i tipi di articolo precedenti a causa di riferimenti esistenti. I clienti possono utilizzare la Developer Console per cercare '*__ka' e '*__kav' e individuare codice Apex che può fare riferimento a tipi di articolo precedenti. Maggiori dettagli sono descritti nei punti del passaggio 13 nella documentazione Migrazione di più tipi di articoli.

Nota: l'analisi dei metadati per l'elenco di tutti i riferimenti esula dall'ambito dei servizi offerti dall'Assistenza. Questo processo deve essere completato dai clienti.

Se uno sviluppatore conferma che tutti i riferimenti correlati sono stati eliminati ma il messaggio relativo alla presenza di dipendenze viene ancora visualizzato e non si è in grado di eliminare i tipi di articolo precedenti, registrare un caso con l'Assistenza Salesforce per approfondire se possa essere necessario uno script per rimuovere manualmente le dipendenze Apex impreviste ancora presenti in background.
Numero articolo Knowledge

000385080

 
Caricamento
Salesforce Help | Article