Compartir a través de


Contenido dinámico del flujo de trabajo

Nota:

Catálogo de datos de Microsoft Purview (clásico) y Data Health Insights (clásico) ya no tienen nuevos clientes y estos servicios, anteriormente Azure Purview, ahora están en modo de soporte al cliente.

Importante

Esta característica está actualmente en versión preliminar. Los Términos de uso complementarios para las versiones preliminares de Microsoft Azure incluyen términos legales adicionales que se aplican a las características de Azure que están en versión beta, en versión preliminar o que aún no se han publicado en disponibilidad general.

Puede usar contenido dinámico dentro de flujos de trabajo de Microsoft Purview para asociar determinadas variables en el flujo de trabajo o agregar otras expresiones para procesar estos valores.

Al agregar contenido dinámico a los flujos de trabajo, se crean expresiones a partir de los bloques de creación proporcionados que hacen referencia y procesan información en el flujo de trabajo para que pueda obtener los valores que necesita en tiempo real.

En el menú de contenido dinámico, las opciones disponibles actualmente son:

  • Variables integradas : variables que representan los valores que llegan al flujo de trabajo desde los elementos que lo desencadenaron
  • Expresiones : fórmulas creadas a partir de funciones y variables que pueden procesar valores en el flujo de trabajo.

Variables integradas

Actualmente, las siguientes variables están disponibles para un conector de flujo de trabajo en Microsoft Purview:

Conector de requisitos previos Variable integrada Funcionalidad Tipo Posibles valores
Cuando se envía la solicitud de acceso a datos
Cuando se envía la solicitud de actualización de recursos
Workflow.Requestor Identificador del solicitante del flujo de trabajo string
Asset.Name Nombre del recurso string
Asset.Description Descripción del recurso string o null
Asset.Type Tipo del recurso string
Nombre completo de Asset.Fully Nombre completo del recurso string
Asset.Owner Los identificadores de los propietarios de datos del recurso matriz de cadenass
Asset.Classification Los nombres para mostrar de las clasificaciones del recurso matriz de cadenass
Asset.Schema.Classification Los nombres para mostrar de las clasificaciones aplicadas a una columna en el esquema de recursos matriz de cadenass
certificado Asset.Is Indicador de si el recurso cumple los estándares de calidad de su organización y se puede considerar confiable boolean true o false
Cuando se envía la solicitud de acceso a datos Destinatario workflow.request Identificador del destinatario de la solicitud del flujo de trabajo string
Iniciar y esperar una aprobación Approval.Outcome Resultado de la aprobación string 'Approved' o 'Rejected'
Approval.Assigned a Los identificadores de los aprobadores matriz de cadenass
Approval.Comments Los nombres de los aprobadores y sus comentarios string
Comprobación del registro del origen de datos para la gobernanza del uso de datos Gobernanza del uso de datos El resultado de la comprobación de gobernanza de uso de datos boolean true o false
Cuando se envía la solicitud de creación de términos Workflow.Requestor Identificador del solicitante del flujo de trabajo string
Term.Name Nombre del término string
Nombre term.formal Nombre formal del término string
Term.Definition Definición del término string
Term.Experts Los identificadores de los expertos del término matriz de cadenass
Term.Stewards Los identificadores de los administradores del término matriz de cadenass
Term.Parent.Name Nombre del término primario si existe string
Nombre term.parent.formal El nombre formal del término primario si existe string
Cuando se envía la solicitud de actualización de términos
Cuando se envía la solicitud de eliminación de términos
Workflow.Requestor Solicitante del flujo de trabajo string
Term.Name Nombre del término string
Nombre term.formal Nombre formal del término string
Term.Definition Definición del término string o null
Term.Experts Los identificadores de los expertos del término matriz de cadenass
Term.Stewards Los identificadores de los administradores del término matriz de cadenass
Term.Parent.Name Nombre del término primario si existe string
Nombre term.parent.formal El nombre formal del término primario si existe string
Term.Created By Identificador del creador del término string
Term.Last actualizado por Identificador del último actualizador del término string
Cuando se envía la solicitud de importación de términos Workflow.Requestor Identificador del solicitante del flujo de trabajo string
Importar File.Name Nombre del archivo que se va a importar string
HTTP Http.Body Cuerpo de la respuesta HTTP objeto o cadena
Encabezados Http.Headers Encabezados de respuesta HTTP object
Código Http.Status Código de estado HTTP string
Aplicar a cada Elemento El elemento actual de Aplicar a cada acción Cualquiera
Hasta Índice Índice de iteración actual de la acción Until entero
Creación de un registro
Eliminar registro
Obtener registro
Actualizar registro
Resultado Resultado de la acción de ServiceNow object
Obtención de tipos de registro
Enumerar registros
Resultado Resultado de la acción de ServiceNow matriz de objetoss

