$Xml¶

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

1

const $Xml: Xml;

Açıklamalar¶

Ö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: - Pre-Work, Post-Work, Role ve Route betiklerinde, $Xml süreç havuzu öğesine bağlanır. - Kural Tabanlı Doğrulama ve Biçimlendirme kurallarında, $Xml denetim öğesine bağlanı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şme¶

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

Havuz köküne erişmek için XPath kullanma¶

1

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

Havuz köküne şu öğeyle erişme:¶

$poolRoot değişkeni:

1

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

Özellikler¶

Ad Alanları¶

• $Xml.AddNamespace: Verilen ö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'sinin önekini kaldırır.

Yapı Değişiklikleri¶

• $Xml.AppendChild: Belirtilen XPath konumuna yeni bir alt düğüm ekler ve bu düğümü DOM'a eklemeden önce oluşturulan düğüm üzerinde sağlanan geri çağırma işlevini yürütü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 girdi düğümleriyle eşitler ve eşitlenen düğümlerin dizisini döndürür.

Doğrulama ve Temizleme¶

• $Xml.Assert: Belirtilen XPath ifadesinin boole türünde true değeri verdiğini doğrulayarak hata denetimi yapar. Doğrulama başarısız olursa hata oluşturulur.
• $Xml.CommitDeletes: Şu değere sahip olan tüm alt düğümleri siler: State 'Deleted' değerine ayarlanmış öznitelik.

İstemci Olayları¶

• $Xml.Bind: Belirtilen XPath tarafından seçilen 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 ofseti 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 iş akışı oluşturur.
• $Xml.Load: XML içeriğini geçerli düğüme şu kaynaktan yükler: $XmlRepository.
• $Xml.Parse: Belirtilen dizeyi bir XML düğümü olarak ayrıştırır ve belge öğesini bir Xml iş akışı 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çta oluşan dizeyi 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 özniteliğin 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'sinde geçerli düğümdeki bir özniteliği 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.