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

Ş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:

• Tüketim ve Standart mantıksal uygulamalar karşılaştırması
• Tümleştirme hesabı yerleşik bağlayıcıları
• Azure Logic Apps için yerleşik bağlayıcılara genel bakış
• Azure Logic Apps'te yönetilen veya Azure tarafından barındırılan bağlayıcılar

Ö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:

  • Çok kiracılı Azure Logic Apps'te örnek tüketim mantıksal uygulaması iş akışı oluşturma

  • Tek kiracılı Azure Logic Apps'te örnek bir Standart mantıksal uygulama iş akışı oluşturma

• 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.

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:

• Tüketim mantıksal uygulaması iş akışı üzerinde çalışıyorsanız şemanızı tümleştirme hesabınıza ekleyin.

• Standart mantıksal uygulama iş akışı üzerinde çalışıyorsanız, şemanızı tümleştirme hesabınıza ekleyebilir veya şemanızı mantıksal uygulama kaynağınıza ekleyebilirsiniz.

Düz Dosya kodlama eylemi ekleme

Tüketim

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.

   

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.

   

   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.

   

   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:

   

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.

Standart

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. Tasarımcıda, Düz Dosya eylemini eklemek istediğiniz adımın altında artı işaretini ()+ ve ardından Eylem ekle'yi seçin.

4. Görüntülenen Eylem ekle bölmesinde, arama kutusunun altında Yerleşik'i seçin.

5. Arama kutusuna düz dosya girin. Eylemler listesinden Düz Dosya Kodlama adlı eylemi seçin.

   

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.

   

7. Kaynak listesinden şema kaynağınız olarak LogicApp veya IntegrationAccount'ı seçin.

   Bu örnek IntegrationAccount'ı seçerek devam eder.

   

8. Ad listesinden kodlama için mantıksal uygulama kaynağınıza daha önce yüklediğiniz şemayı seçin, örneğin:

   

   Not

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

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

Düz Dosya kod çözme eylemi ekleme

Tüketim

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.

   

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.

   

   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.

   

   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:

   

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

Standart

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. Tasarımcıda, Düz Dosya eylemini eklemek istediğiniz adımın altında artı işaretini ()+ ve ardından Eylem ekle'yi seçin.

4. Görüntülenen Eylem ekle bölmesinde, arama kutusunun altında Yerleşik'i seçin.

5. Arama kutusuna düz dosya girin. Eylemler listesinden Düz Dosya Kod Çözme adlı eylemi seçin.

   

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.

   

7. Kaynak listesinden şema kaynağınız olarak LogicApp veya IntegrationAccount'ı seçin.

   Bu örnek IntegrationAccount'ı seçerek devam eder.

   

8. Ad listesinden, kod çözme için mantıksal uygulama kaynağınıza daha önce yüklediğiniz şemayı seçin, örneğin:

   

   Not

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

9. İş 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:

• Azure Logic Apps için yönetilen bağlayıcılar
• Azure Logic Apps için yerleşik bağlayıcılar

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

1. Postman'i veya benzer bir aracı ve POST yöntemini kullanarak İstek tetikleyicisinin URL'sine bir çağrı gönderin. İstek tetikleyicisinin HTTP POST URL'si özelliğinde görünür ve kodlamak veya kodunu çözmek istediğiniz XML içeriğini istek gövdesine ekleyin.

2. İş 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

• Kurumsal Tümleştirme Paketi hakkında daha fazla bilgi edinin