Expresiones

Las definiciones de flujo de trabajo de Microsoft Purview permiten usar funciones en las expresiones para procesar valores en los flujos de trabajo.

Para buscar funciones basadas en su propósito general, revise las tablas siguientes. O bien, para obtener información detallada sobre cada función, consulte la lista alfabética.

Al compilar un flujo de trabajo y desea agregar una función a las expresiones, siga estos pasos:

  1. Seleccione el valor que va a editar.
  2. Seleccione el botón Agregar contenido dinámico que aparece debajo del cuadro de texto.
  3. Seleccione la pestaña Expresiones en la ventana de contenido dinámico y desplácese para seleccionar el valor.
  4. Actualice la expresión y seleccione Aceptar para agregarla.

Captura de pantalla que muestra un campo de texto de flujo de trabajo con Usar contenido dinámico resaltado y la pestaña Expresiones mostrada.

Consideraciones

  • Los parámetros de función se evalúan de izquierda a derecha.

  • Las funciones que aparecen en línea con texto sin formato requieren incluir llaves ({}) para usar el formato interpolado de la expresión en su lugar. Este formato ayuda a evitar problemas de análisis. Si la expresión de función no aparece en línea con texto sin formato, no se necesitan llaves.

    En el ejemplo siguiente se muestra la sintaxis correcta e incorrecta:

    Correcto: "<text>/@{<function-name>('<parameter-name>')}/<text>"

    Incorrecto: "<text>/@<function-name>('<parameter-name>')/<text>"

  • Las funciones pueden tener sobrecargas, que son varias versiones de una función con el mismo nombre, pero diferentes formas de realizar una tarea, en función de la entrada que se les proporcione.

En las secciones siguientes se organizan las funciones en función de su propósito general, o puede examinar estas funciones en orden alfabético.

Funciones de cadena

Para trabajar con cadenas, puede usar estas funciones de cadena y también algunas funciones de colección. Las funciones de cadena solo funcionan en cadenas.

Función String Tarea
endsWith Compruebe si una cadena termina con la subcadena especificada.
startsWith Compruebe si una cadena comienza con una subcadena específica.

Funciones de colección

Para trabajar con colecciones, por lo general matrices, cadenas y, a veces, diccionarios, puede usar estas funciones de colección.

Función de colección Tarea
Contiene Compruebe si una colección tiene un elemento específico.
length Devuelve el número de elementos de una colección o la longitud de una cadena.

Funciones de comparación lógica

Para trabajar con condiciones, comparar valores y resultados de expresiones, o evaluar varios tipos de lógica, puede usar estas funciones de comparación lógica. Para obtener la referencia completa sobre cada función, consulte la lista alfabética.

Función de comparación lógica Tarea
no Compruebe si una expresión es false. Devuelve true cuando la expresión es false o devuelve false cuando es true.
y Compruebe si todas las expresiones son verdaderas. Devuelve true cuando todas las expresiones son true o devuelve false cuando al menos una expresión es false.
o Compruebe si al menos una expresión es true. Devuelve true cuando al menos una expresión es true o devuelve false cuando todos son false.
Iguales Compruebe si ambos valores son equivalentes.
mayor Compruebe si el primer valor es mayor que el segundo.
greaterOrEquals Compruebe si el primer valor es mayor o igual que el segundo valor.
menos Compruebe si el primer valor es menor que el segundo.
lessOrEquals Compruebe si el primer valor es menor o igual que el segundo.

Funciones de usuario

Para trabajar con los usuarios, sus relaciones con otros usuarios y grupos, y los recursos a los que acceden, por ejemplo, sus correos, calendarios, archivos, roles administrativos, pertenencias a grupos. Para obtener la referencia completa sobre cada función, consulte la lista alfabética.

Función de usuario Tarea
getUserName Obtenga el nombre del usuario.
getManager Obtenga el identificador del administrador del usuario.
memberOfGroup Compruebe si el usuario es miembro del grupo.

Funciones Conversion

Para cambiar el tipo o formato de un valor, puede usar estas funciones de conversión. Para obtener la referencia completa sobre cada función, consulte la lista alfabética.

