Confluence'tan İçeri Aktarma
Confluence aktarıcısı, Confluence alanlarını ve sayfalarını SetGet sayfalarına taşır. Sayfa hiyerarşisi, içerik biçimlendirmesi ve satır içi resimler geçiş sırasında korunur. Bu aktarıcı, belgelerini ve bilgi tabanlarını Confluence'tan SetGet'e taşıyan takımlar için tasarlanmıştır.
Nelerin içeri aktarıldığı
| Confluence öğesi | SetGet karşılığı | Notlar |
|---|---|---|
| Alan | Proje sayfaları bölümü | Sayfalar, alan adıyla adlandırılan bir üst sayfanın altına aktarılır |
| Sayfa | SetGet sayfası | İçerik Confluence depolama biçiminden dönüştürüldü |
| Sayfa hiyerarşisi | İç içe sayfalar | Üst-alt ilişkileri korundu |
| Satır içi resimler | Gömülü resimler | SetGet depolama alanına yeniden yüklendi |
| Ekler | Dosya varlıkları | SetGet depolama alanına yeniden yüklendi |
| Sayfa etiketleri | Sayfa etiketleri | Destekleniyorsa eşlendi |
Önkoşullar
- API erişimine sahip bir Confluence Cloud örneği veya Confluence Server/Data Center.
- İçeri aktarmak istediğiniz alanlara okuma erişimi olan bir Confluence hesabı.
- SetGet çalışma alanınızda Yönetici veya Sahip rolü.
Kurulum adımları
Adım 1 -- Confluence'a bağlanın
- Ayarlar > İçeri Aktar'a gidin.
- Confluence'ı seçin.
- Confluence örnek URL'nizi girin (ör.
https://sirketiniz.atlassian.net/wiki). - E-postanızı ve API token'ınızı girin.
- Confluence Cloud için id.atlassian.com/manage-profile/security/api-tokens adresinden token oluşturun.
- Confluence Server için kişisel erişim token'ı kullanın.
- Bağlan'a tıklayın.
Adım 2 -- Alanı seçin
- SetGet erişilebilir tüm alanları listeler.
- İçe aktarmak istediğiniz alanı seçin.
- SetGet alanı tarar ve şunları gösterir: sayfa sayısı, hiyerarşi derinliği, ek sayısı.
Adım 3 -- Hedef projeyi seçin
Aktarılan sayfaların depolanacağı SetGet projesini seçin. Sayfalar projenin sayfalar bölümüne eklenir.
Adım 4 -- Seçenekleri yapılandırın
| Seçenek | Açıklama | Varsayılan |
|---|---|---|
| Hiyerarşiyi koru | Üst-alt sayfa yapısını sürdür | Açık |
| Ekleri aktar | Ekli dosyaları yeniden yükle | Açık |
| Sayfa etiketlerini aktar | Etiketleri sayfa etiketlerine dönüştür | Açık |
| Arşivlenmiş sayfaları aktar | Arşivdeki sayfaları dahil et | Kapalı |
Adım 5 -- İçe aktarmayı başlatın
İçe Aktarmayı Başlat'a tıklayın ve ilerlemeyi izleyin. Çok sayıda sayfa ve ek içeren büyük alanlar birkaç dakika sürebilir.
İçerik dönüşümü
Confluence depolama biçimi (XHTML), SetGet'in editör biçimine dönüştürülür. Aşağıdaki öğeler desteklenmektedir:
| Confluence öğesi | SetGet görünümü |
|---|---|
| Başlıklar (h1-h6) | Başlıklar |
| Paragraflar | Paragraflar |
| Kalın, italik, altı çizili | Metin biçimlendirmesi |
| Madde işaretli listeler | Madde işaretli listeler |
| Numaralı listeler | Numaralı listeler |
| Tablolar | Tablolar |
| Kod blokları | Söz dizimi vurgulama ile kod blokları |
| Resimler | Satır içi resimler |
| Bağlantılar | Köprüler |
| Bilgi/uyarı panelleri | Çağrı blokları |
UYARI
Confluence makroları (ör. Jira sorun makrosu, İçindekiler Tablosu makrosu, özel makrolar) dönüştürülmez. Aktarılan sayfada yer tutucu metin olarak görünürler. Aktarılan sayfaları makro yer tutucular açısından gözden geçirin ve içeriği manuel olarak yeniden oluşturun.
İçerik aktarma sonrası doğrulama
- Sayfa sayısının Confluence alanıyla eşleştiğini doğrulayın.
- Hiyerarşinin (üst-alt iç içe geçme) doğru olduğunu kontrol edin.
- Biçimlendirmeyi ve resimleri doğrulamak için birkaç sayfayı açın.
- Eklerin erişilebilir olduğunu onaylayın.
Çoklu alan içeri aktarma
Birden fazla Confluence alanını içe aktarmak için:
- Her alan için aktarıcıyı ayrı ayrı çalıştırın.
- Yapınıza bağlı olarak aynı veya farklı hedef projeleri seçin.
- Farklı alanlardan gelen sayfalar, projeye veya üst sayfaya göre ayrı tutulur.
İPUCU
Çok sayıda alan içeren büyük bir Confluence örneğiniz varsa önce en aktif alanları önceliklendirin. Aktif olmayan Confluence alanlarını içe aktarmak yerine arşivleyin.
Confluence ve SetGet sayfaları karşılaştırması
| Özellik | Confluence | SetGet |
|---|---|---|
| Sayfa hiyerarşisi | Sınırsız iç içe geçme | Sınırsız iç içe geçme |
| Zengin metin düzenleme | Atlassian editörü | SetGet blok editörü |
| Makrolar | 100'den fazla makro | Slash komutları ve gömme |
| Yorumlar | Sayfa ve satır içi yorumlar | Sayfa yorumları |
| Sürümleme | Tam sürüm geçmişi | Tam sürüm geçmişi |
| İzinler | Alan ve sayfa düzeyi | Proje düzeyi |
| Arama | Global arama | Global arama |
Geçişten sonra ekibiniz SetGet sayfa editörünü tanıdık bulacaktır. Temel fark, Confluence makrolarının SetGet'in slash komut sistemi kullanılarak yeniden oluşturulması gerektiğidir (ör. /table, /code, /diagram).
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Bağlantı başarısız | Yanlış URL veya kimlik bilgisi | Örnek URL'yi ve API token'ını doğrulayın |
| Alan listede yok | Yetersiz izin | Alan okuma erişimi olan bir hesap kullanın |
| Resimler eksik | Özel ekler | API token hesabının resimlere erişebildiğinden emin olun |
| Makrolar metin olarak görünüyor | Beklenen davranış | Makro içeriğini manuel olarak yeniden oluşturun |
| Hiyerarşi düz | Seçenek devre dışı | "Hiyerarşiyi koru"yu etkinleştirin |
| Büyük alan zaman aşımına uğruyor | Çok fazla sayfa | Alt kümeler seçerek toplu olarak aktarın |