Referencia para la escritura de expresiones para la asignación de atributos en Azure ADReference for writing expressions for attribute mappings in Azure AD

Al configurar el aprovisionamiento para una aplicación SaaS, uno de los tipos de asignaciones de atributos que puede especificar es una asignación de expresiones.When you configure provisioning to a SaaS application, one of the types of attribute mappings that you can specify is an expression mapping. En estos casos, debe escribir una expresión similar a un script que permita transformar los datos de los usuarios en formatos más aceptables para la aplicación SaaS.For these, you must write a script-like expression that allows you to transform your users' data into formats that are more acceptable for the SaaS application.

Información general sobre la sintaxisSyntax overview

La sintaxis de expresiones para asignaciones de atributos recuerda a las funciones de Visual Basic para Aplicaciones (VBA).The syntax for Expressions for Attribute Mappings is reminiscent of Visual Basic for Applications (VBA) functions.

  • Toda la expresión se tiene que definir en términos de funciones, que constan de un nombre seguido de argumentos entre paréntesis: FunctionName(<<argument 1>>,<<argument N>>)The entire expression must be defined in terms of functions, which consist of a name followed by arguments in parentheses: FunctionName(<<argument 1>>,<<argument N>>)

  • Es posible anidar funciones dentro de otras.You may nest functions within each other. Por ejemplo: FunctionOne(FunctionTwo(<<argument1>>))For example: FunctionOne(FunctionTwo(<<argument1>>))

  • Puede transformar tres tipos diferentes de argumentos en funciones:You can pass three different types of arguments into functions:

    1. Atributos, que deben ir entre corchetes.Attributes, which must be enclosed in square brackets. Por ejemplo: [NombreAtributo]For example: [attributeName]
    2. Constantes de cadena, que deben ir entre comillas.String constants, which must be enclosed in double quotes. Por ejemplo: "Estados Unidos"For example: "United States"
    3. Otras funciones.Other Functions. Por ejemplo: FunctionOne(<<argument1>>, FunctionTwo(<<argument2>>))For example: FunctionOne(<<argument1>>, FunctionTwo(<<argument2>>))
  • Para las constantes de cadena, si necesita una barra diagonal inversa () o comillas dobles (") en la cadena, se deben convertirse con el símbolo de barra diagonal inversa ().For string constants, if you need a backslash ( \ ) or quotation mark ( " ) in the string, it must be escaped with the backslash ( \ ) symbol. Por ejemplo: "Nombre de la empresa: \"Contoso\""For example: "Company name: \"Contoso\""

  • La sintaxis distingue entre mayúsculas y minúsculas, lo que se debe tener en cuenta al escribirlas como cadenas en una función, por oposición a copiarlas y pegarlas directamente desde aquí.The syntax is case-sensitive, which must be considered while typing them as strings in a function vs copy pasting them directly from here.

Lista de funcionesList of Functions

Append      BitAnd      CBool      Coalesce      ConvertToBase64      ConvertToUTF8Hex      Count      CStr      DateFromNum  FormatDateTime      Guid      IIF     InStr      IsNull      IsNullOrEmpty      IsPresent      IsString      Item      Join      Left      Mid         NormalizeDiacritics Not      NumFromDate      RemoveDuplicates      Replace      SelectUniqueValue     SingleAppRoleAssignment     Split    StripSpaces      Switch     ToLower     ToUpper     WordAppend      BitAnd      CBool      Coalesce      ConvertToBase64      ConvertToUTF8Hex      Count      CStr      DateFromNum  FormatDateTime      Guid      IIF     InStr      IsNull      IsNullOrEmpty      IsPresent      IsString      Item      Join      Left      Mid         NormalizeDiacritics Not      NumFromDate      RemoveDuplicates      Replace      SelectUniqueValue     SingleAppRoleAssignment     Split    StripSpaces      Switch     ToLower     ToUpper     Word


AppendAppend

Función: Append(source, suffix)Function: Append(source, suffix)

Descripción: adopta un valor de la cadena de origen y anexa el sufijo al final de la misma.Description: Takes a source string value and appends the suffix to the end of it.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo del objeto de origen.Usually name of the attribute from the source object.
suffixsuffix ObligatorioRequired StringString La cadena que se va a anexar al final del valor de origen.The string that you want to append to the end of the source value.

Anexar sufijos constantes a nombres de usuarioAppend constant suffix to user name

Ejemplo: si está utilizando un espacio aislado de Salesforce, deberá anexar un sufijo adicional a todos los nombres de usuario antes de sincronizarlas.Example: If you are using a Salesforce Sandbox, you might need to append an additional suffix to all your user names before synchronizing them.

Expresión:
Append([userPrincipalName], ".test")
Expression: Append([userPrincipalName], ".test")

Entrada/salida de ejemplo:Sample input/output:

  • ENTRADA: (userPrincipalName): "John.Doe@contoso.com"INPUT: (userPrincipalName): "John.Doe@contoso.com"
  • ENTRADA: "John.Doe@contoso.com.test"OUTPUT: "John.Doe@contoso.com.test"

BitAndBitAnd

Función: BitAnd(value1, value2)Function: BitAnd(value1, value2)

Descripción: : esta función convierte ambos parámetros en la representación binaria y establece un bit en los siguientes valores:Description: This function converts both parameters to the binary representation and sets a bit to:

  • 0: si uno o ambos de los bits correspondientes en value1 y value2 son 0.0 - if one or both of the corresponding bits in value1 and value2 are 0
  • 1: si ambos de los bits correspondientes son 1.1 - if both of the corresponding bits are 1.

En otras palabras, devuelve 0 en todos los casos excepto cuando los bits correspondientes de los dos parámetros son 1.In other words, it returns 0 in all cases except when the corresponding bits of both parameters are 1.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
value1value1 ObligatorioRequired numnum Valor numérico que se debe agregar con AND a value2Numeric value that should be AND'ed with value2
value2value2 ObligatorioRequired numnum Valor numérico que se debe agregar con AND a value1Numeric value that should be AND'ed with value1

