Notizen & Kommentare
RAMP bietet zwei unterschiedliche Kommunikationssysteme während der Ausführung: Ausführungsnotizen (bearbeitbare, gemeinsame Notizblöcke) und Ausführungskommentare (unveränderliche, nur erweiterbare Protokolle). Beide existieren auf Instanzebene und auf der Ebene einzelner Schritte, sodass Teams flexible Möglichkeiten haben, Beobachtungen, Probleme und Entscheidungen während eines Verfahrens zu dokumentieren.
Ausführungsnotizen vs. Ausführungskommentare
Abschnitt betitelt „Ausführungsnotizen vs. Ausführungskommentare“Das Verständnis des Unterschieds zwischen Notizen und Kommentaren ist wichtig für eine effektive Teamkommunikation während der Ausführung.
| Merkmal | Ausführungsnotizen | Ausführungskommentare |
|---|---|---|
| Bearbeitbarkeit | Bearbeitbar — Inhalt kann im Laufe der Zeit aktualisiert werden | Unveränderlich — einmal gepostet, können sie nicht geändert oder gelöscht werden |
| Kardinalität | Eine Notiz pro Geltungsbereich (eine pro Instanz, eine pro Schritt) | Mehrere Kommentare pro Geltungsbereich (nur erweiterbar) |
| Zweck | Gemeinsamer Notizblock für sich entwickelnde Informationen | Permanente Aufzeichnung von Beobachtungen und Entscheidungen |
| Gleichzeitigkeit | Feldsperrung verhindert gleichzeitige Bearbeitungen | Keine Sperrung erforderlich; Kommentare sind unabhängige Einträge |
| Am besten geeignet für | Laufende Statusaktualisierungen, Checklisten, Listen bekannter Probleme | Zeitpunktbezogene Beobachtungen, Übergabenotizen, Entscheidungsaufzeichnungen |
Ausführungsnotizen auf Instanzebene
Abschnitt betitelt „Ausführungsnotizen auf Instanzebene“Eine Instanzausführungsnotiz ist ein einzelnes, bearbeitbares Rich-Text-Dokument, das in der gesamten Instanz geteilt wird. Es fungiert als lebendiger Notizblock, in dem Teammitglieder laufende Statusinformationen pflegen können.
Erstellen und Bearbeiten
Abschnitt betitelt „Erstellen und Bearbeiten“- Öffnen Sie die Instanz in der Ausführungsansicht
- Navigieren Sie zum Notizen-Panel (rechte Seite der Ausführungsansicht)
- Klicken Sie in den Notizeditor auf der linken Seite des Panels
- Schreiben oder aktualisieren Sie die Notiz mit dem Rich-Text-Editor
- Änderungen werden automatisch gespeichert und über SignalR an alle verbundenen Benutzer übertragen
Feldsperrung
Abschnitt betitelt „Feldsperrung“Um widersprüchliche Bearbeitungen zu verhindern, verwendet RAMP einen Feldsperrmechanismus:
- Wenn Sie in den Notizeditor klicken, erhalten Sie eine Sperre für dieses Feld
- Andere Benutzer sehen ein Sperrsymbol mit einem Tooltip “Gesperrt von [Ihr Name]”
- Die Sperre wird automatisch nach 30 Sekunden Inaktivität oder wenn Sie außerhalb des Editors klicken, aufgehoben
- Nur ein Benutzer kann die Instanzausführungsnotiz gleichzeitig bearbeiten
Berechtigungen
Abschnitt betitelt „Berechtigungen“Für die Bearbeitung der Instanzausführungsnotiz ist die Berechtigung EditInstanceExecutionNote erforderlich. Folgende Rollen haben diese Berechtigung:
- Instanzleiter
- Stellvertretender Leiter
- Ausführender
- Bearbeiter
Beobachter haben nur Lesezugriff.
Schreibgeschützt bei Terminalstatus
Abschnitt betitelt „Schreibgeschützt bei Terminalstatus“Wenn eine Instanz den Status Abgeschlossen oder Storniert erreicht, wird die Ausführungsnotiz schreibgeschützt. Der Inhalt der Notiz bleibt erhalten, es sind jedoch keine weiteren Bearbeitungen erlaubt.
Ausführungskommentare auf Instanzebene
Abschnitt betitelt „Ausführungskommentare auf Instanzebene“Instanzausführungskommentare bilden ein unveränderliches, nur erweiterbares Protokoll für die Instanz. Jeder Kommentar erfasst eine zeitpunktbezogene Beobachtung mit der Identität des Autors und einem Zeitstempel.
Einen Kommentar hinzufügen
Abschnitt betitelt „Einen Kommentar hinzufügen“- Öffnen Sie die Instanz in der Ausführungsansicht
- Navigieren Sie zum Notizen-Panel (rechte Seite)
- Suchen Sie auf der rechten Seite des Panels den Abschnitt Ausführungskommentare
- Geben Sie Ihren Kommentar in den Rich-Text-Editor ein
- Klicken Sie auf Kommentar hinzufügen (oder drücken Sie Strg+Eingabe)
- Der Kommentar erscheint sofort in der Kommentarliste und wird an alle verbundenen Benutzer übertragen
Kommentareigenschaften
Abschnitt betitelt „Kommentareigenschaften“Jeder Ausführungskommentar erfasst:
| Eigenschaft | Beschreibung |
|---|---|
| Inhalt | Rich-Text-HTML-Inhalt des Kommentars |
| Autor | Der Benutzer, der den Kommentar gepostet hat |
| Zeitstempel | Das genaue Datum und die Uhrzeit der Erstellung des Kommentars |
Unveränderlichkeit
Abschnitt betitelt „Unveränderlichkeit“Einmal gepostet, kann ein Ausführungskommentar nicht bearbeitet oder gelöscht werden. Dieses Design gewährleistet ein zuverlässiges Prüfprotokoll darüber, was während der Ausführung kommuniziert wurde. Wenn Sie Informationen korrigieren müssen, posten Sie einen Folgekommentar mit der Korrektur.
Berechtigungen
Abschnitt betitelt „Berechtigungen“Für das Hinzufügen von Instanzausführungskommentaren ist die Berechtigung AddInstanceExecutionComment erforderlich. Verfügbar für:
- Instanzleiter
- Stellvertretender Leiter
- Ausführender
- Bearbeiter
- Beobachter (kann nur Kommentare hinzufügen)
Ausführungsnotizen auf Schrittebene
Abschnitt betitelt „Ausführungsnotizen auf Schrittebene“Jeder einzelne Schritt hat auch seine eigene Ausführungsnotiz — ein einzelnes bearbeitbares Rich-Text-Dokument, das auf diesen Schritt beschränkt ist. Schrittnotizen eignen sich ideal zur Dokumentation schrittspezifischer Beobachtungen, die nicht in die instanzweite Notiz gehören.
Erstellen und Bearbeiten
Abschnitt betitelt „Erstellen und Bearbeiten“- Wählen Sie den Schritt im Schrittstrukturpanel aus
- Suchen Sie im Schrittdetailpanel den Bereich für Schrittausführungsnotizen
- Klicken Sie in den Editor und schreiben oder aktualisieren Sie die Notiz
- Änderungen werden automatisch gespeichert und in Echtzeit synchronisiert
Feldsperrung
Abschnitt betitelt „Feldsperrung“Schrittausführungsnotizen verwenden denselben Feldsperrmechanismus wie Instanznotizen:
- Jeweils ein Benutzer kann die Notiz eines Schritts bearbeiten
- Andere Benutzer sehen einen Sperrindikator mit dem Namen des Bearbeiters
- Die Sperre läuft nach 30 Sekunden Inaktivität ab
Berechtigungen
Abschnitt betitelt „Berechtigungen“Für die Bearbeitung von Schrittausführungsnotizen ist die Berechtigung EditStepExecutionNote erforderlich. Verfügbar für:
- Instanzleiter
- Stellvertretender Leiter
- Ausführender
Ausführungskommentare auf Schrittebene
Abschnitt betitelt „Ausführungskommentare auf Schrittebene“Jeder Schritt hat seinen eigenen nur erweiterbaren Kommentarstrom, getrennt von den Kommentaren auf Instanzebene. Schrittkommentare sind nützlich zur Dokumentation von Entscheidungen, Problemen oder Übergabeinformationen, die spezifisch für einen einzelnen Schritt sind.
Einen Schrittkommentar hinzufügen
Abschnitt betitelt „Einen Schrittkommentar hinzufügen“- Wählen Sie den Schritt im Schrittstrukturpanel aus
- Suchen Sie im Schrittdetailpanel den Abschnitt für Schrittausführungskommentare
- Geben Sie Ihren Kommentar in den Editor ein
- Klicken Sie auf Kommentar hinzufügen oder drücken Sie Strg+Eingabe
- Der Kommentar wird gepostet und an alle verbundenen Benutzer übertragen
Eigenschaften und Unveränderlichkeit
Abschnitt betitelt „Eigenschaften und Unveränderlichkeit“Schrittausführungskommentare haben dieselben Eigenschaften wie Instanzkommentare (Inhalt, Autor, Zeitstempel) und sind gleichermaßen unveränderlich — einmal gepostet, können sie nicht bearbeitet oder gelöscht werden.
Berechtigungen
Abschnitt betitelt „Berechtigungen“Für das Hinzufügen von Schrittausführungskommentaren ist die Berechtigung AddStepExecutionComment erforderlich. Verfügbar für:
- Instanzleiter
- Stellvertretender Leiter
- Ausführender
Ausführungsprotokoll
Abschnitt betitelt „Ausführungsprotokoll“Zusätzlich zu Ausführungsnotizen und -kommentaren pflegt RAMP ein Ausführungsprotokoll — eine chronologische Aufzeichnung sowohl von Benutzerkommentaren als auch von systemgenerierten Aktionseinträgen.
Was im Ausführungsprotokoll erscheint
Abschnitt betitelt „Was im Ausführungsprotokoll erscheint“| Eintragstyp | Beschreibung | Visueller Stil |
|---|---|---|
| Benutzerkommentare | Rich-Text-Nachrichten, die von Teammitgliedern gepostet werden | Standardformatierung mit Autor-Avatar |
| Schrittaktionen | Systemgenerierte Einträge für Start, Abschluss, Anhalten, Fortsetzen, Stornieren, Überspringen, Abbrechen | Monospace-Schriftart |
| Zwangsaktionen | Zwangsabschluss, Zwangsüberspringen, Zwangsabbruch, Zwangsstornierung | Roter Hintergrundhighlight |
Kommentare über das Ausführungsprotokoll hinzufügen
Abschnitt betitelt „Kommentare über das Ausführungsprotokoll hinzufügen“- Navigieren Sie zur Registerkarte Ausführungsprotokoll im Notizenpanel
- Geben Sie Ihre Nachricht in den Rich-Text-Editor unten ein
- Verwenden Sie die Formatierungsleiste für Fett, Kursiv, Überschriften, Listen, Codeblöcke, Textfarbe und Hervorhebung
- Klicken Sie auf Kommentar hinzufügen oder drücken Sie Strg+Eingabe
Das Ausführungsprotokoll filtern
Abschnitt betitelt „Das Ausführungsprotokoll filtern“Das Ausführungsprotokoll unterstützt Filterung, um bestimmte Einträge zu finden:
- Klicken Sie auf die Schaltfläche Filter, um Filteroptionen anzuzeigen
- Nach Aktionstyp: Nur Kommentare, Schrittstartereignisse, Abschlüsse usw. anzeigen
- Nur Zwangsaktionen: Zwangsaktionseinträge zur Überprüfung isolieren
- Nach Datumsbereich: Auf ein bestimmtes Zeitfenster fokussieren
Seitenumbruch
Abschnitt betitelt „Seitenumbruch“Das Ausführungsprotokoll lädt Einträge in Seiten von 50. Verwenden Sie die Schaltfläche Mehr laden, um ältere Einträge anzuzeigen. Der Seitenumbruchindikator zeigt Ihre aktuelle Position (z. B. “Seite 1 von 3 — 142 Einträge insgesamt”).
Rich-Text-Formatierung
Abschnitt betitelt „Rich-Text-Formatierung“Sowohl Notizen als auch Kommentare unterstützen Rich-Text-Formatierung durch den integrierten Editor:
| Format | Verwendung |
|---|---|
| Fett | Schaltfläche in der Leiste oder Strg+B |
| Kursiv | Schaltfläche in der Leiste oder Strg+I |
| Überschriften | Überschriften-Dropdown in der Leiste |
| Aufzählungsliste | Schaltfläche in der Leiste |
| Nummerierte Liste | Schaltfläche in der Leiste |
| Codeblock | Schaltfläche in der Leiste (Monospace-Formatierung) |
| Textfarbe | Farbauswahl in der Leiste |
| Texthervorhebung | Hervorhebungsauswahl in der Leiste |
Echtzeit-Synchronisation
Abschnitt betitelt „Echtzeit-Synchronisation“Alle Notizen und Kommentare werden in Echtzeit über SignalR synchronisiert:
- Notizen: Wenn ein Benutzer eine Ausführungsnotiz bearbeitet, wird der aktualisierte Inhalt an alle anderen Benutzer übertragen, die dieselbe Instanz oder denselben Schritt anzeigen. Der Feldsperrmechanismus verhindert Bearbeitungskonflikte.
- Kommentare: Neue Kommentare erscheinen sofort in allen verbundenen Browsern. Es ist kein Seitenaktualisierung erforderlich.
- Ausführungsprotokolleinträge: Systemgenerierte Einträge (Schritt gestartet, abgeschlossen usw.) und Benutzerkommentare erscheinen in Echtzeit.
Notizen und Kommentare bei terminalen Instanzen
Abschnitt betitelt „Notizen und Kommentare bei terminalen Instanzen“Wenn eine Instanz den Status Abgeschlossen oder Storniert erreicht:
- Alle Ausführungsnotizen werden schreibgeschützt
- Es können keine neuen Ausführungskommentare mehr hinzugefügt werden
- Bestehende Notizen und Kommentare bleiben für Prüf- und Überprüfungszwecke sichtbar
- Das Ausführungsprotokoll bleibt mit allen Filteroptionen einsehbar
Bewährte Praktiken
Abschnitt betitelt „Bewährte Praktiken“Notizen für sich entwickelnde Informationen verwenden
Abschnitt betitelt „Notizen für sich entwickelnde Informationen verwenden“- Halten Sie einen laufenden Status in der Instanzausführungsnotiz aufrecht (z. B. “Derzeit bei Schritt 3.2 blockiert — warten auf Lieferantenantwort”)
- Verwenden Sie Schrittnotizen für schrittspezifische bekannte Probleme oder Umgehungslösungen
- Aktualisieren Sie Notizen, wenn sich die Situation ändert; Notizen sollen den aktuellen Zustand widerspiegeln
Kommentare für zeitpunktbezogene Aufzeichnungen verwenden
Abschnitt betitelt „Kommentare für zeitpunktbezogene Aufzeichnungen verwenden“- Posten Sie Kommentare, wenn eine Entscheidung getroffen wird (“Entschieden, mit Option B gemäß Johns Empfehlung fortzufahren”)
- Übergaben zwischen Schichten dokumentieren (“Schicht 2 übernimmt. Schritte 1-4 abgeschlossen, Schritt 5 in Bearbeitung”)
- Unerwartete Beobachtungen aufzeichnen, die für das Prüfprotokoll erhalten bleiben sollen
Das Ausführungsprotokoll nutzen
Abschnitt betitelt „Das Ausführungsprotokoll nutzen“- Verwenden Sie Ausführungsprotokollkommentare für die Echtzeit-Teamkommunikation während der aktiven Ausführung
- Filtern Sie nach Zwangsaktionen, wenn Sie Instanzen auf Compliance überprüfen
- Verwenden Sie Datumsbereichsfilter, um sich auf bestimmte Ausführungsphasen zu konzentrieren