O actualizare ServiceNow este programată pentru luna viitoare. Echipa de platformă trebuie să știe ce reguli de business, fluxuri și scripturi pentru clienți ar putea fi afectate, auditorii vor dovezi despre cine poate aproba modificările, iar un nou administrator tocmai s-a alăturat. Toată lumea se îndreaptă către documentație și găsește un document de design de la go-live, un folder de capturi de ecran care nu mai corespund ecranelor și o mulțime de cunoștințe care există doar în mintea unui singur consultant.

Documentația de implementare ServiceNow previne asta. Ea înregistrează ce s-a construit, de ce, cum este configurat și cum îl folosesc oamenii, astfel încât platforma să poată fi actualizată, auditată și extinsă în siguranță. Acest ghid explică ce ar trebui să includă documentația de implementare ServiceNow, cum să documentezi fluxuri fără capturi de ecran manuale, cum să surprinzi configurațiile pentru audit, ce să documentezi în fiecare etapă și cum să o menții actualizată pe parcursul lansărilor regulate ale ServiceNow.

Ce este documentația de implementare ServiceNow?

Documentația de implementare ServiceNow este setul de înregistrări care explică o implementare ServiceNow: cerințele și designul procesului, configurarea instanței, configurația și personalizările, integrările, deciziile privind datele și CMDB, testarea, lansările și ghidurile care le arată agenților, angajaților și administratorilor cum să folosească și să ruleze platforma. Se aplică pentru ITSM și pentru alte fluxuri de lucru ServiceNow, precum livrarea serviciilor HR sau serviciul pentru clienți.

Aceleași principii se aplică și altor platforme enterprise; vezi cum să documentezi procese complexe de software enterprise între SAP, ServiceNow și Salesforce.

De ce contează documentația de implementare ServiceNow?

• Actualizările sunt mai sigure. ServiceNow lansează versiuni noi de două ori pe an, iar personalizările documentate fac clar ce trebuie testat.

• Auditurile sunt mai ușoare. Auditorii vor dovezi privind configurațiile, controalele de acces și aprobările schimbărilor.

• Tranziția administratorilor este mai puțin riscantă. Motivele din spatele fiecărei setări nu pleacă odată cu persoana care a construit-o.

• Schimbările sunt mai rapide. Echipele nu trebuie să reconstituie un regulă de business înainte să o modifice.

• Adoptarea se îmbunătățește. Agenții și angajații care au ghiduri clare folosesc platforma așa cum a fost proiectată.

Ce ar trebui să includă documentația de implementare ServiceNow?

Cum documentezi fluxurile de lucru ServiceNow fără capturi de ecran manuale?

Capturile de ecran manuale sunt cea mai lentă modalitate de a documenta ServiceNow. Fiecare pas înseamnă să capturezi, să decupezi, să lipești și să adaugi adnotări, iar fiecare schimbare în UI face capturile de ecran să devină rapid depășite. O abordare „înregistrare-înainte” este mai rapidă și mai ușor de menținut:

1. Înregistrează fluxul o singură dată, executându-l în instanța ta în timp ce povestești fiecare pas, cu AI screen recorder de la Trupeer.

2. Generează ghidul automat. Trupeer transformă înregistrarea într-un ghid pas cu pas cu capturi de ecran și un videoclip narat.

3. Editează și adaugă context, precum reguli de business, criterii de aprobare și ce se întâmplă în continuare.

4. Publică-l acolo unde caută oamenii, în baza ta de cunoștințe sau în portal.

5. Actualizează prin editare, nu prin re-capturare, când se schimbă o etichetă sau un pas.

Funcționează la fel de bine pentru fluxurile de lucru ale agenților, cererile din catalog, aprobări și sarcinile de administrare. Pentru articole de cunoștințe, în mod specific, vezi cele mai bune practici pentru articolele de cunoștințe ServiceNow.

Cum documentezi configurațiile ServiceNow pentru audit?