Ejemplo: BitAnd(&HF, &HF7)Example: BitAnd(&HF, &HF7)

11110111 AND 00000111 = 00000111 de modo que BitAnd devuelve 7, el valor binario de 00000111.11110111 AND 00000111 = 00000111 so BitAnd returns 7, the binary value of 00000111.


CBoolCBool

Función:
CBool(Expression)
Function: CBool(Expression)

Descripción:
CBool devuelve un valor booleano basado en la expresión evaluada.
Description: CBool returns a boolean based on the evaluated expression. Si la expresión se evalúa en un valor distinto de cero, CBool devuelve True. En caso contrario, devuelve False.If the expression evaluates to a non-zero value, then CBool returns True, else it returns False.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
expressionexpression ObligatorioRequired expresiónexpression Cualquier expresión válidaAny valid expression

Ejemplo: CBool([attribute1] = [attribute2]) Example: CBool([attribute1] = [attribute2])
Devuelve True si ambos atributos tienen el mismo valor.Returns True if both attributes have the same value.


CoalesceCoalesce

Función: Coalesce(source1, source2, ..., defaultValue)Function: Coalesce(source1, source2, ..., defaultValue)

Descripción: Devuelve el primer valor de origen que no es NULL.Description: Returns the first source value that is not NULL. Si todos los argumentos son NULL y defaultValue está presente, se devolverá defaultValue.If all arguments are NULL and defaultValue is present, the defaultValue will be returned. Si todos los argumentos son NULL y defaultValue no está presente, Coalesce devuelve NULL.If all arguments are NULL and defaultValue is not present, Coalesce returns NULL.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
source1 … sourceNsource1 … sourceN ObligatorioRequired StringString Obligatorio, número variable de veces.Required, variable-number of times. Normalmente el nombre del atributo del objeto de origen.Usually name of the attribute from the source object.
defaultValuedefaultValue OpcionalOptional StringString Valor predeterminado que usará cuando todos los valores de origen sean NULL.Default value to be used when all source values are NULL. Puede tratarse de una cadena vacía ("").Can be empty string ("").

Proporciona el valor de correo si no es NULL; de lo contrario, proporciona userPrincipalNameFlow mail value if not NULL, otherwise flow userPrincipalName

Ejemplo: Desea proporcionar el atributo de correo si está presente.Example: You wish to flow the mail attribute if it is present. Si no es así, desea proporcionar el valor de userPrincipalName en su lugar.If it is not, you wish to flow the value of userPrincipalName instead.

Expresión:
Coalesce([mail],[userPrincipalName])
Expression: Coalesce([mail],[userPrincipalName])

Entrada/salida de ejemplo:Sample input/output:

  • ENTRADA (mail): NULLINPUT (mail): NULL
  • ENTRADA: (userPrincipalName): "John.Doe@contoso.com"INPUT (userPrincipalName): "John.Doe@contoso.com"
  • ENTRADA: "John.Doe@contoso.com"OUTPUT: "John.Doe@contoso.com"

ConvertToBase64ConvertToBase64

Función: ConvertToBase64(source)Function: ConvertToBase64(source)

Descripción: La función ConvertToBase64 convierte una cadena en una en base64 de Unicode.Description: The ConvertToBase64 function converts a string to a Unicode base64 string.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Cadena que se va a convertir a base 64.String to be converted to base 64

Ejemplo: ConvertToBase64("Hello world!")Example: ConvertToBase64("Hello world!")

devuelve "SABlAGwAbABvACAAdwBvAHIAbABkACEA".Returns "SABlAGwAbABvACAAdwBvAHIAbABkACEA"


ConvertToUTF8HexConvertToUTF8Hex

Función: ConvertToUTF8Hex(source)Function: ConvertToUTF8Hex(source)

Descripción: : la función ConvertToUTF8Hex convierte una cadena en un valor codificado hexadecimal UTF8.Description: The ConvertToUTF8Hex function converts a string to a UTF8 Hex encoded value.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Cadena que se va a convertir a UTF8 Hex.String to be converted to UTF8 Hex

Ejemplo: ConvertToUTF8Hex("Hello world!")Example: ConvertToUTF8Hex("Hello world!")

devuelve 48656C6C6F20776F726C6421.Returns 48656C6C6F20776F726C6421


CountCount

Función: Count(attribute)Function: Count(attribute)

Descripción: : la función Count devuelve el número de elementos en un atributo multivalor.Description: The Count function returns the number of elements in a multi-valued attribute

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
attributeattribute ObligatorioRequired atributoattribute Atributo con varios valores que tendrá elementos contados.Multi-valued attribute that will have elements counted

CStrCStr

Función: CStr(value)Function: CStr(value)

Descripción: La función CStr convierte un valor en un tipo de datos de cadena.Description: The CStr function converts a value to a string data type.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
valuevalue ObligatorioRequired Numérico, referencia o booleanonumeric, reference, or boolean puede ser un valor numérico, un atributo de referencia o un valor booleano.Can be a numeric value, reference attribute, or Boolean.

Ejemplo: CStr([dn])Example: CStr([dn])

Devuelve "cn=Joe,dc=contoso,dc=com".Returns "cn=Joe,dc=contoso,dc=com"


DateFromNumDateFromNum

Función: DateFromNum(value)Function: DateFromNum(value)

Descripción: la función DateFromNum convierte un valor con formato de fecha de AD en un tipo DateTime.Description: The DateFromNum function converts a value in AD's date format to a DateTime type.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
valuevalue ObligatorioRequired DateDate Fecha de AD que se va a convertir al tipo DateTime.AD Date to be converted to DateTime type

