XML Azure Logic Apps Enterprise Integration Pack ile biçimlerde arasındaki dönüştürme eşlemeleri oluşturmaCreate maps that transform XML between formats in Azure Logic Apps with Enterprise Integration Pack

Kurumsal tümleştirme dönüştürme Bağlayıcısı verileri bir biçimden başka bir biçime dönüştürür.The Enterprise integration Transform connector converts data from one format to another format. Örneğin, YearMonthDay biçiminde geçerli tarihi içeren gelen ileti olabilir.For example, you may have an incoming message that contains the current date in the YearMonthDay format. Bir dönüştürme tarihi MonthDayYear biçimde yeniden biçimlendirmek için kullanabilirsiniz.You can use a transform to reformat the date to be in the MonthDayYear format.

Dönüşüm ne yapar?What does a transform do?

Olarak da bilinen bir eşlemesi olduğundan, bir dönüştürme kaynak XML Şeması (giriş) ve hedef XML Şeması (çıkış) oluşur.A Transform, which is also known as a map, consists of a Source XML schema (the input) and a Target XML schema (the output). Farklı yerleşik işlevler, yönetmek veya veri denetimi gibi dize işlemeleri, koşullu atamaları, aritmetik ifadeler, tarih saat biçimlendiricileri ve hatta döngü yapıları yardımcı olmak için kullanabilirsiniz.You can use different built-in functions to help manipulate or control the data, including string manipulations, conditional assignments, arithmetic expressions, date time formatters, and even looping constructs.

Dönüşümü oluşturmak nasıl?How to create a transform?

Visual Studio kullanarak bir dönüşüm/map oluşturabilirsiniz Kurumsal tümleştirme SDK'sı.You can create a transform/map by using the Visual Studio Enterprise Integration SDK. Oluşturma ve sınama dönüştürme işlemini tamamladığınızda dönüştürme tümleştirme hesabınıza yükleyin.When you are finished creating and testing the transform, you upload the transform into your integration account.

Dönüşüm kullanmaHow to use a transform

Tümleştirme hesabınızda dönüştürme/map karşıya yüklenmesinin ardından, mantıksal uygulama oluşturmak için kullanabilirsiniz.After you upload the transform/map into your integration account, you can use it to create a Logic app. Mantıksal uygulama, mantıksal uygulama tetiklenir (ve dönüştürülmesi için gereken giriş içerik olduğunda) Bağlantılarınızdaki çalıştırır.The Logic app runs your transformations whenever the Logic app is triggered (and there is input content that needs to be transformed).

Dönüşüm kullanmak için adımlar şunlardır:Here are the steps to use a transform:

ÖnkoşullarPrerequisites

  • Tümleştirme hesabı oluşturma ve bir eşleme ekleyinCreate an integration account and add a map to it

Geçen Önkoşullar sizin göre, mantıksal uygulamanızı oluşturmak için zaman verilmiştir:Now that you've taken care of the prerequisites, it's time to create your Logic app:

  1. Mantıksal uygulama oluşturma ve tümleştirme hesabınıza bağlayın harita içeren.Create a Logic app and link it to your integration account that contains the map.

  2. Ekleme bir istek mantıksal uygulamanızın tetikleyicisiAdd a Request trigger to your Logic app

  3. Ekle XML dönüştürme ilk seçerek eylem Eylem Ekle Add the Transform XML action by first selecting Add an action

  4. Sözcük girin dönüştürme kullanmak istediğiniz bir tüm eylemleri filtrelemek için arama kutusunaEnter the word transform in the search box to filter all the actions to the one that you want to use

  5. Seçin XML dönüştürme eylemiSelect the Transform XML action

  6. XML'in içerik , dönüştüren.Add the XML CONTENT that you transform. HTTP isteği aldığınız herhangi bir XML veri kullanabileceğiniz içerik.You can use any XML data you receive in the HTTP request as the CONTENT. Bu örnekte, mantıksal uygulama tetiklenir HTTP isteği gövdesinin seçin.In this example, select the body of the HTTP request that triggered the Logic app.

    Not

    Emin olun içeriğini XML dönüştürme XML'dir.Make sure that the content for the Transform XML is XML. İçerik XML içinde değil veya base64 ile kodlanmış içeriği işleyen bir ifade belirtmeniz gerekir.If the content is not in XML or is base64-encoded, you must specify an expression that processes the content. Örneğin, kullanabileceğiniz işlevlerigibi @base64ToBinary içeriği kod çözme için veya @xml içeriği XML olarak işlemek için.For example, you can use functions, like @base64ToBinary for decoding content or @xml for processing the content as XML.

  7. Adını seçin harita dönüştürmeyi gerçekleştirmek için kullanmak istediğiniz.Select the name of the MAP that you want to use to perform the transformation. Harita, tümleştirme hesabında zaten olması gerekir.The map must already be in your integration account. Daha önceki bir adımda zaten haritanızı içeren, tümleştirme hesabı, mantıksal uygulama erişimi getirdi.In an earlier step, you already gave your Logic app access to your integration account that contains your map.

  8. Çalışmanızı kaydedinSave your work

Bu noktada, map ayarlama tamamlandı.At this point, you are finished setting up your map. Gerçek bir uygulamada, SalesForce gibi bir LOB uygulaması dönüştürülmüş verileri depolamak isteyebilirsiniz.In a real world application, you may want to store the transformed data in an LOB application such as SalesForce. Kolayca Salesforce'a dönüşümün çıkış göndermek için bir eylem olarak belirtebilirsiniz.You can easily as an action to send the output of the transform to Salesforce.

