Due anni dopo il go-live, un sales operations manager chiede perché le opportunità in una determinata regione non possano essere chiuse senza una seconda approvazione. Nessuno nell'attuale team di amministratori ne conosce il motivo. Il consulente che ha creato il flusso ha cambiato azienda, il documento di progettazione descrive una versione precedente e l'unica soluzione è decodificare l'istanza una configurazione alla volta. Questo è il costo di una documentazione di implementazione di Salesforce carente, e quasi ogni team Salesforce prima o poi si trova a pagarlo.

Una buona documentazione di implementazione di Salesforce registra ciò che è stato creato, il motivo per cui è stato realizzato in quel modo e come le persone dovrebbero utilizzarlo. Protegge il tuo investimento quando cambiano gli amministratori, accelera qualsiasi modifica futura, semplifica gli audit e aiuta gli utenti ad adottare realmente il sistema. Questa guida spiega cosa dovrebbe includere la documentazione di implementazione di Salesforce, cosa documentare in ciascuna fase del progetto, come crearla in modo efficiente con registrazioni dello schermo e come mantenerla aggiornata dopo il go-live.

Che cos'è la documentazione di implementazione di Salesforce?

La documentazione di implementazione di Salesforce è l'insieme di record creati durante e dopo un progetto Salesforce che spiegano i requisiti, la progettazione della soluzione, la configurazione, le integrazioni, la migrazione dei dati, i test e il modo in cui gli utenti lavorano nel sistema. È pensata per tre tipi di pubblico: gli amministratori e gli sviluppatori che gestiscono l'istanza, i responsabili aziendali che approvano le modifiche e gli utenti finali che lavorano in Salesforce ogni giorno.

Si applica sia che tu stia implementando Sales Cloud, Service Cloud o un altro prodotto Salesforce, sia che la configurazione venga eseguita internamente o da un partner. Per uno sguardo più ampio sulla documentazione di piattaforme di grandi dimensioni, consulta come documentare processi software aziendali complessi.

Perché la documentazione di implementazione di Salesforce è importante?

• Gli amministratori e i partner cambiano. Senza documentazione, le motivazioni alla base di ogni configurazione se ne vanno con le persone che le hanno create.

• Ogni modifica diventa più lenta. I team trascorrono ore a ricostruire flussi, regole di convalida e autorizzazioni prima di poter modificare qualsiasi cosa in sicurezza.

• Il debito tecnico aumenta. Campi, flussi e automazioni non documentati si accumulano perché nessuno è sicuro di cosa si possa rimuovere in sicurezza.

• Gli audit e le verifiche di sicurezza richiedono prove di chi può visualizzare e fare determinate azioni, e del perché.

• L'adozione dipende da essa. Gli utenti che non sanno come dovrebbe essere utilizzata l'istanza inventano soluzioni alternative proprie; consulta la strategia video per l'adozione del CRM.

Cosa dovrebbe includere la documentazione di implementazione di Salesforce?

Non serve un documento lungo per ciascuna voce. Documenti brevi e coerenti, facili da trovare e affidabili, valgono più di un documento di progettazione di 200 pagine che nessuno apre mai.

Cosa documentare in ciascuna fase dell'implementazione di Salesforce?

Discovery

Raccogli processi attuali, punti critici, requisiti e user story. Registra panoramiche su come lavorano oggi i team, inclusi i fogli di calcolo e i workaround che il nuovo sistema dovrà sostituire. Un modello di documento dei requisiti di business ti fornirà una struttura di partenza.

Design

Documenta il modello dati, i tipi di record, l'approccio all'automazione, il modello di sicurezza e la progettazione dell'integrazione, specificando le ragioni alla base di ogni decisione. Il "perché" è ciò di cui i futuri amministratori avranno più bisogno.

Build

Mantieni un registro di configurazione man mano che procedi con lo sviluppo, in modo che ogni campo personalizzato, flusso, regola di convalida e set di autorizzazioni abbia uno scopo, un responsabile e una data. Registra brevi video esplicativi delle automazioni complesse.

Test e UAT

Scrivi script di test, acquisisci i risultati e registra le prove di ciascun test. Registrare i tester mentre eseguono i diversi scenari fornisce sia le prove UAT sia la prima bozza per le guide destinate agli utenti finali. Scopri come creare documentazione di implementazione di progetti IT e guide UAT tramite video.

Deployment e go-live

Documenta i contenuti della release, i passaggi di deployment, i risultati della migrazione dei dati, il piano di cutover e le procedure di rollback, e pubblica le guide per gli utenti finali prima del go-live.