Ejemplo: DateFromNum([lastLogonTimestamp])Example: DateFromNum([lastLogonTimestamp])

DateFromNum(129699324000000000)

Devuelve un valor DateTime que representa el 1 de enero de 2012 a las 23 h.Returns a DateTime representing January 1, 2012 at 11:00PM.


FormatDateTimeFormatDateTime

Función: FormatDateTime(source, dateTimeStyles, inputFormat, outputFormat)Function: FormatDateTime(source, dateTimeStyles, inputFormat, outputFormat)

Descripción: adopta una cadena de fecha en un formato y la convierte a un formato distinto.Description: Takes a date string from one format and converts it into a different format.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo del objeto de origen.Usually name of the attribute from the source object.
dateTimeStylesdateTimeStyles OpcionalOptional StringString Utilice este parámetro para especificar las opciones de formato que personalizan el análisis de cadenas en algunos métodos de análisis de fecha y hora.Use this to specify the formatting options that customize string parsing for some date and time parsing methods. Para conocer los valores admitidos, consulte la documentación de DateTimeStyles. Si se deja vacío, se utiliza el valor predeterminado: DateTimeStyles.RoundtripKind, DateTimeStyles.AllowLeadingWhite, DateTimeStyles.AllowTrailingWhite.For supported values, see DateTimeStyles doc. If left empty, the default value used is DateTimeStyles.RoundtripKind, DateTimeStyles.AllowLeadingWhite, DateTimeStyles.AllowTrailingWhite
inputFormatinputFormat ObligatorioRequired StringString Formato esperado del valor de origen.Expected format of the source value. Para conocer los formatos admitidos, consulte /dotnet/standard/base-types/custom-date-and-time-format-strings.For supported formats, see /dotnet/standard/base-types/custom-date-and-time-format-strings.
outputFormatoutputFormat ObligatorioRequired StringString Formato de la fecha de salida.Format of the output date.

Fecha de resultado como una cadena en un formato determinadoOutput date as a string in a certain format

Ejemplo: desea enviar fechas a una aplicación SaaS como ServiceNow en un formato determinado.Example: You want to send dates to a SaaS application like ServiceNow in a certain format. Puede usar la siguiente expresión.You can consider using the following expression.

Expresión:Expression:

FormatDateTime([extensionAttribute1], , "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (extensionAttribute1): "20150123105347.1Z"INPUT (extensionAttribute1): "20150123105347.1Z"
  • OUTPUT: "2015-01-23"OUTPUT: "2015-01-23"

GuidGuid

Función: Guid()Function: Guid()

Descripción: La función GUID genera un nuevo GUID aleatorio.Description: The function Guid generates a new random GUID


IIFIIF

Función: IIF(condition,valueIfTrue,valueIfFalse)Function: IIF(condition,valueIfTrue,valueIfFalse)

Descripción: : la función IIF devuelve uno de un conjunto de valores posibles según una condición especificada.Description: The IIF function returns one of a set of possible values based on a specified condition.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
conditioncondition ObligatorioRequired Variable o expresiónVariable or Expression Cualquier valor o expresión que pueda evaluarse como true o false.Any value or expression that can be evaluated to true or false.
valueIfTruevalueIfTrue ObligatorioRequired Variable o cadenaVariable or String si la condición se evalúa como true, el valor devuelto.If the condition evaluates to true, the returned value.
valueIfFalsevalueIfFalse ObligatorioRequired Variable o cadenaVariable or String si la condición se evalúa como false, el valor devuelto.If the condition evaluates to false, the returned value.

Ejemplo: IIF([country]="USA",[country],[department])Example: IIF([country]="USA",[country],[department])


InStrInStr

Función: InStr(value1, value2, start, compareType)Function: InStr(value1, value2, start, compareType)

Descripción: : la función InStr busca la primera repetición de una subcadena en una cadena.Description: The InStr function finds the first occurrence of a substring in a string

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
value1value1 ObligatorioRequired StringString Cadena que se va a buscar.String to be searched
value2value2 ObligatorioRequired StringString Cadena que se va a encontrar.String to be found
startstart OpcionalOptional EnteroInteger Posición inicial para buscar la subcadena.Starting position to find the substring
compareTypecompareType OpcionalOptional EnumEnum Puede ser vbTextCompare o vbBinaryCompare.Can be vbTextCompare or vbBinaryCompare

Ejemplo: InStr("The quick brown fox","quick")Example: InStr("The quick brown fox","quick")

Se evalúa en 5Evaluates to 5

InStr("repEated","e",3,vbBinaryCompare)

Se evalúa en 7.Evaluates to 7


IsNullIsNull

Función: IsNull(Expression)Function: IsNull(Expression)

Descripción: si la expresión se evalúa como Null, la función IsNull devuelve True.Description: If the expression evaluates to Null, then the IsNull function returns true. para un atributo, un valor Null se expresa mediante la ausencia del atributo.For an attribute, a Null is expressed by the absence of the attribute.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
expressionexpression ObligatorioRequired expresiónexpression Expresión que se va a evaluar.Expression to be evaluated

Ejemplo: IsNull([displayName])Example: IsNull([displayName])

Devuelve True si el atributo no está presente.Returns True if the attribute is not present.


IsNullOrEmptyIsNullorEmpty

Función: IsNullOrEmpty(Expression)Function: IsNullOrEmpty(Expression)

Descripción: si la expresión es Null o una cadena vacía, la función IsNullOrEmpty devuelve True.Description: If the expression is null or an empty string, then the IsNullOrEmpty function returns true. para un atributo, esto se evaluaría como True si el atributo no está presente o está presente, pero es una cadena vacía.For an attribute, this would evaluate to True if the attribute is absent or is present but is an empty string. La función contraria a esta es IsPresent.The inverse of this function is named IsPresent.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
expressionexpression ObligatorioRequired expresiónexpression Expresión que se va a evaluar.Expression to be evaluated

Ejemplo: IsNullOrEmpty([displayName])Example: IsNullOrEmpty([displayName])

Devuelve True si el atributo no está presente o si es una cadena vacía.Returns True if the attribute is not present or is an empty string.


IsPresentIsPresent

Función: IsPresent(Expression)Function: IsPresent(Expression)

Descripción: si la expresión se evalúa como una cadena que no es Null y no está vacía, la función IsPresent devuelve True.Description: If the expression evaluates to a string that is not Null and is not empty, then the IsPresent function returns true. la función contraria a esta es IsNullOrEmpty.The inverse of this function is named IsNullOrEmpty.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
expressionexpression ObligatorioRequired expresiónexpression Expresión que se va a evaluar.Expression to be evaluated

Ejemplo: Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])Example: Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])


