$Xml¶

Süreç veri modeline erişim sağlar. $Xml nesnesinin bir örneğidir XmlNode ve iş akışı havuzunun köküne işaret eder.

1

const $Xml: Xml;

Notlar¶

Örnek¶

1
2
3

$Xml.SelectAll('//Customer', function(customer) {
  var id = customer.Evaluate('Id');
});

Başvuru Noktası¶

Nesne $Xml kullanıldığı yere bağlı olarak farklı öğelere işaret eder: - İş Öncesi, İş Sonrası, Rol ve Rota komut dizilerinde, $Xml süreç havuzu öğesine bağlıdır. - Kural Tabanlı Doğrulama ve Biçimlendirme kurallarında, $Xml denetim öğesine bağlıdır.

Havuz Öğesi¶

Havuz öğesi varsayılan olarak XML ağacının kökünde oluşturulur. Ancak alt iş akışı örnekleri, veri ağacındaki herhangi bir öğeyi kullanabilir.

Havuz için Örnek Veri Modeli¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

<form>
  <Product>
    <Id>1234</Id>
    <Orders>
      <Order>
        <Id>4567</Id>
        <Amount>1</Amount>
      </Order>
      <Order>
        <Id>8901</Id>
        <Amount>2</Amount>
      </Order>
    </Orders>
  </Product>
</form>

Havuz Köküne Erişim¶

Veri modelinde farklı öğelere $Xml işaret edebildiğinden, bazı durumlarda havuzun kök öğesine erişmeniz gerekebilir. Havuz köküne erişmek için "/form/Product" XPath'i veya $poolRoot değişkenini kullanabilirsiniz.

Havuz köküne XPath ile erişme¶

1

var productId = $Xml.Evaluate("/form/Product/Id");

Havuz köküne şu değişkenle erişme¶

$poolRoot değişkeni:

1

var productId = $Xml.Evaluate('$poolRoot/Id');

Özellikler¶

Ad alanları¶

• $Xml.AddNamespace: Belirtilen önek ve URI ile XML düğümüne bir ad alanı ekler.
• $Xml.LookupNamespaceURI: Belirtilen önekle ilişkili ad alanı URI'sini döndürür.
• $Xml.LookupPrefix: Belirtilen ad alanı URI'siyle ilişkili öneki döndürür.
• $Xml.RemoveNamespace: Belirtilen ad alanı URI'sine ait öneki kaldırır.

Yapı değişiklikleri¶

• $Xml.AppendChild: Belirtilen XPath konumuna yeni bir alt öğe ekler ve DOM'a eklemeden önce yeni oluşturulan düğümde sağlanan geri çağırma işlevini çalıştırır. Eklenen yeni düğümü döndürür.
• $Xml.Copy: Geçerli XML düğümünü ve tüm alt düğümlerini kaynak XPath'ten hedef XPath'e veya hedef gezgine kopyalar.
• $Xml.Remove: Geçerli düğümü kaldırır ve bir dizi içinde döndürür.
• $Xml.Sync: Belirtilen XPath'teki düğümleri giriş düğümleriyle eşitler ve eşitlenen düğümlerden oluşan bir dizi döndürür.

Doğrulama ve temizleme¶

• $Xml.Assert: Belirtilen XPath'in boole türünde true değeri verdiğini doğrulayarak hata denetimi gerçekleştirir. Doğrulama başarısız olursa hata fırlatılır.
• $Xml.CommitDeletes: Özniteliği State 'Deleted' değerine ayarlanmış tüm alt düğümleri siler.

İstemci olayları¶

• $Xml.Bind: Belirtilen XPath'in seçtiği düğümlere bir değişiklik olay işleyicisi ekler.
• $Xml.Live: Belirtilen XPath'e bir değişiklik olay işleyicisi ekler.
• $Xml.Trigger: Geçerli düğüme bağlı olay işleyicilerini tetikler.

Okuma ve koşullar¶

• $Xml.Count: Belirtilen XPath'teki düğüm sayısını döndürür.
• $Xml.Equals: Belirtilen XPath'in belirtilen değere sahip olup olmadığını belirten bir boole değeri döndürür.
• $Xml.Evaluate: Geçerli düğümün dize değerini döndürür.
• $Xml.EvaluateBoolean: Geçerli düğümün boole değerini döndürür.
• $Xml.EvaluateDateTime: Geçerli düğümün tarih-saat ofset değerini döndürür.
• $Xml.EvaluateNumber: Geçerli düğümün sayısal değerini döndürür.
• $Xml.IsEmpty: Geçerli düğümün boş bir dize değerine sahip olup olmadığını belirten bir boole değeri döndürür.
• $Xml.Sum: Geçerli düğümdeki veya belirtilen XPath'teki alt öğelerin sayısal değerlerinin toplamını döndürür.

Oluşturma ve kalıcılık¶

• $Xml.Create: Yeni bir XmlWriter örneği oluşturur.
• $Xml.Load: XML içeriğini geçerli düğüme şu kaynaktan yükler $XmlRepository.
• $Xml.Parse: Belirtilen dizeyi XML düğümü olarak ayrıştırır ve belge öğesini bir Xml örneği olarak döndürür.
• $Xml.Save: Geçerli düğümün içeriğini şuraya kaydeder $XmlRepository.

Biçimlendirme ve dönüştürme¶

• $Xml.Format: Belirtilen şablonu geçerli düğüme uygular ve sonuç dizesini döndürür.
• $Xml.InnerXml: Geçerli düğümün iç XML'ini döndürür.
• $Xml.OuterXml: Geçerli düğümün dış XML'ini döndürür.
• $Xml.Transform: Geçerli düğüm üzerinde XSLT dönüşümü gerçekleştirir ve sonucu dize olarak döndürür.

Öznitelikler¶

• $Xml.GetAttribute: Geçerli düğümdeki bir öznitelik değerini alır.
• $Xml.RemoveAttribute: Belirtilen ada sahip özniteliği kaldırır.
• $Xml.SetAttribute: Geçerli düğümdeki bir özniteliği belirtilen değere ayarlar.
• $Xml.SetAttributeNS: Belirtilen ad alanı URI'sindeki geçerli düğüm özniteliğini belirtilen değere ayarlar.

Seçim ve gezinme¶

• $Xml.GetParent: Geçerli düğümün üst düğümünü döndürür.
• $Xml.SelectAll: Belirtilen XPath ifadesine göre eşleşen tüm düğümleri seçer.
• $Xml.SelectSingle: Belirtilen XPath ifadesine göre tek bir düğüm seçer.

Değer güncellemeleri¶

• $Xml.SetDefaultValue: Geçerli düğüm boşsa değerini ayarlar.
• $Xml.SetValue: Geçerli düğümün değerini ayarlar.