Función de conversión Tarea
createArray Devuelve una matriz de cualquier número de entradas.
createObject Devuelve un objeto vacío.
string Devuelve la versión de cadena de un valor.
int Intente convertir el valor de entrada en un número entero.
float Intente convertir el valor de entrada en un número float.
bool Intente convertir el valor de entrada en un valor booleano.
object Intente convertir el valor de entrada en un objeto .
array Intente convertir el valor de entrada en una matriz.
nullOrElse Asigne un valor predeterminado a un valor que acepta valores NULL.

Todas las funciones: lista alfabética

y

Compruebe si todas las expresiones son verdaderas. Devuelve true cuando todas las expresiones son true o devuelve false cuando al menos una expresión es false.

Parámetro Tipo Descripción
value boolean La primera expresión que se va a comprobar
valores... boolean Expresiones rest que se van a comprobar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando todas las expresiones son true. Devuelve false cuando al menos una expresión es false.

Ejemplos

En estos ejemplos se comprueba si las expresiones especificadas son false:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2))

Y devuelve estos resultados:

  • Primer ejemplo: ambas expresiones son true, por lo que devuelve true.
  • Segundo ejemplo: una expresión es false, por lo que devuelve false.
  • Tercer ejemplo: la expresión es false, por lo que devuelve false.

matriz

Esta función intenta convertir el valor de entrada en una matriz. Se usa para convertir el valor de un tipo más amplio a una matriz. Para crear una matriz a partir de elementos, vea createArray.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
array Valor de matriz convertida

Ejemplo

En este ejemplo se afirma que Item de una acción "Aplicar a cada uno" es de tipo de matriz :

array(items('Appy to each'))

bool

Esta función intenta convertir el valor de entrada en un valor booleano. Se usa para convertir el valor de un tipo más amplio a booleano.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
boolean Valor booleano convertido

Ejemplo

En este ejemplo se afirma que Item de una acción "Aplicar a cada uno" es de tipo booleano :

bool(items('Appy to each'))

contains

Compruebe si una colección tiene un elemento específico. Devuelve true cuando se encuentra el elemento o devuelve false cuando no se encuentra.

Sobrecarga 1: cadena para buscar una subcadena

Esta sobrecarga distingue mayúsculas de minúsculas.

Parámetro Tipo Descripción
colección string Cadena que se va a comprobar
valor string Subcadena que se va a buscar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando se encuentra la subcadena. Devuelve false cuando no se encuentra.

Sobrecarga 2: matriz para buscar un valor

Parámetro Tipo Descripción
colección array Colección que se va a comprobar
valor Cualquiera Elemento que se va a buscar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando se encuentra el elemento. Devuelve false cuando no se encuentra.

Ejemplo 1

En este ejemplo se comprueba la cadena "hello world" para la subcadena "world" y se devuelve true:

contains('hello world', 'world')

Ejemplo 2

En este ejemplo se comprueba la variable Asset.Owner para el elemento igual que la variable Workflow.Requestor:

contains(runInput()['asset']['dataOwner'], runInput()['requestor'])

createArray

Devuelve una matriz de cualquier número de entradas. Esta función no requiere que los valores de entrada sean de un mismo tipo.

Parámetro Tipo Descripción
valores... Cualquiera Valores para crear la matriz.
Tipo de valor devuelto Descripción
array Matriz creada a partir de todos los elementos de entrada

Ejemplos

En estos ejemplos se crea una matriz a partir de entradas:

createArray('h', 'e', 'l', 'l', 'o')
createArray(true, null)
createArray()

createObject

Devuelve un objeto vacío.

Tipo de valor devuelto Descripción
object Un objeto vacío

Ejemplo

En este ejemplo se crea una matriz a partir de entradas y se devuelve {}.

createObject()

endsWith

Compruebe si una cadena termina con una subcadena específica. Devuelve true cuando se encuentra la subcadena o devuelve false cuando no se encuentra. Esta función distingue mayúsculas de minúsculas.

Parámetro Tipo Descripción
text string Cadena que se va a comprobar
searchText string Subcadena final que se va a buscar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando se encuentra la subcadena final. Devuelve false cuando no se encuentra.

Ejemplo 1

En este ejemplo se comprueba si la cadena "hello world" termina con la cadena "world":

endsWith('hello world', 'world')

Y devuelve este resultado: true

Ejemplo 2

En este ejemplo se comprueba si la cadena "hello world" termina con la cadena "universe":

