Referencia de Azure Active Directory Sync Functions
Actualizado: 22 de julio de 2015
Importante
Este tema se archivará pronto.
Hay un nuevo producto denominado "Azure Active Directory Connect" que reemplaza AADSync y DirSync.
Azure AD Connect incorpora los componentes y la funcionalidad publicados anteriormente como Dirsync y AAD Sync.
En algún momento del futuro, finalizará la compatibilidad con Dirsync y AAD Sync.
Estas herramientas ya no se actualizan individualmente con mejoras de características y todas las mejoras futuras se incluirán en las actualizaciones de Azure AD Connect.
En Azure Active Directory Sync, las funciones se usan para manipular un valor de atributo durante la sincronización.
La sintaxis de las funciones se expresa con el formato siguiente:
<tipo de salida> FunctionName(<tipo de entrada><nombre de posición>, ..)
Si una función está sobrecargada y acepta varias sintaxis, se muestran todas las sintaxis válidas.
Las funciones están fuertemente tipadas y comprueban que el tipo pasado coincide con el tipo documentado. Se producirá un error si el tipo no coincide.
Los tipos se expresan con la sintaxis siguiente:
bin : binario
bool: booleano
dt: fecha y hora UTC
enumeración: enumeración de constantes conocidas
exp: expresión, que se espera que se evalúe como un valor booleano.
mvbin: binario con varios valores
mvstr: referencia con varios valores
numérico: numérico
ref: referencia de valores únicos
str: cadena con valor único
var: una variante de (casi) cualquier otro tipo
void: no devuelve un valor
Lista de funciones
En esta sección se proporcionan descripciones de las siguientes funciones:
BitAnd
BitOr
CBool
CDate
CGuid
Contiene
ConvertFromBase64
ConvertFromUTF8Hex
ConvertToBase64
ConvertToUTF8Hex
Contar
CNum
CRef
CStr
DateAdd
DateFromNum
DNComponent
DNComponentRev
Error
EscapeDNComponent
FormatDateTime
GUID
IIF
Instr
InStrRev
IsBitSet
IsDate
IsEmpty
IsGuid
IsNull
IsNullOrEmpty
IsNumeric
IsString
IsPresent
Artículo
ItemOrNull
Juntar
LCase
Izquierda
Len
LTrim
Medio
Ahora
NumFromDate
PadLeft
PadRight
PCase
RandomNum
RemoveDuplicates
Reemplazar
ReplaceChars
Derecha
RTrim
Partir
StringFromGuid
StringFromSid
Interruptor
Recortar
UCase
Palabra
BitAnd
descripción |
La función BitAnd establece los bits especificados en un valor. |
de sintaxis de |
num BitAnd(num value1, num value2) value1, value2: valores numéricos que deben estar juntos |
comentarios |
Esta función convierte ambos parámetros en la representación binaria y establece un bit en 0 si uno o ambos de los bits correspondientes en mask y flag son 0 y en 1 si ambos de los bits correspondientes son 1. En otras palabras, devuelve 0 en todos los casos, excepto cuando los bits correspondientes de ambos parámetros son 1. |
de ejemplo de |
BitAnd(&HF, &HF7) Se evalúa como 7, ya que hexadecimal "F" AND "F7" se evalúa como este valor. |
BitOr
descripción |
La función BitOr establece los bits especificados en un valor. |
de sintaxis de |
num BitOr(num value1, num value2) value1, value2: valores numéricos que deben estar juntos or'ed |
comentarios |
Esta función convierte ambos parámetros en representación binaria y establece un bit en 1 si uno o ambos de los bits correspondientes en mask y flag son 1 y en 0 si ambos bits correspondientes son 0. En otras palabras, devuelve 1 en todos los casos, excepto cuando los bits correspondientes de ambos parámetros son 0. |
de ejemplo de |
CBool
descripción |
La función CBool devuelve un valor booleano basado en la expresión evaluada. |
de sintaxis de |
bool CBool(exp Expression) |
comentarios |
Si la expresión se evalúa como un valor distinto de cero, CBool devuelve True. De lo contrario, devuelve False. |
de ejemplo de |
CBool([attrib1] = [attrib2]) Devuelve True si ambos atributos tienen el mismo valor. |
CDate
descripción |
La función CDate devuelve una fecha y hora UTC de una cadena. DateTime no es un tipo de atributo nativo en Sync, pero se usa en algunas funciones. |
de sintaxis de |
dt CDate(str value) Valor: una cadena con una fecha, hora y, opcionalmente, zona horaria |
comentarios |
La cadena devuelta siempre está en UTC. |
Ejemplo |
CDate([employeeStartTime]) Devuelve un valor DateTime basado en la hora de inicio del empleado. CDate("2013-01-10 4:00 PM -8") Devuelve un valor DateTime que representa "2013-01-11 12:00 AM" |
CGuid
descripción |
La función CGuid convierte la representación de cadena de un Guid en una representación binaria del Guid. |
de sintaxis de |
bin CGuid(str GUID)GUID: una cadena con formato en este patrón: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx o {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx} |
comentarios |
|
de ejemplo de |
Contiene
descripción |
La función Contains busca una cadena dentro de un atributo con varios valores. |
de sintaxis de |
num Contains (atributo mvstring, str search) // distingue mayúsculas de minúsculas num Contains (atributo mvstring, str search, enum Casetype) num Contains (atributo mvref, str search) // case sensitive attribute: atributo multivalor que se va a buscar. Search: cadena que se va a buscar en el atributo . Casetype: CaseInsensitive o CaseSensitive Devuelve el índice en el atributo multivalor donde se encontró la cadena. 0 se devuelve si no se encuentra la cadena. |
comentarios |
En el caso de los atributos de cadena con varios valores, la búsqueda encontrará subcadenas en los valores. Para los atributos de referencia, la cadena buscada debe coincidir exactamente con el valor que se debe considerar una coincidencia. |
de ejemplo de |
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No se encontró ninguna dirección SMTP principal.")) Si el atributo proxyAddresses tiene una dirección de correo electrónico principal (indicada por "SMTP:") en mayúsculas, devuelva el atributo proxyAddress; de lo contrario, devuelva un error. |
ConvertFromBase64
descripción |
La función ConvertFromBase64 convierte el valor codificado en base64 especificado en una cadena normal. |
de sintaxis de |
str ConvertFromBase64(str source) // asume Unicode para la codificación str ConvertFromBase64(str source, enum Encoding) Origen: cadena codificada en Base64 Codificación: Unicode, ASCII, UTF8 |
comentarios |
|
de ejemplo de |
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA") ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8) Ambos devuelven "Hola mundo!" |
ConvertFromUTF8Hex
descripción |
La función ConvertFromUTF8Hex convierte el valor codificado UTF8 Hexadecimal especificado en una cadena. |
de sintaxis de |
str ConvertFromUTF8Hex(str source) source: sting codificado en 2 bytes UTF8 |
comentarios |
Esta función es diferente de ConvertFromBase64([],UTF8) en que el resultado es descriptivo para el atributo DN. Azure Active Directory usa este formato como DN. |
de ejemplo de |
ConvertFromUTF8Hex("48656C6C6F20776F726C6421") Devuelve "Hola mundo!" |
ConvertToBase64
descripción |
La función ConvertToBase64 convierte una cadena en una cadena Base64 unicode. Convierte el valor de una matriz de enteros en su representación de cadena equivalente codificada con dígitos base-64. |
de sintaxis de |
str ConvertToBase64(str source) |
Observaciones |
|
de ejemplo de |
ConvertToBase64("Hello world!") Devuelve "SABlAGwAbABvACAAdwBvAHIAbABkACEA" |
ConvertToUTF8Hex
descripción |
La función ConvertToUTF8Hex convierte una cadena en un valor codificado hexadecimal UTF8. |
de sintaxis de |
str ConvertToUTF8Hex(str source) |
comentarios |
Azure Active Directory usa el formato de salida de esta función como formato de atributo DN. |
de ejemplo de |
ConvertToUTF8Hex("Hello world!") Devuelve 48656C6C6F20776F726C6421 |
Contar
descripción |
La función Count devuelve el número de elementos de un atributo con varios valores. |
de sintaxis de |
num Count(atributo mvstr) |
comentarios |
|
de ejemplo de |
CNum
descripción |
La función CNum toma una cadena y devuelve un tipo de datos numérico. |
de sintaxis de |
num CNum(str value) |
comentarios |
|
de ejemplo de |
CRef
descripción |
Convierte una cadena en un atributo de referencia. |
de sintaxis de |
ref CRef(str value) |
comentarios |
|
de ejemplo de |
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01, CN=Pools,CN=RTC Service", & %Forest. LDAP%) |
CStr
descripción |
La función CStr se convierte en un tipo de datos de cadena. |
de sintaxis de |
str CStr(valor numérico) str CStr(ref value) str CStr(bool value) Valor: puede ser un valor numérico, un atributo de referencia o un valor booleano. |
comentarios |
|
de ejemplo de |
CStr([dn]) Podría devolver "cn=Joe,dc=contoso,dc=com" |
DateAdd
descripción |
Devuelve una fecha que contiene una fecha a la que se ha agregado un intervalo de tiempo especificado. |
de sintaxis de |
dt DateAdd(str interval, num value, dt date) Intervalo: expresión de cadena que es el intervalo de tiempo que desea agregar. La cadena debe tener uno de los siguientes valores: Año aaaa q Quarter mMonth yDay of year dDay wWeekday wwWeek hHour nMinute sSecond Valor: número de unidades que desea agregar. Puede ser positivo (para obtener fechas en el futuro) o negativas (para obtener fechas en el pasado). Fecha: DateTime que representa la fecha a la que se agrega el intervalo. |
comentarios |
|
de ejemplo de |
DateAdd("m", 3, CDate("2001-01-01")), Agrega 3 meses y devuelve un valor DateTime que representa "2001-04-01" |
DateFromNum
descripción |
La función DateFromNum convierte un valor en el formato de fecha de AD a un tipo DateTime. |
de sintaxis de |
dt DateFromNum(num value) |
comentarios |
|
de ejemplo de |
DateFromNum([lastLogonTimestamp]) DateFromNum(129699324000000000) Devuelve un valor DateTime que representa 2012-01-01 23:00:00 |
DNComponent
descripción |
La función DNComponent devuelve el valor de un componente DN especificado que va de izquierda. |
de sintaxis de |
str DNComponent(ref dn, num ComponentNumber) dn: el atributo de referencia que se va a interpretar ComponentNumber: componente del DN que se va a devolver |
comentarios |
|
de ejemplo de |
DNComponent([dn],1) Si dn es "cn=Joe,ou=... esto devolvería a Joe |
DNComponentRev
descripción |
La función DNComponentRev devuelve el valor de un componente DN especificado que va desde la derecha (el final). |
de sintaxis de |
str DNComponentRev(ref dn, num ComponentNumber) str DNComponentRev(ref dn, num ComponentNumber, enum Options)dn: el atributo de referencia que se va a interpretar ComponentNumber: componente del DN que se va a devolver Opciones: DC: omitir todos los componentes con "dc=" |
comentarios |
|
de ejemplo de |
Si dn es "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" then DNComponentRev([dn],3) DNComponentRev([dn],1,"DC") ambos regresarían a EE. UU. |
Error
descripción |
La función Error se usa para devolver un error personalizado. |
de sintaxis de |
void Error(str ErrorMessage) |
comentarios |
|
de ejemplo de |
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required")) Si el atributo accountName no está presente, produzca un error en el objeto . |
EscapeDNComponent
descripción |
La función EscapeDNComponent toma un componente de un DN y lo escapa para que se pueda representar en LDAP. |
de sintaxis de |
str EscapeDNComponent(str value) |
comentarios |
|
de ejemplo de |
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP% Asegúrese de que el objeto se puede crear en un directorio LDAP incluso si el atributo displayName tiene caracteres que se deben escapar en LDAP. |
FormatDateTime
descripción |
La función FormatDateTime se usa para dar formato a dateTime a una cadena con un formato especificado. |
de sintaxis de |
str FormatDateTime(dt value, str format)value: un valor en el formato DateTime format: una cadena que representa el formato al que se va a convertir. |
comentarios |
Los valores posibles para el formato se pueden encontrar aquí: |
de ejemplo de |
FormatDateTime(CDate("12/25/2007"),"aaaa-mm-dd") Da como resultado "2007-12-25". FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMMddHHmmss.0Z") Puede dar como resultado "20140905081453.0Z" |
GUID
descripción |
El GUID de función genera un nuevo GUID aleatorio |
de sintaxis de |
GUID str() |
comentarios |
|
de ejemplo de |
IIF
descripción |
La función IIF devuelve uno de un conjunto de valores posibles en función de una condición especificada. |
de sintaxis de |
var IIF(exp condition, var valueIfTrue, var valueIfFalse)condition: cualquier valor o expresión que se pueda evaluar como true o false. valueIfTrue: un valor que se devolverá si condition se evalúa como true. valueIfFalse: un valor que se devolverá si la condición se evalúa como false. |
comentarios |
|
de ejemplo de |
IIF([employeeType]="Intern","t-"&[alias],[alias]) Devuelve el alias de un usuario con "t-" agregado al principio si el usuario es un interno; de lo contrario, devuelve el alias del usuario tal como está. |
Instr
descripción |
La función InStr busca la primera aparición de una subcadena en una cadena. |
de sintaxis de |
num InStr(str stringcheck, str stringmatch) num InStr(str stringcheck, str stringmatch, num start) num InStr(str stringcheck, str stringmatch, num start , enum compare) Stringcheck: cadena que se va a buscar Stringmatch: cadena que se va a encontrar Inicio: posición inicial para buscar la subcadena Compare: vbTextCompare o vbBinaryCompare |
Observaciones |
Devuelve la posición donde se encontró la subcadena o 0 si no se encuentra. |
de ejemplo de |
InStr("The quick brown fox","quick") Valores E a 5 InStr("repEated","e",3,vbBinaryCompare) Se evalúa como 7 |
InStrRev
descripción |
La función InStrRev busca la última aparición de una subcadena en una cadena. |
de sintaxis de |
num InstrRev(str stringcheck, str stringmatch) num InstrRev(str stringcheck, str stringmatch, num start) num InstrRev(str stringcheck, str stringmatch, num start, enum compare) Stringcheck: cadena que se va a buscar Stringmatch: cadena que se va a encontrar Inicio: posición inicial para buscar la subcadena Compare: vbTextCompare o vbBinaryCompare |
comentarios |
Devuelve la posición donde se encontró la subcadena o 0 si no se encuentra. |
de ejemplo de |
InStrRev("abbcdbbbef","bb") Se evalúa como 7 |
IsBitSet
descripción |
La función IsBitSet comprueba si se establece un bit o no |
de sintaxis de |
bool IsBitSet(num value, num flag) value: un valor numérico que se evalúa.flag: un valor numérico que tiene el bit que se va a evaluar. |
comentarios |
|
de ejemplo de |
IsBitSet(&HF,4) Se evalúa como True, ya que el bit "4" se establece en el valor hexadecimal "F" |
IsDate
descripción |
La función IsDate se evalúa como True si la expresión se puede evaluar como un tipo DateTime. |
de sintaxis de |
bool IsDate(var Expression) |
comentarios |
Se usa para determinar si CDate() se realizará correctamente. |
de ejemplo de |
IsEmpty
descripción |
La función IsEmpty se evalúa como True si el atributo está presente en el CS o MV, pero se evalúa como una cadena vacía. |
de sintaxis de |
bool IsEmpty(var Expression) |
comentarios |
|
de ejemplo de |
IsGuid
descripción |
La función IsGuid se evaluó como true si la cadena se podría convertir en un GUID. |
de sintaxis de |
bool IsGuid(str GUID) |
comentarios |
Un GUID se define como una cadena que sigue uno de estos patrones: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx o {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} Se usa para determinar si CGuid() se realizará correctamente. |
de ejemplo de |
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL) Si StrAttribute tiene un formato GUID, devuelva una representación binaria; de lo contrario, devuelva un valor Null. |
IsNull
descripción |
La función IsNull devuelve true si la expresión se evalúa como Null. |
de sintaxis de |
bool IsNull(var Expression) |
comentarios |
Para un atributo, un valor Null se expresa por la ausencia del atributo . |
de ejemplo de |
IsNull([displayName]) Se evaluaría como True si el atributo no está presente en el CS o MV. |
IsNullOrEmpty
descripción |
La función IsNullOrEmpty devuelve true si la expresión es null o una cadena vacía. |
de sintaxis de |
bool IsNullOrEmpty(var Expression) |
comentarios |
Para un atributo, esto se evaluaría como True si el atributo está ausente o está presente, pero es una cadena vacía. El inverso de esta función se denomina IsPresent. |
de ejemplo de |
IsNull([displayName]) Se evaluaría como True si el atributo no está presente o es una cadena vacía en el CS o MV. |
IsNumeric
descripción |
La función IsNumeric devuelve un valor booleano que indica si una expresión se puede evaluar como un tipo de número. |
de sintaxis de |
bool IsNumeric(var Expression) |
comentarios |
Se usa para determinar si CNum() se realizará correctamente para analizar la expresión. |
de ejemplo de |
IsString
Descripción |
La función IsString se evalúa como True si la expresión se puede evaluar como un tipo de cadena. |
de sintaxis de |
bool IsString(var expression) |
comentarios |
Se usa para determinar si CStr() se realizará correctamente para analizar la expresión. |
de ejemplo de |
IsPresent
descripción |
La función IsPresent devuelve true si la expresión se evalúa como una cadena que no es Null y no está vacía. |
de sintaxis de |
bool IsPresent(var expression) |
comentarios |
El inverso de esta función se denomina IsNullOrEmpty. |
de ejemplo de |
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director]) |
Artículo
descripción |
La función Item devuelve un elemento de una cadena o atributo de varios valores. |
de sintaxis de |
var Item(mvstr attribute, num index) atributo: atributo multivalor index: index a un elemento de la cadena con varios valores. |
comentarios |
La función Item es útil junto con la función Contains, ya que esta última función devolverá el índice a un elemento del atributo multivalor. Produce un error si el índice está fuera de los límites. |
de ejemplo de |
Mid(Item([proxyAddress],Contains([proxyAddress], "SMTP:")),6) devolvería la dirección de correo electrónico principal. |
ItemOrNull
descripción |
La función ItemOrNull devuelve un elemento de una cadena o atributo de varios valores. |
de sintaxis de |
var ItemOrNull(mvstr attribute, num index) atributo: atributo multivalor index: index a un elemento de la cadena con varios valores. |
comentarios |
La función ItemOrNull es útil junto con la función Contains, ya que esta última función devolverá el índice a un elemento del atributo multivalor. Devuelve un valor Null si el índice está fuera de los límites. |
de ejemplo de |
Juntar
descripción |
La función Join toma una cadena de varios valores y devuelve una cadena de un solo valor con el separador especificado insertado entre cada elemento. |
de sintaxis de |
str Join(atributo mvstr) str Join(mvstr attribute, str Delimiter)attribute: atributo multivalor que contiene cadenas que se van a combinar. Delimitador: cualquier cadena, usada para separar las subcadenas en la cadena devuelta. Si se omite, se usa el carácter de espacio (" ") . Si Delimiter es una cadena de longitud cero ("") o Nothing, todos los elementos de la lista se concatenan sin delimitadores. |
comentarios |
Hay paridad entre las funciones Join y Split. La función Join toma una matriz de cadenas y las combina mediante una cadena delimitador, para devolver una sola cadena. La función Split toma una cadena y la separa en el delimitador para devolver una matriz de cadenas. Sin embargo, una diferencia clave es que Join puede concatenar cadenas con cualquier cadena delimitador, Split solo puede separar cadenas mediante un delimitador de caracteres único. |
de ejemplo de |
Join([proxyAddresses],",") Podría devolver: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com" |
LCase
descripción |
La función LCase convierte todos los caracteres de una cadena en minúsculas. |
de sintaxis de |
str LCase(str value) |
comentarios |
|
de ejemplo de |
LCase("TeSt") Da como resultado "test". |
Izquierda
descripción |
La función Left devuelve un número especificado de caracteres de la izquierda de una cadena. |
de sintaxis de |
str Left(str string, num NumChars)string: la cadena a devolver caracteres de NumChars: un número que identifica el número de caracteres que se van a devolver desde el principio (izquierda) de la cadena. |
comentarios |
Cadena que contiene los primeros caracteres numChars de la cadena. •Si numChars = 0, devuelve una cadena vacía. •Si numChars < 0, devuelva la cadena de entrada. •Si string es null, devuelva una cadena vacía. 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 del parámetro 1). |
de ejemplo de |
Left("John Doe", 3) Devolvería "Joh". |
Len
descripción |
La función Num devuelve el número de caracteres de una cadena. |
de sintaxis de |
num Len(str value) |
comentarios |
|
de ejemplo de |
Len("John Doe") Devolvería 8 |
LTrim
descripción |
La función LTrim quita los espacios en blanco iniciales de una cadena. |
de sintaxis de |
str LTrim(str value) |
comentarios |
|
Ejemplo |
LTrim(" Test ") Da como resultado "Test" |
Medio
descripción |
La función Mid devuelve un número especificado de caracteres de una posición especificada en una cadena. |
de sintaxis de |
str Mid(str string, num start, num NumChars) string: cadena de la que se van a devolver caracteres start: un número que identifica la posición inicial en la cadena para devolver caracteres de NumChars: un número que identifica el número de caracteres que se van a devolver de la posición de la cadena. |
comentarios |
Devuelve caracteres numChars a partir de la posición inicial en la cadena. Cadena que contiene caracteres numChars desde la posición inicial en la cadena. •Si numChars = 0, devuelve una cadena vacía. •Si numChars < 0, devuelva la cadena de entrada. •Si se inicia > la longitud de la cadena, devuelva la cadena de entrada. •Si inicia <= 0, devuelva la cadena de entrada. •Si string es null, devuelva una cadena vacía. Si no hay caracteres numChar restantes en la cadena desde el inicio de la posición, se devuelven tantos caracteres como se pueda devolver. |
de ejemplo de |
Mid("John Doe", 3, 5) Devolvería "hn Do". Mid("John Doe", 6, 999) Devolvería "Doe" |
Ahora
descripción |
La función Now devuelve un valor DateTime que especifica la fecha y hora actuales, según la fecha y hora del sistema del equipo. |
de sintaxis de |
dt Now() |
comentarios |
|
de ejemplo de |
NumFromDate
descripción |
La función NumFromDate devuelve una fecha en el formato de fecha de AD. |
de sintaxis de |
num NumFromDate(dt value) |
comentarios |
|
de ejemplo de |
NumFromDate(CDate("2012-01-01 23:00:00")) Devuelve 129699324000000000 |
PadLeft
descripción |
La función PadLeft rellena una cadena a una longitud especificada mediante un carácter de relleno proporcionado. |
de sintaxis de |
str PadLeft(str string, num length, str padCharacter) string: cadena que se va a rellenar. length: entero que representa la longitud deseada de la cadena. padCharacter: una cadena que consta de un solo carácter que se va a usar como carácter de relleno |
comentarios |
Si la longitud de la cadena es menor que la longitud, padCharacter se anexa repetidamente al principio (izquierda) de la cadena hasta que tiene una longitud igual a la longitud. padCharacter puede ser un carácter de espacio, pero no puede ser un valor NULL. Si la longitud de la cadena es igual o mayor que la longitud, la cadena se devuelve sin cambios. Si la cadena tiene una longitud mayor o igual que la longitud, se devuelve una cadena idéntica a la cadena. Si la longitud de la cadena es menor que la longitud, se devuelve una nueva cadena de la longitud deseada que contiene una cadena rellenada con un padCharacter. Si string es null, la función devuelve una cadena vacía. |
de ejemplo de |
PadLeft("User", 10, "0") Daría como resultado "000000User". |
PadRight
descripción |
La función PadRight rellena una cadena a una longitud especificada mediante un carácter de relleno proporcionado. |
de sintaxis de |
str PadRight(str string, num length, str padCharacter) string: cadena que se va a rellenar. length: entero que representa la longitud deseada de la cadena. padCharacter: una cadena que consta de un solo carácter que se va a usar como carácter de relleno |
comentarios |
Si la longitud de la cadena es menor que la longitud, padCharacter se anexa repetidamente al final (derecha) de la cadena hasta que tiene una longitud igual a la longitud. padCharacter puede ser un carácter de espacio, pero no puede ser un valor NULL. Si la longitud de la cadena es igual o mayor que la longitud, la cadena se devuelve sin cambios. Si la cadena tiene una longitud mayor o igual que la longitud, se devuelve una cadena idéntica a la cadena. Si la longitud de la cadena es menor que la longitud, se devuelve una nueva cadena de la longitud deseada que contiene una cadena rellenada con un padCharacter. Si string es null, la función devuelve una cadena vacía. |
de ejemplo de |
PadRight("User", 10, "0") Daría como resultado "User0000000". |
PCase
descripción |
La función PCase convierte el primer carácter de cada palabra delimitada de espacio en una cadena en mayúsculas y todos los demás caracteres se convierten en minúsculas. |
de sintaxis de |
String PCase(string) |
comentarios |
|
de ejemplo de |
PCase("TEsT") Da como resultado "Test". |
RandomNum
descripción |
La función RandomNum devuelve un número aleatorio entre un intervalo especificado. |
de sintaxis de |
num RandomNum(num start, num end) start: un número que identifica el límite inferior del valor aleatorio que se va a generar. end: un número que identifica el límite superior del valor aleatorio que se va a generar. |
comentarios |
|
de ejemplo de |
Random(100,999) podría devolver 734. |
RemoveDuplicates
descripción |
La función RemoveDuplicates toma una cadena de varios valores y asegúrese de que cada valor es único. |
de sintaxis de |
mvstr RemoveDuplicates(atributo mvstr) |
comentarios |
|
de ejemplo de |
RemoveDuplicates([proxyAddresses]) Devolverá un atributo proxyAddress saneado donde se han quitado todos los valores duplicados. |
Reemplazar
descripción |
La función Replace reemplaza todas las apariciones de una cadena a otra cadena. |
de sintaxis de |
str Replace(str string, str OldValue, str NewValue) string: cadena en la que se van a reemplazar los valores. OldValue: cadena que se va a buscar y reemplazar. NewValue: cadena a la que se va a reemplazar. |
comentarios |
La función reconoce los siguientes monikers especiales. \n: nueva línea \r: retorno de carro \t : pestaña |
de ejemplo de |
Replace([address],"\r\n",", ") Reemplace CRLF por una coma y un espacio, y podría dar lugar a "One Microsoft Way, Redmond, WA, USA" |
ReplaceChars
descripción |
La función ReplaceChars reemplaza todas las apariciones de caracteres que se encuentran en la cadena ReplacePattern. |
de sintaxis de |
str ReplaceChars(str string, str ReplacePattern) string: cadena en la que se van a reemplazar los caracteres. ReplacePattern: una cadena que contiene un diccionario con caracteres que se van a reemplazar. El formato es {source1}:{target1},{source2}:{target2},{sourceN},{targetN} donde source es el carácter para buscar y establecer como destino la cadena por la que se va a reemplazar. |
comentarios |
La función tomará cada aparición de orígenes definidos y los reemplazará por los destinos. El origen debe ser exactamente un carácter (unicode). El origen no puede estar vacío o más de un carácter (error de análisis). El destino puede tener varios caracteres, por ejemplo, ö:oe, β:ss. El destino puede estar vacío que indica que se debe quitar el carácter. El origen distingue mayúsculas de minúsculas y debe ser una coincidencia exacta. Los caracteres , (coma) y : (dos puntos) son caracteres reservados y no se pueden reemplazar mediante esta función. Los espacios y otros caracteres blancos de la cadena ReplacePattern se omiten. |
de ejemplo de |
%ReplaceString% = ':,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o ReplaceChars("Räksmörgås",%ReplaceString%) Devuelve Raksmorgas ReplaceChars("O'Neil",%ReplaceString%) Devuelve "ONeil", se define el tic único que se va a quitar. |
Derecha
descripción |
La función Right devuelve un número especificado de caracteres de la derecha (extremo) de una cadena. |
de sintaxis de |
str Right(str string, num NumChars) string: cadena de la que se van a devolver caracteres NumChars: un número que identifica el número de caracteres que se van a devolver desde el final (derecha) de la cadena. |
Observaciones |
Los caracteres NumChars se devuelven desde la última posición de la cadena. Cadena que contiene los últimos caracteres numChars de la cadena. •Si numChars = 0, devuelve una cadena vacía. •Si numChars < 0, devuelva la cadena de entrada. •Si string es null, devuelva una cadena vacía. Si la cadena contiene menos caracteres que el número especificado en NumChars, se devuelve una cadena idéntica a la cadena. |
de ejemplo de |
Right("John Doe", 3) Devolvería "Doe". |
RTrim
descripción |
La función RTrim quita los espacios en blanco finales de una cadena. |
de sintaxis de |
str RTrim(str value) |
comentarios |
|
de ejemplo de |
RTrim(" Test ") Da como resultado "Test". |
Partir
descripción |
La función Split toma una cadena separada por un delimitador y la convierte en una cadena de varios valores. |
de sintaxis de |
mvstr Split(valor str, delimitador de str) mvstr Split(str value, str delimiter, num limit) Valor: la cadena con un carácter delimitador que se va a separar. Delimitador: carácter único que se va a usar como delimitador Límite: número máximo de valores que se devolverán. |
comentarios |
|
de ejemplo de |
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",") devolvería una cadena de varios valores con 2 elementos útiles para el atributo proxyAddress |
StringFromGuid
Descripción |
La función StringFromGuid toma un GUID binario y lo convierte en una cadena. |
Sintaxis |
str StringFromGuid(bin GUID) |
Observaciones |
|
Ejemplo |
StringFromSid
descripción |
La función StringFromSid convierte una matriz de bytes o una matriz de bytes de varios valores que contiene un identificador de seguridad en una cadena o una cadena con varios valores. |
de sintaxis de |
str StringFromSid(bin ObjectSID) mvstr StringFromSid(mvbin ObjectSID) |
comentarios |
|
de ejemplo de |
Interruptor
descripción |
La función Switch se usa para devolver un único valor en función de las condiciones evaluadas. |
de sintaxis de |
var Switch(expr1, var value1[, expr2, var value ... [, expr, var valueN]]) Expr: expresión variant que desea evaluar. Valor: valor que se va a devolver si la expresión correspondiente es True. |
comentarios |
La lista de argumentos de función Switch consta de pares de expresiones y valores. Las expresiones se evalúan de izquierda a derecha y se devuelve el valor asociado a la primera expresión que se va a evaluar como True. Si las partes no están emparejadas correctamente, se produce un error en tiempo de ejecución. Por ejemplo, si expr1 es True, Switch devuelve value1. Si expr-1 es False, pero expr-2 es True, Switch devuelve value-2, etc. Switch devuelve un valor Nothing si:
Switch evalúa todas las expresiones, aunque solo devuelve una de ellas. Por esta razón, usted debe observar los efectos secundarios no deseados. Por ejemplo, si la evaluación de cualquier expresión da como resultado un error de división por cero, se produce un error. El valor también puede ser la función Error que devolvería una cadena personalizada. |
de ejemplo de |
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city")) Devuelve el idioma hablado en algunas ciudades principales; de lo contrario, devuelve un error. |
Recortar
descripción |
La función Trim quita los espacios en blanco iniciales y finales de una cadena. |
de sintaxis de |
str Trim(str value) mvstr Trim(valor mvstr) |
comentarios |
|
de ejemplo de |
Trim(" Test ") Da como resultado "Test". Trim([proxyAddresses]) Quitará los espacios iniciales y finales de cada valor del atributo proxyAddress. |
UCase
Descripción |
La función UCase convierte todos los caracteres de una cadena en mayúsculas. |
de sintaxis de |
str UCase(str string) |
comentarios |
|
de ejemplo de |
UCase("TeSt") da como resultado "TEST". |
Palabra
descripción |
La función Word devuelve una palabra contenida en una cadena, basada en parámetros que describen los delimitadores que se van a usar y el número de palabra que se va a devolver. |
de sintaxis de |
str Word(str string, num WordNumber, delimitadores str) string: la cadena de la que se va a devolver una palabra WordNumber: un número que identifica qué número de palabra se debe devolver. delimitadores: una cadena que representa los delimitadores que se deben usar para identificar palabras. |
comentarios |
Cada cadena de caracteres de cadena separada por uno de los caracteres de los delimitadores se identifica como palabras. •Si el número < 1, devuelva una cadena vacía. •Si string es null, devuelva una cadena vacía. Si la cadena contiene menos de palabras numéricas, o la cadena no contiene ninguna palabra identificada por delimeters, se devuelve una cadena vacía. |
de ejemplo de |
Word("The quick brown fox",3," ") Devolvería "marrón" Word("This,string!has&muchos separadores",3,","!&#") Devolvería "has" |