Azure Logic Apps Iş akışı tanım dili için şema başvurusu Kılavuzu

Azure Logic Apps' de bir mantıksal uygulama oluşturduğunuzda, mantıksal uygulamanızda mantıksal uygulamanızda çalışan gerçek mantığı açıklayan bir temel alınan iş akışı tanımı vardır. Bu iş akışı tanımı JSON kullanır ve Iş akışı Tanım Dili şeması tarafından doğrulanan bir yapıyı izler. Bu başvuru, bu yapıyla ilgili bir genel bakış ve şemanın iş akışı tanımınızda öznitelikleri nasıl tanımladığını sağlar.

İş akışı tanımı yapısı

Bir iş akışı tanımı her zaman mantıksal uygulamanızı başlatmak için bir tetikleyici ve tetikleyici başladıktan sonra çalışan bir veya daha fazla eylemi içerir.

İş akışı tanımı için üst düzey yapı aşağıda verilmiştir:

"definition": {
  "$schema": "<workflow-definition-language-schema-version>",
  "actions": { "<workflow-action-definitions>" },
  "contentVersion": "<workflow-definition-version-number>",
  "outputs": { "<workflow-output-definitions>" },
  "parameters": { "<workflow-parameter-definitions>" },
  "staticResults": { "<static-results-definitions>" },
  "triggers": { "<workflow-trigger-definitions>" }
}

Tetikleyiciler ve eylemler

Bir iş akışı tanımında, triggers ve actions bölümleri iş akışınızın yürütülmesi sırasında gerçekleşen çağrıları tanımlar. Söz dizimi ve bu bölümler hakkında daha fazla bilgi için bkz. Iş akışı Tetikleyicileri ve eylemleri.

Parametreler

Dağıtım yaşam döngüsü genellikle geliştirme, test, hazırlama ve üretim için farklı ortamlara sahiptir. Mantıksal uygulamaları çeşitli ortamlara dağıttığınızda, büyük ihtimalle dağıtım gereksinimlerinize göre bağlantı dizeleri gibi farklı değerler kullanmak istersiniz. Ya da, bir veya daha fazla değişiklik yapmadan mantıksal uygulamanız genelinde yeniden kullanmak istediğiniz değerlere sahip olabilirsiniz. İş akışı tanımınızın parameters bölümünde, mantıksal uygulamanızın çalışma zamanında kullandığı değerler için parametreleri tanımlayabilir veya düzenleyebilirsiniz. Bu parametreleri iş akışı tanımınızın başka bir yerinde kaydedebilmek için önce bu parametreleri tanımlamanız gerekir.

Bir parametre tanımının genel yapısı aşağıda verilmiştir:

"parameters": {
   "<parameter-name>": {
      "type": "<parameter-type>",
      "defaultValue": <default-parameter-value>,
      "allowedValues": [ <array-with-permitted-parameter-values> ],
      "metadata": {
         "description": "<parameter-description>"
      }
   }
},

Ardından, iş akışı tanımınız için bir Azure Resource Manager şablonu oluşturun, dağıtım sırasında istediğiniz değerleri kabul eden şablon parametrelerini tanımlayın, sabit kodlanmış değerleri şablon veya iş akışı Tanım parametrelerine başvurularla değiştirin ve ayrı bir parametre dosyasındadağıtımda kullanılacak değerleri depolayın. Bu şekilde, mantıksal uygulamanızı güncelleştirip yeniden dağıtmanıza gerek kalmadan parametre dosyası aracılığıyla bu değerleri daha kolay bir şekilde değiştirebilirsiniz. Gizli olan veya güvenli hale getirilmesi gereken (örneğin, Kullanıcı adları, parolalar ve gizli bilgiler), bu değerleri Azure Key Vault saklayabilir ve parametre dosyanızın anahtar kasasından bu değerleri almasına sahip olursunuz. Şablon ve iş akışı Tanım düzeylerinde parametreleri tanımlama hakkında daha fazla bilgi ve örnekler için bkz. genel bakış: Azure Resource Manager şablonlarıyla Logic Apps için dağıtımı otomatikleştirin.

Statik sonuçlar

staticResultsÖzniteliğinde, bir eylemin sahte outputs olduğunu ve eylemin status statik sonuç ayarı açık olduğunda eylemin döndürdüğü eylemi tanımlayın. Eylemin tanımında runtimeConfiguration.staticResult.name öznitelik, içindeki statik sonuç tanımının adına başvurur staticResults . Statik sonuçlar ayarlayarak, sahte verilerle mantıksal uygulamaları nasıl testkullanabileceğinizi öğrenin.

"definition": {
   "$schema": "<...>",
   "actions": { "<...>" },
   "contentVersion": "<...>",
   "outputs": { "<...>" },
   "parameters": { "<...>" },
   "staticResults": {
      "<static-result-definition-name>": {
         "outputs": {
            <output-attributes-and-values-returned>,
            "headers": { <header-values> },
            "statusCode": "<status-code-returned>"
         },
         "status": "<action-status>"
      }
   },
   "triggers": { "<...>" }
}

Örneğin, bu HTTP eylem tanımında runtimeConfiguration.staticResult.name öznitelik, HTTP0 staticResults eylem için olan model çıkışları tanımlı özniteliğin içinde başvuru yapıyor. runtimeConfiguration.staticResult.staticResultOptionsÖzniteliği statik sonuç AYARıNıN Enabled http eyleminde olduğunu belirtir.

