|
<< Click to Display Table of Contents >> RayQC > 2026.3 > User Guide > Troubleshooting Fehlende Plug-ins |
Plug-ins sind ein wesentlicher Bestandteil der dynamischen Checklistenfunktionen in RayQC. Sie können entweder während der Checklistenerstellung/-bearbeitung im Checklisten-Editor fehlen oder während der Auswertung über den Checklisten-Viewer nicht erreichbar sein.
Wenn Checklisteneditoren die Plug-in-Option für ein Element aktivieren, gibt es drei mögliche Quellen für die angebotene Liste der Plug-ins. Wenn ein Plug-in im Plug-in-Auswahlsteuerelement für ein bestimmtes Checklistenelement verfügbar sein sollte, es aber nicht ist, führen die folgenden Schritte zu hilfreichen Informationen, die bei der Lösung des Problems helfen sollten.
•Interne Plug-ins
oFür alle mit RayQC erstellten Checklisten verfügbar, da sie zusammen mit den RayQC-Ressourcen geliefert und standardmäßig als Pflichtfunktion installiert werden.
oÖffnen Sie das RayQC-Programmverzeichnis (üblicherweise C:\Program Files (x86)\RayQC\). Prüfen Sie, ob ein \Libs\-Verzeichnis vorhanden ist und eine Datei mit dem Namen RayQC.plug-ins.dll enthält.
oBitte überprüfen Sie, ob die Datei- und Ordnernamen bei Groß-/Kleinschreibungssuchen korrekt sind.
•Globale externe Plug-ins
oFür alle mit der lokalen Instanz von RayQC ausgewerteten Checklisten verfügbar, einschließlich der von beliebigen RayQC-Benutzern vorbereiteten Plug-ins.
oStarten Sie RayQC und wechseln Sie dann zur Registerkarte Einstellungen ->Plug-ins. Prüfen Sie, ob das gewünschte Plug-in im Plug-in-Manager aufgelistet ist.
oÖffnen Sie das RayQC-Programmverzeichnis (üblicherweise C:\Program Files (x86)\RayQC\). Prüfen Sie, ob ein \plug-ins\-Verzeichnis vorhanden ist und ein (passendes) Set aus Plug-in-Logik ([plug-inName].ps1) und Schnittstellendefinition (Manifest.xml) in einem Unterverzeichnis vorhanden ist.
•Lokale externe Plug-ins
oEs wird in der Checklistendatei/Checklisten-Projektdatei gespeichert
oÖffnen Sie die Checklistendatei/das Projekt im Checklisten-Editor. Klicken Sie auf die Plug-ins-Registerkarte und stellen Sie sicher, dass das Plug-in im Manager angezeigt wird
oDa die RayQC-Checklistendatei grundsätzlich ein ZIP-Container ist, der die eigentliche checklist.xml-Datei, unterstützende Dateien und einen Plug-in-Ordner mit dem lokalen Plug-in enthält. Extrahieren Sie die Checklistendatei und wechseln Sie zum Plug-ins-Ordner. Überprüfen Sie, ob die Funktionen und ihre Argumente im Skript und seiner manifest.xml-Datei übereinstimmen.
Wenn eine der oben genannten Bedingungen nicht erfüllt ist, fehlen die Plug-in-Ressourcen und müssen an den angegebenen Speicherort kopiert oder dort erstellt werden.
Wenn das Plug-in an einem der oben aufgeführten Speicherorte verfügbar ist, prüfen Sie, ob der Benutzer, der RayQC aktuell ausführt, Zugriff auf die Ressourcendateien hat. Verwenden Sie dazu die Datei-/Ordnerberechtigungsverwaltung von Windows.
Da ein Plug-in ausgeführt werden muss, ist die mindestens erforderliche Zugriffsebene „Ausführen".
Wenn diese Bedingung nicht erfüllt ist, passen Sie die Berechtigungen wie erforderlich an und versuchen Sie erneut, das Plug-in in RayQC zu verwenden.
Wenn alle oben genannten Bedingungen überprüft und als erfüllt angesehen werden, wenden Sie sich bitte an Ihren RaySuite / RayQC-Systemadministrator oder kontaktieren Sie das Raynet-Supportteam über unser Support Panel für weitere Unterstützung.
Bitte überprüfen Sie die folgenden Abhängigkeiten:
•Jedes externe (d. h. nicht integrierte) Plug-in muss aus einem .ps1-Skript und einer .xml-Manifest-Datei bestehen. Diese beiden Dateien müssen im selben Verzeichnis gespeichert sein und die Manifest-Datei muss immer manifest.xml heißen.
•Die Funktionsnamen in der Manifest-Datei müssen mit den entsprechenden Funktionsnamen im PowerShell-Skript übereinstimmen. Dasselbe gilt für die Funktionsargumente.
•manifest.xml-Datei muss immer den strukturellen Kriterien der manifest.xsd-Datei entsprechen
Tatsächlich können alle oben genannten Szenarien dazu führen, dass ein Plug-in während der Auswertungsphase nicht zur Ausführung verfügbar ist. Es gibt jedoch noch weitere, die wahrscheinlich sind und daher einen Blick wert sind:
Wenn die Checklistenausführung durch einen RayFlow-Tool-Integrationsbefehl ausgelöst wurde, stellen Sie sicher, dass alle erforderlichen Parameter in einer geeigneten Bedingung enthalten sind.
Aufgrund des flexiblen Konfigurations- und Parameter-Injektionskonzepts der RaySuite-Produkte kann es Probleme mit dem bereitgestellten RayQC-Aufruf hinsichtlich folgender Punkte geben:
•die Tool-Integration in RayFlow selbst
•die Eigenschaftswerte des RayFlow-Workflow-Datenobjekts (z. B. nicht escapte Sonderzeichen in Parameterwerten, falsche Pfadwerte usw.)
•nicht verfügbare Ressourcen, wie Netzwerkfreigaben, die in den Plug-in-Definitionsdateien, der RayFlow-Tool-Integration und dergleichen referenziert werden können
Wenn eine Checklistenvorlage von einem Speicherort an einen anderen verschoben wird, ist es obligatorisch, alle lokalen externen und globalen externen Plug-in-Ressourcen mitzukopieren, damit sie in der neuen Checklistenumgebung verfügbar sind. (Dieselbe Anforderung für Ressourcenkopien gilt, wenn eine Checkliste relative Pfaddefinitionen zu Hilfedateien, Bildern und dergleichen enthält.) Als Alternative können die Checklistenressourcen auch auf einem gemeinsamen Speicherort abgelegt werden. Bitte stellen Sie sicher, dass der lokale oder Netzwerkpfad korrekt ist und die erforderlichen Ressourcen vorhanden, zugänglich und während der Dateiübertragung nicht beschädigt worden sind.