IsStringIsString

Función: IsString(Expression)Function: IsString(Expression)

Descripción: si la expresión se puede evaluar en un tipo de cadena, la función IsString se evalúa en True.Description: If the expression can be evaluated to a string type, then the IsString function evaluates to True.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
expressionexpression ObligatorioRequired expresiónexpression Expresión que se va a evaluar.Expression to be evaluated

ElementoItem

Función: Item(attribute, index)Function: Item(attribute, index)

Descripción: la función Item devuelve un elemento de un atributo o una cadena de varios valores.Description: The Item function returns one item from a multi-valued string/attribute.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
attributeattribute ObligatorioRequired AtributoAttribute Atributo multivalor en el que se va a buscar.Multi-valued attribute to be searched
índiceindex ObligatorioRequired EnteroInteger Índice de un elemento en la cadena multivalor.Index to an item in the multi-valued string

Ejemplo: Item([proxyAddresses], 1) devuelve el segundo elemento en el atributo de varios valores.Example: Item([proxyAddresses], 1) returns the second item in the multi-valued attribute.


JoinJoin

Función: Join(separator, source1, source2, …)Function: Join(separator, source1, source2, …)

Descripción: Join() es similar a Append(), excepto en que puede combinar varios valores de cadena de source en una sola cadena, y cada valor estará separado por una cadena de separator.Description: Join() is similar to Append(), except that it can combine multiple source string values into a single string, and each value will be separated by a separator string.

Si uno de los valores de origen es un atributo multivalor, cada valor de ese atributo se unirá, separado por el valor del separador.If one of the source values is a multi-value attribute, then every value in that attribute will be joined together, separated by the separator value.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
separatorseparator ObligatorioRequired StringString Cadena utilizada para separar los valores de origen cuando se concatenan en una sola cadena.String used to separate source values when they are concatenated into one string. Puede ser "" si no es necesario ningún separador.Can be "" if no separator is required.
source1 … sourceNsource1 … sourceN Obligatorio, número variable de vecesRequired, variable-number of times StringString Valores de cadena que se van a agrupar.String values to be joined together.

LeftLeft

Función: Left(String,NumChars)Function: Left(String,NumChars)

Descripción: la función Left devuelve un número especificado de caracteres desde la izquierda de una cadena.Description: The Left function returns a specified number of characters from the left of a string. Con numChars = 0, se devuelve una cadena vacía.If numChars = 0, return empty string. Con numChars < 0, se devuelve una cadena de entrada.If numChars < 0, return input string. Si la cadena es null, se devuelve una cadena vacía.If string is null, return empty string. Si la cadena contiene menos caracteres que el número especificado en numChars, se devuelve una cadena idéntica a la cadena (es decir, que contiene todos los caracteres en el parámetro 1).If string contains fewer characters than the number specified in numChars, a string identical to string (that is, containing all characters in parameter 1) is returned.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
StringString ObligatorioRequired AtributoAttribute Cadena de la que se van a devolver caracteres.The string to return characters from
NumCharsNumChars ObligatorioRequired EnteroInteger Número que identifica el número de caracteres que se va a devolver desde el principio (la izquierda) de la cadena.A number identifying the number of characters to return from the beginning (left) of string

Ejemplo: Left("John Doe", 3)Example: Left("John Doe", 3)

devuelve “Joh”.Returns "Joh".


MidMid

Función: Mid(source, start, length)Function: Mid(source, start, length)

Descripción: devuelve una subcadena del valor de origen.Description: Returns a substring of the source value. Una subcadena es una cadena que contiene sólo algunos de los caracteres de la cadena de origen.A substring is a string that contains only some of the characters from the source string.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo.Usually name of the attribute.
startstart ObligatorioRequired integerinteger Índice de la cadena de source donde debe empezar la subcadena.Index in the source string where substring should start. El primer carácter de la cadena tendrá el índice de 1, el segundo carácter tendrá el índice de 2, y así sucesivamente.First character in the string will have index of 1, second character will have index 2, and so on.
lengthlength ObligatorioRequired integerinteger Longitud de la subcadena.Length of the substring. Si length acaba fuera de la cadena de source, la función devolverá una subcadena desde el índice de start hasta el final de la cadena de source.If length ends outside the source string, function will return substring from start index till end of source string.

NormalizeDiacriticsNormalizeDiacritics

Función: NormalizeDiacritics(source)Function: NormalizeDiacritics(source)

Descripción: Requiere un argumento de cadena.Description: Requires one string argument. Devuelve la cadena, pero se reemplazan todos los caracteres diacríticos por sus equivalentes no diacríticos.Returns the string, but with any diacritical characters replaced with equivalent non-diacritical characters. Normalmente se usa para convertir nombres y apellidos que contienen caracteres diacríticos (acentos) en valores legales que se pueden emplear en diversos identificadores de usuario como, nombres principales de usuario, nombres de cuenta de SAM y direcciones de correo electrónico.Typically used to convert first names and last names containing diacritical characters (accent marks) into legal values that can be used in various user identifiers such as user principal names, SAM account names, and email addresses.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente un atributo de nombre o de apellido.Usually a first name or last name attribute.