Hypercare e fasi successive

Registra problemi, correzioni e domande frequenti, aggiorna le guide man mano che l'istanza evolve e trasferisci la responsabilità di ciascun documento al team operativo (run team). Un pacchetto formativo post-implementazione raccoglie le guide e i video di cui i nuovi utenti hanno bisogno.

Come creare la documentazione di implementazione di Salesforce passo dopo passo?

Passaggio 1: Definire uno standard di documentazione

Decidi di quali documenti hai bisogno, il modello da utilizzare per ciascuno, dove verranno archiviati e chi ne sarà il responsabile, prima dell'inizio dello sviluppo.

Passaggio 2: Documentare le decisioni man mano che vengono prese

Registra le decisioni di progettazione sul momento, indicando le opzioni considerate e il motivo della scelta adottata. Cercare di ricostruire la documentazione dopo il go-live porta inevitabilmente a perdere queste motivazioni.

Passaggio 3: Registrare walkthrough di configurazione e di processo

Fai registrare all'amministratore o al consulente una breve spiegazione video per ogni flusso significativo, processo di approvazione o configurazione di permessi con il registratore dello schermo IA di Trupeer, illustrando cosa fa e perché. Le registrazioni catturano dettagli che i registri scritti tralasciano.

Passaggio 4: Trasformare le registrazioni in guide

Trupeer trasforma ogni registrazione in una guida passo-passo con screenshot e un video narrato, in modo che i walkthrough per amministratori diventino documentazione tecnica e quelli per gli utenti si trasformino in guide per gli utenti finali. Utilizza un modello di guida utente per il software coerente per le versioni destinate agli utenti finali.

Passaggio 5: Pubblicare tutto in un unico punto

Conserva requisiti, progettazione, registri di configurazione, runbook e guide per l'utente in un'unica libreria ricercabile con responsabili chiaramente definiti, anziché disperderli tra cartelle condivise e strumenti di progetto vari.

Passaggio 6: Effettuare il passaggio di consegne e mantenere i contenuti aggiornati

Al termine del progetto, assegna un responsabile a ciascun documento e concordate la modalità con cui la documentazione verrà aggiornata a ogni release.

Come documentare Salesforce per gli utenti finali?

Gli utenti finali non hanno bisogno del documento di progettazione. Hanno bisogno di guide basate sui ruoli che mostrino esattamente come svolgere il proprio lavoro nell'istanza aziendale:

• Guide alle attività basate sui ruoli, come "Registrare una chiamata", "Convertire un lead" o "Chiudere un ticket/case", con screenshot dei layout effettivi in uso.

• Brevi video per le attività più comuni, pensati per chi impara meglio guardando.

• Schede di riferimento rapido per le attività quotidiane e i campi principali.

• Guide ai processi che spiegano le regole aziendali dietro i campi obbligatori e le approvazioni.

• FAQ raccolte durante le fasi di UAT e hypercare.

Una buona documentazione per gli utenti finali è anche alla base dell'adozione del sistema. Consulta la sezione formazione Salesforce oltre Trailhead per costruire una formazione specifica per ciascun ruolo a partire da essa.

Come mantenere aggiornata la documentazione di Salesforce dopo il go-live?

Salesforce cambia costantemente: la piattaforma rilascia tre importanti aggiornamenti all'anno e il tuo team interno continua ad apportare modifiche all'istanza. Per mantenere aggiornata la documentazione di implementazione di Salesforce:

• Collega gli aggiornamenti della documentazione al tuo processo di gestione delle modifiche (change management), in modo che nessuna modifica venga distribuita senza aggiornare il documento corrispondente.

• Rivedi le guide per gli utenti finali dopo ogni rilascio di Salesforce e dopo ogni release interna.

• Aggiorna i video modificando lo script, anziché registrarli nuovamente da zero, quando cambiano etichette o passaggi; scopri come aggiornare un video formativo senza doverlo registrare di nuovo.

• Crea versioni dei tuoi documenti, per poter vedere come si presentava l'istanza in qualsiasi momento.

• Fai pulizia regolarmente, archiviando la documentazione relativa a campi e automazioni che sono stati rimossi.

Checklist per la documentazione di implementazione di Salesforce

• I requisiti e le user story sono documentati, completi di criteri di accettazione.

• Ogni decisione chiave di progettazione è registrata con la relativa motivazione.