endsWith('hello world', 'universe')

Y devuelve este resultado: false

Iguales

Compruebe si ambos valores, expresiones u objetos son equivalentes. Devuelve true cuando ambos son equivalentes o devuelve false cuando no son equivalentes.

Parámetro Tipo Descripción
value Cualquiera Valores, expresiones u objetos que se van a comparar
compareTo Cualquiera Valores de comparación, expresiones u objetos
Tipo de valor devuelto Descripción
boolean Devuelve true cuando ambos son equivalentes. Devuelve false cuando no es equivalente.

Ejemplos

En estos ejemplos se comprueba si las entradas especificadas son equivalentes.

equals(true, 1)
equals('abc', 'abcd')

Y devuelve estos resultados:

  • Primer ejemplo: ambos valores son equivalentes, por lo que la función devuelve true.
  • Segundo ejemplo: ambos valores no son equivalentes, por lo que la función devuelve false.

float

Esta función intenta convertir el valor de entrada en un número float. Se usa para convertir el valor de un tipo más amplio a float.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
float Valor float convertido

Ejemplo

En este ejemplo se afirma que Item de una acción "Aplicar a cada uno" es de tipo float :

float(items('Appy to each'))

getManager

Obtenga el identificador del administrador del usuario en Microsoft Entra ID.

Sobrecarga 1: Obtener para un solo usuario

Parámetro Tipo Description
userId string Identificador del usuario de entrada
Tipo de valor devuelto Descripción
string o null El identificador del administrador del usuario de entrada o null si no existe

Sobrecarga 2: Obtener para varios usuarios

Parámetro Tipo Description
userId array Los identificadores de los usuarios de entrada
Tipo de valor devuelto Descripción
array La unión de identificadores de los administradores de los usuarios de entrada

Ejemplos

En estos ejemplos se obtienen los administradores de los usuarios de entrada:

getManager(runInput()['requestor'])
getManager(runInput()['term']['stewards'])
  • Primer ejemplo: El parámetro de entrada es una cadena, por lo que devuelve el identificador del administrador de Workflow.Requestor.
  • Segundo ejemplo: el parámetro de entrada es una matriz, por lo que devuelve el conjunto de unión de identificadores de los administradores de Term.Stewards.

getUserName

Obtenga el nombre del usuario en Microsoft Entra ID.

Sobrecarga 1: Obtener para un solo usuario

Parámetro Tipo Description
userId string Identificador del usuario de entrada
Tipo de valor devuelto Descripción
string Nombre del usuario de entrada

Sobrecarga 2: Obtener para varios usuarios

Parámetro Tipo Description
userId array Los identificadores de los usuarios de entrada
Tipo de valor devuelto Descripción
array Los nombres de los usuarios de entrada

Ejemplos

En estos ejemplos se obtienen los nombres de los usuarios de entrada:

getUserName(runInput()['requestor'])
getUserName(runInput()['term']['stewards'])
  • Primer ejemplo: El parámetro de entrada es una cadena, por lo que devuelve el nombre de Workflow.Requestor.
  • Segundo ejemplo: el parámetro de entrada es una matriz, por lo que devuelve una matriz de nombres de Term.Stewards.

mayor

Compruebe si el primer valor es mayor que el segundo. Devuelve true cuando el primer valor es más o devuelve false cuando es menor.

Sobrecarga 1: Comparar números

Parámetro Tipo Descripción
value integer o float Primer valor para comprobar si es mayor que el segundo valor
compareTo integer o float Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es mayor que el segundo. Devuelve false cuando el primer valor es igual o menor que el segundo valor.

Sobrecarga 2: Comparar cadenas

Parámetro Tipo Descripción
value string Primer valor para comprobar si es mayor que el segundo valor
compareTo string Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es mayor que el segundo. Devuelve false cuando el primer valor es igual o menor que el segundo valor.

Ejemplos

En estos ejemplos se comprueba si el primer valor es mayor que el segundo:

greater(10, 5)
greater('apple', 'banana')

Y devuelva estos resultados:

  • Primer ejemplo: true
  • Segundo ejemplo: false

greaterOrEquals

Compruebe si el primer valor es mayor o igual que el segundo valor. Devuelve true cuando el primer valor es mayor o igual, o devuelve false cuando el primer valor es menor.

Sobrecarga 1: Comparar números

Parámetro Tipo Descripción
value integer o float Primer valor para comprobar si es mayor o igual que el segundo valor
compareTo integer o float Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es mayor o igual que el segundo valor. Devuelve false cuando el primer valor es menor que el segundo.

