Azure Logic Apps'teki iş akışları için XML içeriğini düz dosyalarda kodlama ve çözme

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

İşletmeler arası (B2B) tümleştirmesinde bir ticari ortakla XML içeriği alışverişinde bulunurken, içeriği göndermeden önce genellikle kodlamanız gerekir. Kodlanmış XML içeriği aldığınızda, kullanabilmeniz için önce bu içeriğin kodunu çözmeniz gerekir.

Bu kılavuz, Düz Dosya yerleşik bağlayıcı eylemlerini ve düz dosya şemasını kullanarak iş akışlarınızda XML'yi kodlamayı ve çözmeyi gösterir.

Bağlayıcı teknik referans

Düz Dosya kodlama ve kod çözme eylemleri Tüketim mantıksal uygulaması iş akışları ve Standart mantıksal uygulama iş akışları için kullanılabilir.

Mantıksal uygulama Çevre
Consumption Çok Kiracılı Azure Logic Apps
Standart Tek kiracılı Azure Logic Apps, App Servis Ortamı v3 (yalnızca Windows planları) ve karma dağıtım

Daha fazla bilgi için bkz Tümleştirme hesabı yerleşik bağlayıcıları.

Önkoşullar

  • Bir Azure hesabı ve aboneliği Ücretsiz bir Azure hesabı edinin.

  • Düz Dosya işlemlerini kullanmak istediğiniz mantıksal uygulama kaynağı ve iş akışı.

    Düz Dosya işlemleri tetikleyici içermez. İş akışınız herhangi bir tetikleyiciyle başlayabilir veya herhangi bir eylemi kullanarak kaynak XML'yi getirebilir.

    Bu makaledeki örneklerde Http isteği alındığında adlı İstek tetikleyicisi kullanılır.

    Daha fazla bilgi için bakınız:

  • Kurumsal tümleştirme ve B2B iş akışları için entegrasyon artefaktlarını tanımlamak ve depolamak amacıyla bir entegrasyon hesap kaynağı.

    • Hem tümleştirme hesabınızın hem de mantıksal uygulama kaynağınızın aynı Azure aboneliğinde ve Azure bölgesinde mevcut olması gerekir.

    • Düz Dosya işlemleriyle çalışmaya başlamadan önce Tüketim mantıksal uygulamanızı bağlamanız veya Ticari iş ortakları ve anlaşmalar gibi yapıtlarla çalışmak için Standart mantıksal uygulamanızı tümleştirme hesabına bağlamanız gerekir. Aynı öğeleri paylaşmak amacıyla bir tümleştirme hesabını birden fazla mantıksal Tüketim veya Standart uygulama kaynağına bağlayabilirsiniz.

    Tavsiye

    Standart iş akışlarında ticari ortaklar ve sözleşmeler gibi B2B yapıtlarıyla çalışmıyorsanız tümleştirme hesabına ihtiyacınız olmayabilir. Bunun yerine, şemaları doğrudan Standart mantıksal uygulama kaynağınıza yükleyebilirsiniz. Her iki durumda da, aynı mantıksal uygulama kaynağındaki tüm alt iş akışlarında aynı şemayı kullanabilirsiniz. Aynı şemayı birden çok mantıksal uygulama kaynağında kullanmak için bir tümleştirme hesabı kullanmanız ve bağlamanız gerekir.

  • XML içeriğinin nasıl kodlandığını veya kodunun nasıl çözileceğini belirten düz dosya şeması.

    Standart iş akışlarında Düz Dosya işlemleri, bağlantılı tümleştirme hesabından veya daha önce mantıksal uygulamanıza yüklediğiniz ancak ikisini birden yüklemediğiniz bir şema seçmenize olanak tanır.

    Daha fazla bilgi için bkz. Tümleştirme hesaplarına şema ekleme.

  • Çözümünüzü test etmek için HTTP istekleri gönderebilen bir araç yükleyin veya kullanın, örneğin:

    Dikkat

    Kimlik bilgileri, gizli diziler, erişim belirteçleri, API anahtarları ve diğer benzer bilgiler gibi hassas verileriniz olduğu senaryolarda, verilerinizi gerekli güvenlik özellikleriyle koruyan bir araç kullandığınızdan emin olun. Araç çevrimdışı veya yerel olarak çalışmalı ve çevrimiçi bir hesapta oturum açmayı veya verileri bulutla eşitlemeyi gerektirmemelidir. Bu özelliklere sahip bir araç kullandığınızda, hassas verileri genel kullanıma çıkarma riskini azaltırsınız.

