Azure Logic Apps kullanarak B2B iş akışlarında Exchange X12 iletileri

Ş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 bağlayıcısını kullanın. Bu bağlayıcı, X12 iletişimlerini destekleyen ve yöneten işlemler sağlar.

Bu kılavuzda, X12 için kodlama ve kod çözme eylemlerinin var olan bir mantıksal uygulama iş akışına nasıl ekleneceği gösterilmektedir. X12 eylemleriyle herhangi bir tetikleyici kullanabilirsiniz. Bu kılavuzdaki örneklerde İstek tetikleyicisi kullanılır.

Bağlayıcı teknik başvurusu

X12 bağlayıcısı, mantıksal uygulama türüne ve konak ortamına göre farklı sürümlere sahiptir.

Mantıksal uygulama	Çevre	Bağlayıcı sürümü
Tüketim	Çok Kiracılı Azure Logic Apps	Paylaşılan kategorisi altındaki bağlayıcı galerisinde görünen X12 yönetimli bağlayıcı. X12 bağlayıcısının bir tetikleyicisi ve birden çok eylemi vardır. Senaryonuza uygun herhangi bir tetikleyici kullanabilirsiniz. Daha fazla bilgi için bkz: - X12 yönetilen bağlayıcı referansı - X12 ileti sınırları
Standart	Tek kiracılı Azure Logic Apps, App Servis Ortamı v3 (yalnızca Windows planları) ve karma dağıtım	Yerleşik altında, bağlayıcı galerisine görünen X12 yerleşik bağlayıcı ve Paylaşılan altında, bağlayıcı galerisine görünen X12 yönetilen bağlayıcı. X12'nin yönetilen bağlayıcısı bir tetikleyici ve birden fazla işlem içerir. X12 yerleşik bağlayıcısı yalnızca eylemler sağlar. Senaryonuza uygun herhangi bir tetikleyici kullanabilirsiniz. Yerleşik sürüm aşağıdaki şekillerde farklılık gösterir: - Yerleşik sürüm, Azure sanal ağlara doğrudan erişebilir. Şirket içi veri ağ geçidine ihtiyacınız yoktur. - Yerleşik sürüm daha yüksek aktarım hızı ve daha düşük gecikme süresi sağlar. Daha fazla bilgi için bkz: - X12 yönetilen bağlayıcı referansı - X12 yerleşik bağlayıcı işlemleri - X12 ileti sınırları

X12 yerleşik işlemleri

Aşağıdaki bölümlerde X12 yerleşik bağlayıcı işlemleri ve parametreleri açıklanmaktadır:

X12 kodunu çözme

İşlem Kimliği: x12Decode

Düz dosyayı XML biçimine dönüştürerek X12 iletisinin kodunu çözer.

Parametreler

Ekran adı	JSON adı	Zorunlu	Türü	Açıklama
Kodunu çözmek için ileti	messageToDecode	Yes	String	X12 iletisi çözülmesi gereken mesaj.
B2B izleme kimliği	b2bTrackingId	Hayır	String	B2B izleme kimliği.

X12 kodla

İşlem Kimliği: x12Encode

XML'yi düz dosya biçimine dönüştürerek X12 iletisini kodlar.

Parametreler

Ekran adı	JSON adı	Zorunlu	Türü	Açıklama
Kodlanacak ileti	messageToEncode	Yes	String	Kodlanacak X12 mesajı.
Gönderen kimliği Gönderen niteleyicisi	senderIdentity.qualifier	Hayır	String	Gönderen niteleyicisi.
Gönderen kimliği Gönderen tanımlayıcısı	senderIdentity.value	Hayır	String	Gönderen tanımlayıcısı.
Alıcı kimliği Alıcı niteleyicisi	receiverIdentity.qualifier	Hayır	String	Alıcı niteleyicisi.
Alıcı kimliği Alıcı tanımlayıcısı	receiverIdentity.value	Hayır	String	Alıcı tanımlayıcısı.
X12 sözleşmesinin adı	agreementName	Hayır	String	X12 sözleşmesinin adı.
B2B izleme kimliği	b2bTrackingId	Hayır	String	B2B izleme kimliği.

X12 toplu verisini kodlama

İşlem Kimliği: x12BatchEncode

XML'yi düz dosya biçimine dönüştürerek bir X12 ileti toplu işlemini kodlar.

Parametreler