Sobrecarga 2: Comparar cadenas

Parámetro Tipo Descripción
value string Primer valor para comprobar si es mayor o igual que el segundo valor
compareTo string Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es mayor o igual que el segundo valor. Devuelve false cuando el primer valor es menor que el segundo.

Ejemplos

En estos ejemplos se comprueba si el primer valor es mayor o igual que el segundo valor:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Y devuelva estos resultados:

  • Primer ejemplo: true
  • Segundo ejemplo: false

Entero

Esta función intenta convertir el valor de entrada en un número entero. Se usa para convertir el valor de un tipo más amplio a entero.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
entero Valor entero convertido

Ejemplo

En este ejemplo se afirma que Item de una acción "Aplicar a cada uno" es de tipo entero :

int(items('Appy to each'))

length

Devuelve el número de elementos de una colección o la longitud de una cadena.

Parámetro Tipo Descripción
value cadena o matriz La cadena o la colección con los elementos que se van a contar
Tipo de valor devuelto Descripción
boolean Número de elementos de la colección o la longitud de la cadena

Ejemplos

En estos ejemplos se cuenta el número de elementos de estas colecciones:

length('abcd')
length(createArray(0, 1, 2, 3))

Y ambos devuelven este resultado: 4

menos

Compruebe si el primer valor es menor que el segundo. Devuelve true cuando el primer valor es menor o devuelve false cuando el primer valor es más.

Sobrecarga 1: Comparar números

Parámetro Tipo Descripción
value integer o float Primer valor para comprobar si es menor que el segundo valor
compareTo integer o float Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es menor que el segundo. Devuelve false cuando el primer valor es igual o mayor que el segundo valor.

Sobrecarga 2: Comparar cadenas

Parámetro Tipo Descripción
value string Primer valor para comprobar si es mayor que el segundo valor
compareTo string Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es menor que el segundo. Devuelve false cuando el primer valor es igual o mayor que el segundo valor.

Ejemplos

En estos ejemplos se comprueba si el primer valor es menor que el segundo.

less(5, 10)
less('banana', 'apple')

Y devuelva estos resultados:

  • Primer ejemplo: true
  • Segundo ejemplo: false

lessOrEquals

Compruebe si el primer valor es menor o igual que el segundo. Devuelve true cuando el primer valor es menor o igual, o devuelve false cuando el primer valor es más.

Sobrecarga 1: Comparar números

Parámetro Tipo Descripción
value integer o float Primer valor para comprobar si es menor o igual que el segundo valor
compareTo integer o float Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es menor o igual que el segundo valor. Devuelve false cuando el primer valor es mayor que el segundo.

Sobrecarga 2: Comparar cadenas

Parámetro Tipo Descripción
value string Primer valor para comprobar si es menor o igual que el segundo valor
compareTo string Valor de comparación
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el primer valor es menor o igual que el segundo valor. Devuelve false cuando el primer valor es mayor que el segundo.

Ejemplos

En estos ejemplos se comprueba si el primer valor es menor o igual que el segundo.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Y devuelva estos resultados:

  • Primer ejemplo: true
  • Segundo ejemplo: false

memberOfGroup

Compruebe si el usuario es miembro del grupo de Microsoft Entra ID. El identificador de grupo se puede encontrar en Microsoft Entra página de administración de grupos.

Parámetro Tipo Description
userId string Identificador del usuario de entrada
groupId string Identificador del grupo que se va a comprobar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando el usuario es miembro del grupo. Devuelve false cuando el usuario no es miembro del grupo o el grupo no existe.

Ejemplo

En este ejemplo se comprueba si Workflow.Requestor es miembro del grupo especificado:

memberOfGroup(runInput()['requestor'], '00000000-0000-0000-0000-111111111111')

not

Compruebe si una expresión es false. Devuelve true cuando la expresión es false o devuelve false cuando es true.

Parámetro Tipo Descripción
value boolean Expresión que se va a comprobar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando la expresión es false. Devuelve false cuando la expresión es true.

Ejemplos

En estos ejemplos se comprueba si las expresiones especificadas son false:

not(equals(1, 2))
not(equals(1, 1))

Y devuelva estos resultados:

  • Primer ejemplo: la expresión es false, por lo que la función devuelve true.
  • Segundo ejemplo: la expresión es true, por lo que la función devuelve false.

nullOrElse

Asigne un valor predeterminado a un valor que acepta valores NULL. Devuelve un valor que no acepta valores NULL.

