Beginnen Sie mit Tests mit einfachem Text und der Tastatur: Kopieren Sie aus einer lokalen Anwendung, klicken Sie in das Collabora-Dokument und drücken Sie die Eingabetaste Ctrl+V(oder Command+VStrg+Eingabetaste unter macOS). Um Text aus einer anderen Anwendung zu kopieren, markieren Sie den Text in Collabora, drücken Sie Strg+ Eingabetaste Ctrl+Coder Command+CStrg+Eingabetaste und fügen Sie ihn anschließend in eine lokale Anwendung ein. Wenn die Tastenkombinationen funktionieren, das Einfügen über die Symbolleiste oder per Rechtsklick jedoch nicht, liegt das Problem wahrscheinlich an den Berechtigungen des Browsers für die Zwischenablage. Falls auch die Tastenkombinationen nicht funktionieren, testen Sie beide Richtungen und prüfen Sie, ob Collabora in eine andere Website eingebettet ist.
Die Systemzwischenablage ist der gemeinsame Puffer, über den Daten zwischen Anwendungen ausgetauscht werden. Collabora Online läuft innerhalb eines Browsers, daher unterliegt das Kopieren über die Grenzen des Browsers hinweg auch den Sicherheitsregeln des Browsers.
Verwenden Sie für den ersten Test Klartext. Bilder, Tabellen, Tabellenbereiche und formatierter Text können unterschiedliche Zwischenablageformate verwenden, daher trennt ein Klartexttest den grundlegenden Zugriff von Formatkonvertierungsproblemen.
Klicken Sie in den Bearbeitungsbereich des Dokuments, um ihn zu aktivieren. Verwenden Sie die Systemkürzel anstelle der Editor-Symbolleiste oder des Browser-Kontextmenüs. Unter Windows und Linux verwenden Sie Strg+Alt+F und Strg+C Ctrl+C; Ctrl+Vunter macOS verwenden Sie Strg+Alt+F und Strg+ Command+CC Command+V. Wenn Collabora eine Meldung anzeigt, dass der Browser nur eingeschränkten Zugriff auf die Zwischenablage hat und Sie zur Verwendung von Tastenkombinationen auffordert, befolgen Sie diese Anweisung. Die Tastaturaktion ist direkt an eine Benutzergeste gebunden und funktioniert auch dann, wenn eine Menüaktion, die die asynchrone Clipboard-API aufruft, blockiert ist.
Falls dies nicht der Fall ist, stellen Sie sicher, dass das Dokument bearbeitbar ist, sich der Cursor im Dokument und nicht in einem Suchfeld oder einer Symbolleiste befindet und der Quelltext tatsächlich ausgewählt ist. Schließen Sie das Dokument nach einer Berechtigungsänderung und öffnen Sie es erneut; ein veralteter Editor kann die vorherige Richtlinie beibehalten.
Prüfen Sie zunächst, ob der reine Text korrekt übertragen wurde. Testen Sie anschließend die gewünschten formatierten Inhalte; Schriftarten, Formeln, Bilder und Zellformate werden möglicherweise nicht identisch übertragen. Verwenden Sie die Funktion „Inhalte einfügen“, falls diese im Zielprogramm verfügbar ist.
Die moderne Zwischenablage-API ist auf sichere Umgebungen (in der Regel HTTPS) beschränkt, und Browser können eine Benutzeraktion oder -berechtigung anfordern. Öffnen Sie in Chrome oder Edge die Websiteinformationen neben der Adresse, rufen Sie die Websiteeinstellungen auf und aktivieren Sie die Option „Zwischenablage zulassen “ für die vertrauenswürdige Website, sofern die entsprechende Berechtigung verfügbar ist. Falls beim Auswählen von „Einfügen“ eine Browserabfrage erscheint, erlauben Sie dies nur für den Office-Dienst, dem Sie vertrauen. Laden Sie das Dokument neu und wiederholen Sie den Test mit dem bidirektionalen Text.
Die Berechtigungen für die Zwischenablage und deren Verhalten variieren je nach Browser. Einige Browser verwenden eine Benutzergeste oder eine kurzzeitige Einfügeaufforderung anstelle einer dauerhaften Berechtigung. Ein verwalteter Browser kann zudem eine Richtlinie erzwingen, die Ihre Auswahl überschreibt. Wenn die Steuerung gesperrt oder die Berechtigung durch eine Richtlinie verweigert wird, bitten Sie den Browseradministrator, die Regel für die Website Ihres Unternehmens zu überprüfen. Stellen Sie sicher, dass die Website über HTTPS läuft: Die Erteilung einer Berechtigung macht eine unsichere Verbindung nicht automatisch sicher.
Ein iFrame ist eine Webseite, die in eine andere Seite eingebettet ist. Viele Collabora-Installationen verwenden einen iFrame, damit die Host-Plattform den Editor anzeigen kann. In Chromium-basierten Browsern benötigt ein Cross-Origin-Frame möglicherweise die Freigabe des Zwischenablagezugriffs durch die einbettende Seite. Das Collabora SDK-Handbuch dokumentiert dieses iFrame-Attribut für die Abfrage der Zwischenablageberechtigung.
<iframe allow="clipboard-read *; clipboard-write *">
Dies ist eine Einstellung für die Integration, die den Frame erstellt, keine Docker-Einstellung auf dem Collabora-Server. Wenn Sie die Host-Anwendung verwalten, überprüfen Sie den Editor-iFrame in den Entwicklertools Ihres Browsers und stellen Sie sicher, dass der Antwortheader der übergeordneten Seite Permissions-Policyden Zugriff nicht blockiert clipboard-read. clipboard-writeEine restriktive Richtlinie der übergeordneten Seite kann den Zugriff auch dann verweigern, wenn der iFrame ein entsprechendes Attribut besitzt allow. Delegieren Sie den Zugriff nur an den Collabora-Frame, den Ihre Benutzer benötigen; gewähren Sie keinen umfassenden Zugriff auf die Zwischenablage für nicht zugehörige eingebettete Inhalte.
Wenn Sie eine gehostete Nextcloud-, Lernplattform oder ein Dokumentenportal verwenden und die Frame-Markup- oder Antwortheader nicht bearbeiten können, senden Sie dem Administrator bitte die Browserversion, die fehlgeschlagene Richtung, ob Tastenkombinationen funktionieren und alle Konsolenfehler im Zusammenhang mit der Zwischenablage. Möglicherweise muss die Integration aktualisiert werden. Das Ändern der Netzwerkports von CODE oder ein Neustart des Containers gewährt keine Browserberechtigung für iFrames.
| Was Sie beobachten | Was Sie als Nächstes überprüfen sollten |
|---|---|
Das Einfügen über die Symbolleiste schlägt fehl, Ctrl+Vfunktioniert aber | Verwenden Sie die Tastenkombination oder erteilen Sie dem Browser die angeforderte Berechtigung zum Ablegen der Zwischenablage für die vertrauenswürdige Website. |
| Nur das Kopieren von Collabora auf den Desktop schlägt fehl. | Prüfen Sie, ob Kopierbeschränkungen oder Schreibberechtigungen des Browsers vorliegen; vergewissern Sie sich, dass nur der markierte Text kopiert wird. |
| Nur das Einfügen vom Desktop in Collaborata schlägt fehl. | Prüfen Sie, ob der Browser die Einfügeberechtigung hat, ob der Fokus im Dokument liegt und ob der Host-Frame Lesezugriff delegiert. |
| Die Konsole meldet: „Die Zwischenablage-API wurde durch eine Berechtigungsrichtlinie blockiert.“ | Die Einbettungsseite oder deren Antwortheader blockiert den Zugriff. Der Inhaber der Integration muss dies anpassen. |
| Reiner Text funktioniert, Rich Content jedoch nicht. | Vergleichen Sie die unterstützten Zwischenablageformate mit den Einfügeoptionen der Ziel-App; es könnte sich eher um eine Einschränkung der Formatgenauigkeit als um einen kompletten Fehler der Zwischenablage handeln. |
Nach einer Änderung der Berechtigungen oder der Integration öffnen Sie das Dokument erneut und wiederholen Sie beide Tests mit Klartext: von der lokalen Anwendung zu Collabora und anschließend von Collabora zur lokalen Anwendung. Prüfen Sie, ob der Text an der gewünschten Stelle erscheint, und testen Sie dann die spezifischen Rich-Content-Funktionen, auf die Sie angewiesen sind. Funktioniert nach der Änderung nur das Menü, überprüfen Sie auch die Tastatureingabe. Funktionieren hingegen nur Tastenkombinationen, ist der interne Pfad zur Zwischenablage nutzbar, der asynchrone Zugriff auf Browserberechtigungen jedoch möglicherweise weiterhin blockiert.
Die Sicherheitsregeln für den Zugriff auf die Browser-Zwischenablage finden Sie in der MDN-Referenz zur Clipboard-API . Informationen zu den Website-Berechtigungen in Chrome finden Sie in der Chrome-Hilfe zu den Website-Einstellungen . Integrationsverantwortliche können die Dokumentation zur erweiterten Integration von Collabora bezüglich der Berechtigungsanforderungen für die Zwischenablage in iFrames einsehen.
Aktivieren Sie die sichere Dokumentenbearbeitung in Seafile, indem Sie die Discovery-URL, HTTPS und den WOPI-Zugriff von Collabora für Ihre Bereitstellung konfigurieren.
Testen Sie die Systemzwischenablage, passen Sie die Browserberechtigungen an und ermitteln Sie, wann eine eingebettete Collabora-Integration eine Änderung der iFrame-Richtlinie erfordert.
Binden Sie Schriftartdateien in Docker und Collaboras Systemplate ein, damit benutzerdefinierte Schriftarten im Editor angezeigt und in Dokumenten korrekt dargestellt werden.
Sichern Sie die Datei coolwsd.xml und ihre Bereitstellungsquellen, stellen Sie sie sicher wieder her und überprüfen Sie den CODE, bevor die Benutzer die Bearbeitung wieder aufnehmen.
Erlauben Sie den genauen Ursprung von Nextcloud oder einer anderen WOPI-Instanz im CODE, überprüfen Sie dann die aktive Host-Zulassungsliste und unterscheiden Sie diese von der Quell-IP-Beschränkung von Nextcloud.
Analysieren Sie die Browser-, WOPI- und WebSocket-Verbindungen von Collabora, um herauszufinden, warum sich ein Dokument nicht öffnen lässt, und wenden Sie dann die Lösung an, die zu Ihrer Nextcloud-Konfiguration passt.
Mit Helm können Collabora CODE-Replikate bereitgestellt werden, wobei jedes Dokument über WOPI-Affinität auf einem Pod verbleibt, und Ingress, Knotenplatzierung und Nextcloud-Bearbeitung können überprüft werden.
Verfolgen Sie einen fehlgeschlagenen Socket-Handshake vom Browser zu coolwsd und gleichen Sie dann die Reverse-Proxy-Route mit Ihrer Collabora-Version ab, einschließlich der Apache-Änderung CODE 26.04.
Verfolgen Sie Collabora WOPI-Beweisfehler auf nicht übereinstimmende Schlüssel, veraltete Erkennungsdaten, Zeitabweichungen oder Änderungen der Proxy-URL – ohne die Validierung zu schwächen.
Browserzoom zurücksetzen, eine saubere Sitzung testen und feststellen, wann ein fehlerhaftes Größenmenü ein Collabora-Server-Update erfordert.
