Quando provi ad aggiungere una scheda SharePoint in un canale di Microsoft Teams può comparire l’errore “We couldn’t complete that action”. In questa guida trovi cause probabili, un workaround stabile (scheda Website), checklist di verifica e consigli per amministratori.
Scenario e messaggio di errore
Durante l’aggiunta di una scheda a un canale di Teams con la sequenza “+” → SharePoint → Any SharePoint site → incolla URL della cartella → Salva, viene mostrato l’errore:
“We couldn’t complete that action”.
Il problema può ripetersi anche su canali appena creati, nonostante in passato la stessa procedura funzionasse correttamente. Nelle sezioni seguenti trovi una soluzione immediata e, a seguire, una diagnosi completa con tutte le verifiche consigliate.
Soluzione rapida (workaround consigliato)
Obiettivo: esporre la stessa cartella SharePoint in Teams, evitando il blocco dell’app “SharePoint”.
- Apri il canale desiderato e fai clic su “+”.
- Seleziona Website (o Sito web nella localizzazione italiana).
- Assegna un Nome scheda a piacere.
- Incolla l’URL completo della cartella SharePoint (vedi anche la sezione “Controllare l’URL”).
- Conferma con Salva.
Risultato: la cartella viene visualizzata in un iFrame come pagina Web e resta accessibile a tutti gli utenti che hanno i permessi necessari su SharePoint.
Stato attuale e segnalazione del bug
Il comportamento è coerente con un malfunzionamento dell’app “SharePoint” per Teams. Finché Microsoft non rilascia un fix, l’approccio Website rappresenta la soluzione più rapida e affidabile. È comunque utile segnalare il bug tramite il Community Feedback Portal di Microsoft Teams per consentire la correzione in un aggiornamento futuro.
Riepilogo sintetico delle opzioni
Approccio | Esito | Passaggi |
---|---|---|
Usare una scheda “Website” (workaround) | ✅ Funziona | 1. “+” nel canale → Website 2. Inserire un nome a piacere 3. Incollare l’URL completo della cartella SharePoint 4. Salva |
Segnalare il bug al team di sviluppo | — | Inviare feedback dal Community Feedback Portal di Microsoft Teams per sollecitare un aggiornamento correttivo. |
Perché la scheda “SharePoint” può fallire
Le cause più comuni dietro all’errore “We couldn’t complete that action” quando si collega una cartella SharePoint come scheda sono:
- Incosistenze di permessi: l’utente vede la cartella in SharePoint, ma un gruppo Teams include membri senza accesso in lettura. L’app tenta di risolvere i permessi durante l’embed e fallisce.
- URL non pulito o non diretto alla cartella: parametri come
?web=0
o link di condivisione temporanei possono interferire con l’embed. - Restrizioni di tenant o criteri: cartella ospitata su un tenant diverso (B2B/cross-tenant), Conditional Access o policy che bloccano l’anteprima (SharePoint viewer disabilitato per i tab).
- Cache o client obsoleto: Teams conserva dati locali che, se corrotti, impattano le app in scheda.
- Tipologia di risorsa: alcune viste particolari (cartelle con colonne personalizzate, viste filtrate o formattazione JSON complessa) possono innescare errori nell’host in iFrame.
Checklist operativa di diagnosi
Prima di procedere con attività avanzate, usa la seguente lista di controllo. È pensata per ridurre al minimo i falsi positivi e risolvere rapidamente i casi più frequenti.
Verifica permessi e tenant
- Conferma che la cartella appartenga allo stesso tenant del team. I tab di Teams non sono pensati per l’embed stabile di risorse cross-tenant.
- Assicurati che tutti i membri del canale abbiano almeno lettura sulla cartella o sulla libreria che la contiene.
- Preferisci l’assegnazione tramite gruppo di sicurezza o gruppi SharePoint (Visitors/Members) per una gestione coerente con la membership del team.
Ruolo SharePoint | Quando usarlo | Impatto su Teams |
---|---|---|
Visitors (Lettura) | Consultazione di file senza modifiche | La scheda visualizza i contenuti senza errori |
Members (Modifica) | Collaborazione su documenti | Consigliato per team operativi |
Owners (Controllo totale) | Gestione autorizzazioni e impostazioni | Limitato ai pochi amministratori del team |
Pulizia della cache di Teams e aggiornamento client
Una cache corrotta o un client “fuori supporto” è tra i primi indizi quando le app in scheda falliscono.
- Verifica aggiornamenti: in Teams seleziona l’icona profilo → Verifica aggiornamenti (o chiudi e riapri l’app “Nuovo Teams”).
- Pulisci cache:
- Windows (classico): chiudi Teams; apri
%appdata%\Microsoft\Teams
e svuota le cartelleCache
,blob_storage
,databases
,GPUCache
,IndexedDB
,Local Storage
,tmp
. Riavvia Teams. - Windows (nuovo Teams): esci da Teams; svuota la cache locale dell’app (cartelle di cache nell’area
%LocalAppData%
dell’app Teams). Riavvia. - macOS: chiudi Teams; svuota
~/Library/Application Support/Microsoft/Teams
(cache e storage); riapri Teams. - Web: prova in una finestra in incognito per escludere estensioni e cookie corrotti.
- Windows (classico): chiudi Teams; apri
Nota: se il problema scompare in modalità incognito o su browser differente, sospetta conflitti con estensioni o policy di sicurezza (cookie di terze parti bloccati) che impattano il rendering della scheda.
Controllare e “pulire” l’URL
Per l’embed in scheda, un URL “pulito” riduce gli errori.
- Apri la cartella in SharePoint e seleziona Copia collegamento.
- Preferisci un link diretto del tipo:
https://<tenant>.sharepoint.com/sites/<sito>/Shared%20Documents/<cartella>/Forms/AllItems.aspx
- Rimuovi parametri superflui come
?web=0
,?CT=
o token temporanei. Mantieni il percorso fino alla cartella o alla vistaAllItems.aspx
. - Se l’URL punta a una vista personalizzata, prova prima la vista standard per escludere problemi di formattazione.
Abilitare “Use SharePoint Viewer” (se previsto dalle policy)
Alcune organizzazioni limitano l’anteprima di contenuti SharePoint incorporati in Teams. Se sei amministratore, verifica in Teams Admin Center → Policies → Files che l’opzione per usare il viewer di SharePoint nelle schede sia consentita. Dopo una modifica, attendi la propagazione della policy e prova di nuovo.
Procedura alternativa: scheda “Document Library”
Oltre al tab SharePoint, Teams offre la scheda Document Library (Libreria documenti), che può risultare più tollerante in alcuni casi.
- Nel canale, clic su “+” → Document Library.
- Scegli Usa un collegamento a una raccolta SharePoint.
- Incolla l’URL della libreria (non della singola cartella, se inizialmente non funziona con la cartella). Esempio:
https://<tenant>.sharepoint.com/sites/<sito>/Shared%20Documents/Forms/AllItems.aspx
- Salva. Se la libreria viene caricata, naviga alla cartella dall’interno della scheda e “aggiungila ai preferiti” in Teams.
Se anche la scheda Document Library dovesse fallire, torna al metodo Website, che resta il più robusto finché il bug non sarà risolto.
Matrix di troubleshooting
Sintomo | Probabile causa | Azione consigliata |
---|---|---|
Errore immediato “We couldn’t complete that action” | Bug dell’app “SharePoint” in tab | Usa il tab Website o Document Library |
Alcuni utenti vedono la scheda, altri no | Permessi eterogenei sulla cartella/libreria | Allinea i permessi con i ruoli del team (Visitors/Members) |
Richieste di accesso ripetute dentro la scheda | Cookie/blocco terze parti o Conditional Access | Test in incognito, verifica policy e consentire il viewer di SharePoint |
La scheda si carica ma è vuota | Vista personalizzata incompatibile | Usa AllItems.aspx o rimuovi formattazioni JSON complesse |
Funziona nel browser, non su desktop | Cache client Teams o app non aggiornata | Pulisci la cache, aggiorna il client, riavvia |
Cartella di un tenant esterno | Cross-tenant embedding non supportato in tab | Condividi link esterno oppure sincronizza via OneDrive; evita il tab |
Best practice per un tab stabile e “a prova di utenti”
- Usa nomi di scheda chiari (es. “Documenti Progetto → Offerte”).
- Preferisci URL stabili alla cartella o alla libreria (evita link di condivisione “temporanei”).
- Minimizza le personalizzazioni di vista nella cartella esposta in scheda.
- Definisci permessi a livello di libreria (in ereditarietà), riduci rotture a livello di sotto-cartella.
- Comunica agli utenti che l’accesso in scheda riflette i permessi SharePoint (vedi il template in fondo).
Procedura di segnalazione efficace al supporto interno o a Microsoft
Se desideri coinvolgere il supporto, invia una segnalazione completa. Ecco un modello di contenuti utili:
- Contesto: canale, team, tipo di scheda che si desidera aggiungere, URL della cartella (eventualmente offuscato).
- Passaggi per riprodurre: “+” → SharePoint → Any SharePoint site → incolla URL → Salva.
- Risultato atteso: la cartella si carica nella scheda.
- Risultato effettivo: messaggio “We couldn’t complete that action”.
- Test effettuati: prova con tab Website (funziona / non funziona), prova in incognito, prova con altro utente, pulizia cache, verifica permessi.
- Allegati: screenshot dell’errore, versione del client, canale/tenant.
Domande frequenti (FAQ)
È sicuro usare la scheda “Website” per una cartella SharePoint?
Sì, a condizione che gli utenti abbiano già i permessi corretti su SharePoint. La scheda Website incapsula la stessa pagina in un iFrame: i controlli di autenticazione e autorizzazione restano quelli di Microsoft 365.
Perché a volte funziona l’URL della libreria ma non quello della cartella?
Alcune variabili (parametri, formattazioni della vista, colonne personalizzate) possono interferire quando il target è una sotto-cartella. Collegare la libreria e poi navigare alla cartella dall’interno della scheda è spesso più affidabile.
Posso collegare una cartella di un tenant esterno?
Non è consigliato. I tab di Teams sono progettati per risorse nel medesimo tenant. Per contenuti esterni, preferisci link di condivisione diretti o sincronizzazione con OneDrive dove appropriato.
Gli utenti vedono “Accesso negato” pur essendo nel team. Perché?
La membership del team non garantisce automaticamente i permessi su una libreria SharePoint esterna al sito collegato al team. Verifica che i gruppi del team siano mappati ai ruoli SharePoint corretti (almeno Visitors).
Il problema appare solo sull’app desktop, non nel browser.
È tipico di cache danneggiate o differenze di policy/cookie. Aggiorna l’app, svuota la cache e riprova. Se il tab Website funziona nel browser, puoi adottarlo come soluzione definitiva.
Guida passo–passo completa: dal problema alla soluzione
- Prova il workaround: aggiungi la scheda Website con l’URL della cartella. Se funziona, documenta il cambio e comunica agli utenti.
- Ripulisci l’URL ed eventualmente collega la libreria (scheda Document Library) come step alternativo.
- Allinea i permessi: assicurati che i membri del canale abbiano accesso alla cartella/libreria.
- Pulisci la cache / aggiorna l’app: elimina i fattori client-side.
- Controlla le policy: abilita il viewer SharePoint nelle schede se la tua organizzazione lo consente.
- Segnala il bug e monitora gli aggiornamenti: quando il fix sarà rilasciato, potrai tornare alla scheda “SharePoint”.
Esempi di URL “puliti” (da adattare al tuo ambiente)
- Libreria documenti (vista standard):
https://contoso.sharepoint.com/sites/ProgettoX/Shared%20Documents/Forms/AllItems.aspx
- Sotto-cartella all’interno della libreria:
https://contoso.sharepoint.com/sites/ProgettoX/Shared%20Documents/Offerte/Forms/AllItems.aspx
- Sotto-cartella senza vista (navigazione diretta):
https://contoso.sharepoint.com/sites/ProgettoX/Shared%20Documents/Offerte
Suggerimento: se la cartella contiene spazi, l’URL mostrerà %20
. Non modificarlo.
Impatto su sicurezza e governance
- Accesso: il tab non amplia i permessi. Vede solo chi è già autorizzato.
- Condivisione controllata: preferisci link “Solo persone con accesso esistente”. Evita link pubblici a meno di casi d’uso approvati.
- Visibilità: il nome della scheda è pubblico nel canale; non inserire informazioni sensibili nel titolo del tab.
Template di comunicazione agli utenti
Da oggi la cartella “<Nome cartella>” è accessibile dal canale Teams tramite la scheda “<Nome scheda>”. Se visualizzi un messaggio di accesso negato, richiedi l’abilitazione al Team Owner. La scheda riflette i permessi di SharePoint; il contenuto non viene duplicato.
Conclusioni
L’errore “We couldn’t complete that action” durante la creazione di una scheda SharePoint in Microsoft Teams indica verosimilmente un bug dell’app o una combinazione di URL/permessi/policy che impedisce l’embed della cartella. In attesa di un fix, il workaround più rapido e stabile è la scheda Website con lo stesso URL. Completa la soluzione con la verifica dei permessi, la pulizia della cache, il controllo delle policy e, se necessario, con la scheda Document Library. Documenta il cambiamento e comunica le istruzioni agli utenti per ridurre ticket e interruzioni.
Appendice: differenze tra le schede “SharePoint”, “Document Library” e “Website”
Tipo scheda | Vantaggi | Limiti | Quando sceglierla |
---|---|---|---|
SharePoint | Integrazione nativa, supporto a pagine e liste | Può fallire con cartelle/URL specifici o policy restrittive | Quando funziona regolarmente nell’ambiente |
Document Library | Focalizzata su file; spesso più robusta con le librerie | Talvolta richiede URL della libreria (non della cartella) | Per esporre intere librerie o navigare a cartelle dall’interno |
Website | Massima compatibilità con URL “puliti”; impatto minimo da bug dell’app | UI meno “nativa”; dipende da iFrame e cookie | Workaround consigliato finché il bug persiste |
Appendice: guida rapida per gli amministratori
- Policy file: consenti il SharePoint viewer nei tab.
- Conditional Access: verifica che i flussi di autenticazione non blocchino l’embed di SharePoint in Teams.
- Tenant boundary: evita schede che puntano a risorse di tenant esterni; privilegia sincronizzazione o link espliciti.
- Governance URL: promuovi l’uso di URL stabili (senza parametri dinamici) per tutte le integrazioni in Teams.