Artık HTTP uç noktası için bir istekte, dönüştürme test edebilirsiniz.You can now test your transform by making a request to the HTTP endpoint.

Özellikler ve kullanım örnekleriFeatures and use cases

  • Bir eşlem içinde oluşturulan dönüştürme bir ad ve adres bir belgeden diğerine kopyalama gibi basit olabilir.The transformation created in a map can be simple, such as copying a name and address from one document to another. Veya, kullanıma hazır eşleme işlemleri kullanarak daha karmaşık dönüştürmeler oluşturabilirsiniz.Or, you can create more complex transformations using the out-of-the-box map operations.
  • Birden çok eşleme işlemleri veya işlevleri dizeleri, tarih saat işlevleri ve benzeri gibi kullanıma hazır.Multiple map operations or functions are readily available, including strings, date time functions, and so on.
  • Şemalar arasında doğrudan veri kopyasını yapabilirsiniz.You can do a direct data copy between the schemas. SDK'da bulunan eşleyicisinde karşılıkları hedef şema ile kaynak şema öğeleri bağlayan bir çizgi çizme olarak basit budur.In the Mapper included in the SDK, this is as simple as drawing a line that connects the elements in the source schema with their counterparts in the destination schema.
  • Bir eşleme oluştururken, tüm bağlantıları, oluşturma ve ilişkileri gösteren haritayı grafik gösterimi görüntüleyin.When creating a map, you view a graphical representation of the map, which shows all the relationships and links you create.
  • Örnek XML iletisi eklemek için testi Haritası özelliğini kullanın.Use the Test Map feature to add a sample XML message. Bir basit tıklamayla oluşturduğunuz harita test edin ve oluşturulan çıktıyı görürsünüz.With a simple click, you can test the map you created, and see the generated output.
  • Var olan eşlemeleri karşıya yüklemeUpload existing maps
  • XML biçimi için destek içerir.Includes support for the XML format.

Gelişmiş özelliklerAdvanced features

Başvuru bütünleştirilmiş kodu veya özel kod eşlemeleriReference assembly or custom code from maps

Dönüştürme eylem ayrıca haritalarını destekler veya başvuru içeren dış bütünleştirilmiş dönüştürür.The transform action also supports maps or transforms with reference to external assembly. Bu özellik, XSLT eşlemeleri doğrudan çağrıları özel .NET kodu için sağlar.This capability enables calls to custom .NET code directly from XSLT maps. Maps'a derleme kullanmak için Önkoşullar aşağıda verilmiştir.Here are the prerequisites to use assembly in maps.

  • Harita ve harita gereksinimlerini olmasını başvurduğu derlemenin tümleştirme hesabına yüklediniz.The map and the assembly referenced from the map needs to be uploaded to integration account.

    Not

    Belirli bir sırada yüklenecek Haritası ve derleme gereklidir.Map and assembly are required to be uploaded in a specific order. Derlemenin başvurduğu harita karşıya yüklemeden önce derlemeyi yüklemeniz gerekir.You must upload the assembly before you upload the map that references the assembly.

  • Harita, bu öznitelikler ve derleme koduna çağrı içeren CDATA bölümü de sahip olmanız gerekir:The map must also have these attributes and a CDATA section that contains the call to the assembly code:

    • adı özel bütünleştirilmiş kod adı.name is the custom assembly name.
    • ad alanı özel kodunu içeren bütünleştirilmiş kodunuzda ad alanındadır.namespace is the namespace in your assembly that includes the custom code.

    Bu örnek, çağrı "XslUtilitiesLib" adlı bir derlemeye başvuran bir harita gösterir circumreference derlemesinden yöntemi.This example shows a map that references an assembly named "XslUtilitiesLib" and calls the circumreference method from the assembly.

    <?xml version="1.0" encoding="UTF-8"?>
    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
    <msxsl:script language="C#" implements-prefix="user">
      <msxsl:assembly name="XsltHelperLib"/>
      <msxsl:using namespace="XsltHelpers"/>
      <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
    </msxsl:script>
    <xsl:template match="data">
       <circles>
          <xsl:for-each select="circle">
              <circle>
                  <xsl:copy-of select="node()"/>
                      <circumference>
                          <xsl:value-of select="user:circumference(radius)"/>
                      </circumference>
              </circle>
          </xsl:for-each>
       </circles>
      </xsl:template>
      </xsl:stylesheet>
    

Bayt sırası işaretiByte Order Mark

Varsayılan olarak, dönüştürme yanıttan bayt sırası işareti (BOM) ile başlar.By default, the response from the transformation starts with the Byte Order Mark (BOM). Kod Görünümü düzenleyicide çalışırken bu işlevselliğe erişebilirsiniz.You can access this functionality only while working in the Code View editor. Bu işlev devre dışı bırakmak için belirtin disableByteOrderMark için transformOptions özelliği:To disable this functionality, specify disableByteOrderMark for the transformOptions property:

"Transform_XML": {
    "inputs": {
        "content": "@{triggerBody()}",
        "integrationAccount": {
            "map": {
                "name": "TestMap"
            }
        },
        "transformOptions": "disableByteOrderMark"
    },
    "runAfter": {},
    "type": "Xslt"
}

Daha fazla bilgi edininLearn more