Quitar los signos diacríticos de una cadenaRemove diacritics from a string

Ejemplo: necesita reemplazar caracteres que contienen acentos por otros equivalentes que no los contengan.Example: You need to replace characters containing accent marks with equivalent characters that don't contain accent marks.

Expresión: NormalizeDiacritics([givenName])Expression: NormalizeDiacritics([givenName])

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (givenName): "Zoë"INPUT (givenName): "Zoë"
  • OUTPUT: "Zoe"OUTPUT: "Zoe"

NotNot

Función: Not(source)Function: Not(source)

Descripción: Invierte el valor booleano de source.Description: Flips the boolean value of the source. Si el valor de source es True, devuelve False.If source value is True, returns False. De lo contrario, devuelve True.Otherwise, returns True.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired Cadena booleanaBoolean String Los valores de source esperados son "True" o "False".Expected source values are "True" or "False".

NumFromDateNumFromDate

Función: NumFromDate(value)Function: NumFromDate(value)

Descripción: La función NumFromDate convierte un valor DateTime a un formato de Active Directory necesario para establecer atributos como accountExpires.Description: The NumFromDate function converts a DateTime value to Active Directory format that is required to set attributes like accountExpires. Use esta función para convertir valores DateTime recibidos de aplicaciones de recursos humanos en la nube, como WorkDay y SuccessFactors, a su representación de AD equivalente.Use this function to convert DateTime values received from cloud HR apps like Workday and SuccessFactors to their equivalent AD representation.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
valuevalue ObligatorioRequired StringString Cadena de fecha y hora en el formato admitido.Date time string in the supported format. Para conocer los formatos admitidos, consulte https://msdn.microsoft.com/library/8kb3ddd4%28v=vs.110%29.aspx.For supported formats, see https://msdn.microsoft.com/library/8kb3ddd4%28v=vs.110%29.aspx.

Ejemplo:Example:

  • Ejemplo de Workday. Suponiendo que desee asignar el atributo ContractEndDate desde WorkDay, que tiene el formato 2020-12-31-08:00 al campo accountExpires en AD, aquí se muestra cómo puede usar esta función y cambiar el desplazamiento de zona horaria para que coincida con la configuración regional.Workday example Assuming you want to map the attribute ContractEndDate from Workday which is in the format 2020-12-31-08:00 to accountExpires field in AD, here is how you can use this function and change the timezone offset to match your locale. NumFromDate(Join("", FormatDateTime([ContractEndDate], ,"yyyy-MM-ddzzz", "yyyy-MM-dd"), "T23:59:59-08:00"))

  • Ejemplo de SuccessFactors Suponiendo que desea asignar el atributo endDate de SuccessFactors, que tiene el formato M/d/yyyy hh:mm:ss tt para el campo accountExpires en AD, aquí se muestra cómo puede usar esta función y cambiar el ajuste de zona horaria para que coincida con la configuración regional.SuccessFactors example Assuming you want to map the attribute endDate from SuccessFactors which is in the format M/d/yyyy hh:mm:ss tt to accountExpires field in AD, here is how you can use this function and change the time zone offset to match your locale. NumFromDate(Join("",FormatDateTime([endDate], ,"M/d/yyyy hh:mm:ss tt","yyyy-MM-dd"),"T23:59:59-08:00"))


RemoveDuplicatesRemoveDuplicates

Función: RemoveDuplicates(attribute)Function: RemoveDuplicates(attribute)

Descripción: la función RemoveDuplicates toma una cadena multivalor y garantiza que cada valor es único.Description: The RemoveDuplicates function takes a multi-valued string and make sure each value is unique.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
attributeattribute ObligatorioRequired Atributo multivalorMulti-valued Attribute Atributo multivalor en el que se habrán quitado los duplicados.Multi-valued attribute that will have duplicates removed

Ejemplo: RemoveDuplicates([proxyAddresses]) devuelve un atributo proxyAddress saneado donde se han quitado todos los valores duplicados.Example: RemoveDuplicates([proxyAddresses]) Returns a sanitized proxyAddress attribute where all duplicate values have been removed.


ReplaceReplace

Función: Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)Function: Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)

