Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Al crear un flujo de trabajo de aplicación lógica en Azure Logic Apps, el flujo de trabajo tiene una definición subyacente de notación de objetos JavaScript (JSON) que describe la lógica real que ejecuta el flujo de trabajo. La definición de flujo de trabajo sigue una estructura que se valida con el esquema del lenguaje de definición de flujo de trabajo. En esta referencia se proporciona información general sobre esta estructura y cómo el esquema define los atributos en la definición de flujo de trabajo.
Estructura de definición de flujo de trabajo
Una definición de flujo de trabajo siempre incluye un desencadenador que crea instancias del flujo de trabajo, además de una o varias acciones que se ejecutan después de que se active el desencadenador.
Esta es la estructura de alto nivel para una definición de flujo de trabajo:
"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>" }
}
| Attribute | Required | Description |
|---|---|---|
definition |
Yes | El elemento inicial de la definición de flujo de trabajo. |
$schema |
Solo cuando se hace referencia externa a una definición de flujo de trabajo. | La ubicación del archivo de esquema JSON que describe la versión del lenguaje de definición de flujo de trabajo, que puede encontrar aquí: https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json |
actions |
No | Las definiciones de una o varias acciones que se van a ejecutar en el tiempo de ejecución del flujo de trabajo. Para más información, vea Desencadenadores y acciones. Máximo de acciones: 250 |
contentVersion |
No | El número de versión de la definición de flujo de trabajo, que es "1.0.0.0" de forma predeterminada. Para ayudar a identificar y confirmar la definición correcta al implementar un flujo de trabajo, especifique el valor que usará. |
outputs |
No | Las definiciones de las salidas que se devuelven de la ejecución de un flujo de trabajo. Para obtener más información, consulte Salidas. Máximo de salidas: 10 |
parameters |
No | Las definiciones de uno o varios parámetros que pasan los valores que se usan en el runtime de una aplicación lógica. Para obtener más información, vea Parámetros. Máximo de parámetros: 50 |
staticResults |
No | Las definiciones de uno o varios resultados estáticos devueltos por las acciones como salidas ficticias cuando se habilitan los resultados estáticos en esas acciones. En cada definición de acción, el atributo runtimeConfiguration.staticResult.name hace referencia a la definición correspondiente dentro de staticResults. Para obtener más información, consulte Resultados estáticos. |
triggers |
No | Las definiciones de uno o varios desencadenadores que crean una instancia del flujo de trabajo. Puede definir más de un desencadenador, pero solo con el lenguaje de definición de flujo de trabajo, no visualmente mediante el Diseñador de flujo de trabajo. Para más información, vea Desencadenadores y acciones. Máximo de desencadenadores: 10 |
Desencadenadores y acciones
En una definición de flujo de trabajo, las secciones triggers y actions definen las llamadas que se producen durante la ejecución del flujo de trabajo. Para más información sobre estas secciones y la sintaxis, consulte Desencadenadores y acciones para flujos de trabajo.
Parameters
Por lo general, el ciclo de vida de una implementación tiene distintos entornos para el desarrollo, las pruebas, el almacenamiento provisional y la producción. Al implementar aplicaciones lógicas en varios entornos, es probable que desee usar valores diferentes, como cadenas de conexión, en función de sus necesidades de implementación. O bien, es posible que tenga valores que quiera reutilizar en todo el flujo de trabajo sin codificación rígida o ese cambio a menudo. En la sección de la definición de parameters flujo de trabajo, puede definir o editar parámetros para los valores que usa el flujo de trabajo en tiempo de ejecución. Estos parámetros deben definirse antes para poder hacer referencia a ellos en cualquier otra parte de la definición del flujo de trabajo.
Esta es la estructura general de una definición de parámetro:
"parameters": {
"<parameter-name>": {
"type": "<parameter-type>",
"defaultValue": <default-parameter-value>,
"allowedValues": [ <array-with-permitted-parameter-values> ],
"metadata": {
"description": "<parameter-description>"
}
}
},
| Attribute | Required | Type | Description |
|---|---|---|---|
| < parameter-name> | Yes | String | Nombre del parámetro que desea definir |
| < tipo de parámetro> | Yes | int, float, string, bool, array, object, securestring, secureobject Nota: Para todas las contraseñas, claves y secretos, use los securestring tipos o secureobject porque la GET operación no devuelve estos tipos. Para más información acerca de la protección de parámetros, consulte Recomendaciones de seguridad para los parámetros de acción y de entrada. |
El tipo del parámetro. |
| < default-parameter-value> | Yes | Igual que type. |
El valor de parámetro predeterminado que se usa si no se especifica ningún valor al crear una instancia del flujo de trabajo. El defaultValue atributo es necesario para que el diseñador de flujo de trabajo pueda mostrar correctamente el parámetro, pero puede especificar un valor vacío. |
| < array-with-permitted-parameter-values> | No | Array | Una matriz con valores que puede aceptar el parámetro. |
| < parameter-description> | No | Json (objeto) | Cualquier otro detalle del parámetro, como una descripción del parámetro |
Después, cree una plantilla de Azure Resource Manager para la definición del flujo de trabajo, defina parámetros de la plantilla que acepten los valores que desea en la implementación, reemplace los valores codificados por referencias a la plantilla o a los parámetros de definición del flujo de trabajo, según corresponda, y almacene los valores que se van a usar en la implementación en un archivo de parámetros independiente. De esta forma puede cambiar estos valores más fácilmente a través del archivo de parámetros sin tener que actualizar y volver a implementar la aplicación lógica. Para obtener información confidencial o debe protegerse, como nombres de usuario, contraseñas y secretos, puede almacenar esos valores en Azure Key Vault y hacer que el archivo de parámetros recupere esos valores del almacén de claves. Para más información y ejemplos acerca de cómo definir parámetros en los niveles de definición de plantilla y flujo de trabajo, consulte Introducción: Implementación automatizada de aplicaciones lógicas con plantillas de Azure Resource Manager.
Resultados estáticos
En el atributo staticResults, defina los valores ficticios outputs y status de una acción que se devuelven cuando se activa la configuración de resultado estático de la acción. En la definición de la acción, el atributo runtimeConfiguration.staticResult.name hace referencia al nombre de la definición de resultado estático dentro de staticResults. Descubra cómo puede probar flujos de trabajo de aplicaciones lógicas con datos simulados mediante la configuración de resultados estáticos.
"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": { "<...>" }
}
| Attribute | Required | Type | Description |
|---|---|---|---|
| < static-result-definition-name> | Yes | String | El nombre de una definición de resultado estático a la que una definición de acción puede hacer referencia a través de un objeto runtimeConfiguration.staticResult. Para más información, consulte Opciones de configuración del entorno en tiempo de ejecución. Puede usar el nombre único que quiera. De forma predeterminada, este nombre único se anexa con un número, que se incrementa según sea necesario. |
| < output-attributes-and-values-returned> | Yes | Varies | Los requisitos para estos atributos varían en función de diferentes condiciones. Por ejemplo, cuando status es Succeeded, el atributo outputs incluye los atributos y valores devueltos como salidas ficticias por la acción. Si status es Failed, el atributo outputs incluye el atributo errors, que es una matriz con uno o varios objetos message de error que tienen información del error. |
| < header-values> | No | JSON | Los valores de encabezado devueltos por la acción. |
| < status-code-returned> | Yes | String | Código de estado devuelto por la acción. |
| < action-status> | Yes | String | Estado de la acción, por ejemplo, Succeeded o Failed. |
Por ejemplo, en esta definición de acción HTTP, el atributo runtimeConfiguration.staticResult.name hace referencia a HTTP0 dentro del atributo staticResults donde se definen las salidas ficticias para la acción. El atributo runtimeConfiguration.staticResult.staticResultOptions especifica que la configuración de resultado estático es Enabled en la acción HTTP.
"actions": {
"HTTP": {
"inputs": {
"method": "GET",
"uri": "https://www.microsoft.com"
},
"runAfter": {},
"runtimeConfiguration": {
"staticResult": {
"name": "HTTP0",
"staticResultOptions": "Enabled"
}
},
"type": "Http"
}
},
La acción HTTP devuelve los resultados en la definición HTTP0 dentro de staticResults. En este ejemplo, para el código de estado, la salida ficticia es OK. Para los valores de encabezado, la salida ficticia es "Content-Type": "application/JSON". Para el estado de la acción, la salida ficticia es Succeeded.
"definition": {
"$schema": "<...>",
"actions": { "<...>" },
"contentVersion": "<...>",
"outputs": { "<...>" },
"parameters": { "<...>" },
"staticResults": {
"HTTP0": {
"outputs": {
"headers": {
"Content-Type": "application/JSON"
},
"statusCode": "OK"
},
"status": "Succeeded"
}
},
"triggers": { "<...>" }
},
Expressions
Con JSON, puede tener valores literales que existen en tiempo de diseño, por ejemplo:
"customerName": "Sophia Owen",
"rainbowColors": ["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
"rainbowColorsCount": 7
También puede tener valores que no existen hasta el momento de ejecución. Para representar estos valores, puede usar expresiones que se evalúan en tiempo de ejecución. Una expresión es una secuencia que puede contener una o varias funciones, operadores, variables, valores explícitos o constantes. En la definición de flujo de trabajo, se puede usar una expresión en cualquier lugar de un valor de cadena JSON agregando delante de la expresión el prefijo de signo de arroba (@). Al evaluar una expresión que representa un valor JSON, se extrae el cuerpo de la expresión quitando el carácter @ y siempre da como resultado otro valor JSON.
Por ejemplo, para la propiedad definida customerName anteriormente, puede obtener el valor de propiedad mediante la función parameters() en una expresión y asignar ese valor a la accountName propiedad :
"customerName": "Sophia Owen",
"accountName": "@parameters('customerName')"
La interpolación de cadenas también permite usar varias expresiones dentro de cadenas ajustadas por el carácter @ y llaves ({}). Esta es la sintaxis:
@{ "<expression1>", "<expression2>" }
El resultado siempre es una cadena, de forma que esta funcionalidad es similar a la función concat(), por ejemplo:
"customerName": "First name: @{parameters('firstName')} Last name: @{parameters('lastName')}"
Si tiene un literal de cadena que comienza por el carácter @, coloque delante de este carácter otro carácter @ como carácter de escape: @@
En estos ejemplos se muestra cómo se evalúan las expresiones:
| Valor JSON | Result |
|---|---|
| "Sophia Owen" | Devuelve estos caracteres: "Sophia Owen" |
| "array[1]" | Devuelve estos caracteres: "array [1]" |
| "@@" | Devuelve estos caracteres como una cadena de un carácter: "\@\" |
| " @" | Devuelve estos caracteres como una cadena de dos caracteres: \"\@\" |
Para estos ejemplos, suponga que tiene que definir "myBirthMonth" es igual a "January" y "myAge" es igual al número 42:
"myBirthMonth": "January",
"myAge": 42
Estos ejemplos muestran cómo se evalúan las expresiones siguientes:
| Expresión JSON | Result |
|---|---|
| "@parameters('myBirthMonth')" | Devuelve esta cadena: "January" |
| "@{parameters('myBirthMonth')}" | Devuelve esta cadena: "January" |
| "@parameters('myAge')" | Devuelve este número: 42 |
| "@{parameters('myAge')}" | Devuelve este número como una cadena: "42" |
| "Mi edad es @{parameters('myAge')}" | Devuelve esta cadena: "My age is 42" |
| "@concat('Mi edad es ', string(parameters('myAge')))" | Devuelve esta cadena: "My age is 42" |
| "Mi edad es @@{parameters('myAge')}" | Devuelve esta cadena, que incluye la expresión: "My age is @{parameters('myAge')}` |
Al trabajar visualmente en el Diseñador de flujo de trabajo, puede crear expresiones mediante el editor de expresiones, por ejemplo:
Cuando haya terminado, la expresión aparece en la propiedad correspondiente en la definición de flujo de trabajo, por ejemplo, la propiedad searchQuery aquí:
"Search_tweets": {
"inputs": {
"host": {
"connection": {
"name": "@parameters('$connections')['x']['connectionId']"
}
}
},
"method": "get",
"path": "/searchtweets",
"queries": {
"maxResults": 20,
"searchQuery": "Azure @{concat('firstName','', 'LastName')}"
}
},
Outputs
En la sección outputs, defina los datos que puede devolver el flujo de trabajo cuando termine de ejecutarse. Por ejemplo, para realizar el seguimiento de un estado o valor específico de cada ejecución, especifique que la salida del flujo de trabajo devuelva esos datos.
Note
Al responder a las solicitudes entrantes de la API de REST de un servicio, no use outputs. En su lugar, use el tipo de acción Response.
Para más información, consulte Desencadenadores y acciones para flujos de trabajo.
Esta es la estructura general de una definición de salida:
"outputs": {
"<key-name>": {
"type": "<key-type>",
"value": "<key-value>"
}
}
| Attribute | Required | Type | Description |
|---|---|---|---|
| < key-name> | Yes | String | El nombre de clave del valor devuelto de salida. |
| < tipo de clave> | Yes | int, float, string, securestring, bool, array, JSON object | El tipo del valor devuelto de salida. |
| < key-value> | Yes | Igual que <el tipo de clave> | El valor devuelto de salida. |
Para obtener la salida de una ejecución de flujo de trabajo, revise el historial y los detalles de ejecución de la aplicación lógica en Azure Portal o use la API REST de flujo de trabajo. También puede pasar la salida a sistemas externos, por ejemplo, a Power BI, para crear paneles.
Operators
En expresiones y funciones, los operadores realizan tareas específicas, como hacer referencia a una propiedad o un valor en una matriz.
| Operator | Task |
|---|---|
' |
Para usar un literal de cadena como entrada o en expresiones y funciones, encapsule la cadena solo con comillas sencillas, por ejemplo, '<myString>'. No use comillas dobles (""), que entran en conflicto con el formato JSON alrededor de una expresión completa. Por ejemplo: Sí: length('Hello') No: length("Hello") Al pasar matrices o números, no es necesario encapsular los signos de puntuación. Por ejemplo: Sí: length([1, 2, 3]) No: length("[1, 2, 3]") |
[] |
Para hacer referencia a un valor en una posición específica (índice) de una matriz o dentro de un objeto JSON, use corchetes, por ejemplo: - Para obtener el segundo elemento de una matriz: myArray[1] - Para acceder a las propiedades dentro de un objeto JSON: Ejemplo 1: setProperty(<object>, '<parent-property>', addProperty(<object>['<parent-property>'], '<child-property>', <value>) Ejemplo 2: lastIndexOf(triggerBody()?['subject'],'some string') |
. |
Para hacer referencia a una propiedad de un objeto, use el operador punto. Por ejemplo, para obtener la propiedad name de un objeto JSON customer: "parameters('customer').name" |
? |
Para hacer referencia a la propiedad de un objeto sin arriesgarse a un error en tiempo de ejecución o al error del flujo de trabajo, use el operador de signo de interrogación (?), también conocido como operador ignore null, que precede a la propiedad . Este operador le permite acceder de forma segura a una propiedad o un elemento de matriz cuando el objeto primario o la propiedad a la que se hace referencia pueden contener null o faltan. - Si el objeto primario que aparece antes de que el ? operador es null o falta la propiedad a la que se hace referencia, la expresión completa devuelve null, en lugar del flujo de trabajo con errores. - Si el objeto o la propiedad existe, la expresión devuelve el valor de la propiedad. Por ejemplo, supongamos que tiene la expresión siguiente: triggerBody()?['ContentData'] - Si triggerBody() devuelve un objeto de la ContentData propiedad , obtendrá el valor del objeto. - Si triggerBody() falta o null falta la ContentData propiedad, la función devuelve null en lugar de producir un error con el error "No se pueden procesar expresiones de lenguaje de plantilla". El ? operador también le permite encadenar propiedades de acceso de forma segura y resulta útil en los escenarios siguientes: - Administrar expresiones que funcionan con campos JSON opcionales. - Controle las salidas del conector que podrían omitir determinadas propiedades. - Evite expresiones frágiles en la lógica condicional. Por ejemplo, para encadenar el acceso a propiedades y controlar salidas nulas desde un desencadenador, puede usar la siguiente expresión: coalesce(trigger().outputs?.body?['<property-name>'], '<property-default-value>') |
Functions
Algunas expresiones obtienen sus valores de acciones en tiempo de ejecución que es posible que todavía no existan cuando comienza a ejecutarse la definición del flujo de trabajo. Para hacer referencia a estos valores o trabajar con estos valores en expresiones, puede usar funciones que proporciona el lenguaje de definición de flujo de trabajo.