Azure Logic Apps'te düz dosyaları kodlama ve çözme

  • Makale

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

İşletmeler arası (B2B) senaryosunda bir iş ortağına XML içeriği göndermeden önce bu içeriği kodlamak isteyebilirsiniz. Kodlanmış XML içeriği alırsanız, önce bu içeriğin kodunu çözmeniz gerekir. Azure Logic Apps'te bir mantıksal uygulama iş akışı oluştururken Düz Dosya yerleşik bağlayıcı eylemlerini ve kodlama ve kod çözme için düz dosya şemasını kullanarak düz dosyaları kodlayabilir ve kodunu çözebilirsiniz. Çok kiracılı Tüketim mantıksal uygulaması iş akışlarında ve tek kiracılı Standart mantıksal uygulama iş akışlarında Düz Dosya eylemlerini kullanabilirsiniz.

Düz Dosya tetikleyicisi olmasa da, kaynak XML içeriğini iş akışınıza beslemek için herhangi bir tetikleyici veya eylem kullanabilirsiniz. Örneğin, yerleşik bağlayıcı tetikleyicisini, Azure Logic Apps için kullanılabilen yönetilen veya Azure tarafından barındırılan bağlayıcı tetikleyicisini, hatta başka bir uygulamayı kullanabilirsiniz.

Bu makalede, düz dosya kodlama ve kod çözme eylemlerinin iş akışınıza nasıl ekleneceği gösterilmektedir.

  • İş akışınıza Düz Dosya kodlama veya kod çözme eylemi ekleyin.
  • Kullanmak istediğiniz şemayı seçin.

Daha fazla bilgi için aşağıdaki belgeleri gözden geçirin:

Önkoşullar

  • Bir Azure hesabı ve aboneliği Henüz aboneliğiniz yoksa ücretsiz bir Azure hesabına kaydolun.

  • Düz Dosya eylemini kullanmak istediğiniz boş veya mevcut mantıksal uygulama iş akışı.

    Boş bir iş akışınız varsa, iş akışını başlatmak istediğiniz tetikleyicileri kullanın. Bu örnekte İstek tetikleyicisi kullanılır.

  • Mantıksal uygulama kaynağınız ve iş akışınız. Düz dosya işlemlerinde kullanılabilir tetikleyici yoktur, bu nedenle iş akışınızın en az bir tetikleyici içermesi gerekir. Daha fazla bilgi için, aşağıdaki belgelere bakın:

  • XML içeriğini kodlamak ve kodunu çözmek için düz bir dosya şeması. Daha fazla bilgi için Azure Logic Apps'te iş akışlarıyla kullanılacak şemaları ekleyin.

  • Tüketim veya Standart mantıksal uygulama iş akışı üzerinde çalışıp çalışmadığınıza bağlı olarak bir tümleştirme hesabı kaynağı gerekir. Genellikle, kurumsal tümleştirme ve B2B iş akışlarında kullanmak üzere yapıtları tanımlamak ve depolamak istediğinizde bu kaynağa ihtiyacınız vardır.

    Önemli

    Birlikte çalışmak için 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.

    • Tüketim mantıksal uygulaması iş akışı üzerinde çalışıyorsanız mantıksal uygulama kaynağınız tümleştirme hesabınıza bir bağlantı gerektirir.

    • Standart mantıksal uygulama iş akışı üzerinde çalışıyorsanız, mantıksal uygulama kaynağınızı tümleştirme hesabınıza bağlayabilir, şemaları mantıksal uygulama kaynağınıza doğrudan veya aşağıdaki senaryolara göre her ikisini birden yükleyebilirsiniz:

      • İhtiyacınız olan veya kullanmak istediğiniz yapıtlarla zaten bir tümleştirme hesabınız varsa, tümleştirme hesabınızı yapıtları kullanmak istediğiniz birden çok Standart mantıksal uygulama kaynağına bağlayabilirsiniz. Bu şekilde, şemaları tek tek her mantıksal uygulamaya yüklemeniz gerekmez. Daha fazla bilgi için mantıksal uygulama kaynağınızı tümleştirme hesabınıza bağlama bölümünü gözden geçirin.

      • Düz Dosya yerleşik bağlayıcısı, mantıksal uygulama kaynağınıza veya bağlı tümleştirme hesabına daha önce yüklediğiniz bir şemayı seçmenize olanak tanır, ancak ikisini birden seçmez. Daha sonra bu yapıtı aynı mantıksal uygulama kaynağı içindeki tüm alt iş akışlarında kullanabilirsiniz.

      Bu nedenle, tümleştirme hesabınız yoksa veya bu hesaba ihtiyacınız varsa karşıya yükleme seçeneğini kullanabilirsiniz. Aksi takdirde, bağlama seçeneğini kullanabilirsiniz. Her iki durumda da, bu yapıtları aynı mantıksal uygulama kaynağı içindeki tüm alt iş akışlarında kullanabilirsiniz.

  • Çö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, çevrimdışı veya yerel olarak çalışan, verilerinizi bulutla eşitlemeyen ve çevrimiçi bir hesapta oturum açmanızı gerektirmeyen bir araç kullandığınızdan emin olun. Bu şekilde, hassas verileri herkese açık hale getirmekle ilgili riski 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'den büyük bir değere ayarlanmış aşırı sayıda max count 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 sembol ve tahmin oluşturur. Şema, örneğin 100.000'den fazla bu tür yapılara izin veriyorsa, şema genişletmesi aşırı 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, şimdi aşağıdaki senaryoya göre şemayı karşıya yüklemeniz gerekir:

