|
<< Click to Display Table of Contents >> RayQC > 2026.3 > User Guide > Checklist Structures > Basic Checklist Properties > Steps and Actions > Element Options Plug-Ins verwenden |
Bedingungen sind ein geeignetes Werkzeug, um einer Checkliste dynamische Aspekte hinzuzufügen. Das andere Werkzeug ist die offene Plug-in-Schnittstelle, die RayQC für alle Elementtypen bereitstellt. Ein Plug-in kann bereits ausgefüllte Felder lesen, diese Werte verarbeiten und andere Felder mit Daten füllen. Der Aufwand beim Ausfüllen einer Checkliste kann auf diese Weise erheblich reduziert werden.
|
Tipp: Dieser Abschnitt behandelt die Plug-in-Optionen, die für die Elementkonfiguration in der Checklisten-Editor-Oberfläche verfügbar sind, sowie die Auswirkungen von Plug-ins auf Checklisten-Projekte im Checklisten-Viewer. Weitere Details zu den verfügbaren Typen interner Standard-Plug-ins, erforderlichen Dateien und Definitionen für die Integration externer (benutzerdefinierter) Plug-ins sowie Tipps zur Kombination von Plug-ins für erweiterte Checklistenlogik-Implementierungen finden Sie im Abschnitt Plug-ins. |
1.Scrollen Sie im Checklisten-Editor zum Element, das mit einem Plug-in ausgestattet werden soll.
2.Wählen Sie das Element mit einem Linksklick aus und öffnen Sie seine Plug-in-Registerkarte im Details-Bereich auf der rechten Seite.
Bitte beachten Sie, dass Information-Elemente nicht durch Plug-in-Funktionen erweitert werden können und daher keine Plug-in-Registerkarte in ihrem Details-Bereich haben.
3.Durchsuchen Sie die in der Symbolleiste angezeigte Plug-in-Liste nach der gewünschten Funktion. Verwenden Sie bei Bedarf das Suchfeld. Ziehen Sie die gewünschte Plug-in-Funktion auf die Plug-in-Registerkarte des Details-Bereichs, der für das aktuell ausgewählte Element angezeigt wird. (Als Alternative können Plug-in-Funktionen auch auf ein Element gezogen werden, das bereits im Checklistenstrukturbereich in der Mitte der Checklisten-Editor-Oberfläche vorhanden ist. Das Ablegen einer Plug-in-Funktion erfordert jedoch dennoch das Öffnen der Plug-in-Registerkarte des betroffenen Elements, um die erforderlichen Parametereinstellungen der Plug-in-Funktion definieren zu können.)
Bitte beachten Sie, dass jede Plug-in-Funktion über eine definierte Menge gültiger übergeordneter Elemente verfügt. Wenn eine Funktion nicht in Kombination mit einem bestimmten Elementtyp verwendet werden kann, verhindert RayQC, dass Benutzer die Plug-in-Funktion auf diesen Elementtyp ziehen. Die interne Plug-in- Dokumentation enthält Informationen zu gültigen Funktion-Elementtyp-Kombinationen. Externe Plug-ins müssen diese Informationen als Teil ihrer Manifest-Datei enthalten.
Ein weiterer wichtiger Aspekt bei der Plug-in-Verwendung ist, dass jedes Element nur mit maximal einer Plug-in-Funktion kombiniert werden kann. Wenn ein Benutzer daher versucht, eine Plug-in-Funktion auf ein Element zu ziehen, dem bereits eine Plug-in-Funktion zugewiesen ist, zeigt RayQC einen Dialog an, in dem der Benutzer gefragt wird, was zu tun ist: Die vorhandene Plug-in-Funktion für dieses Element ersetzen oder das Hinzufügen der neuen Plug-in-Funktion abbrechen.
Änderungen an der Plug-in-Verwendung können erhebliche Auswirkungen auf den logischen Ablauf von Checklisten haben. Stellen Sie sich vor, dass in Szenario A ein bestimmtes Element ein Boolean-Ergebnis konvertiert (z. B. durch Verwendung der InvertBoolean-Funktion des Logic-Plug-ins), während diese Umkehrung in Szenario B fehlt: Dieser kleine Unterschied kann dazu führen, dass bedingte Abhängigkeiten und Referenzen, die durch die Verwendung von Elementergebnissen für Funktionsparameterdefinitionen hergestellt wurden, völlig anders ausgewertet werden, was wiederum zu einem dramatisch veränderten Auswertungsablauf führen kann. Es wird daher dringend empfohlen, das Ergebnis eines Plug-in-Austausches zu überprüfen, um unerwünschte Nebeneffekte zu vermeiden.
4.Sobald ein Plug-in zu einem Element hinzugefügt wurde, zeigt RayQC Eingabesteuerelemente für die Parameter an, die zur erfolgreichen Ausführung der Plug-in-Funktion erforderlich sind.
Da jedes Plug-in über einen eigenen Parametersatz verfügt, kann in diesem Abschnitt keine vollständige Liste bereitgestellt werden. Es wird dringend empfohlen, den Abschnitt Plug-ins für Details zu den internen Plug-ins zu lesen, die mit den RayQC-Installationsressourcen geliefert werden, sowie die Manifest-Datei zu überprüfen oder den Autor externer Plug-ins für eine detailliertere technische Dokumentation zu kontaktieren.
5.Jetzt ist es an der Zeit, die Änderungen an der Checklistenvorlage zu speichern und diese zu testen, indem Sie die Schritte der Checkliste im Checklisten-Viewer durchlaufen.
6.Stellen Sie sicher, dass alle Elementergebnisse wie erforderlich gesetzt werden, um alle Parameterwerte und Element-/Gruppenverfügbarkeitsstatuseinstellungen bereitzustellen, die erforderlich sind, um das Element mit dem neu erstellten Plug-in verfügbar und vollständig vorbereitet zu machen.
7.Im Kontrollkästchen des Elements in der Checklisten-Viewer-Oberfläche sollte ein nach rechts zeigendes Pfeilsymbol verfügbar sein. Durch Klicken auf dieses Symbol wird die Plug-in-Ausführung ausgelöst.
8.Stellen Sie sicher, dass die Plug-in-Logik wie erwartet ausgeführt wird. Falls erforderlich, bereiten Sie verschiedene Parametersätze vor, um sicherzustellen, dass erfolgreiche und fehlgeschlagene Ausführungen durch entsprechende Checklistenreaktionen abgedeckt sind (z. B. Fehlermeldungen in Kommentarelementen, dynamische Checklistenverzweigungsverfügbarkeit usw.). Das von der Ausführung der Plug-in-Funktion zurückgegebene Ergebnis wird standardmäßig als Ergebnis des Elements gespeichert, das die Plug-in-Funktion enthält. Aufgrund von Typkonvertierungen, Elementoptionen und anderen beeinflussenden Einstellungen kann das tatsächlich in der Checklisten-Viewer-Oberfläche angezeigte Ergebnis jedoch vom ursprünglichen Rückgabewert der Plug-in-Funktion abweichen. Dies ist beim Testen und Debuggen der verschiedenen Funktionsszenarien zu berücksichtigen.