Descripción: Reemplaza los valores de una cadena de manera que distinga entre mayúsculas y minúsculas.Description: Replaces values within a string in a case-sensitive manner. La función se comporta de forma diferente según los parámetros proporcionados:The function behaves differently depending on the parameters provided:

  • Cuando se proporcionan oldValue y replacementValue:When oldValue and replacementValue are provided:

    • Reemplaza todas las ocurrencias de oldValue en el origen por replacementValueReplaces all occurrences of oldValue in the source with replacementValue
  • Cuando se proporcionan oldValue y template:When oldValue and template are provided:

    • Reemplaza todas las ocurrencias de oldValue en template por el valor de sourceReplaces all occurrences of the oldValue in the template with the source value
  • Cuando se proporcionan regexPattern y replacementValue:When regexPattern and replacementValue are provided:

    • La función aplica regexPattern a la cadena de source, y usted puede usar los nombres de grupo regex para construir la cadena para replacementValueThe function applies the regexPattern to the source string and you can use the regex group names to construct the string for replacementValue
  • Cuando se proporcionan regexPattern, regexGroupName y replacementValue:When regexPattern, regexGroupName, replacementValue are provided:

    • La función aplica regexPattern a la cadena de source y reemplaza todos los valores que coinciden con regexGroupName por replacementValueThe function applies the regexPattern to the source string and replaces all values matching regexGroupName with replacementValue
  • Cuando se proporcionan regexPattern, regexGroupName y replacementAttributeName:When regexPattern, regexGroupName, replacementAttributeName are provided:

    • Si source no tiene un valor, se devuelve source.If source has no value, source is returned
    • Si source tiene un valor, la función aplica regexPattern a la cadena de source y reemplaza todos los valores coincidentes de regexGroupName por el valor asociado con replacementAttributeNameIf source has a value, the function applies the regexPattern to the source string and replaces all values matching regexGroupName with the value associated with replacementAttributeName

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo del objeto source.Usually name of the attribute from the source object.
oldValueoldValue OpcionalOptional StringString Valor que se va a reemplazar en source o template.Value to be replaced in source or template.
regexPatternregexPattern OpcionalOptional StringString Patrón Regex del valor que se va a reemplazar en source.Regex pattern for the value to be replaced in source. O bien, cuando se usa replacementPropertyName, patrón para extraer el valor de la propiedad replacementPropertyName.Or, when replacementPropertyName is used, pattern to extract value from replacementPropertyName.
regexGroupNameregexGroupName OpcionalOptional StringString Nombre del grupo dentro de regexPattern.Name of the group inside regexPattern. Solo cuando se usa replacementPropertyName, extraeremos el valor de este grupo como replacementValue de replacementPropertyName.Only when replacementPropertyName is used, we will extract value of this group as replacementValue from replacementPropertyName.
replacementValuereplacementValue OpcionalOptional StringString Nuevo valor para reemplazar uno anterior.New value to replace old one with.
replacementAttributeNamereplacementAttributeName OpcionalOptional StringString Nombre del atributo que se usará para el valor de reemplazoName of the attribute to be used for replacement value
templatetemplate OpcionalOptional StringString Cuando se proporcione el valor de template, buscaremos oldValue dentro de la plantilla y lo reemplazaremos por el valor de source.When template value is provided, we will look for oldValue inside the template and replace it with source value.

Reemplazar los caracteres con una expresión regularReplace characters using a regular expression

Ejemplo: debe buscar los caracteres que coincidan con un valor de expresión regular y quitarlos.Example: You need to find characters that match a regular expression value and remove them.

Expresión:Expression:

Replace([mailNickname], , "[a-zA-Z_]*", , "", , )Replace([mailNickname], , "[a-zA-Z_]*", , "", , )

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (mailNickname: "john_doe72"INPUT (mailNickname: "john_doe72"
  • OUTPUT: "72"OUTPUT: "72"

SelectUniqueValueSelectUniqueValue

Función: SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, …)Function: SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, …)

Descripción: Requiere dos argumentos como mínimo, que son las reglas de generación de valor único definidas con expresiones.Description: Requires a minimum of two arguments, which are unique value generation rules defined using expressions. La función evalúa cada regla y, a continuación, comprueba la unicidad del valor generado en el directorio o la aplicación de destino.The function evaluates each rule and then checks the value generated for uniqueness in the target app/directory. Se devolverá el primer valor único encontrado.The first unique value found will be the one returned. Si todos los valores ya existen en el destino, la entrada se depositará y el motivo se anota en los registros de auditoría.If all of the values already exist in the target, the entry will get escrowed and the reason gets logged in the audit logs. No hay ningún límite superior para el número de argumentos que se pueden proporcionar.There is no upper bound to the number of arguments that can be provided.

  • Esta es una función de nivel superior, no se puede anidar.This is a top-level function, it cannot be nested.
  • Esta función no se puede aplicar a los atributos que tienen una precedencia de coincidencia.This function cannot be applied to attributes that have a matching precedence.
  • Esta función solo está destinada a usarse para creaciones de entradas.This function is only meant to be used for entry creations. Al usarla con un atributo, establezca la propiedad Apply Mapping (Aplicar asignación) en Solo durante la creación del objeto.When using it with an attribute, set the Apply Mapping property to Only during object creation.
  • Actualmente, esta función solo se admite en el aprovisionamiento de usuarios de Workday en Active Directory y en el de SuccessFactors en Active Directory.This function is currently only supported for "Workday to Active Directory User Provisioning" and "SuccessFactors to Active Directory User Provisioning". No se puede usar con otras aplicaciones de aprovisionamiento.It cannot be used with other provisioning applications.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
uniqueValueRule1 … uniqueValueRuleNuniqueValueRule1 … uniqueValueRuleN Al menos se requieren dos, sin límite superiorAt least 2 are required, no upper bound StringString Lista de reglas de generación de valor único para realizar la evaluación.List of unique value generation rules to evaluate.

Generación de un valor único para el atributo userPrincipalName (UPN)Generate unique value for userPrincipalName (UPN) attribute

Ejemplo: según el nombre del usuario, el segundo nombre y los apellidos, deberá generar un valor para el atributo UPN y comprobar si es único en el directorio de AD de destino antes de asignarlo al atributo UPN.Example: Based on the user's first name, middle name and last name, you need to generate a value for the UPN attribute and check for its uniqueness in the target AD directory before assigning the value to the UPN attribute.

Expresión:Expression:

    SelectUniqueValue( 
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  [PreferredFirstName], [PreferredLastName]))), "contoso.com"), 
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  Mid([PreferredFirstName], 1, 1), [PreferredLastName]))), "contoso.com"),
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  Mid([PreferredFirstName], 1, 2), [PreferredLastName]))), "contoso.com")
    )

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (PreferredFirstName): "John"INPUT (PreferredFirstName): "John"
  • INPUT (PreferredLastName): "Smith"INPUT (PreferredLastName): "Smith"
  • OUTPUT: "John.Smith@contoso.com" si el valor de UPN John.Smith@contoso.com no existe aún en el directorioOUTPUT: "John.Smith@contoso.com" if UPN value of John.Smith@contoso.com doesn't already exist in the directory
  • OUTPUT: "J.Smith@contoso.com" si el valor de UPN John.Smith@contoso.com ya existe en el directorioOUTPUT: "J.Smith@contoso.com" if UPN value of John.Smith@contoso.com already exists in the directory
  • OUTPUT: "Jo.Smith@contoso.com" si los dos valores de UPN anteriores ya existen en el directorioOUTPUT: "Jo.Smith@contoso.com" if the above two UPN values already exist in the directory