Düz Dosya kodlama eylemi ekleme

  1. Azure portalında mantıksal uygulama iş akışınızı henüz açık değilse tasarımcıda açın.

  2. İş akışınızda tetikleyici veya iş akışınıza gereken başka eylemler yoksa, önce bu işlemleri ekleyin. Düz Dosya işlemlerinde kullanılabilir tetikleyici yoktur.

    Bu örnek, HTTP isteği alındığında adlı İstek tetikleyicisiyle devam eder.

  3. İş akışı tasarımcısında, Düz Dosya eylemini eklemek istediğiniz adımın altında Yeni adım'ı seçin.

  4. İşlem seçin arama kutusunun altında Yerleşik'i seçin. Arama kutusuna düz dosya girin.

  5. Eylemler listesinden Düz Dosya Kodlama adlı eylemi seçin.

    Arama kutusunda

  6. Eylemin content özelliğinde, aşağıdaki adımları izleyerek tetikleyiciden veya kodlamak istediğiniz önceki bir eylemden çıktı sağlayın:

    1. Dinamik içerik listesinin görünmesi için İçerik kutusunun içine tıklayın.

    2. Dinamik içerik listesinden kodlamak istediğiniz düz dosya içeriğini seçin.

      Bu örnek için dinamik içerik listesinde http isteği alındığında altında tetikleyiciden gövde içerik çıkışını temsil eden Gövde belirtecini seçin.

    Dinamik içerik listesi ve kodlama için seçilen içerik içeren Tüketim iş akışı tasarımcısını ve

    Not

    Body özelliği 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.

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

    Tüketim iş akışı tasarımcısını gösteren ve kodlama için seçilen şemayla

    Not

    Şema listesi boşsa mantıksal uygulama kaynağınız tümleştirme hesabınıza bağlı değildir veya tümleştirme hesabınız herhangi bir şema dosyası içermez.

    İşiniz bittiğinde, eyleminiz aşağıdakine benzer görünür:

    Tamamlanmış

  8. Eyleme başka isteğe bağlı parametreler eklemek için Yeni parametre ekle 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ı izleyebilir veya Azure Logic Apps'in boş düğümler oluşturmasını veya atabilmesini 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.

  9. İş 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 iş akışınızı henüz açık değilse tasarımcıda açın.

  2. İş akışınızda tetikleyici veya iş akışınıza gereken başka eylemler yoksa, önce bu işlemleri ekleyin. Düz Dosya işlemlerinde kullanılabilir tetikleyici yoktur.

    Bu örnek, HTTP isteği alındığında adlı İstek tetikleyicisiyle devam eder.

  3. İş akışı tasarımcısında, Düz Dosya eylemini eklemek istediğiniz adımın altında Yeni adım'ı seçin.

  4. İşlem seçin arama kutusunun altında Yerleşik'i seçin. Arama kutusuna düz dosya girin.

  5. Eylemler listesinden Düz Dosya Kod Çözme adlı eylemi seçin.

    Arama kutusunda

  6. Eylemin Content özelliğinde, aşağıdaki adımları izleyerek tetikleyiciden veya kodunu çözmek istediğiniz önceki bir eylemden çıktı sağlayın:

    1. Dinamik içerik listesinin görünmesi için İçerik kutusunun içine tıklayın.

    2. Dinamik içerik listesinden kodlamak istediğiniz düz dosya içeriğini seçin.

      Bu örnek için dinamik içerik listesinde http isteği alındığında altında tetikleyiciden gövde içerik çıkışını temsil eden Gövde belirtecini seçin.

    Dinamik içerik listesi ve kod çözme için seçilen içerik içeren Tüketim iş akışı tasarımcısını ve

    Not

    Body özelliği 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.

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

    Tüketim iş akışı tasarımcısını gösteren ve kod çözme için seçilen şemayla

    Not

    Şema listesi boşsa mantıksal uygulama kaynağınız tümleştirme hesabınıza bağlı değildir veya tümleştirme hesabınız herhangi bir şema dosyası içermez.

    İşiniz bittiğinde, eyleminiz aşağıdakine benzer görünür:

    Tamamlanmış

  8. İş 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'si özelliğini 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.

Sonraki adımlar