Lasciare Mermaid for Confluence, Swagger UI for Confluence o PowerPlantUML
Queste tre app di Confluence Cloud girano ancora su Atlassian Connect e non ricevono aggiornamenti da quando Atlassian ha congelato gli aggiornamenti di Connect. Atlassian termina il supporto a Connect il 31 gennaio 2027. Specdock è creato su Forge e copre tutte e tre: diagrammi Mermaid, documentazione Swagger/OpenAPI e diagrammi PlantUML, su qualsiasi pagina.
Quali app sono coinvolte
| App | Installazioni | Ultimo aggiornamento | Sostituire con |
|---|---|---|---|
| Mermaid for Confluence (Tech Labs) | circa 800 | dicembre 2024 | la macro per diagrammi Mermaid di Specdock |
| Swagger UI for Confluence (Tech Labs) | circa 650 | aprile 2025 | la macro OpenAPI / Swagger di Specdock |
| PowerPlantUML | circa 430 | maggio 2022 | la macro per diagrammi PlantUML di Specdock |
Fonte: Atlassian Marketplace, verificato il 14 novembre 2026.
Come passare, in quattro passaggi
- Un amministratore di Confluence installa Specdock da Atlassian Marketplace (gratis fino a 10 utenti).
- Apri Impostazioni → Impostazioni di Specdock ed esegui lo scanner di migrazione su uno spazio. Elenca ogni pagina che usa ancora una vecchia macro Swagger/OpenAPI, Mermaid o PlantUML, con il testo della specifica o del diagramma.
- In ogni pagina digita / e aggiungi la macro Mermaid, PlantUML o OpenAPI / Swagger di Specdock, poi incolla il testo (oppure indica lo stesso allegato, file Git o URL).
- Controlla la pagina, rimuovi la vecchia macro, pubblica. Quando non restano pagine, disinstalla la vecchia app.
Cosa ottieni con Forge
- Gira su Atlassian: nessun server esterno conserva le tue pagine.
- Specifiche da allegati, GitHub, GitLab o Bitbucket Cloud (anche repository privati), così la documentazione resta aggiornata.
- OpenAPI 3.x, Swagger 2.0 e AsyncAPI, più un report delle modifiche incompatibili tra due versioni.
Domande
Le mie pagine Mermaid, Swagger o PlantUML si romperanno il 31 gennaio 2027?
Atlassian termina il supporto alle app Connect il 31 gennaio 2027. Le app ancora su Connect dopo quella data non sono supportate e possono smettere di funzionare. Se la tua app non è passata a Forge, pianifica la sostituzione delle sue macro prima di allora.
Come trovo le pagine che usano la vecchia app?
Installa Specdock, apri Impostazioni → Impostazioni di Specdock ed esegui lo scanner di migrazione su uno spazio. Elenca le pagine che usano ancora una vecchia macro Swagger/OpenAPI, Mermaid o PlantUML, con il testo della specifica o del diagramma di ciascuna.
Devo riscrivere i miei diagrammi?
No. Il testo Mermaid e PlantUML funziona così com'è: copia il testo mostrato dallo scanner nella macro Mermaid o PlantUML di Specdock. Per Swagger/OpenAPI, punta la macro allo stesso allegato, file Git o URL.
La mia vecchia app è ancora su Connect?
Controlla con la verifica gratuita nella nostra guida sulla fine di Connect. Legge l'ultima versione dell'app da Atlassian Marketplace e indica se è su Forge, in migrazione o a rischio.
Quanto costa Specdock?
Gratis fino a 10 utenti. Oltre, la fatturazione è per utente al mese tramite Atlassian.
Non sai quali delle tue app sono su Connect? Usa la verifica gratuita nella guida sulla fine di Connect. Altro su Specdock: documentazione.