Ein ServiceNow-Upgrade ist für den nächsten Monat geplant. Das Platform-Team muss wissen, welche Business Rules, Flows und Client Scripts möglicherweise betroffen sind, die Auditoren möchten einen Nachweis darüber, wer Änderungen genehmigen darf, und ein neuer Admin ist gerade an Bord gekommen. Alle greifen zur Dokumentation und finden ein Design-Dokument vom Go-live, einen Ordner mit Screenshots, die nicht mehr zu den aktuellen Bildschirmen passen, und jede Menge Wissen, das nur in den Köpfen eines einzelnen Consultants existiert.

ServiceNow-Implementierungsdokumentation verhindert genau das. Sie hält fest, was umgesetzt wurde, warum und wie es konfiguriert ist und wie die Menschen es nutzen – damit das Platform-Team sicher upgraden, auditieren und erweitern kann. Dieser Leitfaden erklärt, was eine ServiceNow-Implementierungsdokumentation enthalten sollte, wie Workflows ohne manuelle Screenshots dokumentiert werden, wie Konfigurationen für Audits erfasst werden, was in jeder Phase zu dokumentieren ist und wie man die Dokumentation über die regelmäßigen Releases von ServiceNow hinweg aktuell hält.

Was ist ServiceNow-Implementierungsdokumentation?

ServiceNow-Implementierungsdokumentation ist die Gesamtheit der Aufzeichnungen, die eine ServiceNow-Implementierung erklären: die Anforderungen und die Prozessgestaltung, das Setup der Instanz, die Konfiguration und Customisation, Integrationen, Entscheidungen zu Daten und CMDB, das Testing, die Releases sowie die Anleitungen, die Agents, Mitarbeitende und Admins zeigen, wie sie die Plattform nutzen und betreiben. Sie gilt für ITSM und für andere ServiceNow-Workflows, wie z. B. HR Service Delivery oder Customer Service.

Die gleichen Grundsätze gelten auch für andere Enterprise-Plattformen; siehe wie man komplexe Prozesse für Enterprise-Software dokumentiert über SAP, ServiceNow und Salesforce hinweg.

Warum ist ServiceNow-Implementierungsdokumentation wichtig?

• Upgrades sind sicherer. ServiceNow veröffentlicht neue Versionen zweimal pro Jahr, und dokumentierte Customisations machen klar, was getestet werden muss.

• Audits sind einfacher. Auditoren möchten Nachweise zu Konfigurationen, Zugriffskontrollen und Change-Genehmigungen.

• Admin-Wechsel sind weniger riskant. Die Gründe hinter jeder Einstellung gehen nicht mit der Person verloren, die sie umgesetzt hat.

• Änderungen gehen schneller. Teams müssen keine Business Rule rückentwickeln, bevor sie sie ändern.

• Die Akzeptanz steigt. Agents und Mitarbeitende mit klaren Anleitungen nutzen die Plattform so, wie sie vorgesehen ist.

Was sollte ServiceNow-Implementierungsdokumentation enthalten?

Wie dokumentiert man ServiceNow-Workflows ohne manuelle Screenshots?

Manuelle Screenshots sind der langsamste Weg, um ServiceNow zu dokumentieren. Jeder Schritt bedeutet: erfassen, zuschneiden, einfügen und annotieren – und jede Änderung in der Benutzeroberfläche macht die Screenshots sofort veraltet. Ein „Recording-first“-Ansatz ist schneller und lässt sich leichter pflegen:

1. Den Workflow einmal aufnehmen, indem Sie ihn in Ihrer Instanz ausführen und dabei jeden Schritt kommentieren – mit dem AI Screen Recorder von Trupeer.

2. Die Anleitung automatisch generieren. Trupeer macht aus der Aufnahme eine Schritt-für-Schritt-Anleitung mit erfassten Screenshots und einem kommentierten Video.

3. Bearbeiten und Kontext ergänzen, z. B. Business Rules, Genehmigungskriterien und was als Nächstes passiert.

4. Veröffentlichen, wo Menschen nachsehen, in Ihrer Knowledge Base oder Ihrem Portal.

5. Aktualisieren durch Bearbeiten, nicht durch erneutes Erfassen, wenn sich ein Label oder ein Schritt ändert.

Das funktioniert für Agent-Workflows, Kataloganfragen, Genehmigungen und Admin-Aufgaben gleichermaßen. Für Knowledge-Artikel im Speziellen siehe ServiceNow Knowledge-Artikel Best Practices.

Wie dokumentiert man ServiceNow-Konfigurationen für ein Audit?

