Proje paketi

Proje paketinin biçimini, kapsamını ve boş projeye geri yükleme kurallarını öğrenin.

Son güncelleme: 2026-11-10

Biçim ve sürüm

Proje paketi .sosogis uzantılı, gzip ile sıkıştırılmış UTF-8 JSON belgesidir. Üst düzey alanları format, version, brand, exported_at, sha256 ve payload değerleridir.

Paketin brand alanı eski biçimin uyumluluk değerini korur; görünen ürün adı SoSoMaps’tir. Bu alanı ürün adını güncellemek amacıyla değiştirmeyin.

Kanonik içerik, JSON anahtarları sıralanarak, Unicode karakterler kaçırılmadan ve ayırıcılar virgül/iki nokta olacak şekilde UTF-8 üretilir. Okuyucu biçimi, sürümü, içerik özetini ve gerekli dizi/sayı eşleşmelerini denetler. SHA-256 bütünlük kontrolüdür; kaynağın kimliğini doğrulayan bir imza değildir.

İçerik

Paket; proje adı, açıklama ve ayarları, referans katmanlarını, etkin harita nesnelerini, cihazları, bağlantıları, yerleşim/güzergâh ilişkilerini, adres ve bina plan kayıtlarını, birim aktarımı üst verisini, tahsis kayıtlarını, teknik devreleri ve optik kayıtları taşır.

Sürüm 18; CAD tanımlarını, aktarım üst verisini, veri kaynağı ailelerini ve kabul edilmiş kaynak satırı tabanlarını da içerir. Önceki biçimlerde eklenen ONT ve OLT uplink portları, birincil/yedek devre yolları ve saha eki kayıtları korunur. Kablo uçları ve cihaz/bağlantı başvuruları yapılandırılmış olarak korunur. Nesnelerin konum niteliği ve kaynak bilgileri de taşınır. Paket şemasında elektrik için ayrılmış alanlar bulunması, elektrik modülünün genel kullanıma açık olduğunu göstermez.

Kullanıcılar, oturumlar, proje üyelikleri, tasarım/onay ve iş paketi iş akışları, çevrimdışı saha paketleri, webhook abonelikleri, erişim anahtarları ve eski değişiklik geçmişi paketin parçası değildir. Ham içe aktarma dosyaları, optik ölçüm dosyaları ile saha fotoğraf/belge eklerinin dosya içeriği de taşınmaz. Saha eki hedefi ve üst verisi korunur; hedef dosya deposunda içerik yoksa ek eksik dosya olarak işaretlenir. Ölçüm eki geri yüklemede dosya mevcut değil olarak işaretlenir; ayrıştırılmış SOR üst verisi korunur. Bu nedenle .sosogis, tam sistem yedeğinin yerine geçmez.

Paket indirme

GET /api/p/{pid}/export?fmt=bundle

Paket tutarlı bir veritabanı anından üretilir. Coğrafi sınır ve nesne türü filtreleri kısmi paket oluşturmaz. Başvurular kendi içinde tutarsızsa 409 dönebilir.

Kapalı modülde veri bulunuyorsa, o veriyi okuma yetkisi olmayan kullanıcı paketi alamaz ve 403 döner. Yetki yeterliyse kapalı modül verisi de pakete dahil edilir.

Boş projeye yükleme

1. Erişim yetkiniz olan kurumda boş hedef proje oluşturun.
2. Paketin gerektirdiği modüllerin hedef projede etkin olduğunu kontrol edin.
3. POST /api/p/{pid}/bundle?ayarlar=paket çağrısına dosyayı multipart/form-data içindeki file alanında gönderin.
4. Yanıttaki counts, settings_conflicts ve varsa uyarilar bilgilerini inceleyin.
5. Hedef projeyi yeniden okuyun; entegrasyonda eski kimlikleri yeni projenin kimlikleri olarak kullanmayın.

Hedefte etkin kayıtlar veya daha önce yüklenmiş bir paketin kaynak kaydı varsa yükleme 409 ile reddedilir. Bir paketi mevcut projeye birleştirme akışı değildir. Paket yükleme yeni kimlikler üretir ve ilişkileri bu kimliklere eşler; teknik kimliklerin değişmeyeceği varsayılmamalıdır.

Ayar tercihi

ayarlar=paket varsayılandır. Paketin koordinat sistemi, yerel dönüşüm, görünüm ve etiket şablonu gibi aktarılabilir ayarları uygulanır. ayarlar=proje hedefin mevcut değerlerini korur; hedefte eksik değerler paketten tamamlanabilir. Farklılıklar settings_conflicts içinde bildirilir.

Paket tahsis kuralı, kıl sınıf istisnası, optik profil/seçim veya etiket şablonu içeriyorsa yönetici yetkisi gerekebilir. Bir modül kapalıysa içerik sessizce atılmaz; yükleme reddedilir.

Sonuç, sınırlar ve geri alma

Başarı yanıtı ok, batch, counts, settings, settings_conflicts ve gerektiğinde uyarilar alanlarını taşır. Paket yükleme tek veritabanı işlemi içinde yapılır. Kayıt veya ilişki doğrulaması reddedilirse kısmi yükleme bırakılmaz.

Yüklenen sıkıştırılmış dosya 300 MiB ile sınırlıdır. Açılmış JSON için sınır 1536 MiB’dir. İçerik ve yetki hataları ayrıca değerlendirildiği için bu boyutların altında olmak paketin kabul edileceği anlamına gelmez.

Bu uç genel request_id mekanizmasını almaz. Yanıt kaybolduğunda hedef projeyi ve geçmişi kontrol edin. Başarılı yüklemenin yeniden gönderimi, dolu hedef kontrolü nedeniyle reddedilir. POST /api/p/{pid}/changes/{batch}/revert ile yükleme geri alınabilir; sonradan yapılan değişiklikler ve bağımlılıklar geri almayı engelleyebilir.

Saha raporlarının ZIP paketi ayrı bir biçimdir; Çıktılar API’si sayfasında anlatılır.