Projelerin otomatik olarak içe aktarılması için XML dosya formatının açıklaması

1. Örnek dosya

Ayrıca örnek XML dosyasına şu adreste ulaşılabilir: https://emirates.estate/uploads/xml_import_sample.xml

2. Genel açıklama

Proje içe aktarma dosyası, geçerli bir UTF-8 kodlu XML belgesi olmalıdır. Dosya, herhangi bir ek parametre (yetkilendirme, belirli HTTP üstbilgileri vb.) Olmadan doğrudan belirtilen URL'de mevcut olmalıdır.

Dikkat: bir dosyanın indirilmesi için 30 saniyelik bir zaman aşımı ayarlanmıştır, dosyaya erişim ve indirme bu süre içinde tamamlanmalıdır.

Kök XML etiketi – objects

Bir dizi proje, bir dizi object etiketi ile belirtilir.

3. Alanların açıklaması

Aşağıda, bir proje hakkındaki bilgileri ve açıklamalarını belirtmek için desteklenen bir dizi etiket bulunmaktadır.

Sayısal değerler için, ondalık ayırıcı dışında boşluk veya diğer ayırıcılar içermeyen yazım kullanılır. Ondalık ayırıcı olarak nokta kullanılmalıdır.

Dikkat: etiket değerleri HTML etiketleri veya başka bir kod içermemelidir.

Etiket	Açıklama	Zorunlu
id	Benzersiz proje kimliği. Hem sayı hem de harf içerebilir.	Evet
edited	Proje verilerinin ISO-8601 formatındaki son değişikliğinin tarihi ve saati	Evet
trakheesi_permit	Object Trakheesi Permit license number	Hayır
description	Proje açıklaması. Bu şifrenin içine alınmalı Örnek: Ayrıca çok dilli formatı destekler. Bu durumda, etiket adı olarak dil kodunun kullanıldığı (parağraf 4) ve projenin bu dildeki açıklamasının değer olarak kullanıldığı bir dizi etiket olarak belirtilir. Açıklama içine alınmalıdır. Örnek:	Hayır
excerpt	Projenin kısa açıklaması. şifresinin içine alınmalıdır Örnek: Aynı şekilde çok dilli formatı destekler. Bu durumda, dil kodunun etiket adı olarak kullanıldığı (parağraf 4) ve değerin, projenin verilen dildeki kısa bir açıklaması olduğu bir dizi etiket olarak belirtilir. Açıklaması şifresine alınmalıdır. Örnek:	Hayır
labels	Projeyi karakterize eden bir dizi etiket. Etiket metnini içeren bir dizi etiket label olarak belirtilir. Etiketin metni içine alınmalıdır Örnek: Ayrıca çok dilli formatı destekler. Bu durumda, etiket adı olarak dil kodunun kullanıldığı (parağraf 4) ve değer olarak bu dildeki proje etiketlerini içeren label etiket dizisi belirtilir. Örnek:	Hayır
deal	Alışveriş türü sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, alışveriş türleri kılavuzu.	Evet
price	Proje fiyatı, rakam	Evet
currency	Projenin fiyatının belirtildiği para birimi. Üç harfli para birimi kodu belirtilir. Desteklenen para birimleri kılavuzda listelenmiştir, 4. paragrafa bakın, para birimleri kılavuzu.	Evet
price_period	Projenin bir kiralama teklifi olması durumunda fiyatın belirtildiği süre. Dört değerden biri: monthly – fiyat aylık belirtilmişse daily – fiyat günlük belirtilmişse weekly – fiyat haftalık belirtilmişse yearly – fiyat yıllık belirtilmişse	Evet, kira olduğunda
installment	Belli proje için taksitle ödeme imkanı var mı? Olası değerler: 1 – evet 0 – hayır	Hayır
type	Projenin türünün sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, proje türleri kılavuzu.	Evet
region	Projenin bulunduğu bölgenin sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, bölge ve semtler kılavuzu. Regions bölümü. Dikkat: bölge olarak bir şehir belirtmenizi öneririz (kılavuzda city türü)	Evet
district	Projenin bulunduğu bölgenin sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, bölge ve semtler kılavuzu. Districts bölümü. Dikkat: bir bölge belirtirseniz, dizinindeki city özniteliğinin değeri region etiketinde belirtilen değerle eşleşmelidir.	Hayır
status	Proje statüsünün sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, statüler kılavuzu.	Evet
square	Projenin toplam alanı metrekare, rakam	Hayır
rooms	Projenin toplam oda sayısı, rakam. Dikkat: Salon dahil toplam oda sayısı belirtilmelidir. Örneğin 2 + 1 plan için toplam oda sayısı 3'tür (2 yatak odası + 1 salon).	Hayır
bedrooms	Projenin yatak odası sayısı, rakam	Hayır
bathrooms	Banyoların sayısı, rakam.	Hayır
floor	Bulunduğu kat, rakam.	Hayır
floors	Projenin kat sayısı, rakam. Daireler için dairenin bulunduğu binanın kat sayısı belirtilir. Evler, villalar, vb. için projenin kat sayısı belirtilir.	Hayır
tosea	Projeden denize uzaklık, metre olarak, rakam.	Hayır
tocenter	Projeden denize mesafe, metre olarak, rakam.	Hayır
toairport	Projeden en yakın havalimanına mesafe, kilometre olarak, rakam.	Hayır
finish	Projenin tamamlanma tarihi. Bir dizi etiket olarak belirtilir: year – YYYY formatında inşaatın tamamlanma yılı quarter – inşaatın tamamlanmasının üç ay, 1'den 4'e kadar bir sayı Örnek: 2021 1	Hayır
finished	Projenin teslim edilip edilmediği. Olası değerler: 1 – evet 0 – hayır	Hayır
geo	Projenin enlem ve boylamı. Bir etiket dizisi olarak belirtilir: lat – enlem lng – boylam Örnek: 30.123456 31.234567	Hayır
developer	Proje yapan müteahhitin sayısal kimliği. Kılavuzdan alınan ID değeri, 4. parağrafa bakın, müteahhitler kılavuzu.	Hayır
images	Projenin tüm resmleri. URL resimlerini içeren bir image etiket dizisi olarak belirtilir. Örnek: http://domain.com/images/image1.jpg http://domain.com/images/image2.jpg http://domain.com/images/image3.jpg Attention: Projenin ana resmi ve önizlemesi olarak, listedeki ilk görüntü sitede kullanılacaktır. Sadece JPEG, GIF, PNG görüntüleri desteklenir. 5000 piksel genişliğinde veya 4000 piksel yüksekliğinde görüntüler yüklenmez. Her proje için maksimum görüntü sayısı 30. Bir proje için daha fazla resim belirtilmişse, yalnızca ilk 30 yüklenir. Resimler, herhangi bir ek parametre (yetkilendirme, belirli HTTP üstbilgileri, vb.) olmadan doğrudan belirtilen URL'de erişilebilir olmalıdır.	Hayır
agent	Bu projenin yöneticisi olarak hareket eden firmanızın bir çalışanı. name etiketi olarak gösterilir ve bu etiket, kişisel hesabınızdaki çalışanlar listesinde belirtilen çalışanın adıdır. Bu etiket belirtilmezse emirates.estate web sitesinde firmanın irtibat kişisi projenin satıcısı olarak belirtilecektir. Örnek: John Smith	Hayır
features	Bir projenin özellikleri için sayısal kimlikler. feature etiketi olarak belirtilir. Değer olarak projelerin özelliklerinin kimlikleri kullanılır, 4. parağrafa bakın, projelerin özellikleri kılavuzu. Örnek: 5 19 71	Hayır