Auditoren und Teams für Platform Governance müssen sehen, was konfiguriert ist, wer es ändern kann und wie Änderungen genehmigt werden. So dokumentieren Sie ServiceNow-Konfigurationen für ein Audit:

• Führen Sie für jede Customisation ein Konfigurationsprotokoll, mit Zweck, Owner, Datum und der Anforderung, die es erfüllt.

• Dokumentieren Sie Walkthroughs kritischer Konfigurationen, z. B. Genehmigungsregeln, Zugriffskontrollen und Change-Workflows – inklusive Darstellung, wie sie in der Instanz funktionieren.

• Dokumentieren Sie Rollen und Zugriff gruppenbasiert – inklusive Business-Begründung für privilegierte Rollen.

• Verknüpfen Sie jede Änderung mit ihrer Genehmigung, über Ihre Change- und Release-Records.

• Versionieren Sie die Dokumentation, damit Sie zeigen können, wie die Konfiguration zu jedem Zeitpunkt aussah; siehe SOP Version Control.

• Überprüfen Sie regelmäßig, insbesondere vor Audits und nach Upgrades.

Was sollten Sie in jeder Implementierungsphase dokumentieren?

Für Nachweise im Testing siehe die UAT-Dokumentations-Checkliste.

Wie erstellt man ServiceNow-Implementierungsdokumentation Schritt für Schritt?

Schritt 1: Einen Dokumentationsstandard vereinbaren

Legen Sie fest, welche Dokumente Sie benötigen, welches Template für jedes gilt, wo sie abgelegt werden und wer dafür verantwortlich ist – bevor der Build startet.

Schritt 2: Entscheidungen dokumentieren, während Sie designen

Halten Sie Designentscheidungen fest – inklusive der geprüften Optionen und warum eine ausgewählt wurde. Die Begründung ist das, was zukünftige Admins am meisten brauchen.

Schritt 3: Konfiguration protokollieren, während Sie bauen

Fügen Sie jede Customisation in das Konfigurationsprotokoll ein, sobald sie entsteht – nicht erst am Ende des Projekts.

Schritt 4: Walkthroughs von Prozessen und Konfigurationen aufzeichnen

Zeichnen Sie auf, wie Admins komplexe Flows und Regeln erklären, und wie Key User Agent- und Mitarbeitenden-Aufgaben ausführen. Wandeln Sie die Aufnahmen anschließend in Anleitungen und Videos um.

Schritt 5: Anleitungen für jedes Publikum erstellen

Erstellen Sie separate Anleitungen für Agents, Genehmiger, Mitarbeitende und Admins. Training und Dokumentation für Agents sollten Hand in Hand gehen; siehe ServiceNow Training Video Best Practices.

Schritt 6: Übergabe mit Ownern und Review-Daten

Weisen Sie zum Projektabschluss jedem Dokument einen Owner zu und vereinbaren Sie, wie die Dokumentation mit jedem Release aktualisiert wird.

Wie hält man ServiceNow-Dokumentation über Upgrades hinweg aktuell?

• Überprüfen Sie die Dokumentation als Teil jedes Upgrades, zusammen mit übersprungenen Records und Regressionstests.

• Verknüpfen Sie Dokumentations-Updates mit Change Records, damit kein Change abgeschlossen wird, ohne dass seine Dokumentation aktualisiert wurde.

• Aktualisieren Sie Anleitungen durch Bearbeiten von Scripts statt durch erneutes Aufnehmen; siehe wie man ein Trainingsvideo aktualisiert, ohne es neu aufzunehmen.

• Dokumentation außer Betrieb nehmen für Konfigurationen, die entfernt wurden.

• Prüfen Sie Anleitungen gegen die aktuelle UI nach jedem Release, insbesondere für Mitarbeitende und Agents.

Funktioniert derselbe Ansatz auch für andere ITSM-Plattformen?

Ja. Egal, ob Sie ServiceNow, Atomicwork, Freshservice oder ein anderes ITSM-Tool betreiben: Die Grundsätze sind dieselben – dokumentieren Sie Entscheidungen und Konfigurationen, halten Sie Walkthroughs fest statt Screenshots manuell zu erfassen, geben Sie jedem Dokument einen Owner und aktualisieren Sie die Dokumentation bei jeder Änderung. Nur die Terminologie und die Screens unterscheiden sich. Für einen direkten Vergleich siehe die ITSM-Plattform-Dokumentationsübersicht.

Checkliste für ServiceNow-Implementierungsdokumentation

• Anforderungen und Prozessgestaltungen sind mit den Gründen hinter wichtigen Entscheidungen dokumentiert.

• Die Instanz-Landschaft und der Promotion-Prozess sind dokumentiert.