Auditorii și echipele de guvernanță a platformei trebuie să vadă ce este configurat, cine îl poate modifica și cum sunt aprobate schimbările. Pentru a documenta configurațiile ServiceNow pentru audit:

• Păstrează un jurnal de configurație pentru fiecare personalizare, cu scopul, proprietarul, data și cerința pe care o îndeplinește.

• Înregistrează prezentări (walkthrough-uri) ale configurațiilor critice, precum reguli de aprobare, controale de acces și fluxuri de schimbare, arătând cum funcționează în instanță.

• Documentează rolurile și accesul pe grup, cu justificarea de business pentru rolurile privilegiate.

• Leagă fiecare schimbare de aprobarea ei, prin înregistrările tale de change și release.

• Versionează documentația, astfel încât să poți arăta cum arăta configurația în orice moment; vezi SOP version control.

• Revizuiește regulat, mai ales înainte de audituri și după upgrade-uri.

Ce ar trebui să documentezi în fiecare etapă de implementare?

Pentru dovezi de testare, vezi UAT documentation checklist.

Cum creezi documentația de implementare ServiceNow pas cu pas?

Pasul 1: Stabilește un standard de documentare

Decide ce documente ai nevoie, șablonul pentru fiecare, unde vor fi găzduite și cine le deține, înainte să înceapă build-ul.

Pasul 2: Documentează deciziile pe măsură ce proiectezi

Înregistrează deciziile de design cu opțiunile luate în calcul și de ce a fost aleasă una. Raționamentul este ceea ce au nevoie cel mai mult viitorii administratori.

Pasul 3: Înregistrează configurația pe măsură ce construiești

Adaugă fiecare personalizare în jurnalul de configurație pe măsură ce este creată, nu la finalul proiectului.

Pasul 4: Înregistrează prezentări ale proceselor și configurațiilor

Înregistrează administratori explicând fluxuri și reguli complexe, și utilizatori cheie care execută sarcini pentru agenți și angajați, apoi transformă înregistrările în ghiduri și videoclipuri.

Pasul 5: Construiește ghiduri pentru fiecare public

Creează ghiduri separate pentru agenți, aprobatori, angajați și administratori. Instruirea și documentația pentru agenți ar trebui să meargă mână în mână; vezi cele mai bune practici pentru videoclipurile de training ServiceNow.

Pasul 6: Predă cu proprietari și date de revizie

La închiderea proiectului, atribuie un proprietar fiecărui document și stabilește cum va fi actualizată documentația la fiecare lansare.

Cum menții documentația ServiceNow actuală pe parcursul upgrade-urilor?

• Revizuiește documentația ca parte din fiecare upgrade, alături de testele skipped-record și de regresie.

• Leagă actualizările de documentație de înregistrările de change, astfel încât nicio schimbare să nu se închidă fără ca documentația ei să fie actualizată.

• Actualizează ghidurile prin editarea scripturilor în loc să le reînregistrezi; vezi cum să actualizezi un videoclip de training fără reînregistrare.

• Scoate din uz documentația pentru configurațiile care au fost eliminate.

• Verifică ghidurile față de UI-ul curent după fiecare lansare, mai ales pentru angajați și agenți.

Funcționează aceeași abordare și pentru alte platforme ITSM?

Da. Indiferent dacă folosești ServiceNow, Atomicwork, Freshservice sau un alt instrument ITSM, se aplică aceleași principii: documentează deciziile și configurațiile, înregistrează prezentări în loc să capturezi capturi de ecran manual, oferă fiecărui document un proprietar și actualizează documentația la fiecare schimbare. Doar terminologia și ecranele diferă. Pentru o vedere comparativă, vezi comparația documentației platformelor ITSM.

Checklist pentru documentația de implementare ServiceNow

• Designurile de cerințe și proces sunt documentate cu motivele din spatele deciziilor-cheie.