Sınırlamalar

  • Kodunu çözmek istediğiniz XML içeriği UTF-8 biçiminde kodlanmalıdır.

  • Düz dosya şemanızda, kapsanan XML gruplarının özellikte 1'denmax countayarlanmış aşırı sayıda olmadığından emin olun. Özellik değeri 1'den büyük olan bir max count XML grubunu, özelliği 1'den büyük olan başka bir max count XML grubunun içine yerleştirmekten kaçının.

  • Azure Logic Apps düz dosya şemasını ayrıştırdığında ve şema bir sonraki parçanın seçimine izin verdiğinde, Azure Logic Apps bu parça için bir simge ve tahmin oluşturur. Şema çok fazla yapıya izin veriyorsa (örneğin, 100.000'den fazla) şema genişletmesi çok büyük hale gelir ve bu da çok fazla kaynak ve zaman tüketir.

Şemayı karşıya yükleme

Şemanızı oluşturduktan sonra, iş akışınıza göre şemayı karşıya yükleyin:

Düz dosya kodlama eylemi ekleme

  1. Azure portalında mantıksal uygulama kaynağınızı açın.

  2. Tasarımcıda iş akışınızı açın.

    İş akışınızda tetikleyici veya iş akışınıza gereken başka eylemler yoksa, önce bu işlemleri ekleyin.

    Bu örnekte HTTP isteği alındığında adlı İstek tetikleyicisi kullanılır. Tetikleyici eklemek için bkz. İş akışınızı başlatmak için tetikleyici ekleme.

  3. Tasarımcıda, Düz Dosya Kodlama adlı yerleşik eylemi eklemek için bu genel adımları izleyin.

    Parametreler sekmesi seçili durumdayken eylem bilgileri bölmesi açılır.

  4. Eylemin content parametresinde, şu adımları izleyerek tetikleyiciden veya önceki bir eylemden alınan kod için XML içeriğini sağlayın:

    1. İçerik kutusunun içini seçin ve ardından şimşek simgesini seçerek dinamik içerik listesini açın.

    2. Dinamik içerik listesinden kodlanacak XML içeriğini seçin.

    Aşağıdaki örnekte, açılan dinamik içerik listesi, HTTP isteği alındığında tetikleyicisinden alınan çıkış ve tetikleyici çıkışından seçilen Gövde içeriği gösterilir.

    Dinamik içerik listesi ve kodlama için seçilen içerik ile Azure portalı, iş akışı tasarımcısı, Düz Dosya Kodlama eylemi ve İçerik parametresini gösteren ekran görüntüsü.

    Not

    Gövde dinamik içerik listesinde görünmüyorsa HTTP isteği alındığında bölüm etiketinin yanındaki Daha fazla bilgi'yi seçin. Ayrıca, doğrudan İçerik kutusuna kodlamak için içeriği girebilirsiniz.

  5. Şema Adı listesinden şemanızı seçin.

    Ekran görüntüsü, kodlama için seçilen şemayla tasarımcıyı ve açılmış Şema Adı listesini gösteriyor.

    Not

    Şema listesi boşsa, bunun nedeni şu olabilir:

    • Mantık uygulaması kaynağı bir tümleştirme hesabına bağlı değildir.
    • Bağlı tümleştirme hesabı herhangi bir şema dosyası içermiyor.
    • Mantıksal uygulama kaynağı herhangi bir şema dosyası içermez. Bu neden yalnızca Standart mantıksal uygulamalar için geçerlidir.

  6. Eyleme başka isteğe bağlı parametreler eklemek için Gelişmiş parametreler listesinden bu parametreleri seçin.

    Parametre Değer Açıklama
    Boş düğüm oluşturma modu ForcedDisabled veya HonorSchemaNodeProperty veya ForcedEnabled Düz dosya kodlamalı boş düğüm oluşturma için kullanılacak mod.

    BizTalk için düz dosya şeması, boş düğüm oluşturmayı denetleen bir özelliğe sahiptir. Düz dosya şemanız için boş düğüm oluşturma özelliği davranışını izleyebilirsiniz. Alternatif olarak, Azure Logic Apps'in boş düğümler oluşturmasını veya ihmal etmesini sağlamak için bu ayarı kullanabilirsiniz. Daha fazla bilgi için bkz . Boş öğeler için etiketler.
    XML Normalleştirme Evet veya Hayır Düz dosya kodlamasında XML normalleştirmesini etkinleştirme veya devre dışı bırakma ayarı. Daha fazla bilgi için bkz . XmlTextReader.Normalization.

  7. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

Düz dosya kod çözme eylemi ekleme

  1. Azure portalında mantıksal uygulama kaynağınızı açın.

  2. Tasarımcıda iş akışınızı açın.

    İş akışınızda tetikleyici veya iş akışınıza gereken başka eylemler yoksa, önce bu işlemleri ekleyin.

    Bu örnekte HTTP isteği alındığında adlı İstek tetikleyicisi kullanılır. Tetikleyici eklemek için bkz. İş akışınızı başlatmak için tetikleyici ekleme.

  3. Tasarımcıda, Düz Dosya Kod Çözme adlı yerleşik eylemi eklemek için bu genel adımları izleyin.

  4. Eylemin content parametresinde, şu adımları izleyerek tetikleyiciden veya önceki bir eylemden çıktı olarak kodunu çözmek için XML içeriğini sağlayın:

    1. İçerik kutusunun içini seçin ve ardından şimşek simgesini seçerek dinamik içerik listesini açın.

    2. Dinamik içerik listesinden kodunu çözmek için XML içeriğini seçin.

    Aşağıdaki örnekte, açılan dinamik içerik listesi, HTTP isteği alındığında tetikleyicisinden alınan çıkış ve tetikleyici çıkışından seçilen Gövde içeriği gösterilir.

    Dinamik içerik listesi ve kod çözme için seçilen içerik ile Azure portalı, iş akışı tasarımcısı, Düz Dosya Kod Çözme eylemi ve İçerik parametresini gösteren ekran görüntüsü.

    Not

    Gövde dinamik içerik listesinde görünmüyorsa HTTP isteği alındığında bölüm etiketinin yanındaki Daha fazla göster'i seçin. Ayrıca, İçerik kutusuna kodu çözmek için içeriği doğrudan girebilirsiniz.

  5. Şema Adı listesinden şemanızı seçin.

    Ekran görüntüsü, tasarımcının yanı sıra kod çözme için seçilen şemayla birlikte açılmış Şema Adı listesini gösteriyor.

    Not

    Şema listesi boşsa, bunun nedeni şu olabilir:

    • Mantıksal uygulama kaynağı bir tümleştirme hesabına bağlı değildir.
    • Bağlı tümleştirme hesabı herhangi bir şema dosyası içermiyor.
    • Mantıksal uygulama kaynağı herhangi bir şema dosyası içermez. Bu neden yalnızca Standart mantıksal uygulamalar için geçerlidir.

  6. İş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

Artık düz dosya kod çözme eyleminizi ayarlamayı bitirdiniz. Gerçek bir dünyada kodu çözülen verileri Salesforce gibi bir iş kolu (LOB) uygulamasında depolamak isteyebilirsiniz. Ya da kodu çözülen verileri bir ticaret ortağına gönderebilirsiniz. Kod çözme eyleminden elde edilen çıkışı Salesforce'a veya ticari iş ortağınıza göndermek için Azure Logic Apps'te bulunan diğer bağlayıcıları kullanın:

İş akışınızı test etme

İş akışınızı tetikleme için şu adımları izleyin:

  1. İstek tetikleyicisinde HTTP POST URL parametresini bulun ve URL'yi kopyalayın.

  2. HTTP istek aracınızı açın ve yönergelerini kullanarak kopyalanan URL'ye İstek tetikleyicisinin beklediği yöntem de dahil olmak üzere bir HTTP isteği gönderin.

    Bu örnekte URL ile yöntemi kullanılır POST .

  3. Kodlamak veya kodunu çözmek istediğiniz XML içeriğini istek gövdesine ekleyin.

  4. İş akışınızın çalışması tamamlandıktan sonra iş akışının çalıştırma geçmişine gidin ve Düz Dosya eyleminin girişlerini ve çıkışlarını inceleyin.

İlgili içerik

  • Last updated on