Ekran adı	JSON adı	Zorunlu	Türü	Açıklama
Toplu iletiler	batchMessage.items	Yes	Array	Kodlanacak X12 mesajı.
İleti Kimliği	batchMessage.items.messageId	Yes	String	Toplu iş öğesinin benzersiz kimliği.
Content	batchMessage.items.content	Yes	String	Toplu öğe içeriği.
Toplu adı	batchMessage.batchName	Hayır	String	Toplu adı.
Bölüm adı	batchMessage.partitionName	Hayır	String	Bölüm adı.
Gönderen kimliği Gönderen niteleyicisi	senderIdentity.qualifier	Hayır	String	Gönderen niteleyicisi.
Gönderen kimliği Gönderen tanımlayıcısı	senderIdentity.value	Hayır	String	Gönderen tanımlayıcısı.
Alıcı kimliği ve Alıcı niteleyicisi	receiverIdentity.qualifier	Hayır	String	Alıcı niteleyicisi.
Alıcı kimliği Alıcı tanımlayıcısı	receiverIdentity.value	Hayır	String	Alıcı tanımlayıcısı.
X12 sözleşmesinin adı	agreementName	Hayır	String	X12 sözleşmesinin adı.
B2B izleme kimliği	b2bTrackingId	Hayır	String	B2B izleme kimliği.

Önkoşullar

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

• X12 işlemlerini kullanmak istediğiniz mantıksal uygulama kaynağı ve iş akışı.

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

  • Azure Logic Apps'te Tüketim mantıksal uygulaması iş akışı oluşturma
  • Azure Logic Apps'te Standart mantıksal uygulama iş akışı oluşturma

• Kurumsal tümleştirme ve B2B iş akışlarında kullanılacak yapıtları tanımlamak ve depolamak için bir tümleştirme hesabı 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.

  • İş akışınızda kullanılan X12 işlemine katılan en az iki ticari ortağı tanımlar. Her iki iş ortağının tanımları aynı X12 iş kimliği niteleyicisini kullanmalıdır.

  • İş akışınıza katılan ticari ortaklar arasında bir X12 sözleşmesi tanımlar. Her sözleşme için bir konak iş ortağı ve konuk iş ortağı gerekir. Sizinle diğer iş ortağı arasındaki iletilerdeki içerik, sözleşme türüyle eşleşmelidir. İletileri alırken ve gönderirken kullanılacak sözleşme ayarları hakkında bilgi için bkz . X12 ileti ayarları.

    Önemli

    Sağlık Sigortası Taşınabilirlik ve Sorumluluk Yasası (HIPAA) şemalarıyla çalışıyorsanız sözleşmenize bir schemaReferences bölüm eklemeniz gerekir. Daha fazla bilgi için bkz . HIPAA şemaları ve ileti türleri.

  • XML doğrulaması için kullanılacak şemaları tanımlar.

    Önemli

    Sağlık Sigortası Taşınabilirlik ve Sorumluluk Yasası (HIPAA) şemalarıyla çalışıyorsanız HIPAA şemalarını ve ileti türlerini gözden geçirmeyi unutmayın.

• X12 işlemleriyle çalışmaya başlamadan önce Tüketim mantıksal uygulamanızı bağlamanız veya Standart mantıksal uygulamanızı bir tümleştirme hesabına bağlamanız gerekir.

  Bir X12 işlemi eklediğinizde, tümleştirme hesabına bir bağlantı da oluşturmanız gerekir. X12 işlemini iş akışınıza eklediğinizde bağlantıyı oluşturabilirsiniz.

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.

• Elektronik Veri Değişimini (EDI) 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.

X12 bağlayıcısı ile iletileri kodlamak için şu adımları izleyin:

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.

   Not

   Bunun yerine X12'ye kodla iletisini kimliklere göre kodla eylemini kullanmak için, daha sonra X12 sözleşmeniz tarafından belirtilen Gönderen tanımlayıcısı ve Alıcı tanımlayıcısı gibi farklı parametre değerleri sağlamanız gerekir. Ayrıca değeri kodlamak için XML iletisini belirtmelisiniz. Bu iletiyi tetikleyiciden veya önceki bir eylemden çıkış olarak seçebilirsiniz.

3. Tümleştirme hesabınızla bağlantı oluşturmanız istendiğinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Açıklama
   Bağlantı Adı	Yes	Bağlantı için bir ad.
   Tümleştirme Hesabı Kimliği	Yes	Aşağıdaki biçime sahip tümleştirme hesabınızın kaynak kimliği: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Örneğin: /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Bu kaynak kimliğini bulmak için şu adımları izleyin: 1. Azure portalında tümleştirme hesabınızı açın. 2. Tümleştirme hesabı kenar çubuğunda Genel Bakış'ı seçin. 3. Genel Bakış sayfasında JSON Görünümü'nü seçin. 4. Kaynak Kimliği özelliğinden değeri kopyalayın.
   Tümleştirme Hesabı SAS URL'si	Yes	Tümleştirme hesabınıza erişim sağlamak için paylaşılan erişim imzası (SAS) kimlik doğrulamasını kullanan istek uç noktası URL'si. Bu geri çağırma URL'si aşağıdaki biçime sahiptir: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Örneğin: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR Bu URL'yi bulmak için şu adımları izleyin: 1. Azure portalında tümleştirme hesabınızı açın. 2. Tümleştirme hesabı kenar çubuğunda, Ayarlar'ın altında Geri arama URL'si'ni seçin. 3. Oluşturulan Geri Çağırma URL'si özelliğinden değeri kopyalayın.
   Denetim Numarası Bloğunun Boyutu	Hayır	Yüksek aktarım hızı senaryoları için bir sözleşmeden ayıracak denetim numaralarının blok boyutu.

   Örneğin:

   