• Peisajul instanței și procesul de promovare sunt documentate.

• Un jurnal de configurație acoperă fiecare personalizare, cu scop și proprietar.

• Rolurile, grupurile și controalele de acces sunt documentate și justificate.

• Elementele din catalog, integrările și deciziile CMDB sunt documentate.

• Dovezile de testare și înregistrările de lansare sunt stocate și conectate.

• Ghidurile pentru agenți, aprobatori, angajați și administratori sunt publicate.

• Fiecare document are un proprietar și o dată de revizie.

• Documentația este revizuită la fiecare upgrade și change.

Greșeli comune în documentația ServiceNow

• Documentezi ce, nu de ce, astfel încât nimeni să nu știe dacă o personalizare mai contează.

• Te bazezi pe capturi de ecran manuale care devin depășite la fiecare lansare.

• Lași documentația pentru după go-live.

• Păstrezi documentele în folderele de proiect pe care nimeni nu le vizitează după predare.

• Ignori ghidurile pentru utilizatorii finali și agenți, ceea ce afectează adoptarea; vezi strategia noastră de adoptare ServiceNow.

• Niciodată nu actualizezi documentația după upgrade-uri.

Creează documentația de implementare ServiceNow cu Trupeer

Trupeer transformă înregistrările instanței tale ServiceNow în ghiduri pas cu pas și videoclipuri, astfel încât prezentările de configurare, fluxurile de lucru ale agenților și „cum se face” pentru angajați să fie documentate fără capturi de ecran manuale și să rămână actuale după fiecare upgrade. Vezi IT knowledge base și platforma SOP de la Trupeer sau începe gratuit cu Trupeer.

Întrebări frecvente

Ce este documentația de implementare ServiceNow?

Este setul de înregistrări care explică o implementare ServiceNow: cerințe, design de proces, configurarea instanței, configurație, acces, catalog, integrări, CMDB, testare, lansări și ghiduri pentru agenți, angajați și administratori.

Ce ar trebui să includă documentația ServiceNow?

Cerințe și design de proces, peisajul instanței, un jurnal de configurație, roluri și acces, elemente din catalog, integrări, decizii privind CMDB și date, înregistrări de lansare și testare, ghiduri pentru utilizatori și agenți și runbook-uri pentru administratori.

Cum documentezi fluxurile de lucru ServiceNow fără capturi de ecran?

Înregistrezi fluxul o singură dată în instanța ta în timp ce îl povestești și folosești un instrument precum Trupeer pentru a transforma înregistrarea într-un ghid pas cu pas cu capturi de ecran și un videoclip, apoi îl actualizezi prin editare, nu prin re-capturare.

Cum documentezi configurațiile ServiceNow pentru audit?

Păstrează un jurnal de configurație cu scopul, proprietarul și data pentru fiecare personalizare, înregistrează prezentări ale configurațiilor critice, documentează rolurile și accesul, leagă schimbările de aprobări și versionază documentația.

Cât de des ar trebui actualizată documentația ServiceNow?

La fiecare schimbare care o afectează și ca parte din fiecare upgrade, deoarece ServiceNow lansează versiuni noi de două ori pe an.

Cine ar trebui să dețină documentația ServiceNow?

Proprietarul platformei sau echipa de administratori ServiceNow ar trebui să dețină biblioteca, cu proprietari desemnați pentru fiecare zonă de proces și pentru fiecare ghid.

Care este diferența dintre documentația pentru administratori și ghidurile pentru utilizatori?

Documentația pentru administratori explică cum este construită și menținută platforma. Ghidurile pentru utilizatori explică cum își fac agenții, aprobatorii și angajații sarcinile. Ambele fac parte din documentația de implementare ServiceNow.

Funcționează această abordare pentru Atomicwork sau Freshservice?

Da. Principiile sunt aceleași pentru orice platformă ITSM; doar terminologia și ecranele se schimbă.