XMLFİLTRELE

XMLFİLTRELE (FILTERXML), XML biçimindeki bir metinden XPath ifadesiyle belirtilen veriyi döndürür. Bir hücredeki XML içeriğinden etiket değerlerini ayıklamak ve WEBHİZMETİ işlevinin getirdiği XML yanıtını işlemek için kullanılır.

Söz dizimi ve parametre​

XML etiket adları ve XPath ifadeleri büyük küçük harfe duyarlıdır; etiketleri XML metninde yazıldığı gibi kullanın. Formülün içinde XPath ifadesini çift tırnak içinde metin olarak yazın.

1. Etiket değerini alma​

A sütunundaki XML metinlerinden B sütunundaki XPath ifadesine uyan değeri alalım. C2 hücresine aşağıdaki formülü yazıp aşağı kopyalayın:
Sonuçlar sırasıyla Lahmacun, İzmir ve Zeynep olur. Her satırda XPath ifadesi, XML içindeki etiket yolunu izleyerek ilgili düğümün içeriğini bulur. Formül her satırda aynı yapıda olduğundan yalnızca XML metni ve XPath ifadesi değişir.

2. Birden çok düğümden sıra ile seçme​

Aynı XML metninde üç yemek bulunuyor. B sütunundaki XPath ifadesi hangi düğümün alınacağını belirler. C2 hücresine aşağıdaki formülü yazıp aşağı kopyalayın:
Sonuçlar sırasıyla Lahmacun, Pide ve Mantı olur. Köşeli parantez içindeki sayı, aynı adı taşıyan düğümlerden kaçıncısının alınacağını belirtir. last() ise her zaman sonuncu düğümü seçer; düğüm sayısı değişse bile ifadeyi değiştirmeniz gerekmez.

3. XPath ifadesini sıra numarasıyla oluşturma​

XPath ifadesini sabit yazmak yerine A sütunundaki sıra numarasından metin birleştirme ile oluşturabilirsiniz. C2 hücresine aşağıdaki formülü yazıp aşağı kopyalayın:
Sonuçlar sırasıyla Ankara, İzmir ve Bursa olur. Formül, A sütunundaki sayıyı XPath ifadesinin içine ekleyerek her satırda bir sonraki şehri seçer. Sıra numarası sütunu yerine SATIR işlevini kullanarak da aynı sonucu elde edebilirsiniz.

4. Geçersiz XML ve hata durumları​

XML metni geçerli değilse işlev hata verir. C2 hücresine aşağıdaki formülü yazıp aşağı kopyalayın:
Sonuçlar sırasıyla Pide, #DEĞER! ve #DEĞER! olur. İlk satırdaki XML geçerlidir ve değer alınır. İkinci satırda açılan yemek etiketi kapatılmadığı için XML geçersizdir. Üçüncü satırda ise tanımlanmamış bir ad alanı öneki kullanıldığından işlev #DEĞER! hatası verir.

Kullanırken dikkat edin​

• xml parametresi: xml parametresi XML biçiminde bir metin olmalıdır ve 255 karakterden kısa olmalıdır. xml geçerli değilse işlev #DEĞER! hatası verir. xml geçersiz bir ad alanı içeriyorsa da sonuç #DEĞER! olur.
• xpath parametresi: xpath parametresi, XML içindeki hangi düğümün alınacağını belirten XPath biçiminde bir metin olmalıdır. Örneğin //yemek/ad ifadesi yemek etiketinin içindeki ad etiketinin değerini, //yemek[2]/ad ifadesi ikinci yemek düğümünün adını verir.
• Web hizmeti ile kullanım: WEBHİZMETİ işlevinin getirdiği XML yanıtını xml parametresi olarak verebilirsiniz. Servis adresinin A2 hücresinde yazılı olduğu bir örnek aşağıdadır:
  
  Excel formülü

  TR

  =XMLFİLTRELE(WEBHİZMETİ(A2);"//city/name")

  EN

  =FILTERXML(WEBSERVICE(A2),"//city/name")

  Servis geçerli bir XML döndürmezse ya da yanıt bulunamazsa sonuç #DEĞER! olur. Adres içinde özel karakterler varsa URLKODLA işleviyle adresi kodlayabilirsiniz.
• Sürüm ve platform: İşlev Excel 2013 ile eklenmiştir ve yalnızca Windows sürümünde kullanılabilir.
• İlgili işlevler: WEBHİZMETİ: Bir web servisinden XML yanıtı almak için kullanılır; sonucu XMLFİLTRELE içine xml olarak verirsiniz. URLKODLA: Web servisi adresindeki özel karakterleri kodlamak için tercih edilir. SATIR: XPath ifadesindeki düğüm sırasını satır numarasından üretmek istediğinizde kullanılabilir.

Mini Sayfa içindeki sonuç hücresini seçerek gerçek formülü görebilirsiniz. Formüllü örnekleri indirilebilir Excel dosyasında da kullanabilirsiniz.