• Un registro di configurazione elenca ogni campo personalizzato, flusso, regola di convalida e set di autorizzazioni, con uno scopo e un responsabile indicati.

• Il modello di sicurezza e condivisione è documentato e approvato.

• Ogni integrazione dispone di un flusso di dati, passaggi per la gestione degli errori e un responsabile designato.

• La mappatura della migrazione dei dati e i risultati della riconciliazione sono salvati.

• Script UAT, risultati e approvazioni formali sono archiviati insieme alla documentazione di progetto, utilizzando un modello di piano di test coerente.

• Sono disponibili note di rilascio e passaggi di rollback per ogni deployment.

• Guide e video basati sui ruoli per gli utenti finali sono pubblicati prima del go-live.

• I runbook per gli amministratori coprono le attività di routine come la configurazione degli utenti e i caricamenti dei dati.

• Ogni documento ha un responsabile designato e una data di revisione stabilita dopo il passaggio di consegne.

Per approfondire nel dettaglio la fase di test, consulta la checklist per la documentazione UAT.

Errori comuni nella documentazione di implementazione di Salesforce

• Documentare "cosa" ma non "perché", impedendo ai futuri amministratori di comprendere se una configurazione sia ancora rilevante.

• Rimandare la documentazione alla fine del progetto, quando budget e attenzione sono ormai esauriti.

• Affidarsi esclusivamente al pacchetto di passaggio consegne del partner senza personalizzarlo e farlo proprio.

• Tralasciare le guide per gli utenti finali, spingendo gli utenti a farsi formare dai colleghi e ad acquisire cattive abitudini.

• Conservare i documenti nello strumento di project management, dove nessuno andrà più a consultarli dopo il go-live.

• Non aggiornare mai la documentazione dopo il primo rilascio.

Crea la documentazione di implementazione di Salesforce con Trupeer

Trupeer trasforma le registrazioni dei tuoi amministratori e utenti che lavorano in Salesforce in guide passo-passo e video formativi, garantendo che la documentazione rimanga al passo con lo sviluppo e si mantenga aggiornata anche dopo il go-live. Inizia gratis con Trupeer.

Domande frequenti

Che cos'è la documentazione di implementazione di Salesforce?

È l'insieme di documenti e registri che spiegano un'implementazione di Salesforce: requisiti, progettazione della soluzione, configurazione, sicurezza, integrazioni, migrazione dei dati, test, note di rilascio, guide per utenti finali e runbook per amministratori.

Cosa dovrebbe essere incluso nella documentazione di implementazione di Salesforce?

Requisiti e user story, progettazione della soluzione, registro di configurazione, modello di sicurezza e condivisione, dettagli su integrazioni e migrazione dati, documentazione di test e UAT, note di rilascio, guide per l'utente finale e runbook per amministratori.

Chi dovrebbe essere il responsabile della documentazione di Salesforce?

L'amministratore Salesforce o il platform owner dovrebbe essere responsabile dell'intera libreria, con incarichi specifici assegnati per la progettazione, le integrazioni e le guide per gli utenti finali. Dopo il go-live, la proprietà deve passare al team operativo interno, non rimanere in capo al partner di implementazione.

Quando bisognerebbe iniziare a documentare un'implementazione di Salesforce?

Durante la fase di discovery. Documentare decisioni e configurazioni man mano che vengono prese è molto più accurato rispetto a redigere tutto alla fine.

Come si documenta la configurazione di Salesforce?

Tieni un registro di configurazione con campi personalizzati, flussi, regole di convalida, processi di approvazione e autorizzazioni, ciascuno provvisto di scopo, responsabile e data, e registra brevi panoramiche video delle automazioni più complesse.

Come creare rapidamente guide per gli utenti di Salesforce?

Registra gli utenti o i key user mentre svolgono ogni attività in Salesforce e usa uno strumento come Trupeer per convertire ogni registrazione in una guida passo-passo e in un video.

Come mantenere aggiornata la documentazione di Salesforce?

Associa gli aggiornamenti della documentazione al tuo processo di change management, rivedi le guide dopo ogni release di Salesforce e interna, aggiorna i video modificando lo script e gestisci le versioni dei tuoi documenti.

Qual è la differenza tra documentazione per amministratori e documentazione per utenti finali?

La documentazione per amministratori spiega come l'istanza è stata costruita e come viene manutenuta. La documentazione per utenti finali spiega come eseguire le attività quotidiane al suo interno. Entrambe fanno parte della documentazione di implementazione di Salesforce, ma sono scritte per destinatari diversi.