4. İşiniz bittiğinde Yeni oluştur'u seçin.

5. X12 eylem bilgileri bölmesinde aşağıdaki değerleri sağlayın:

   Parametre	Zorunlu	Açıklama
   X12 sözleşmesinin adı	Yes	Kullanılacak X12 sözleşmesi.
   Kodlanacak XML iletisi	Yes	Kodlanacak XML iletisi.
   Gelişmiş parametreler	Hayır	Seçebileceğiniz diğer parametreler: - 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ı (ISA12) - Uygulama Gönderen Tanımlayıcısı/Kodu GS02 - Uygulama Alıcı Tanımlayıcısı/Kod GS03 Daha fazla bilgi için bkz . X12 ileti ayarları.

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

   Bu çıkışı bulmak ve seçmek için şu adımları izleyin:

   1. Kodlanacak XML iletisi kutusunun içini seçin ve ardından yıldırım simgesini seçerek dinamik içerik listesini açın.

   2. Listeden, HTTP iletisi alındığında altında Gövde'yi seçin.

   

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.

X12 bağlayıcısı ile iş akışınızdaki X12 iletilerinin kodunu çözmek için şu adımları izleyin:

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. Tümleştirme hesabınızla bağlantı oluşturmanız istendiğinde aşağıdaki bilgileri sağlayın:

   Parametre	Zorunlu	Açıklama
   Bağlantı Adı	Yes	Bağlantı için bir ad.
   Tümleştirme Hesabı Kimliği	Yes	Aşağıdaki biçime sahip tümleştirme hesabınızın kaynak kimliği: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Örneğin: /subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Bu kaynak kimliğini bulmak için şu adımları izleyin: 1. Azure portalında tümleştirme hesabınızı açın. 2. Tümleştirme hesabı kenar çubuğunda Genel Bakış'ı seçin. 3. Genel Bakış sayfasında JSON Görünümü'nü seçin. 4. Kaynak Kimliği özelliğinden değeri kopyalayın.
   Tümleştirme Hesabı SAS URL'si	Yes	Tümleştirme hesabınıza erişim sağlamak için paylaşılan erişim imzası (SAS) kimlik doğrulamasını kullanan istek uç noktası URL'si. Bu geri çağırma URL'si aşağıdaki biçime sahiptir: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Örneğin: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR Bu URL'yi bulmak için şu adımları izleyin: 1. Azure portalında tümleştirme hesabınızı açın. 2. Tümleştirme hesabı kenar çubuğunda, Ayarlar'ın altında Geri arama URL'si'ni seçin. 3. Oluşturulan Geri Çağırma URL'si özelliğinden değeri kopyalayın.
   Denetim Numarası Bloğunun Boyutu	Hayır	Yüksek aktarım hızı senaryoları için bir sözleşmeden ayırılacak kontrol numaralarının blok büyüklüğü.

   Örneğin:

   

4. İşiniz bittiğinde Yeni oluştur'u seçin.

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

   Parametre	Zorunlu	Açıklama
   Kodunu çözmek için X12 düz dosya iletisi	Yes	Kodunu çözmek için düz dosya biçiminde X12 iletisi Not: bir ileti dizisindeki XML ileti yükü veya içeriği base64 kodludur. Bu içeriği işleyen bir ifade kullanmanız gerekir. Örneğin, aşağıdaki ifade, bir ileti dizisindeki içeriği , xml()ve base64ToBinary() işlevlerini kullanarak item()XML olarak işler: xml(base64ToBinary(item()?['Body']))
   Gelişmiş parametreler	Hayır	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 bkz . X12 ileti ayarları.

   Örneğin, İstek tetikleyicisinden alınan Gövde içerik çıkışını XML ileti yükü olarak kullanabilirsiniz, ancak önce aşağıdaki ifadede gösterildiği gibi bu içeriği işlemeniz gerekir:

   xml(base64ToBinary(item()?['Body']))

   Bu görevi tamamlamak için şu adımları izleyin:

   1. Kodu çözmek için X12 düz dosya iletisinin içini seçin ve ardından işlev simgesini seçerek ifade düzenleyicisini açın.

   2. İfade düzenleyicisi kutusuna, Request tetikleyicisinden Body çıkışına başvuran aşağıdaki ifadeyi girin:

      xml(base64ToBinary(string(triggerBody())))

   3. İşiniz bittiğinde Ekle'yi seçin.

   

İlgili içerik

• X12 TA1 teknik bildirimler ve hata kodları
• X12 997 işlevsel bildirimler ve hata kodları
• X12 ileti ayarları