Iniziate con un test utilizzando testo semplice e tastiera: copiate da un'app locale, fate clic all'interno del documento di Collabora e premete Ctrl+V(o Command+Vsu macOS). Per copiare, selezionate il testo in Collabora, premete Ctrl+Co Command+C, quindi incollatelo in un'app locale. Se le scorciatoie funzionano ma la barra degli strumenti o l'opzione Incolla tramite clic destro non funzionano, il problema è probabilmente legato al percorso delle autorizzazioni degli appunti del browser. Se anche le scorciatoie non funzionano, provate entrambe le direzioni e verificate se Collabora è incorporato in un altro sito.
Gli appunti di sistema sono il buffer condiviso che trasferisce i dati tra le applicazioni. Collabora Online viene eseguito all'interno di un browser, quindi la copia di dati al di fuori di esso passa anche attraverso le regole di sicurezza del browser.
Per il primo test, utilizza testo semplice. Immagini, tabelle, intervalli di fogli di calcolo e testo formattato possono utilizzare formati di appunti diversi, quindi un test con testo semplice permette di distinguere l'accesso di base dai problemi di conversione del formato.
Fai clic sull'area di modifica del documento per selezionarla. Utilizza la scorciatoia di sistema anziché la barra degli strumenti dell'editor o il menu contestuale del browser. Su Windows e Linux, usa Ctrl+Ce Ctrl+V; su macOS, usa Command+Ce Command+V. Quando un messaggio di Collabora indica che il browser ha un accesso limitato agli appunti e ti chiede di utilizzare le scorciatoie, segui tale istruzione. L'azione da tastiera è direttamente collegata a un gesto dell'utente e può funzionare anche quando un'azione di menu che richiama l'API asincrona degli appunti è bloccata.
Se ciò non accade, assicurati che il documento sia modificabile, che il cursore si trovi all'interno del documento e non in una casella di ricerca o in un campo della barra degli strumenti e che il testo sorgente sia effettivamente selezionato. Chiudi e riapri il documento una volta dopo aver modificato le autorizzazioni; una finestra dell'editor non aggiornata potrebbe mantenere le impostazioni precedenti.
Innanzitutto, verifica che il testo semplice venga ricevuto correttamente. Quindi, testa il contenuto formattato di cui hai bisogno; caratteri, formule, immagini e formati di cella potrebbero non essere trasferiti in modo identico. Utilizza la funzione Incolla speciale quando il paese di destinazione la offre.
L'API Appunti moderna è limitata a contesti sicuri, in genere HTTPS, e i browser possono richiedere un'azione o un'autorizzazione da parte dell'utente. In Chrome o Edge, apri le informazioni sul sito accanto all'indirizzo, apri le impostazioni del sito e imposta Appunti su Consenti per il sito attendibile quando tale autorizzazione è disponibile. Se viene visualizzato un messaggio di richiesta del browser quando scegli Incolla, consentilo solo per il servizio di Office di cui ti fidi. Ricarica il documento e ripeti il test del testo bidirezionale.
Le etichette e il comportamento relativi alle autorizzazioni per gli appunti variano a seconda del browser. Alcuni browser utilizzano un gesto dell'utente o una richiesta di incolla temporanea anziché un'autorizzazione permanente. Un browser gestito può anche imporre una policy che ha la precedenza sulla scelta dell'utente; se il controllo è bloccato o l'autorizzazione è negata dalla policy, chiedere all'amministratore del browser di verificare la regola per il sito aziendale. Mantenere il sito su HTTPS: concedere un'autorizzazione non trasforma un'origine non sicura in un contesto sicuro.
Un iframe è una pagina web incorporata all'interno di un'altra pagina. Molte implementazioni di Collabora ne utilizzano uno per consentire alla piattaforma host di visualizzare l'editor. Nei browser basati su Chromium, un frame cross-origin potrebbe richiedere alla pagina che lo incorpora di delegare l'accesso agli appunti. Il manuale dell'SDK di Collabora documenta questo attributo dell'iframe per la sua richiesta di autorizzazione agli appunti:
<iframe allow="clipboard-read *; clipboard-write *">
Questa è un'impostazione per l'integrazione che crea il frame, non un'impostazione Docker sul server Collabora. Se gestisci l'applicazione host, verifica l'iframe dell'editor effettivo negli strumenti per sviluppatori del browser e controlla che l' Permissions-Policyintestazione di risposta della pagina padre non blocchi clipboard-reado clipboard-write. Una policy padre restrittiva può comunque negare l'accesso anche quando l'iframe ha un allowattributo. Delega solo al frame Collabora di cui i tuoi utenti hanno bisogno; non concedere un accesso esteso agli appunti a contenuti incorporati non correlati.
Se utilizzi un servizio Nextcloud, una piattaforma di apprendimento o un portale di documenti ospitato e non riesci a modificarne il markup del frame o le intestazioni di risposta, comunica all'amministratore il browser e la versione, il percorso che ha generato l'errore, se le scorciatoie da tastiera funzionano e qualsiasi errore della console relativo agli appunti. Potrebbe essere necessario aggiornare l'integrazione. La modifica delle porte di rete di CODE o il riavvio del suo container non concederanno l'autorizzazione al browser per l'iframe.
| Ciò che osservi | Cosa controllare dopo |
|---|---|
La funzione Incolla della barra degli strumenti non funziona, ma Ctrl+Vfunziona | Utilizza la scorciatoia o concedi al sito attendibile l'autorizzazione per accedere agli appunti del browser. |
| Solo la collaborazione alla copia desktop non riesce | Verifica le restrizioni di copia o i permessi di scrittura del browser; conferma che il testo selezionato sia stato copiato correttamente. |
| Solo l'operazione di incolla dal desktop a Collabora non riesce. | Verifica i permessi di incolla del browser, assicurati che il focus sia sul documento e che il frame host deleghi l'accesso in lettura. |
| La console visualizza il messaggio "L'API degli appunti è stata bloccata da una policy di autorizzazioni". | La pagina di incorporamento o la sua intestazione di risposta sta bloccando l'accesso. Il responsabile dell'integrazione deve modificarla. |
| Il testo semplice funziona, ma il contenuto formattato no. | Confronta i formati degli appunti supportati e le opzioni di incolla dell'applicazione di destinazione; potrebbe trattarsi di un limite di fedeltà del formato piuttosto che di un malfunzionamento totale degli appunti. |
Dopo una modifica delle autorizzazioni o dell'integrazione, riapri il documento e ripeti entrambi i test di testo semplice: dall'app locale a Collabora, quindi da Collabora all'app locale. Verifica che il testo venga visualizzato nella posizione prevista, quindi testa il contenuto formattato specifico su cui fai affidamento. Se dopo la modifica funziona solo il menu, verifica anche il percorso da tastiera; se funzionano solo le scorciatoie, il percorso principale degli appunti è utilizzabile, ma il percorso asincrono delle autorizzazioni del browser potrebbe essere ancora bloccato.
Per le regole di sicurezza relative all'accesso agli appunti del browser, consultare la documentazione di riferimento dell'API Clipboard di MDN . Per i controlli delle autorizzazioni del sito di Chrome, consultare la guida alle impostazioni del sito di Chrome . I responsabili dell'integrazione possono consultare la documentazione avanzata di Collabora sull'integrazione per i requisiti di autorizzazione agli appunti degli iframe.
Abilita la modifica sicura dei documenti in Seafile configurando l'URL di individuazione di Collabora, HTTPS e l'accesso WOPI per la tua implementazione.
Verifica gli appunti di sistema, regola le autorizzazioni del browser e identifica quando un'integrazione di Collabora incorporata richiede una modifica dei criteri iframe.
Monta i file dei font nella cartella di sistema di Docker e Collabora in modo che i caratteri personalizzati vengano visualizzati nell'editor e riprodotti correttamente nei documenti.
Eseguire il backup del file coolwsd.xml e delle relative sorgenti di distribuzione, ripristinarli in modo sicuro e verificare il CODICE prima che gli utenti riprendano la modifica.
Consenti l'origine Nextcloud o altra origine WOPI esatta nel CODE, quindi verifica l'elenco degli host consentiti attivi e distinguilo dalla restrizione IP di origine di Nextcloud.
Analizza le connessioni del browser, WOPI e WebSocket di Collabora per capire perché un documento non si apre, quindi applica la soluzione più adatta alla tua configurazione di Nextcloud.
Distribuisci repliche di Collabora CODE con Helm, mantieni ogni documento su un singolo pod tramite l'affinità WOPI e verifica l'ingress, il posizionamento dei nodi e la modifica su Nextcloud.
Traccia un handshake socket non riuscito dal browser a coolwsd, quindi abbina il percorso del reverse proxy alla tua versione di Collabora, inclusa la modifica Apache CODE 26.04.
Traccia gli errori di WOPI di Collabora dovuti a chiavi non corrispondenti, dati di rilevamento obsoleti, deriva dell'orologio o modifiche all'URL del proxy, senza indebolire la convalida.
Reimposta lo zoom del browser, testa una sessione pulita e identifica quando un menu di dimensioni non corretto richiede un aggiornamento del server Collabora.