Sobrecarga 1: versión de cadena

Parámetro Tipo Descripción
value string o null Valor que acepta valores NULL
defaultValue string Valor de reserva
Tipo de valor devuelto Descripción
string Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Sobrecarga 2: versión de entero

Parámetro Tipo Descripción
value integer o null Valor que acepta valores NULL
defaultValue entero Valor de reserva
Tipo de valor devuelto Descripción
entero Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Sobrecarga 3: versión float

Parámetro Tipo Descripción
value float o null Valor que acepta valores NULL
defaultValue float Valor de reserva
Tipo de valor devuelto Descripción
float Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Sobrecarga 4: versión booleana

Parámetro Tipo Descripción
value booleano o null Valor que acepta valores NULL
defaultValue boolean Valor de reserva
Tipo de valor devuelto Descripción
boolean Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Sobrecarga 5: versión de matriz

Parámetro Tipo Descripción
value matriz o null Valor que acepta valores NULL
defaultValue array Valor de reserva
Tipo de valor devuelto Descripción
array Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Sobrecarga 6: versión del objeto

Parámetro Tipo Descripción
value objeto o null Valor que acepta valores NULL
defaultValue object Valor de reserva
Tipo de valor devuelto Descripción
object Devuelve el valor de entrada si no es null. Devuelve el valor predeterminado si el valor de entrada es NULL.

Ejemplo

En este ejemplo se proporciona a la variable Term.Definition que acepta valores NULL un valor 'Empty'predeterminado:

nullOrElse(runInput()['term']['definition'], 'Empty')

objeto

Esta función intenta convertir el valor de entrada en un valor de objeto. Se usa para convertir el valor de un tipo más amplio a un objeto.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
boolean Valor del objeto convertido

Ejemplo

En este ejemplo se afirma que Item de una acción "Aplicar a cada uno" es de tipo de objeto :

object(items('Appy to each'))

Otra posibilidad:

Compruebe si al menos una expresión es true. Devuelve true cuando al menos una expresión es true o devuelve false cuando todos son false.

Parámetro Tipo Descripción
value boolean La primera expresión que se va a comprobar
valores... boolean Expresiones rest que se van a comprobar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando al menos una expresión es true. Devuelve false cuando todas las expresiones son false.

Ejemplos

En estos ejemplos se comprueba si al menos una expresión es true:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
or(equals(1, 2))

Y devuelva estos resultados:

  • Primer ejemplo: al menos una expresión es true, por lo que la función devuelve true.
  • Segundo ejemplo: ambas expresiones son false, por lo que la función devuelve false.
  • Tercer ejemplo: la expresión es false, por lo que la función devuelve false.

startsWith

Compruebe si una cadena comienza con una subcadena específica. Devuelve true cuando se encuentra la subcadena o devuelve false cuando no se encuentra. Esta función distingue mayúsculas de minúsculas.

Parámetro Tipo Descripción
text string Cadena que se va a comprobar
searchText string Subcadena inicial que se va a buscar
Tipo de valor devuelto Descripción
boolean Devuelve true cuando se encuentra la subcadena inicial. Devuelve false cuando no se encuentra.

Ejemplo 1

En este ejemplo se comprueba si la cadena "hello world" comienza con la subcadena "hello":

startsWith('hello world', 'hello')

Y devuelve este resultado: true

Ejemplo 2

En este ejemplo se comprueba si la cadena "hello world" comienza con la subcadena "greetings":

startsWith('hello world', 'greetings')

Y devuelve este resultado: false

string

Esta función devuelve la versión de cadena del valor.

Parámetro Tipo Descripción
value Cualquiera Valor que se va a convertir
Tipo de valor devuelto Descripción
string Versión de cadena para el valor especificado. Si el parámetro value es null, este valor se devuelve como un valor de cadena vacía ("").

Ejemplos

Estos ejemplos convierten el valor de entrada en una cadena:

string('abc')
string(true)
string(createArray())

Y devuelva estos resultados:

  • Primer ejemplo: el valor de entrada es una cadena, por lo que devuelve un valor 'abc'de identidad .
  • Segundo ejemplo: la versión de cadena de los valores booleanos tiene mayúsculas, por lo que la función devuelve 'True'.
  • Tercer ejemplo: las matrices u objetos se convierten en formato JSON, por lo que la función devuelve '[]'.

Pasos siguientes

Para obtener más información sobre los flujos de trabajo, consulte estos artículos: