Azure Logic Apps'te iş akışlarını kullanarak Exchange X12 iletileri

  • Makale

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

Azure Logic Apps kullanarak oluşturduğunuz iş akışlarında X12 iletileri göndermek ve almak için X12 iletişimini destekleyen ve yöneten işlemler sağlayan X12 bağlayıcısını kullanın.

Bu nasıl yapılır kılavuzu, mevcut bir mantıksal uygulama iş akışına X12 kodlama ve kod çözme eylemlerinin nasıl ekleneceğini gösterir. X12 bağlayıcısı tetikleyici içermez, bu nedenle iş akışınızı başlatmak için herhangi bir tetikleyici kullanabilirsiniz. Bu kılavuzdaki örneklerde İstek tetikleyicisi kullanılır.

Bağlan veya teknik başvuru

X12 bağlayıcısı, çok kiracılı Azure Logic Apps, tek kiracılı Azure Logic Apps ve tümleştirme hizmeti ortamı (ISE) içindeki iş akışları genelinde tek bir sürüme sahiptir. X12 bağlayıcısı hakkında teknik bilgi için aşağıdaki belgelere bakın:

Önkoşullar

X12 iletilerini kodlama

X12'ye Kodla ileti işlemi aşağıdaki görevleri gerçekleştirir:

  • Gönderen ve alıcı bağlam özelliklerini eşleştirerek sözleşmeyi çözer.
  • EDI değişimini serileştirir ve XML ile kodlanmış iletileri değişimdeki EDI işlem kümelerine dönüştürür.
  • İşlem kümesi üst bilgisi ve fragman kesimlerini uygular.
  • Her giden değişim için bir değişim denetim numarası, bir grup denetim numarası ve bir işlem kümesi denetim numarası oluşturur.
  • Yük verilerindeki ayırıcıları değiştirir.
  • EDI ve iş ortağına özgü özellikleri doğrular.
    • İleti şemasında işlem kümesi veri öğelerinin şema doğrulaması.
    • İşlem kümesi veri öğelerinde EDI doğrulaması.
    • İşlem kümesi veri öğelerinde genişletilmiş doğrulama.
  • Yapılandırıldıysa Teknik ve İşlevsel Bir Bildirim isteğinde bulunur.
    • Üst bilgi doğrulamasının bir sonucu olarak bir Teknik Bildirim oluşturur. Teknik bildirim, adres alıcısı tarafından değişim üst bilgisinin ve fragmanının işlenme durumunu bildirir.
    • Gövde doğrulamasının bir sonucu olarak İşlevsel Bir Bildirim oluşturur. İşlevsel bildirim, alınan belge işlenirken karşılaşılan her hatayı bildirir.

  1. Azure portalında mantıksal uygulama kaynağınızı ve iş akışınızı tasarımcıda açın.

  2. Tasarımcıda, iş akışınıza sözleşme adına göre X12 iletisine kodla adlı X12 eylemini eklemek için bu genel adımları izleyin.

    Dekont

    Bunun yerine Kimliklere göre X12 iletisine kodla eylemini kullanmak istiyorsanız, daha sonra X12 sözleşmeniz tarafından belirtilen Gönderen tanımlayıcısı ve Alıcı tanımlayıcısı gibi farklı değerler sağlamanız gerekir. Ayrıca kodlanacak XML iletisini belirtmeniz gerekir. Bu, tetikleyicinin veya önceki bir eylemin çıkışı olabilir.

  3. İstendiğinde, tümleştirme hesabınız için aşağıdaki bağlantı bilgilerini sağlayın:

    Özellik Zorunlu Açıklama
    Bağlantı adı Evet Bağlantı için bir ad
    Tümleştirme Hesabı Evet Kullanılabilir tümleştirme hesapları listesinden kullanılacak hesabı seçin.

    Örneğin:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Bitirdiğinizde Oluştur'u seçin.

  5. X12 eylem bilgileri kutusunda aşağıdaki özellik değerlerini sağlayın:

    Özellik Zorunlu Açıklama
    X12 sözleşmesinin adı Evet Kullanılacak X12 sözleşmesi.
    Kodlanacak XML iletisi Evet Kodlanacak XML iletisi
    Diğer parametreler No Bu işlem aşağıdaki diğer parametreleri içerir:

    - Veri öğesi ayırıcısı
    - Bileşen ayırıcısı
    - Değiştirme karakteri
    - Segment sonlandırıcısı
    - Segment sonlandırıcısı soneki
    - Denetim Sürüm Numarası
    - Uygulama Gönderen Tanımlayıcısı/Kodu GS02
    - Uygulama Alıcı Tanımlayıcısı/Kod GS03

    Daha fazla bilgi için X12 ileti ayarlarını gözden geçirin.

    Örneğin, İstek tetikleyicisinden alınan Gövde içeriği çıkışını XML ileti yükü olarak kullanabilirsiniz:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

X12 iletilerinin kodunu çözme

X12 kodunu çözme ileti işlemi aşağıdaki görevleri gerçekleştirir:

  • Zarfı ticari ortak sözleşmesine göre doğrular.

  • EDI ve iş ortağına özgü özellikleri doğrular.

    • EDI yapısal doğrulaması ve genişletilmiş şema doğrulaması
    • Değişim zarfı yapısal doğrulaması
    • Zarfın denetim şemasına göre şema doğrulaması
    • İşlem kümesi veri öğelerinin ileti şemasına göre şema doğrulaması
    • İşlem kümesi veri öğelerinde EDI doğrulaması

  • Değişim, grup ve işlem kümesi denetim numaralarının yinelenen olmadığını doğrular.

    • Değişim denetim numarasını daha önce alınan değişimlerle karşılaştırarak denetler.
    • Grup denetim numarasını değişimdeki diğer grup denetim numaralarıyla karşılaştırarak denetler.
    • İşlem kümesi denetim numarasını, bu gruptaki diğer işlem kümesi denetim numaralarıyla karşılaştırarak denetler.

  • Bir değişimi işlem kümelerine böler veya değişimin tamamını korur:

    • Değişim işlemini işlem kümelerine bölün veya hata oluştuğunda işlem kümelerini askıya alın: Her işlem kümesini ayrıştırın. X12 kod çözme eylemi yalnızca doğrulaması badMessagesbaşarısız olan işlem kümelerini, kalan işlem kümelerini ise olarak goodMessagesverir.

    • Değişimi işlem kümelerine bölün veya hatada değişimi askıya alın: Her işlem kümesini ayrıştırın. Değişimdeki bir veya daha fazla işlem kümesi doğrulama başarısız olursa, X12 kod çözme eylemi bu değişimdeki tüm işlem kümelerini olarak badMessagesverir.

    • Değişim durumunu koruyun veya hatada işlem kümelerini askıya alın: Değişimi koruyun ve toplu değişimin tamamını işleyin. X12 kod çözme eylemi yalnızca doğrulaması badMessagesbaşarısız olan işlem kümelerini, kalan işlem kümelerini ise olarak goodMessagesverir.

    • Değişim durumunu koruyun veya hatada değişimi askıya alın: Değişimi koruyun ve toplu değişimin tamamını işleyin. Değişimdeki bir veya daha fazla işlem kümesi doğrulama başarısız olursa, X12 kod çözme eylemi bu değişimdeki tüm işlem kümelerini olarak badMessagesverir.

  • Yapılandırıldıysa, Teknik ve İşlevsel Bir Bildirim oluşturur.

    • Üst bilgi doğrulamasının bir sonucu olarak bir Teknik Bildirim oluşturur. Teknik bildirim, adres alıcısı tarafından değişim üst bilgisinin ve fragmanının işlenme durumunu bildirir.
    • Gövde doğrulamasının bir sonucu olarak İşlevsel Bir Bildirim oluşturur. İşlevsel bildirim, alınan belge işlenirken karşılaşılan her hatayı bildirir.

  1. Azure portalında mantıksal uygulama kaynağınızı ve iş akışınızı tasarımcıda açın.

  2. Tasarımcıda, iş akışınıza X12 kodunu çözme adlıX12 eylemini eklemek için bu genel adımları izleyin.

  3. İstendiğinde, tümleştirme hesabınız için aşağıdaki bağlantı bilgilerini sağlayın:

    Özellik Zorunlu Açıklama
    Bağlantı adı Evet Bağlantı için bir ad
    Tümleştirme Hesabı Evet Kullanılabilir tümleştirme hesapları listesinden kullanılacak hesabı seçin.

    Örneğin:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Bitirdiğinizde Oluştur'u seçin.

  5. X12 eylem bilgileri kutusunda aşağıdaki özellik değerlerini sağlayın:

    Özellik Zorunlu Açıklama
    Kodunu çözmek için X12 düz dosya iletisi Evet Kodunu çözmek için düz dosya biçiminde X12 iletisi

    Not: İleti dizisinin XML ileti yükü veya içeriği (iyi veya kötü) base64 kodlanmıştır. Bu nedenle, bu içeriği işleyen bir ifade kullanmanız gerekir. Örneğin, aşağıdaki ifade ileti içeriğini XML olarak işler:

    xml(base64ToBinary(item()?['Body']))
    Diğer parametreler No Bu işlem aşağıdaki diğer parametreleri içerir:

    - Değişimi Koru
    - Hatada Değişimi Askıya Al

    Daha fazla bilgi için X12 ileti ayarlarını gözden geçirin.

    Örneğin, İstek tetikleyicisinden alınan Gövde içerik çıkışını XML ileti yükü olarak kullanabilirsiniz, ancak önce bir ifade kullanarak bu içeriği önceden işlemeniz gerekir:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Sonraki adımlar