SingleAppRoleAssignmentSingleAppRoleAssignment

Función: SingleAppRoleAssignment([appRoleAssignments])Function: SingleAppRoleAssignment([appRoleAssignments])

Descripción: Devuelve una única función appRoleAssignment de la lista de todas las funciones appRoleAssignments asignadas a un usuario para una aplicación determinada.Description: Returns a single appRoleAssignment from the list of all appRoleAssignments assigned to a user for a given application. Esta función es necesaria para convertir el objeto appRoleAssignments en una cadena de nombre de rol único.This function is required to convert the appRoleAssignments object into a single role name string. Tenga en cuenta que el procedimiento recomendado consiste en asegurarse de que solo una función appRoleAssignment esté asignada a un usuario a la vez. Si se asignan varios roles, la cadena del rol devuelta podría no ser predecible.Note that the best practice is to ensure only one appRoleAssignment is assigned to one user at a time, and if multiple roles are assigned the role string returned may not be predictable.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
[appRoleAssignments][appRoleAssignments] ObligatorioRequired StringString Objeto [appRoleAssignments] .[appRoleAssignments] object.

DividirSplit

Función: Split(source, delimiter)Function: Split(source, delimiter)

Descripción: divide una cadena en una matriz de varios valores, usando el carácter delimitador especificado.Description: Splits a string into a multi-valued array, using the specified delimiter character.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString de origen que se actualiza.source value to update.
delimitadordelimiter ObligatorioRequired StringString Especifica el carácter que se usará para dividir la cadena (ejemplo: ",").Specifies the character that will be used to split the string (example: ",")

Dividir una cadena en una matriz con varios valoresSplit a string into a multi-valued array

Ejemplo: debe tomar una lista de cadenas delimitadas con comas y dividir esas cadenas en una matriz que se pueda incluir en un atributo de varios valores, como el atributo PermissionSets de Salesforce.Example: You need to take a comma-delimited list of strings, and split them into an array that can be plugged into a multi-value attribute like Salesforce's PermissionSets attribute. En este ejemplo, una lista de conjuntos de permisos se ha rellenado en extensionAttribute5 en Azure AD.In this example, a list of permission sets has been populated in extensionAttribute5 in Azure AD.