Dikkat:

Çok dilli formatta doldurulduğunda, her bir dildeki değer belirtilen dile karşılık gelmelidir. Uygun olmayan bir dilde doldurulursa, alan yayınlanmayacaktır.
Aynı projenin farklı dil sürümleri, çok dilli biçim kullanılarak tek bir proje olarak biçimlendirilmelidir. Her dil versiyonunun ayrı bir proje olarak tasarlanması, projelerin türk.estate sitesinde çoğaltılmasına neden olur.
Daha önce barındırılan bir XML dosyasını silmek için bu projeyi XML dosyasından kaldırmanız gerekir.

4. Kılavuzlar

Dil kodu listesi:

Dil	Kod
Rusça	ru
İngilizce	en
Türkçe	tr
Almanca	de
Fince	fi
İsveççe	sv
Norveççe	no
Lehçe	pl
Azerce	az
Kazakça	kz
Belorusça	by
Ukraynaca	ua
Danimarkali	da
Farsça	fa
Arap	ar

Kılavuzlar listesi:

Gayrimenkul türü kılavuzu: XML / JSON
Alışveriş türü kılavuzu: XML / JSON
Statüler kılavuzu: XML / JSON
Müteahhitler kılavuzu: XML / JSON
Projelerin özellikleri kılavuzu: XML / JSON
Para birimleri kılavuzu: XML / JSON
Bölge ve semtler kılavuzu: XML / JSON