• Ein Konfigurationsprotokoll deckt jede Customisation ab – mit Zweck und Owner.

• Rollen, Gruppen und Zugriffskontrollen sind dokumentiert und begründet.

• Katalogartikel, Integrationen und CMDB-Entscheidungen sind dokumentiert.

• Testnachweise und Release-Records werden gespeichert und verknüpft.

• Anleitungen für Agents, Genehmiger, Mitarbeitende und Admins werden veröffentlicht.

• Jedes Dokument hat einen Owner und ein Review-Datum.

• Die Dokumentation wird bei jedem Upgrade und jeder Änderung überprüft.

Häufige Fehler bei der ServiceNow-Dokumentation

• Man dokumentiert das Was, nicht das Warum, sodass niemand weiß, ob eine Customisation noch relevant ist.

• Man verlässt sich auf manuelle Screenshots, die mit jedem Release veralten.

• Man lässt die Dokumentation bis nach dem Go-live liegen.

• Man hält Dokumente in Projektordnern vor, die nach der Übergabe niemand mehr besucht.

• Man ignoriert Anleitungen für Endnutzer und Agents, was die Akzeptanz beeinträchtigt; siehe unsere ServiceNow-Strategie zur User Adoption.

• Man aktualisiert die Dokumentation nie nach Upgrades.

Erstellen Sie ServiceNow-Implementierungsdokumentation mit Trupeer

Trupeer macht aus Aufnahmen Ihrer ServiceNow-Instanz Schritt-für-Schritt-Anleitungen und Videos – sodass Konfigurations-Walkthroughs, Agent-Workflows und How-tos für Mitarbeitende ohne manuelle Screenshots dokumentiert werden und nach jedem Upgrade aktuell bleiben. Sehen Sie sich Trupeers IT Knowledge Base und SOP-Plattform an oder starten Sie kostenlos mit Trupeer.

Häufig gestellte Fragen

Was ist ServiceNow-Implementierungsdokumentation?

Es ist die Gesamtheit der Aufzeichnungen, die eine ServiceNow-Implementierung erklären: Anforderungen, Prozessgestaltung, Setup der Instanz, Konfiguration, Zugriff, Katalog, Integrationen, CMDB, Testing, Releases sowie Anleitungen für Agents, Mitarbeitende und Admins.

Was sollte in der ServiceNow-Dokumentation enthalten sein?

Anforderungen und Prozessgestaltung, die Instanz-Landschaft, ein Konfigurationsprotokoll, Rollen und Zugriff, Katalogartikel, Integrationen, CMDB- und Datenentscheidungen, Release- und Test-Records, Anleitungen für Nutzer und Agents sowie Admin-Runbooks.

Wie dokumentiert man ServiceNow-Workflows ohne Screenshots?

Nehmen Sie den Workflow einmal in Ihrer Instanz auf, während Sie ihn kommentieren, und nutzen Sie ein Tool wie Trupeer, um aus der Aufnahme eine Schritt-für-Schritt-Anleitung mit erfassten Screenshots und einem Video zu erstellen. Aktualisieren Sie sie anschließend durch Bearbeiten statt durch erneutes Erfassen.

Wie dokumentiert man ServiceNow-Konfigurationen für ein Audit?

Führen Sie für jede Customisation ein Konfigurationsprotokoll mit Zweck, Owner und Datum, zeichnen Sie Walkthroughs kritischer Konfigurationen auf, dokumentieren Sie Rollen und Zugriff, verknüpfen Sie Änderungen mit Genehmigungen und versionieren Sie Ihre Dokumentation.

Wie oft sollte die ServiceNow-Dokumentation aktualisiert werden?

Bei jeder Änderung, die sie betrifft, und als Teil jedes Upgrades, da ServiceNow neue Versionen zweimal pro Jahr veröffentlicht.

Wer sollte ServiceNow-Dokumentation besitzen?

Der Platform Owner oder das ServiceNow-Admin-Team sollte die Bibliothek verantworten – mit benannten Ownern für jeden Prozessbereich und jede Anleitung.

Was ist der Unterschied zwischen Admin-Dokumentation und User Guides?

Admin-Dokumentation erklärt, wie die Plattform aufgebaut und gepflegt wird. User Guides erklären, wie Agents, Genehmiger und Mitarbeitende ihre Aufgaben erledigen. Beide gehören zur ServiceNow-Implementierungsdokumentation.

Funktioniert dieser Ansatz auch für Atomicwork oder Freshservice?

Ja. Die Grundsätze sind für jede ITSM-Plattform gleich; nur die Terminologie und die Screens ändern sich.