Schema referens guide för språket för arbets flödes definition i Azure Logic Apps

När du skapar en Logic app i Azure Logic Apps, har din Logic app en underliggande arbets flödes definition som beskriver den faktiska logiken som körs i din Logic app. Den arbets flödes definitionen använder JSON och följer en struktur som verifieras av språk schema för arbets flödes definition. Den här referensen ger en översikt över den här strukturen och hur schemat definierar attribut i arbets flödes definitionen.

Struktur för arbets flödes definition

En arbets flödes definition innehåller alltid en utlösare för att instansiera din Logic app, plus en eller flera åtgärder som körs när utlösaren utlöses.

Här är en övergripande struktur för en arbets flödes definition:

"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>" }
}

Utlösare och åtgärder

I en arbets flödes definition triggers actions definierar avsnitten och de anrop som inträffar under arbets flödets körning. Syntax och mer information om dessa avsnitt finns i arbets flödes utlösare och åtgärder.

Parametrar

Distributions livs cykeln har vanligt vis olika miljöer för utveckling, testning, mellanlagring och produktion. När du distribuerar Logi Kap par till olika miljöer vill du förmodligen använda olika värden, t. ex. anslutnings strängar, baserat på dina distributions behov. Eller så kanske du har värden som du vill återanvända i din Logic app utan hårdkoda eller som ändras ofta. I arbets flödets definitions parameters avsnitt kan du definiera eller redigera parametrar för de värden som din Logic app använder vid körning. Du måste definiera dessa parametrar först innan du kan referera till parametrarna någon annan stans i arbets flödes definitionen.

Här är den allmänna strukturen för en parameter definition:

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

Skapa sedan en Azure Resource Manager mall för arbets flödes definitionen, definiera mallparametrar som godkänner de värden som du vill ha vid distributionen, Ersätt hårdkodad-värden med referenser till mall-eller arbets flödes definitions parametrar efter behov och lagra värdena som ska användas vid distributionen i en separat parameter fil. På så sätt kan du enkelt ändra dessa värden genom parameter filen utan att behöva uppdatera och distribuera om din Logic app. För information som är känslig eller måste skyddas, t. ex. användar namn, lösen ord och hemligheter, kan du lagra dessa värden i Azure Key Vault och låta parameter filen hämta dessa värden från ditt nyckel valv. Mer information och exempel på hur du definierar parametrar på mall-och arbets flödes definitions nivåer finns i Översikt: Automatisera distribution av logi Kap par med Azure Resource Manager mallar.

Statiska resultat

I staticResults -attributet definierar du en åtgärds modell outputs och status att åtgärden returnerar när åtgärdens statiska resultat-inställning är aktive rad. I åtgärdens definition runtimeConfiguration.staticResult.name refererar attributet till namnet på den statiska resultat definitionen i staticResults . Lär dig hur du kan testa Logi Kap par med blå data genom att konfigurera statiska resultat.

"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": { "<...>" }
}

I den här definitionen för HTTP-åtgärder runtimeConfiguration.staticResult.name är attributet exempelvis referenser i HTTP0 staticResults attributet där de blå utdata för åtgärden definieras. runtimeConfiguration.staticResult.staticResultOptionsAttributet anger att den statiska resultat inställningen är Enabled i http-åtgärden.

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

HTTP-åtgärden returnerar utdata i HTTP0 definitionen inuti staticResults . I det här exemplet är den blå utdatan i status koden OK . För rubrik värden är resultatet av den blå "Content-Type": "application/JSON" . För åtgärdens status är den blå utmatningen Succeeded .

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

Uttryck

Med JSON kan du ha exakta värden som finns i design läge, till exempel:

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

Du kan också ha värden som inte finns förrän kör tid. För att representera dessa värden kan du använda uttryck som utvärderas vid körning. Ett uttryck är en sekvens som kan innehålla en eller flera funktioner, operatorer, variabler, explicita värden eller konstanter. I arbets flödes definitionen kan du använda ett uttryck var som helst i ett JSON-sträng värde genom att använda prefixet med at-sign ( @ ). När du utvärderar ett uttryck som representerar ett JSON-värde extraheras uttrycks texten genom att det tas bort @ och alltid resulterar i ett annat JSON-värde.

För den tidigare definierade customerName egenskapen kan du till exempel hämta egenskap svärdet genom att använda funktionen Parameters () i ett uttryck och tilldela värdet till accountName egenskapen:

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

Med hjälp av String-interpolation kan du också använda flera uttryck inuti strängar som omsluts av @ tecken-och klammerparenteserna ( {} ). Här är syntaxen:

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

Resultatet är alltid en sträng, vilket gör den här funktionen liknande som concat() funktionen, till exempel:

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

Om du har en tecken sträng som börjar med ett @ tecken, ska du använda det @ @ som ett escape-tecken som ett escape-tecken i ett tecken. @@

Följande exempel visar hur uttryck utvärderas:

I de här exemplen antar vi att du definierar "myBirthMonth" lika med "januari" och "myAge" som motsvarar talet 42:

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

Följande exempel visar hur följande uttryck utvärderas:

När du arbetar visuellt i Logic Apps Designer kan du skapa uttryck genom uttrycks verktyget, till exempel:

När du är klar visas uttrycket för motsvarande egenskap i arbets flödes definitionen, till exempel searchQuery egenskapen här:

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

Utdata

I outputs avsnittet definierar du de data som arbets flödet kan returnera när du har kört klart. Om du till exempel vill spåra en speciell status eller ett värde från varje körning anger du att arbets flödets utdata returnerar dessa data.

Här är den allmänna strukturen för en utmatnings definition:

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

Om du vill hämta utdata från en arbets flödes körning granskar du din Logic Apps körnings historik och information i Azure Portal eller använder arbets flödes REST API. Du kan också skicka utdata till externa system, till exempel Power BI så att du kan skapa instrument paneler.

Operatorer

I uttryck och funktionerutför operatorer olika uppgifter, t. ex. referenser till en egenskap eller ett värde i en matris.

Functions

Vissa uttryck hämtar sina värden från körnings åtgärder som kanske inte redan finns när arbets flödes definitionen börjar köras. Om du vill referera till eller arbeta med dessa värden i uttryck kan du använda funktioner som definieras av arbets flödes definitions språket.

Nästa steg

• Läs mer om språk åtgärder och utlösare för arbets flödes definition
• Lär dig mer om att skapa och hantera Logi Kap par program mässigt med arbets flödes REST API