Ayrıca, kılavuzların listesi web sitesinde "Projeler"> "Projelerin içe aktarılması"> "Belgeler" bölümünde kişisel hesabınızda mevcuttur (https://emirates.estate/en/agency-profile/properties/?autoload=documentation)

5. Alanları doldurma örnekleri

Etiket	Yanlış örneği	Doğru örneği
id	Aynı kimliğe sahip birden çok proje geçersiz	Her proje için benzersiz değer
edited	2020-01-17 January, 17th 2020 17/01/2020 05:33 Geçersiz tarih biçimleri	2020-01-17T08:05:33+0000 ISO-8601 formatında tarih
description	Object description Proje açıklaması içine alınmadı Object description ]]> Proje açıklaması HTML etiketleri içerir Proje açıklaması, kodlanmış olsa da HTML etiketleri içerir Çoklu dil biçiminde geçersiz dil kodları	veya
excerpt	Short object description Kısa açıklama içine alınmadı. Short object description ]]> Kısa açıklama HTML etiketleri içerir Kısa açıklama, kodlanmış olsa da HTML etiketlerini içerir. Çok dilli formatta geçersiz dil kodları mevcuttur.	veya
labels	Etiket metni doğrudan labels etiketinde belirtilir Label 1 Etiket metni içine alınmadı. Label 1]]> Etiket HTML etiketleri içerir. Etiket, kodlanmış olsa da HTML kodu içerir.	veya
deal	sale Kıiavuzdan sayısal kimliği, alişveriş türü olarak belirtilmelidir 10 Kılavuzda alışveriş/anlaşma türü kimliği eksik	1
price	123 456 Sayısal değer ayırıcılar olmadan belirtilmelidir 1234,56 Ondalık ayırıcı olarak nokta kullanılmalıdır 123456 EUR Fiyat yalnızca sayısal bir değer içermelidir	123456
currency	euro $ € Geçersiz para birimi kodları	EUR
price_period	<price_period> Kiralama süresi belirtilmedi <price_period>week Geçersiz kiralama süresi	<price_period>monthly
installment	yes 3 Geçersiz etiket değerleri	1
type	apartment Proje türü olarak kılavuzdan sayısal kimlik belirtilmelidir. 111 Projenin türü kimliği kılavuzda eksik	1
region	Анталья Antalya Bölge olarak kılavuzdan sayısal kimlik belirtilmelidir 123456 Bölge kimliği kılavuzda eksiktir	90
district	Tosmur Semt olarak kılavuzdan sayısal kimlik belirtilmelidir 170 Semt yerine bölge kimliği belirtilmiş 170 1 Belirtilen semt belirtilen bölge ile eşleşmiyor	1
status	Secondary Proje statüsü olarak kılavuzdan sayısal kimlik belirtilmelidir. 10 Proje statüsü kimliği kılavuzda mevcut değildir.	1
square	150 m2 Projenin alanı, ölçü birimleri belirtilmeksizin metrekare olarak gösterilmelidir. 150-160 Projenin alanı için yalnızca bir değer belirtilmelidir.	150
rooms	studio 2+1 Oda sayısı olarak sayısal bir değer belirtilmelidir 2,3 Oda sayısının yalnızca bir değeri belirtilmelidir	2
bedrooms	2+1 Yatak odası sayısı olarak sayısal bir değer belirtilmelidir 1,2 Yatak odası sayısının sadece bir değeri belirtilmelidir	1
bathrooms	да Banyo sayısı olarak sayısal bir değer belirtilmelidir 1,2 Banyo sayısının sadece bir değeri belirtilmelidir	2
floor	five Kat olarak sayısal bir değer belirtilmelidir 5,6,7 Sadece bir kat değeri belirtilmelidir	5
floors	ten Kat sayısı olarak sayısal bir değer belirtilmelidir 10,12 Kat sayısı için sadece bir değer belirtilmelidir	10
tosea	500 m Denize olan mesafe, ölçü birimleri belirtilmeksizin metre sayısıyla belirtilir. 0.5 Denize olan mesafe kilometre değil metre olarak belirtilmelidir	500
tocenter	1000 m Şehir merkezine olan mesafe, ölçü birimleri belirtilmeden metre sayısıyla belirtilir. 1 Şehir merkezine mesafe kilometre değil metre olarak belirtilmelidir	1000
toairport	15 km Havalimanına olan mesafe, birimler belirtilmeksizin kilometre olarak belirtilir. 15000 Havalimanına olan mesafe metre değil kilometre olarak belirtilmelidir	15
finish	2021 İnşaat tamamlama tarihi, year ve quarter etiketleri olmadan belirtildi 21 1 Yıl, YYYY biçiminde olmalıdır 2021 II İnşaat bitiş çeyreği (yılın çeyreği) Arap rakamıyla belirtilmelidir 2021 İnşaat bitiş çeyreği(yılın çeyreği) belirtilmemiş	2021 1
finished	yes 10 Geçersiz etiket değerleri	0
geo	30.123456,31.234567 Koordinatlar, lat ve lng etiketleri olmadan belirtilmiş 36°49'13.4"N 34°38'21.6"E Koordinatlar ondalık kesirler olarak belirtilmelidir	30.123456 31.234567
developer	Yekta Homes Müteahhit olarak kılavuzdaki sayısal kimlik belirtilmelidir 123456 Müteahhitin kimliği kılavuzda mevcut değildir	83
images	http://domain.com/image1.jpg, http://domain.com/image2.jpg, http://domain.com/image3.jpg Resimler, image etiketleri olmadan belirtilmiş /path/image1.jpg /path/image2.jpg /path/image3.jpg Resimlerin mutlak URL'sini belirtmeniz gerekir	http://domain.com/image1.jpg http://domain.com/image2.jpg http://domain.com/image3.jpg
agent	John Smith Çalışan name etiketi olmadan belirtilmiş Nonexistent manager emirates.estate'de şirketinizin çalışanları listesinde olmayan bir çalışan belirtilir	John Smith Proje özellikleri, feature etiketleri olmadan belirtilmiş
features	5,19,71 Proje özellikleri, feature etiketleri olmadan belirtilmiş Близко к пляжу Близко к природе У моря Projenin özellikleri olarak kılavuzdaki sayısal kimlik belirtmelidir	5 19 71

