So öffnen Sie .CWL-Dateien unter Windows
Um .CWL-Dateien unter Windows zu öffnen, wenn Sie den Workflow ausführen möchten, installieren Sie einen CWL-Runner wie die cwltool-Referenzimplementierung und führen Sie ihn dann von einem Terminal aus mit Ihrer .cwl-Datei (und allen erforderlichen Eingabeobjektdateien) aus.
Schritt-für-Schritt-Anleitung
- Wenn Sie den Workflow ausführen möchten, installieren Sie einen CWL-Runner wie die cwltool-Referenzimplementierung und führen Sie ihn dann von einem Terminal aus mit Ihrer .cwl-Datei (und allen erforderlichen Eingabeobjektdateien) aus.
- Wenn Sie es nur lesen/bearbeiten müssen, öffnen Sie die .cwl-Datei in einem Nur-Text-Editor (CWL-Dokumente sind normalerweise YAML oder JSON).
- Wenn Sie sich nicht sicher sind, welchen Runner Sie verwenden sollen, konsultieren Sie die offizielle CWL-Liste „Implementierungen“ und wählen Sie einen Executor aus, der zu Ihrer Umgebung passt.
Empfohlene Software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative Methoden
- Open .CWL in a browser-based viewer if desktop apps fail.
- Try opening .CWL on Windows with a secondary app to rule out app-specific issues.
- Convert .CWL only with trusted tools when direct opening is not possible.
Häufige Probleme
Die .CWL-Datei wird als Text geöffnet, aber nicht „ausgeführt“.
Eine .cwl-Datei ist eine Workflow-/Tool-Beschreibung, kein eigenständiges Programm. Es muss von einem CWL-Läufer ausgeführt werden, normalerweise zusammen mit einer Eingabeobjektdatei und den erforderlichen Tools/Containern.
- Führen Sie die Datei mit einem CWL-Executor (z. B. der cwltool-Referenzimplementierung) aus, anstatt darauf zu doppelklicken.
- Prüfen Sie, ob der Workflow eine separate Eingabeparameterdatei (häufig YAML/JSON) erwartet und stellen Sie diese bei der Ausführung bereit.
- Stellen Sie sicher, dass die referenzierten Befehlszeilentools oder Container in Ihrer Umgebung verfügbar sind.
Runner meldet Validierungsfehler oder „nicht unterstützte CWL-Version“
CWL-Dokumente deklarieren eine CWL-Version und müssen der Spezifikation entsprechen; Ein Runner kann Dokumente ablehnen, die nicht dem erwarteten Schema oder der erwarteten Version entsprechen.
- Bestätigen Sie die CWL-Version des Dokuments und vergleichen Sie sie mit den unterstützten Versionen Ihres Läufers.
- Validieren Sie die Dokumentstruktur anhand der CWL-Spezifikation und korrigieren Sie fehlende/falsche Felder.
- Probieren Sie eine andere CWL-Implementierung aus der offiziellen Liste aus, wenn Ihr aktueller Executor die Funktionen des Dokuments nicht unterstützt.
Der Workflow wird gestartet, schlägt jedoch aufgrund fehlender Tools, Pfade oder Container fehl
CWL-Workflows rufen häufig externe Befehlszeilentools oder Container auf; Fehler treten auf, wenn Abhängigkeiten nicht vorhanden sind, nicht zugänglich sind oder von den Erwartungen des Workflows abweichen.
- Überprüfen Sie die Workflow-/Tool-Anforderungen und stellen Sie sicher, dass die erforderliche Software installiert oder über Container-Referenzen verfügbar ist.
- Überprüfen Sie Dateipfade und Eingabedateinamen in Ihrem Eingabeobjekt. Stellen Sie sicher, dass referenzierte Dateien vorhanden und lesbar sind.
- Führen Sie die Ausführung mit erhöhter Protokollierung in Ihrem Executor aus, um zu ermitteln, welcher Schritt fehlgeschlagen ist und warum, und passen Sie dann die Umgebung oder Eingaben entsprechend an.
Verwirrung bei der Dateizuordnung (wird in der falschen App geöffnet)
Betriebssysteme erkennen .cwl möglicherweise nicht als ausführbare Workflow-Beschreibung und öffnen sie mit einem Standardeditor oder einem nicht verwandten Programm.
- Öffnen Sie es explizit mit einem Texteditor zum Anzeigen oder mit Ihrem CWL-Runner über die Befehlszeile zur Ausführung.
- Vermeiden Sie es, die Erweiterung zu ändern; Installieren/konfigurieren Sie stattdessen einen CWL-Runner und verwenden Sie ihn zum Verarbeiten der Datei.
- Wenn Sie konsistentes Verhalten benötigen, dokumentieren Sie einen Standardläufer und -befehl für Ihr Team (z. B. mit cwltool).
Sicherheitshinweis
Behandeln Sie .cwl-Dateien als ausführbare Anweisungen: Durch das Ausführen eines CWL-Workflows können Befehlszeilentools ausgeführt und Dateien gelesen/geschrieben werden. Führen Sie daher Workflows nur von Quellen aus, denen Sie vertrauen.