Naslag Gids voor schema's voor de taal van de werk stroom definitie in Azure Logic Apps

Wanneer u een logische app in Azure Logic appsmaakt, heeft uw logische app een onderliggende werk stroom definitie die de daad werkelijke logica beschrijft die in uw logische app wordt uitgevoerd. Deze werk stroom definitie maakt gebruik van JSON en volgt een structuur die wordt gevalideerd door het taal schema voor de werk stroom definitie. Deze Naslag informatie bevat een overzicht van deze structuur en hoe het schema kenmerken in uw workflowdefinitie definieert.

Structuur van werk stroom definitie

Een definitie van een werk stroom bevat altijd een trigger voor het instantiëren van uw logische app, plus een of meer acties die worden uitgevoerd nadat de trigger wordt geactiveerd.

Dit is de structuur op hoog niveau voor een werk stroom definitie:

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

Triggers en acties

In een werk stroom definitie triggers definiëren de en- actions secties de aanroepen die tijdens de uitvoering van de werk stroom plaatsvinden. Zie werk stroom triggers en actiesvoor een syntaxis en meer informatie over deze secties.

Parameters

De levens cyclus van de implementatie heeft doorgaans verschillende omgevingen voor ontwikkeling, testen, faseren en productie. Wanneer u logische apps implementeert in verschillende omgevingen, wilt u waarschijnlijk verschillende waarden gebruiken, zoals verbindings reeksen, op basis van uw implementatie behoeften. Het kan ook zijn dat u waarden wilt gebruiken die u in de logische app wilt hergebruiken zonder hardcoding of die regel matig veranderen. In de sectie werk stroom definitie parameters kunt u para meters definiëren of bewerken voor de waarden die uw logische app gebruikt tijdens runtime. U moet deze para meters eerst definiëren voordat u deze para meters ergens anders in uw werk stroom definitie kunt raadplegen.

Hier volgt de algemene structuur voor een parameter definitie:

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

Maak vervolgens een Azure Resource Manager sjabloon voor de definitie van uw werk stroom, definieer sjabloon parameters die de waarden accepteren die u tijdens de implementatie wilt gebruiken, vervang hardcoded-waarden door verwijzingen naar sjabloon-of werk stroom definitie parameters en sla de waarden op die moeten worden gebruikt bij de implementatie in een afzonderlijk parameter bestand. Op die manier kunt u deze waarden gemakkelijker wijzigen via het parameter bestand zonder dat u uw logische app hoeft bij te werken en opnieuw te implementeren. Voor informatie die gevoelig is of die moet worden beveiligd, zoals gebruikers namen, wacht woorden en geheimen, kunt u deze waarden opslaan in Azure Key Vault en uw parameter bestand de waarden laten ophalen uit uw sleutel kluis. Zie overzicht: implementatie voor Logic apps automatiseren met Azure Resource Manager sjablonenvoor meer informatie en voor beelden over het definiëren van para meters in de sjabloon en de definities van werk stromen.

Statische resultaten

Definieer in het staticResults -kenmerk een actie model outputs en status dat de actie retourneert wanneer de statische resultaat instelling van de actie is ingeschakeld. In de definitie van de actie runtimeConfiguration.staticResult.name verwijst het kenmerk naar de naam van de statische resultaat definitie in staticResults . Meer informatie over hoe u logische apps kunt testen met gegevens over modellen door statische resultaten in te stellen.

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

In deze HTTP-actie definitie wordt bijvoorbeeld het runtimeConfiguration.staticResult.name kenmerk verwezen naar HTTP0 het staticResults kenmerk waarin de uitvoer van de model voor de actie wordt gedefinieerd. Het runtimeConfiguration.staticResult.staticResultOptions kenmerk geeft aan dat de statische resultaat instelling is ingesteld Enabled op de http-actie.

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

De HTTP-actie retourneert de uitvoer in de HTTP0 definitie in staticResults . In dit voor beeld is voor de status code de uitvoer van de Modeler OK . Voor header waarden is de uitvoer van de Detrek "Content-Type": "application/JSON" . Voor de status van de actie is de uitvoer van de activiteit Succeeded .

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

Expressies

Met JSON kunt u letterlijke waarden hebben die tijdens de ontwerp fase bestaan, bijvoorbeeld:

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

U kunt ook waarden hebben die niet bestaan tot de uitvoerings tijd. Om deze waarden weer te geven, kunt u expressies gebruiken die tijdens runtime worden geëvalueerd. Een expressie is een reeks die een of meer functies, Opera tors, variabelen, expliciete waarden of constanten kan bevatten. In de definitie van uw werk stroom kunt u een expressie overal in een JSON-teken reeks waarde gebruiken door de expressie te voorzien van het plus teken ( @ ). Bij het evalueren van een expressie die een JSON-waarde vertegenwoordigt, wordt de hoofd tekst van de expressie geëxtraheerd door het @ teken te verwijderen en wordt altijd een andere JSON-waarde geretourneerd.

Voor de eerder gedefinieerde customerName eigenschap kunt u bijvoorbeeld de waarde van de eigenschap ophalen met behulp van de functie para meters () in een expressie en die waarde toewijzen aan de accountName eigenschap:

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

Met de interpolatie van teken reeksen kunt u ook meerdere expressies gebruiken in teken reeksen die worden verpakt door het teken en accolades @ ( {} ). Dit is de syntaxis:

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

Het resultaat is altijd een teken reeks, waardoor deze functionaliteit vergelijkbaar is met de concat() functie, bijvoorbeeld:

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

Als u een letterlijke teken reeks hebt die begint met het teken, plaatst u een @ voor voegsel @ van het teken met een ander @ teken als escape-teken: @@

In deze voor beelden ziet u hoe expressies worden geëvalueerd:

Voor deze voor beelden definieert u "myBirthMonth" gelijk aan "januari" en "myAge" gelijk aan het getal 42:

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

In deze voor beelden ziet u hoe de volgende expressies worden geëvalueerd:

Wanneer u visueel met de Logic Apps Designer werkt, kunt u expressies maken via de opbouw functie van de expressie, bijvoorbeeld:

Wanneer u klaar bent, wordt de expressie weer gegeven voor de bijbehorende eigenschap in de definitie van de werk stroom, bijvoorbeeld de searchQuery eigenschap:

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

Uitvoerwaarden

In de outputs sectie definieert u de gegevens die uw werk stroom kan retour neren als de uitvoering is voltooid. Als u bijvoorbeeld een specifieke status of waarde van elke uitvoering wilt bijhouden, geeft u op dat de uitvoer van de werk stroom die gegevens retourneert.

Hier volgt de algemene structuur voor een uitvoer definitie:

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

Als u de uitvoer van een werk stroom wilt uitvoeren, controleert u de uitvoerings geschiedenis van de logische app en de details in de Azure Portal of gebruikt u de werk stroom rest API. U kunt ook de uitvoer door geven aan externe systemen, bijvoorbeeld Power BI, zodat u Dash boards kunt maken.

Operators

In expressies en functiesvoeren Opera tors specifieke taken uit, zoals verwijzen naar een eigenschap of een waarde in een matrix.

Functions

Sommige expressies halen hun waarden uit runtime-acties die mogelijk nog niet bestaan wanneer de definitie van de werk stroom wordt gestart. Als u wilt verwijzen naar of wilt werken met deze waarden in expressies, kunt u functies gebruiken die door de werk stroom definitie taal zijn geleverd.

Volgende stappen

• Meer informatie over acties en triggers voor de werk stroom definitie taal
• Meer informatie over het programmatisch maken en beheren van logische apps met behulp van de werk stroom rest API