Expresión: Split([extensionAttribute5], ",")Expression: Split([extensionAttribute5], ",")

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (extensionAttribute5):INPUT (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
  • OUTPUT: ["PermissionSetOne", "PermissionSetTwo"]OUTPUT: ["PermissionSetOne", "PermissionSetTwo"]

StripSpacesStripSpaces

Función: StripSpaces(source)Function: StripSpaces(source)

Descripción: quita todos los caracteres de espacio (" ") de la cadena de origen.Description: Removes all space (" ") characters from the source string.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString de origen que se actualiza.source value to update.

SwitchSwitch

Función: Switch(source, defaultValue, key1, value1, key2, value2, …)Function: Switch(source, defaultValue, key1, value1, key2, value2, …)

Descripción: Cuando el valor de source coincide con una key, devuelve el value de dicha key.Description: When source value matches a key, returns value for that key. Si el valor de source no coincide con ninguna clave, devuelve defaultValue.If source value doesn't match any keys, returns defaultValue. Los parámetros key y value siempre deben estar emparejados.Key and value parameters must always come in pairs. La función espera siempre un número par de parámetros.The function always expects an even number of parameters. La función no se debe usar para atributos referenciales, como manager.The function should not be used for referential attributes such as manager.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Source que se actualiza.Source value to update.
defaultValuedefaultValue OpcionalOptional StringString Valor predeterminado que se usará si el origen no coincide con ninguna clave.Default value to be used when source doesn't match any keys. Puede tratarse de una cadena vacía ("").Can be empty string ("").
keykey ObligatorioRequired StringString Key con que se compara el valor de source.Key to compare source value with.
valuevalue ObligatorioRequired StringString Valor de reemplazo para el source que coincide con la clave.Replacement value for the source matching the key.

Reemplazar un valor basado en un conjunto predefinido de opcionesReplace a value based on predefined set of options

Ejemplo: debe definir la zona horaria del usuario según el código de estado almacenado en Azure AD.Example: You need to define the time zone of the user based on the state code stored in Azure AD. Si el código de estado no coincide con ninguna de las opciones predefinidas, use el valor predeterminado de "Australia/Sídney".If the state code doesn't match any of the predefined options, use default value of "Australia/Sydney".

Expresión:
Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")
Expression: Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (state): "QLD"INPUT (state): "QLD"
  • OUTPUT: "Australia/Brisbane"OUTPUT: "Australia/Brisbane"

ToLowerToLower

Función: ToLower (origen, referencia cultural)Function: ToLower(source, culture)

Descripción: Toma un valor de cadena de origen y se convierte a minúsculas mediante las reglas de referencia cultural que se hayan especificado.Description: Takes a source string value and converts it to lower case using the culture rules that are specified. Si no hay ninguna información de referencia cultural especificada, se usará la referencia cultural invariable.If there is no culture info specified, then it will use Invariant culture.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo del objeto de origenUsually name of the attribute from the source object
referencia culturalculture OpcionalOptional StringString El formato para el nombre de la referencia cultural según RFC 4646 es languagecode2-country/regioncode2, donde languagecode2 es el código de idioma de dos letras y country/regioncode2 es el código de referencia de subcultura de dos letras.The format for the culture name based on RFC 4646 is languagecode2-country/regioncode2, where languagecode2 is the two-letter language code and country/regioncode2 is the two-letter subculture code. Algunos ejemplos son a ja-JP para japonés (Japón) y en-US para inglés (Estados Unidos).Examples include ja-JP for Japanese (Japan) and en-US for English (United States). En casos donde un código de idioma de dos letras no está disponible, se usa un código de tres letras derivado de ISO 639-2.In cases where a two-letter language code is not available, a three-letter code derived from ISO 639-2 is used.

Conversión del valor generado de userPrincipalName (UPN) a minúsculasConvert generated userPrincipalName (UPN) value to lower case

Ejemplo: desea generar el valor de UPN concatenando los campos de origen PreferredFirstName y PreferredLastName, y convirtiendo todos los caracteres a minúsculas.Example: You would like to generate the UPN value by concatenating the PreferredFirstName and PreferredLastName source fields and converting all characters to lower case.

ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (PreferredFirstName): "John"INPUT (PreferredFirstName): "John"
  • INPUT (PreferredLastName): "Smith"INPUT (PreferredLastName): "Smith"
  • OUTPUT: "john.smith@contoso.com"OUTPUT: "john.smith@contoso.com"

ToUpperToUpper

Función: ToUpper (origen, referencia cultural)Function: ToUpper(source, culture)

Descripción: Toma un valor de cadena de origen y se convierte a mayúsculas mediante las reglas de referencia cultural que se hayan especificado.Description: Takes a source string value and converts it to upper case using the culture rules that are specified. Si no hay ninguna información de referencia cultural especificada, se usará la referencia cultural invariable.If there is no culture info specified, then it will use Invariant culture.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
de origensource ObligatorioRequired StringString Normalmente el nombre del atributo del objeto de origen.Usually name of the attribute from the source object.
referencia culturalculture OpcionalOptional StringString El formato para el nombre de la referencia cultural según RFC 4646 es languagecode2-country/regioncode2, donde languagecode2 es el código de idioma de dos letras y country/regioncode2 es el código de referencia de subcultura de dos letras.The format for the culture name based on RFC 4646 is languagecode2-country/regioncode2, where languagecode2 is the two-letter language code and country/regioncode2 is the two-letter subculture code. Algunos ejemplos son a ja-JP para japonés (Japón) y en-US para inglés (Estados Unidos).Examples include ja-JP for Japanese (Japan) and en-US for English (United States). En casos donde un código de idioma de dos letras no está disponible, se usa un código de tres letras derivado de ISO 639-2.In cases where a two-letter language code is not available, a three-letter code derived from ISO 639-2 is used.

WordWord

Función: Word(String,WordNumber,Delimiters)Function: Word(String,WordNumber,Delimiters)

Descripción: : la función Word devuelve una palabra incluida en una cadena, según los parámetros que describen los delimitadores que se usarán y el número de palabras que se devolverán.Description: The Word function returns a word contained within a string, based on parameters describing the delimiters to use and the word number to return. : cada cadena de caracteres en la cadena separada por uno de los caracteres en los delimitadores se identifica como palabras:Each string of characters in string separated by the one of the characters in delimiters are identified as words:

Si el número es < 1, se devuelve una cadena vacía.If number < 1, returns empty string. Si la cadena es Null, se devuelve una cadena vacía.If string is null, returns empty string. Si la cadena contiene menos palabras o si la cadena no contiene palabras identificadas por los delimitadores, se devuelve una cadena vacía.If string contains less than number words, or string does not contain any words identified by delimiters, an empty string is returned.

Parámetros:Parameters:

NombreName Obligatorio/RepeticiónRequired/ Repeating TipoType NotasNotes
StringString ObligatorioRequired Atributo multivalorMulti-valued Attribute Cadena de la que se va a devolver una palabra.String to return a word from.
WordNumberWordNumber ObligatorioRequired EnteroInteger Número que identifica qué número de palabras debe devolver.Number identifying which word number should return
delimitersdelimiters ObligatorioRequired StringString Cadena que representa los delimitadores que deben usarse para identificar palabras.A string representing the delimiter(s) that should be used to identify words

Ejemplo: Word("The quick brown fox",3," ")Example: Word("The quick brown fox",3," ")

Devuelve "brown".Returns "brown".

Word("This,string!has&many separators",3,",!&#")

Devuelve "has".Returns "has".


EjemplosExamples

En esta sección se proporcionan más ejemplos de uso de las funciones de expresión.This section provides more expression function usage examples.

Seccionar un nombre de dominio conocidoStrip known domain name

Debe seccionar un nombre de dominio conocido del correo electrónico de un usuario para obtener el nombre de usuario.You need to strip a known domain name from a user's email to obtain a user name. Por ejemplo, si el dominio es "contoso.com", puede usar la expresión siguiente:For example, if the domain is "contoso.com", then you could use the following expression:

Expresión:
Replace([mail], "@contoso.com", , ,"", ,)
Expression: Replace([mail], "@contoso.com", , ,"", ,)

Ejemplo de entrada y salida:Sample input / output:

  • ENTRADA (mail): "john.doe@contoso.com"INPUT (mail): "john.doe@contoso.com"
  • SALIDA: "john.doe"OUTPUT: "john.doe"

Generar el alias de usuario concatenando partes de nombre y apellidosGenerate user alias by concatenating parts of first and last name

Debe generar un alias de usuario con las tres primeras letras del nombre del usuario y las cinco primeras letras del apellido del usuario.You need to generate a user alias by taking first 3 letters of user's first name and first 5 letters of user's last name.

Expresión:
Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))
Expression: Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))

Entrada/salida de ejemplo:Sample input/output:

  • INPUT (givenName): "John"INPUT (givenName): "John"
  • INPUT (surname): "Doe"INPUT (surname): "Doe"
  • OUTPUT: "JohnDoe"OUTPUT: "JohDoe"