"actions": {
   "HTTP": {
      "inputs": {
         "method": "GET",
         "uri": "https://www.microsoft.com"
      },
      "runAfter": {},
      "runtimeConfiguration": {
         "staticResult": {
            "name": "HTTP0",
            "staticResultOptions": "Enabled"
         }
      },
      "type": "Http"
   }
},

HTTP eylemi, HTTP0 içindeki tanımdaki çıkışları döndürür staticResults . Bu örnekte, durum kodu için, sahte çıktı olur OK . Üst bilgi değerleri için, sahte çıktı olur "Content-Type": "application/JSON" . Eylemin durumu için, sahte çıktı olur Succeeded .

"definition": {
   "$schema": "<...>",
   "actions": { "<...>" },
   "contentVersion": "<...>",
   "outputs": { "<...>" },
   "parameters": { "<...>" },
   "staticResults": {
      "HTTP0": {
         "outputs": {
            "headers": {
               "Content-Type": "application/JSON"
            },
            "statusCode": "OK"
         },
         "status": "Succeeded"
      }
   },
   "triggers": { "<...>" }
},

İfadeler

JSON ile, tasarım zamanında mevcut olan değişmez değer değerlerine sahip olabilirsiniz, örneğin:

"customerName": "Sophia Owen",
"rainbowColors": ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
"rainbowColorsCount": 7

Ayrıca çalışma zamanına kadar mevcut olmayan değerlere sahip olabilirsiniz. Bu değerleri temsil etmek için, çalışma zamanında değerlendirilen ifadeleri kullanabilirsiniz. İfade bir veya daha fazla işlev, işleç, değişken, açık değer veya sabitler içerebilen bir dizidir. İş akışı tanımınızda, ifadesi @ işareti () ile önek olarak ekleyerek JSON dize değerinde herhangi bir yerde bir ifadeyi kullanabilirsiniz @ . JSON değerini temsil eden bir ifadeyi değerlendirirken, ifade gövdesi, karakter kaldırılarak ayıklanır @ ve her zaman başka BIR JSON değeriyle sonuçlanır.

Örneğin, daha önce tanımlanmış customerName olan özelliği için, bir ifadede Parameters () işlevini kullanarak özellik değerini alabilir ve bu değeri accountName özelliğine atayabilirsiniz:

"customerName": "Sophia Owen",
"accountName": "@parameters('customerName')"

Dize ilişkilendirme Ayrıca @ karakter ve küme ayraçları () tarafından Sarmalanan dizeler içinde birden çok ifade kullanmanızı sağlar {} . Sözdizimi şöyledir:

@{ "<expression1>", "<expression2>" }

Sonuç her zaman bir dizedir ve bu özellik işleve benzer hale getirir concat() , örneğin:

"customerName": "First name: @{parameters('firstName')} Last name: @{parameters('lastName')}"

Karakteriyle başlayan bir sabit dize varsa @ , @ karakteri @ Çıkış karakteri olarak başka bir karakterle önek olarak ekleyin: @@

Bu örnekler, ifadelerin nasıl değerlendirildiğini gösterir:

Bu örnekler için, "Mydoğum ayı" ' nı "Ocak" ve "myAge" değerinden 42 numaraya eşit olarak tanımladığınızı varsayalım:

"myBirthMonth": "January",
"myAge": 42

Bu örneklerde aşağıdaki ifadelerin nasıl değerlendirildiği gösterilmektedir:

Logic Apps tasarımcısında görsel olarak çalışırken, Ifade Oluşturucu aracılığıyla ifadeler oluşturabilirsiniz, örneğin:

İşiniz bittiğinde, ifadesi iş akışı tanımınızda karşılık gelen özellik için görünür, örneğin, searchQuery burada özelliği:

"Search_tweets": {
  "inputs": {
    "host": {
      "connection": {
        "name": "@parameters('$connections')['twitter']['connectionId']"
      }
    }
  },
  "method": "get",
  "path": "/searchtweets",
  "queries": {
    "maxResults": 20,
    "searchQuery": "Azure @{concat('firstName','', 'LastName')}"
  }
},

Çıkışlar

outputsBölümünde, iş akışınızın, çalışmayı bitirdiğinde döndürebileceğinizi belirten verileri tanımlayın. Örneğin, her çalıştırmada belirli bir durumu veya değeri izlemek için, iş akışı çıktısının bu verileri döndürdüğünü belirtin.

Bir çıkış tanımının genel yapısı aşağıda verilmiştir:

"outputs": {
  "<key-name>": {
    "type": "<key-type>",
    "value": "<key-value>"
  }
}

Bir iş akışı çalıştırmasının çıkışını almak için Azure portal mantıksal uygulamanızın çalıştırma geçmişini ve ayrıntılarını gözden geçirin veya Iş akışı REST APIkullanın. Ayrıca, panoları oluşturabilmeniz için çıktıyı dış sistemlere geçirebilirsiniz (örneğin, Power BI).

İşleçler

İfadeler ve işlevlerde, işleçler bir özellik başvurusu veya dizideki bir değer gibi belirli görevleri gerçekleştirir.

İşlevler

Bazı ifadeler, iş akışı tanımınız çalışmaya başladığında henüz mevcut olmayan çalışma zamanı eylemlerinden değerlerini alır. Deyimlerdeki bu değerlere başvurmak veya bunlarla çalışmak için, Iş akışı tanımı dilinin sağladığı işlevleri kullanabilirsiniz.

Sonraki adımlar

• Iş akışı tanımı dil eylemleri ve Tetikleyicileri hakkında bilgi edinin
• Iş akışı ile programlı bir şekilde mantıksal uygulamalar oluşturma ve yönetme hakkında bilgi edinin REST API