6. Sıkça Sorulan Sorular

Daha önce XML dosyasıyla eklenmiş bir proje nasıl kaldırılır?

emirates.estate'e XML dosyası kullanılarak eklenen bir projeyi kaldırmak için, bu projeyi bu XML dosyasından kaldırmalısınız. Bir sonraki veri aktarımı sırasında, dosyada eksik olan tüm projeler/üyeler silinecektir. Projelerin id etiketinin değeriyle tanımlandığını unutmayın.

XML'deki nesne ile ilgili bilgileri güncelledik, ancak emirates.estate'de değişiklikler görünmedi

Bu durum iki nedenden dolayı olabilir:

Projelerin bir sonraki içe aktarımı henüz yapılmadı. Aktarım günde bir kez yapıldığını lütfen unutmayın.
Nesnenin düzenleme tarihi değişmedi - edited etiketi. Her proje için XML dosyasının işlenmesi sırasında, önceki içe aktarma işleminde belirtilen değerle edited etiketinde belirtilen son düzenleme tarihini karşılaştırır. emirates.estate üzerindeki verilerde değişiklikler sadece son düzenleme tarihi arttıysa yapılır.

Proje resmi emirates.estate'de görüntülenmiyor, ancak XML dosyasında mevcut

Lütfen XML dosyasındaki resim bağlantısının doğru olduğunu ve gereksinimleri karşıladığını kontrol edin:

Ek parametreler (yetkilendirme, belirli HTTP üstbilgileri vb.) olmadan herkesin kullanımına açık olduğu resmin tam URL'sini belirtmelisiniz.
Resim JPEG, GIF veya PNG formatında olmalıdır.
Resmin genişliği 5000 pikselden fazla değil ve yükseklik 4000 pikselden fazla değil.
Her proje için en fazla 30 fotoğraf gösterilir. 31'den itibaren resimler yüklenmeyecek.

Ayrıca, proje bilgilerinin ve resimlerin yüklenmesinin aynı anda gerçekleşmediğini lütfen unutmayın: önce emirates.estate'e projelerin açıklamaları aktarılır ve ardından görseller yüklenir. Çok sayıda görüntünün aynı anda indirilmesi gerekiyorsa, işlem birkaç saat sürebilir.

Proje açıklamasında HTML kullanmak mümkün mü? Biçimlendirme ve açıklama nasıl yapılır?

Hayır, ne yazık ki, proje açıklamasında herhangi bir HTML etiketi kullanılamaz. Proje açıklamasını işaretlemek için lütfen satır çevirilerini kullanın.

2 + 1 planı olan bir projemiz var - oda ve yatak odası sayısını doğru bir şekilde nasıl belirtebiliriz?

rooms etiketinde, oturma odaları dahil projedeki toplam oda sayısı ve bedrooms etiketinde yatak odası sayısı belirtilir. 2+1 planı için toplam oda sayısı-3'tür, rooms etiketinde belirtmeniz gereken değer budur. 2 + 1 planında iki yatak odası vardır, bu nedenle bedrooms etiketinde 2 belirtilmelidir.

Projeleri içe aktarma sonuçlarını nasıl kontrol edebilirim?

XML dosyanızdan nesnelerin son içe aktarılmasına ilişkin rapor, kişisel hesabınızda "Projeler"> "Projelerin içe aktarılması" bölümünde mevcuttur. XML dosyanızdan son başarılı içe aktarmanın tarihini ve eklenen, güncellenen ve gizlenen projelerin sayısı hakkında bir rapor var. Н "Ayrıntıları göster" bağlantısına tıklayarak ayrıntılı raporu görüntüleyebilirsiniz.