Servizio di sincronizzazione Azure AD Connect: Riferimento alle funzioniAzure AD Connect sync: Functions Reference

In Azure AD Connect le funzioni vengono usate per modificare il valore di un attributo durante la sincronizzazione.In Azure AD Connect, functions are used to manipulate an attribute value during synchronization.
La sintassi delle funzioni viene espressa nel formato seguente: The Syntax of the functions is expressed using the following format:
<output type> FunctionName(<input type> <position name>, ..)

Se una funzione è in overload e accetta più sintassi, verranno elencate tutte quelle valide.If a function is overloaded and accepts multiple syntaxes, all valid syntaxes are listed.
Le funzioni sono fortemente tipizzate e verificano che il tipo passato corrisponda al tipo documentato.The functions are strongly typed and they verify that the type passed in matches the documented type.
Se il tipo non corrisponde, viene generato un errore.If the type does not match, an error is thrown.

I tipi vengono espressi con la sintassi seguente:The types are expressed with the following syntax:

  • bin : binariobin – Binary
  • bool : booleanobool – Boolean
  • dt : data/ora UTCdt – UTC Date/Time
  • enum : enumerazione di costanti noteenum – Enumeration of known constants
  • exp : espressione per cui è prevista la restituzione di un valore booleanoexp – Expression, which is expected to evaluate to a Boolean
  • mvbin : binario multivaloremvbin – Multi-Valued Binary
  • mvstr : stringa multivaloremvstr – Multi-Valued String
  • mvref : riferimento multivaloremvref – Multi-Valued Reference
  • num : numericonum – Numeric
  • ref : riferimentoref – Reference
  • str : stringastr – String
  • var : variante di (quasi) tutti gli altri tipivar – A variant of (almost) any other type
  • void : non restituisce un valorevoid – doesn’t return a value

Le funzioni con i tipi mvbin, mvstr e mvref possono operare solo con gli attributi multivalore.The functions with the types mvbin, mvstr, and mvref can only work on multi-valued attributes. Le funzioni con bin, str e ref operano con gli attributi a valore singolo e multivalore.Functions with bin, str, and ref work on both single-valued and multi-valued attributes.

Riferimento alle funzioniFunctions Reference

Elenco di funzioniList of functions
CertificateCertificate
CertExtensionOidsCertExtensionOids CertFormatCertFormat CertFriendlyNameCertFriendlyName CertHashStringCertHashString
CertIssuerCertIssuer CertIssuerDNCertIssuerDN CertIssuerOidCertIssuerOid CertKeyAlgorithmCertKeyAlgorithm
CertKeyAlgorithmParamsCertKeyAlgorithmParams CertNameInfoCertNameInfo CertNotAfterCertNotAfter CertNotBeforeCertNotBefore
CertPublicKeyOidCertPublicKeyOid CertPublicKeyParametersOidCertPublicKeyParametersOid CertSerialNumberCertSerialNumber CertSignatureAlgorithmOidCertSignatureAlgorithmOid
CertSubjectCertSubject CertSubjectNameDNCertSubjectNameDN CertSubjectNameOidCertSubjectNameOid CertThumbprintCertThumbprint
CertVersion CertVersion IsCertIsCert
ConversioneConversion
CBoolCBool CDateCDate CGuidCGuid ConvertFromBase64ConvertFromBase64
ConvertToBase64ConvertToBase64 ConvertFromUTF8HexConvertFromUTF8Hex ConvertToUTF8HexConvertToUTF8Hex CNumCNum
CRefCRef CStrCStr StringFromGuidStringFromGuid StringFromSidStringFromSid
Data/OraDate / Time
DateAddDateAdd DateFromNumDateFromNum FormatDateTimeFormatDateTime NowNow
NumFromDateNumFromDate
DirectoryDirectory
DNComponentDNComponent DNComponentRevDNComponentRev EscapeDNComponentEscapeDNComponent
Versione di valutazioneEvaluation
IsBitSetIsBitSet IsDateIsDate IsEmptyIsEmpty IsGuidIsGuid
IsNullIsNull IsNullOrEmptyIsNullOrEmpty IsNumericIsNumeric IsPresentIsPresent
IsStringIsString
MatematicheMath
BitAndBitAnd BitOrBitOr RandomNumRandomNum
A più valoriMulti-valued
ContieneContains NumeroCount ElementoItem ItemOrNullItemOrNull
JoinJoin RemoveDuplicatesRemoveDuplicates SplitSplit
Flusso del programmaProgram Flow
ErroreError IIFIIF SelezionareSelect SwitchSwitch
DoveWhere WithWith
TextText
GUIDGUID InStrInStr InStrRevInStrRev LCaseLCase
LeftLeft LenLen LTrimLTrim MidMid
PadLeftPadLeft PadRightPadRight PCasePCase ReplaceReplace
ReplaceCharsReplaceChars RightRight RTrimRTrim TrimTrim
UCaseUCase WordWord

BitAndBitAnd

Descrizione:Description:
La funzione BitAnd imposta i bit specificati su un valore.The BitAnd function sets specified bits on a value.

Sintassi:Syntax:
num BitAnd(num value1, num value2)

  • value1, value2: valori numerici da unire con ANDvalue1, value2: numeric values that should be AND’ed together

Osservazioni:Remarks:
Questa funzione converte entrambi i parametri nella rappresentazione binaria e imposta un bit su:This function converts both parameters to the binary representation and sets a bit to:

  • 0: se il valore di uno o entrambi i bit corrispondenti nella maschera e nel flag sono pari a 00 - if one or both of the corresponding bits in mask and flag are 0
  • 1: se entrambi i bit corrispondenti sono pari a 1.1 - if both of the corresponding bits are 1.

In altre parole, restituisce 0 in tutti i casi tranne quando i bit corrispondenti di entrambi i parametri sono pari a 1.In other words, it returns 0 in all cases except when the corresponding bits of both parameters are 1.

Esempio:Example:
BitAnd(&HF, &HF7)
Restituisce 7 perché i valori esadecimali "F" E "F7" restituiscono questo valore.Returns 7 because hexadecimal "F" AND "F7" evaluate to this value.


BitOrBitOr

Descrizione:Description:
La funzione BitOr imposta i bit specificati su un valore.The BitOr function sets specified bits on a value.

Sintassi:Syntax:
num BitOr(num value1, num value2)

  • value1, value2: valori numerici da unire con ORvalue1, value2: numeric values that should be OR’ed together

Osservazioni:Remarks:
Questa funzione converte entrambi i parametri nella rappresentazione binaria e imposta un bit su 1 se il valore di uno o entrambi i bit corrispondenti nella maschera e nel flag è pari a 1 e su 0 se entrambi i bit corrispondenti sono pari a 0.This function converts both parameters to the binary representation and sets a bit to 1 if one or both of the corresponding bits in mask and flag are 1, and to 0 if both of the corresponding bits are 0. In altre parole, restituisce 1 in tutti i casi tranne dove i bit corrispondenti di entrambi i parametri sono pari a 0.In other words, it returns 1 in all cases except where the corresponding bits of both parameters are 0.


CBoolCBool

Descrizione:Description:
La funzione CBool restituisce un valore booleano basato sull'espressione valutata.The CBool function returns a Boolean based on the evaluated expression

Sintassi:Syntax:
bool CBool(exp Expression)

Osservazioni:Remarks:
Se l'espressione restituisce un valore diverso da zero, CBool restituisce True. In caso contrario restituisce False.If the expression evaluates to a nonzero value, then CBool returns True, else it returns False.

Esempio:Example:
CBool([attrib1] = [attrib2])

Restituisce True se entrambi gli attributi hanno lo stesso valore.Returns True if both attributes have the same value.


CDateCDate

Descrizione:Description:
La funzione CDate restituisce un valore di data/ora UTC da una stringa.The CDate function returns a UTC DateTime from a string. DateTime non è un attributo nativo in Sync, ma viene usato da alcune funzioni.DateTime is not a native attribute type in Sync but is used by some functions.

Sintassi:Syntax:
dt CDate(str value)

  • Value: una stringa con una data, un'ora e facoltativamente un fuso orarioValue: A string with a date, time, and optionally time zone

Osservazioni:Remarks:
La stringa restituita è sempre espressa in UTC.The returned string is always in UTC.

Esempio:Example:
CDate([employeeStartTime])
Restituisce un valore di data/ora basato sull'ora di inizio del dipendenteReturns a DateTime based on the employee’s start time

CDate("2013-01-10 4:00 PM -8")
Restituisce un valore di data/ora che rappresenta "2013-01-11 12:00 AM"Returns a DateTime representing "2013-01-11 12:00 AM"


CertExtensionOidsCertExtensionOids

Descrizione:Description:
Restituisce i valori Oid di tutte le estensioni critiche di un oggetto certificato.Returns the Oid values of all the critical extensions of a certificate object.

Sintassi:Syntax:
mvstr CertExtensionOids(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertFormatCertFormat

Descrizione:Description:
Restituisce il nome del formato di questo certificato X.509v3.Returns the name of the format of this X.509v3 certificate.

Sintassi:Syntax:
str CertFormat(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertFriendlyNameCertFriendlyName

Descrizione:Description:
Restituisce l'alias associato per un certificato.Returns the associated alias for a certificate.

Sintassi:Syntax:
str CertFriendlyName(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertHashStringCertHashString

Descrizione:Description:
Restituisce il valore hash SHA1 per il certificato X.509v3 come stringa esadecimale.Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.

Sintassi:Syntax:
str CertHashString(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertIssuerCertIssuer

Descrizione:Description:
Restituisce il nome dell'autorità di certificazione che ha emesso il certificato X.509v3.Returns the name of the certificate authority that issued the X.509v3 certificate.

Sintassi:Syntax:
str CertIssuer(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertIssuerDNCertIssuerDN

Descrizione:Description:
Restituisce il nome distintivo dell'autorità di certificazione.Returns the distinguished name of the certificate issuer.

Sintassi:Syntax:
str CertIssuerDN(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertIssuerOidCertIssuerOid

Descrizione:Description:
Restituisce il valore Oid dell'autorità di certificazione.Returns the Oid of the certificate issuer.

Sintassi:Syntax:
str CertIssuerOid(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertKeyAlgorithmCertKeyAlgorithm

Descrizione:Description:
Restituisce le informazioni dell'algoritmo a chiave per il certificato X.509v3 sotto forma di stringa.Returns the key algorithm information for this X.509v3 certificate as a string.

Sintassi:Syntax:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertKeyAlgorithmParamsCertKeyAlgorithmParams

Descrizione:Description:
Restituisce i parametri dell'algoritmo a chiave per il certificato X.509v3 sotto forma di stringa esadecimale.Returns the key algorithm parameters for the X.509v3 certificate as a hexadecimal string.

Sintassi:Syntax:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertNameInfoCertNameInfo

Descrizione:Description:
Restituisce i nomi del soggetto e dell'autorità di certificazione di un certificato.Returns the subject and issuer names from a certificate.

Sintassi:Syntax:
str CertNameInfo(binary certificateRawData, str x509NameType, bool includesIssuerName)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.
  • X509NameType: il valore X509NameType per il soggetto.X509NameType: The X509NameType value for the subject.
  • includesIssuerName: true per includere il nome dell'autorità di certificazione, in caso contrario, false.includesIssuerName: true to include the issuer name; otherwise, false.

CertNotAfterCertNotAfter

Descrizione:Description:
Restituisce la data nell'ora locale dopo la quale un certificato non è più valido.Returns the date in local time after which a certificate is no longer valid.

Sintassi:Syntax:
dt CertNotAfter(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertNotBeforeCertNotBefore

Descrizione:Description:
Restituisce la data nell'ora locale in cui un certificato diventa valido.Returns the date in local time on which a certificate becomes valid.

Sintassi:Syntax:
dt CertNotBefore(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertPublicKeyOidCertPublicKeyOid

Descrizione:Description:
Restituisce l'Oid della chiave pubblica per il certificato X.509v3.Returns the Oid of the public key for the X.509v3 certificate.

Sintassi:Syntax:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertPublicKeyParametersOidCertPublicKeyParametersOid

Descrizione:Description:
Restituisce l'Oid dei parametri della chiave pubblica per il certificato X.509v3.Returns the Oid of the public key parameters for the X.509v3 certificate.

Sintassi:Syntax:
str CertPublicKeyParametersOid(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertSerialNumberCertSerialNumber

Descrizione:Description:
Restituisce il numero di serie del certificato X.509v3.Returns the serial number of the X.509v3 certificate.

Sintassi:Syntax:
str CertSerialNumber(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertSignatureAlgorithmOidCertSignatureAlgorithmOid

Descrizione:Description:
Restituisce l'Oid dell'algoritmo usato per creare la firma di un certificato.Returns the Oid of the algorithm used to create the signature of a certificate.

Sintassi:Syntax:
str CertSignatureAlgorithmOid(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertSubjectCertSubject

Descrizione:Description:
Ottiene il nome distintivo del soggetto da un certificato.Gets the subject distinguished name from a certificate.

Sintassi:Syntax:
str CertSubject(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertSubjectNameDNCertSubjectNameDN

Descrizione:Description:
Restituisce il nome distintivo del soggetto di un certificato.Returns the subject distinguished name from a certificate.

Sintassi:Syntax:
str CertSubjectNameDN(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertSubjectNameOidCertSubjectNameOid

Descrizione:Description:
Restituisce l'Oid del nome del soggetto di un certificato.Returns the Oid of the subject name from a certificate.

Sintassi:Syntax:
str CertSubjectNameOid(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertThumbprintCertThumbprint

Descrizione:Description:
Restituisce l'identificazione personale di un certificato.Returns the thumbprint of a certificate.

Sintassi:Syntax:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CertVersionCertVersion

Descrizione:Description:
Restituisce la versione in formato X.509 di un certificato.Returns the X.509 format version of a certificate.

Sintassi:Syntax:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

CGuidCGuid

Descrizione:Description:
La funzione CGuid converte la rappresentazione di stringa di un GUID nella corrispondente rappresentazione binaria.The CGuid function converts the string representation of a GUID to its binary representation.

Sintassi:Syntax:
bin CGuid(str GUID)

  • Stringa formattata con questo schema: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx o {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}A String formatted in this pattern: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx or {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

ContieneContains

Descrizione:Description:
La funzione Contains trova una stringa all'interno di un attributo multivalore.The Contains function finds a string inside a multi-valued attribute

Sintassi:Syntax:
num Contains (mvstring attribute, str search) - distinzione maiuscole/minuscolenum Contains (mvstring attribute, str search) - case-sensitive
num Contains (mvstring attribute, str search, enum Casetype)
num Contains (mvref attribute, str search) - distinzione maiuscole/minuscolenum Contains (mvref attribute, str search) - case-sensitive

  • attribute: l'attributo multivalore da cercare.attribute: the multi-valued attribute to search.
  • search: stringa da trovare nell'attributo.search: string to find in the attribute.
  • Casetype: CaseInsensitive o CaseSensitive.Casetype: CaseInsensitive or CaseSensitive.

Restituisce l'indice nell'attributo multivalore in cui è stata trovata la stringa.Returns index in the multi-valued attribute where the string was found. Se la stringa non viene trovata, restituisce 0.0 is returned if the string is not found.

Osservazioni:Remarks:
Per gli attributi stringa multivalore, viene effettuata la ricerca di sottostringhe nei valori.For multi-valued string attributes, the search finds substrings in the values.
Per gli attributi di riferimento, la stringa cercata deve corrispondere esattamente al valore per essere considerata una corrispondenza.For reference attributes, the searched string must exactly match the value to be considered a match.

Esempio:Example:
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found."))
Se l'attributo proxyAddresses include un indirizzo di posta elettronica primario (indicato da "SMTP:") viene restituito l'attributo proxyAddress. In caso contrario viene restituito un errore.If the proxyAddresses attribute has a primary email address (indicated by uppercase "SMTP:"), then return the proxyAddress attribute, else return an error.


ConvertFromBase64ConvertFromBase64

Descrizione:Description:
La funzione ConvertFromBase64 converte il valore con codifica Base 64 specificato in una stringa normale.The ConvertFromBase64 function converts the specified base64 encoded value to a regular string.

Sintassi:Syntax:
str ConvertFromBase64(str source): presuppone l'uso di Unicode per la codificastr ConvertFromBase64(str source) - assumes Unicode for encoding
str ConvertFromBase64(str source, enum Encoding)

  • source: stringa con codifica Base 64source: Base64 encoded string
  • Encoding: Unicode, ASCII, UTF8Encoding: Unicode, ASCII, UTF8

EsempioExample
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")
ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)

Entrambi gli esempi restituiscono "Hello world!"Both examples return "Hello world!"


ConvertFromUTF8HexConvertFromUTF8Hex

Descrizione:Description:
La funzione ConvertFromUTF8Hex converte il valore con codifica esadecimale UTF8 specificato in una stringa.The ConvertFromUTF8Hex function converts the specified UTF8 Hex encoded value to a string.

Sintassi:Syntax:
str ConvertFromUTF8Hex(str source)

  • source: stringa con codifica a 2 byte UTF8source: UTF8 2-byte encoded sting

Osservazioni:Remarks:
La differenza tra questa funzione e ConvertFromBase64([],UTF8) è che il risultato può essere usato per l'attributo DN.The difference between this function and ConvertFromBase64([],UTF8) in that the result is friendly for the DN attribute.
Questo formato viene utilizzato da Azure Active Directory come DN.This format is used by Azure Active Directory as DN.

Esempio:Example:
ConvertFromUTF8Hex("48656C6C6F20776F726C6421")
Restituisce "Hello world!"Returns "Hello world!"


ConvertToBase64ConvertToBase64

Descrizione:Description:
La funzione ConvertToBase64 converte una stringa in una stringa Base 64 Unicode.The ConvertToBase64 function converts a string to a Unicode base64 string.
Converte il valore di una matrice di interi nella rappresentazione di stringa equivalente in cifre con codifica Base 64.Converts the value of an array of integers to its equivalent string representation that is encoded with base-64 digits.

Sintassi:Syntax:
str ConvertToBase64(str source)

Esempio:Example:
ConvertToBase64("Hello world!")
Restituisce "SABlAGwAbABvACAAdwBvAHIAbABkACEA"Returns "SABlAGwAbABvACAAdwBvAHIAbABkACEA"


ConvertToUTF8HexConvertToUTF8Hex

Descrizione:Description:
La funzione ConvertToUTF8Hex converte una stringa in un valore con codifica esadecimale UTF8.The ConvertToUTF8Hex function converts a string to a UTF8 Hex encoded value.

Sintassi:Syntax:
str ConvertToUTF8Hex(str source)

Osservazioni:Remarks:
Il formato di output di questa funzione viene usato da Azure Active Directory come formato dell'attributo DN.The output format of this function is used by Azure Active Directory as DN attribute format.

Esempio:Example:
ConvertToUTF8Hex("Hello world!")
Restituisce 48656C6C6F20776F726C6421Returns 48656C6C6F20776F726C6421


NumeroCount

Descrizione:Description:
La funzione Count restituisce il numero di elementi in un attributo multivalore.The Count function returns the number of elements in a multi-valued attribute

Sintassi:Syntax:
num Count(mvstr attribute)


CNumCNum

Descrizione:Description:
La funzione CNum accetta una stringa e restituisce un tipo di dati numerico.The CNum function takes a string and returns a numeric data type.

Sintassi:Syntax:
num CNum(str value)


CRefCRef

Descrizione:Description:
Converte una stringa in un attributo di riferimento.Converts a string to a reference attribute

Sintassi:Syntax:
ref CRef(str value)

Esempio:Example:
CRef("CN=LC Services,CN=Microsoft,CN=lcspool01,CN=Pools,CN=RTC Service," & %Forest.LDAP%)


CStrCStr

Descrizione:Description:
La funzione CStr esegue la conversione in un tipo di dati stringa.The CStr function converts to a string data type.

Sintassi:Syntax:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)

  • value: può essere un valore numerico, un attributo di riferimento o un valore booleano.value: Can be a numeric value, reference attribute, or Boolean.

Esempio:Example:
CStr([dn])
Può restituire "cn=Joe,dc=contoso,dc=com"Could return "cn=Joe,dc=contoso,dc=com"


DateAddDateAdd

Descrizione:Description:
Restituisce un valore Date contenente una data alla quale è stato aggiunto un intervallo di tempo specificato.Returns a Date containing a date to which a specified time interval has been added.

Sintassi:Syntax:
dt DateAdd(str interval, num value, dt date)

  • interval: espressione stringa che corrisponde all'intervallo di tempo da aggiungere.interval: String expression that is the interval of time you want to add. La stringa deve avere almeno uno dei valori seguenti:The string must have one of the following values:
    • yyyy Yearyyyy Year
    • q Quarterq Quarter
    • m Monthm Month
    • y Day of yeary Day of year
    • d Dayd Day
    • w Weekdayw Weekday
    • ww Weekww Week
    • h Hourh Hour
    • n Minuten Minute
    • s Seconds Second
  • value: numero di unità da aggiungere.value: The number of units you want to add. Può essere positivo (per ottenere date nel futuro) o negativo (per ottenere date nel passato).It can be positive (to get dates in the future) or negative (to get dates in the past).
  • date: data/ora che rappresenta la data alla quale viene aggiunto l'intervallo.date: DateTime representing date to which the interval is added.

Esempio:Example:
DateAdd("m", 3, CDate("2001-01-01"))
Aggiunge 3 mesi e restituisce un valore di data/ora che rappresenta "2001-04-01".Adds 3 months and returns a DateTime representing "2001-04-01".


DateFromNumDateFromNum

Descrizione:Description:
La funzione DateFromNum converte un valore nel formato di data di Active Directory in un tipo di data/ora.The DateFromNum function converts a value in AD’s date format to a DateTime type.

Sintassi:Syntax:
dt DateFromNum(num value)

Esempio:Example:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Restituisce un valore di data/ora che rappresenta 2012-01-01 23:00:00Returns a DateTime representing 2012-01-01 23:00:00


DNComponentDNComponent

Descrizione:Description:
La funzione DNComponent restituisce il valore di un componente DN specificato, a partire da sinistra.The DNComponent function returns the value of a specified DN component going from left.

Sintassi:Syntax:
str DNComponent(ref dn, num ComponentNumber)

  • dn: attributo di riferimento da interpretaredn: the reference attribute to interpret
  • ComponentNumber: componente nel DN da restituireComponentNumber: The component in the DN to return

Esempio:Example:
DNComponent([dn],1)
Se dn è "cn=Joe,ou=…," verrà restituito JoeIf dn is "cn=Joe,ou=…," it returns Joe


DNComponentRevDNComponentRev

Descrizione:Description:
La funzione DNComponentRev restituisce il valore di un componente DN specificato, a partire da destra (dalla fine).The DNComponentRev function returns the value of a specified DN component going from right (the end).

Sintassi:Syntax:
str DNComponentRev(ref dn, num ComponentNumber)
str DNComponentRev(ref dn, num ComponentNumber, enum Options)

  • dn: attributo di riferimento da interpretaredn: the reference attribute to interpret
  • ComponentNumber: componente nel DN da restituireComponentNumber - The component in the DN to return
  • Options: DC - Ignora tutti i componenti con "dc="Options: DC – Ignore all components with "dc="

Esempio:Example:
Se dn è "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com", alloraIf dn is "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" then
DNComponentRev([dn],3)
DNComponentRev([dn],1,"DC")
restituiscono entrambi US.Both return US.


ErroreError

Descrizione:Description:
La funzione Error viene usata per restituire un errore personalizzato.The Error function is used to return a custom error.

Sintassi:Syntax:
void Error(str ErrorMessage)

Esempio:Example:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Se l'attributo accountName non è presente, viene generato un errore nell'oggetto.If the attribute accountName is not present, throw an error on the object.


EscapeDNComponentEscapeDNComponent

Descrizione:Description:
La funzione EscapeDNComponent accetta un componente di un DN e inserisce un carattere di escape per consentirne la rappresentazione in LDAP.The EscapeDNComponent function takes one component of a DN and escapes it so it can be represented in LDAP.

Sintassi:Syntax:
str EscapeDNComponent(str value)

Esempio:Example:
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%)
Verifica che sia possibile creare l'oggetto in una directory LDAP, anche se l'attributo displayName include caratteri che devono essere preceduti da un carattere di escape in LDAP.Makes sure the object can be created in an LDAP directory even if the displayName attribute has characters that must be escaped in LDAP.


FormatDateTimeFormatDateTime

Descrizione:Description:
La funzione FormatDateTime viene usata per formattare un valore di data/ora in una stringa con un formato specificato.The FormatDateTime function is used to format a DateTime to a string with a specified format

Sintassi:Syntax:
str FormatDateTime(dt value, str format)

  • value: valore nel formato di data/oravalue: a value in the DateTime format
  • format: stringa che rappresenta il formato in cui effettuare la conversione.format: a string representing the format to convert to.

Osservazioni:Remarks:
I valori possibili per il formato sono disponibili qui: Formati di data/ora definiti dall'utente (funzione Format)The possible values for the format can be found here: User-Defined Date/Time Formats (Format Function)

Esempio:Example:

FormatDateTime(CDate("12/25/2007"),"yyyy-mm-dd")
Il risultato è "2007-12-25".Results in "2007-12-25".

FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")
Può restituire "20140905081453.0Z"Can result in "20140905081453.0Z"


GuidGuid

Descrizione:Description:
La funzione Guid genera un nuovo GUID casualeThe function Guid generates a new random GUID

Sintassi:Syntax:
str Guid()


IIFIIF

Descrizione:Description:
La funzione IIF restituisce uno dei possibili valori di un set, in base a una condizione specificata.The IIF function returns one of a set of possible values based on a specified condition.

Sintassi:Syntax:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)

  • condition: qualsiasi valore o espressione che possa restituire true o false.condition: any value or expression that can be evaluated to true or false.
  • valueIfTrue: se la condizione restituisce true, il valore restituito.valueIfTrue: If the condition evaluates to true, the returned value.
  • valueIfFalse: se la condizione restituisce false, il valore restituito.valueIfFalse: If the condition evaluates to false, the returned value.

Esempio:Example:
IIF([employeeType]="Intern","t-" & [alias],[alias])
Se l'utente è uno stagista, restituisce l'alias di un utente, aggiungendo "t-" all'inizio. In caso contrario restituisce l'alias dell'utente invariato.If the user is an intern, returns the alias of a user with "t-" added to the beginning of it, else returns the user’s alias as is.


InStrInStr

Descrizione:Description:
La funzione InStr trova la prima occorrenza di una sottostringa in una stringa.The InStr function finds the first occurrence of a substring in a string

Sintassi:Syntax:

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: stringa da cercarestringcheck: string to be searched
  • stringmatch: stringa da trovarestringmatch: string to be found
  • start: posizione iniziale per la ricerca della sottostringastart: starting position to find the substring
  • compare: vbTextCompare o vbBinaryComparecompare: vbTextCompare or vbBinaryCompare

Osservazioni:Remarks:
Restituisce la posizione in cui è stata trovata la sottostringa o 0 se non viene trovata.Returns the position where the substring was found or 0 if not found.

Esempio:Example:
InStr("The quick brown fox","quick")
Restituisce 5Evalues to 5

InStr("repEated","e",3,vbBinaryCompare)
Restituisce 7Evaluates to 7


InStrRevInStrRev

Descrizione:Description:
La funzione InStrRev trova l'ultima occorrenza di una sottostringa in una stringa.The InStrRev function finds the last occurrence of a substring in a string

Sintassi:Syntax:
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: stringa da cercarestringcheck: string to be searched
  • stringmatch: stringa da trovarestringmatch: string to be found
  • start: posizione iniziale per la ricerca della sottostringastart: starting position to find the substring
  • compare: vbTextCompare o vbBinaryComparecompare: vbTextCompare or vbBinaryCompare

Osservazioni:Remarks:
Restituisce la posizione in cui è stata trovata la sottostringa o 0 se non viene trovata.Returns the position where the substring was found or 0 if not found.

Esempio:Example:
InStrRev("abbcdbbbef","bb")
Restituisce 7Returns 7


IsBitSetIsBitSet

Descrizione:Description:
La funzione IsBitSet verifica se un bit è o non è impostato.The function IsBitSet Tests if a bit is set or not

Sintassi:Syntax:
bool IsBitSet(num value, num flag)

  • value: valore numerico valutato. flag: valore numerico contenente il bit da valutarevalue: a numeric value that is evaluated.flag: a numeric value that has the bit to be evaluated

Esempio:Example:
IsBitSet(&HF,4)
Restituisce True perché il bit "4" è impostato come valore esadecimale "F"Returns True because bit "4" is set in the hexadecimal value "F"


IsDateIsDate

Descrizione:Description:
Se l'espressione può essere valutata come tipo di data/ora, la funzione IsDate restituisce True.If the expression can be evaluates as a DateTime type, then the IsDate function evaluates to True.

Sintassi:Syntax:
bool IsDate(var Expression)

Osservazioni:Remarks:
Usata per determinare se CDate() riuscirà.Used to determine if CDate() can be successful.


IsCertIsCert

Descrizione:Description:
Restituisce true se i dati non elaborati possono essere serializzati nell'oggetto certificato X509Certificate2 di .NET.Returns true if the raw data can be serialized into .NET X509Certificate2 certificate object.

Sintassi:Syntax:
bool CertThumbprint(binary certificateRawData)

  • certificateRawData: rappresentazione in forma di matrice di byte di un certificato X.509.certificateRawData: Byte array representation of an X.509 certificate. La matrice di byte può essere costituita da dati X.509 in codifica binaria (DER) o Base64.The byte array can be binary (DER) encoded or Base64-encoded X.509 data.

IsEmptyIsEmpty

Descrizione:Description:
Se l'attributo è presente in CS o MV, ma restituisce una stringa vuota, la funzione IsEmpty restituisce True.If the attribute is present in the CS or MV but evaluates to an empty string, then the IsEmpty function evaluates to True.

Sintassi:Syntax:
bool IsEmpty(var Expression)


IsGuidIsGuid

Descrizione:Description:
Se la stringa può essere convertita in un GUID, la funzione IsGuid restituisce True.If the string could be converted to a GUID, then the IsGuid function evaluated to true.

Sintassi:Syntax:
bool IsGuid(str GUID)

Osservazioni:Remarks:
Un GUID viene definito come stringa in base a uno degli schemi seguenti: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx o {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}A GUID is defined as a string following one of these patterns: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx or {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Usata per determinare se CGuid() riuscirà.Used to determine if CGuid() can be successful.

Esempio:Example:
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)
Se StrAttribute ha un formato GUID, restituisce una rappresentazione binaria. In caso contrario restituisce Null.If the StrAttribute has a GUID format, return a binary representation, otherwise return a Null.


IsNullIsNull

Descrizione:Description:
Se l'espressione restituisce Null, la funzione IsNull restituisce True.If the expression evaluates to Null, then the IsNull function returns true.

Sintassi:Syntax:
bool IsNull(var Expression)

Osservazioni:Remarks:
Per un attributo, Null è espresso dall'assenza dell'attributo.For an attribute, a Null is expressed by the absence of the attribute.

Esempio:Example:
IsNull([displayName])
Restituisce True se l'attributo non è presente in CS o MV.Returns True if the attribute is not present in the CS or MV.


IsNullOrEmptyIsNullOrEmpty

Descrizione:Description:
Se l'espressione è Null o una stringa vuota, la funzione IsNullOrEmpty restituisce True.If the expression is null or an empty string, then the IsNullOrEmpty function returns true.

Sintassi:Syntax:
bool IsNullOrEmpty(var Expression)

Osservazioni:Remarks:
Per un attributo, verrà restituito True se l'attributo è assente oppure se è presente, ma è una stringa vuota.For an attribute, this would evaluate to True if the attribute is absent or is present but is an empty string.
La funzione inversa di questa funzione è denominata IsPresent.The inverse of this function is named IsPresent.

Esempio:Example:
IsNullOrEmpty([displayName])
Restituisce True se l'attributo non è presente oppure è una stringa vuota in CS o MV.Returns True if the attribute is not present or is an empty string in the CS or MV.


IsNumericIsNumeric

Descrizione:Description:
La funzione IsNumeric restituisce un valore booleano che indica se un'espressione può essere valutata come tipo di numero.The IsNumeric function returns a Boolean value indicating whether an expression can be evaluated as a number type.

Sintassi:Syntax:
bool IsNumeric(var Expression)

Osservazioni:Remarks:
Usata per determinare se CNum() riuscirà ad analizzare l'espressione.Used to determine if CNum() can be successful to parse the expression.


IsStringIsString

Descrizione:Description:
Se l'espressione può essere valutata come tipo stringa, la funzione IsString restituisce True.If the expression can be evaluated to a string type, then the IsString function evaluates to True.

Sintassi:Syntax:
bool IsString(var expression)

Osservazioni:Remarks:
Usata per determinare se CStr() riuscirà ad analizzare l'espressione.Used to determine if CStr() can be successful to parse the expression.


IsPresentIsPresent

Descrizione:Description:
Se l'espressione restituisce una stringa non Null e non vuota, la funzione IsPresent restituisce True.If the expression evaluates to a string that is not Null and is not empty, then the IsPresent function returns true.

Sintassi:Syntax:
bool IsPresent(var expression)

Osservazioni:Remarks:
La funzione inversa di questa funzione è denominata IsNullOrEmpty.The inverse of this function is named IsNullOrEmpty.

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


ElementoItem

Descrizione:Description:
La funzione Item restituisce un elemento da una stringa o un attributo multivalore.The Item function returns one item from a multi-valued string/attribute.

Sintassi:Syntax:
var Item(mvstr attribute, num index)

  • attribute: attributo multivaloreattribute: multi-valued attribute
  • index: indice di un elemento nella stringa multivalore.index: index to an item in the multi-valued string.

Osservazioni:Remarks:
La funzione Item usata con la funzione Contains è utile, perché quest'ultima restituisce l'indice di un elemento nell'attributo multivalore.The Item function is useful together with the Contains function since the latter function returns the index to an item in the multi-valued attribute.

Genera un errore se l'indice non è compreso nell'intervallo.Throws an error if index is out of bounds.

Esempio:Example:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Restituisce l'indirizzo di posta elettronica primario.Returns the primary email address.


ItemOrNullItemOrNull

Descrizione:Description:
La funzione ItemOrNull restituisce un elemento da una stringa o un attributo multivalore.The ItemOrNull function returns one item from a multi-valued string/attribute.

Sintassi:Syntax:
var ItemOrNull(mvstr attribute, num index)

  • attribute: attributo multivaloreattribute: multi-valued attribute
  • index: indice di un elemento nella stringa multivalore.index: index to an item in the multi-valued string.

Osservazioni:Remarks:
La funzione ItemOrNull usata con la funzione Contains è utile, perché quest'ultima restituisce l'indice di un elemento nell'attributo multivalore.The ItemOrNull function is useful together with the Contains function since the latter function returns the index to an item in the multi-valued attribute.

Se l'indice non è compreso nell'intervallo, restituisce un valore Null.If index is out of bounds, then returns a Null value.


JoinJoin

Descrizione:Description:
La funzione Join accetta una stringa multivalore e restituisce una stringa a valore singolo con il separatore specificato inserito tra ogni elemento.The Join function takes a multi-valued string and returns a single-valued string with specified separator inserted between each item.

Sintassi:Syntax:
str Join(mvstr attribute)
str Join(mvstr attribute, str Delimiter)

  • attribute: attributo multivalore contenente stringhe da unire.attribute: Multi-valued attribute containing strings to be joined.
  • delimiter: qualsiasi stringa usata per separare le sottostringhe nella stringa restituita.delimiter: Any string, used to separate the substrings in the returned string. Se omessa, viene usato uno spazio (" ").If omitted, the space character (" ") is used. Se Delimiter è una stringa di lunghezza zero ("") o Nothing, tutti gli elementi nell'elenco vengono concatenati senza delimitatori.If Delimiter is a zero-length string ("") or Nothing, all items in the list are concatenated with no delimiters.

Osservazioni:Remarks
Esiste un'analogia tra le funzioni Join e Split.There is parity between the Join and Split functions. La funzione Join accetta una matrice di stringhe e le unisce usando una stringa delimitatore per restituire una singola stringa.The Join function takes an array of strings and joins them using a delimiter string, to return a single string. La funzione Split accetta una stringa e la separa in corrispondenza del delimitatore per restituire una matrice di stringhe.The Split function takes a string and separates it at the delimiter, to return an array of strings. Tuttavia, la differenza principale consiste nel fatto che Join può concatenare stringhe con qualsiasi stringa delimitatore, mentre Split può separare stringhe usando unicamente un delimitatore di un solo carattere.However, a key difference is that Join can concatenate strings with any delimiter string, Split can only separate strings using a single character delimiter.

Esempio:Example:
Join([proxyAddresses],",")
Può restituire: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"Could return: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"


LCaseLCase

Descrizione:Description:
La funzione LCase converte tutti i caratteri in una stringa in lettere minuscole.The LCase function converts all characters in a string to lower case.

Sintassi:Syntax:
str LCase(str value)

Esempio:Example:
LCase("TeSt")
Restituisce "test".Returns "test".


LeftLeft

Descrizione:Description:
La funzione Left restituisce un numero di caratteri specificato a partire da sinistra di una stringa.The Left function returns a specified number of characters from the left of a string.

Sintassi:Syntax:
str Left(str string, num NumChars)

  • string: stringa dalla quale restituire i caratteristring: the string to return characters from
  • NumChars: numero che identifica il numero di caratteri da restituire dall'inizio (sinistra) della stringaNumChars: a number identifying the number of characters to return from the beginning (left) of string

Osservazioni:Remarks:
Una stringa contenente i primi caratteri numChars della stringa:A string containing the first numChars characters in string:

  • Se numChars = 0, restituisce una stringa vuota.If numChars = 0, return empty string.
  • Se numChars < 0, restituisce una stringa di input.If numChars < 0, return input string.
  • Se string è Null, restituisce una stringa vuota.If string is null, return empty string.

Se string contiene un numero di caratteri inferiore al numero specificato in numChars, viene restituita una stringa identica a string (ovvero contenente tutti i caratteri nel parametro 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.

Esempio:Example:
Left("John Doe", 3)
Restituisce "Joh".Returns "Joh".


LenLen

Descrizione:Description:
La funzione Len restituisce il numero di caratteri in una stringa.The Len function returns number of characters in a string.

Sintassi:Syntax:
num Len(str value)

Esempio:Example:
Len("John Doe")
Restituisce 8Returns 8


LTrimLTrim

Descrizione:Description:
La funzione LTrim rimuove gli spazi vuoti iniziali da una stringa.The LTrim function removes leading white spaces from a string.

Sintassi:Syntax:
str LTrim(str value)

Esempio:Example:
LTrim(" Test ")
Restituisce "Test"Returns "Test "


MidMid

Descrizione:Description:
La funzione Mid restituisce un numero di caratteri specificato a partire da una posizione specificata di una stringa.The Mid function returns a specified number of characters from a specified position in a string.

Sintassi:Syntax:
str Mid(str string, num start, num NumChars)

  • string: stringa dalla quale restituire i caratteristring: the string to return characters from
  • start: numero che identifica la posizione in una stringa dalla quale iniziare a restituire caratteristart: a number identifying the starting position in string to return characters from
  • NumChars: numero che identifica il numero di caratteri da restituire dalla posizione nella stringaNumChars: a number identifying the number of characters to return from position in string

Osservazioni:Remarks:
Restituisce i caratteri in numChars a partire dalla posizione start nella stringa.Return numChars characters starting from position start in string.
Stringa contenente i caratteri specificati in numChars a partire dalla posizione start nella stringa:A string containing numChars characters from position start in string:

  • Se numChars = 0, restituisce una stringa vuota.If numChars = 0, return empty string.
  • Se numChars < 0, restituisce una stringa di input.If numChars < 0, return input string.
  • Se start è > della lunghezza della stringa, restituisce la stringa di input.If start > the length of string, return input string.
  • Se start <= 0, restituisce la stringa di input.If start <= 0, return input string.
  • Se string è Null, restituisce una stringa vuota.If string is null, return empty string.

Se nella stringa non ci sono caratteri numChar rimanenti dalla posizione start, vengono restituiti quanti più caratteri possibile.If there are not numChar characters remaining in string from position start, as many characters as possible are returned.

Esempio:Example:
Mid("John Doe", 3, 5)
Restituisce "hn Do".Returns "hn Do".

Mid("John Doe", 6, 999)
Restituisce "Doe"Returns "Doe"


NowNow

Descrizione:Description:
La funzione Now restituisce un valore di data/ora che specifica la data e l'ora correnti, in base alla data e all'ora di sistema del computer.The Now function returns a DateTime specifying the current date and time, according to your computer's system date and time.

Sintassi:Syntax:
dt Now()


NumFromDateNumFromDate

Descrizione:Description:
La funzione NumFromDate restituisce una data nel formato di AD.The NumFromDate function returns a date in AD’s date format.

Sintassi:Syntax:
num NumFromDate(dt value)

Esempio:Example:
NumFromDate(CDate("2012-01-01 23:00:00"))
Restituisce 129699324000000000Returns 129699324000000000


PadLeftPadLeft

Descrizione:Description:
La funzione PadLeft aggiunge a sinistra di una stringa il carattere di riempimento specificato, fino alla lunghezza indicata.The PadLeft function left-pads a string to a specified length using a provided padding character.

Sintassi:Syntax:
str PadLeft(str string, num length, str padCharacter)

  • string: stringa da riempire.string: the string to pad.
  • length: intero che rappresenta la lunghezza della stringa desiderata.length: An integer representing the desired length of string.
  • padCharacter: stringa costituita da un singolo carattere da usare come carattere di riempimentopadCharacter: A string consisting of a single character to use as the pad character

Osservazioni:Remarks:

  • Se la lunghezza di string è minore di length, padCharacter viene aggiunto ripetutamente all'inizio (sinistra) di string finché avrà una lunghezza uguale a length.If the length of string is less than length, then padCharacter is repeatedly appended to the beginning (left) of string until it has a length equal to length.
  • PadCharacter può essere uno spazio, ma non un valore null.PadCharacter can be a space character, but it cannot be a null value.
  • Se la lunghezza di string è uguale a o maggiore di length, la stringa viene restituita invariata.If the length of string is equal to or greater than length, string is returned unchanged.
  • Se string ha una lunghezza maggiore di o uguale a length, viene restituita una stringa identica a string.If string has a length greater than or equal to length, a string identical to string is returned.
  • Se la lunghezza di string è minore di length, viene restituita una nuova stringa con la lunghezza desiderata contenente il valore di string con l'aggiunta di padCharacter.If the length of string is less than length, then a new string of the desired length is returned containing string padded with a padCharacter.
  • Se la stringa è Null, la funzione restituisce una stringa vuota.If string is null, the function returns an empty string.

Esempio:Example:
PadLeft("User", 10, "0")
Restituisce "000000User".Returns "000000User".


PadRightPadRight

Descrizione:Description:
La funzione PadRight aggiunge a destra di una stringa il carattere di riempimento specificato, fino alla lunghezza indicata.The PadRight function right-pads a string to a specified length using a provided padding character.

Sintassi:Syntax:
str PadRight(str string, num length, str padCharacter)

  • string: stringa da riempire.string: the string to pad.
  • length: intero che rappresenta la lunghezza della stringa desiderata.length: An integer representing the desired length of string.
  • padCharacter: stringa costituita da un singolo carattere da usare come carattere di riempimentopadCharacter: A string consisting of a single character to use as the pad character

Osservazioni:Remarks:

  • Se la lunghezza di string è minore di length, padCharacter viene aggiunto ripetutamente alla fine (destra) di string finché avrà una lunghezza uguale a length.If the length of string is less than length, then padCharacter is repeatedly appended to the end (right) of string until it has a length equal to length.
  • PadCharacter può essere uno spazio, ma non un valore null.padCharacter can be a space character, but it cannot be a null value.
  • Se la lunghezza di string è uguale a o maggiore di length, la stringa viene restituita invariata.If the length of string is equal to or greater than length, string is returned unchanged.
  • Se string ha una lunghezza maggiore di o uguale a length, viene restituita una stringa identica a string.If string has a length greater than or equal to length, a string identical to string is returned.
  • Se la lunghezza di string è minore di length, viene restituita una nuova stringa con la lunghezza desiderata contenente il valore di string con l'aggiunta di padCharacter.If the length of string is less than length, then a new string of the desired length is returned containing string padded with a padCharacter.
  • Se la stringa è Null, la funzione restituisce una stringa vuota.If string is null, the function returns an empty string.

Esempio:Example:
PadRight("User", 10, "0")
Restituisce "User000000".Returns "User000000".


PCasePCase

Descrizione:Description:
La funzione PCase converte in maiuscolo il primo carattere di ogni parola delimitata da spazi contenuta in una stringa, mentre tutti gli altri caratteri vengono convertiti in minuscolo.The PCase function converts the first character of each space delimited word in a string to upper case, and all other characters are converted to lower case.

Sintassi:Syntax:
String PCase(string)

Osservazioni:Remarks:

  • Questa funzione attualmente non offre una corretta conversione di maiuscole e minuscole in caso di parola interamente in maiuscolo, come un acronimo.This function does not currently provide proper casing to convert a word that is entirely uppercase, such as an acronym.

Esempio:Example:
PCase("TEsT")
Restituisce "test".Returns "Test".

PCase(LCase("TEST"))
Restituisce "Test"Returns "Test"


RandomNumRandomNum

Descrizione:Description:
La funzione RandomNum restituisce un numero casuale compreso in un intervallo specificato.The RandomNum function returns a random number between a specified interval.

Sintassi:Syntax:
num RandomNum(num start, num end)

  • start: numero che identifica il limite inferiore del valore casuale da generarestart: a number identifying the lower limit of the random value to generate
  • end: numero che identifica il limite superiore del valore casuale da generareend: a number identifying the upper limit of the random value to generate

Esempio:Example:
Random(100,999)
Può restituire 734.Can return 734.


RemoveDuplicatesRemoveDuplicates

Descrizione:Description:
La funzione RemoveDuplicates accetta una stringa multivalore e verifica che ogni valore sia univoco.The RemoveDuplicates function takes a multi-valued string and make sure each value is unique.

Sintassi:Syntax:
mvstr RemoveDuplicates(mvstr attribute)

Esempio:Example:
RemoveDuplicates([proxyAddresses])
Restituisce un attributo proxyAddress purificato in cui sono stati rimossi tutti i valori duplicati.Returns a sanitized proxyAddress attribute where all duplicate values have been removed.


ReplaceReplace

Descrizione:Description:
La funzione Replace sostituisce tutte le occorrenze di una stringa in un'altra stringa.The Replace function replaces all occurrences of a string to another string.

Sintassi:Syntax:
str Replace(str string, str OldValue, str NewValue)

  • string: stringa in cui sostituire i valori.string: A string to replace values in.
  • OldValue: stringa da cercare e sostituire.OldValue: The string to search for and to replace.
  • NewValue: stringa oggetto della sostituzione.NewValue: The string to replace to.

Osservazioni:Remarks:
La funzione riconosce i moniker speciali seguenti:The function recognizes the following special monikers:

  • \n - Nuova riga\n – New Line
  • \r - Ritorno a capo\r – Carriage Return
  • \t - Tabulazione\t – Tab

Esempio:Example:
Replace([address],"\r\n",", ")
Sostituisce CRLF con una virgola e uno spazio e può generare "One Microsoft Way, Redmond, WA, USA"Replaces CRLF with a comma and space, and could lead to "One Microsoft Way, Redmond, WA, USA"


ReplaceCharsReplaceChars

Descrizione:Description:
La funzione ReplaceChars sostituisce tutte le occorrenze dei caratteri trovati nella stringa ReplacePattern.The ReplaceChars function replaces all occurrences of characters found in the ReplacePattern string.

Sintassi:Syntax:
str ReplaceChars(str string, str ReplacePattern)

  • string: stringa in cui sostituire i caratteri.string: A string to replace characters in.
  • ReplacePattern: stringa contenente un dizionario con i caratteri da sostituire.ReplacePattern: a string containing a dictionary with characters to replace.

Il formato è {source1}:{target1},{source2}:{target2},{sourceN},{targetN} dove source è il carattere da trovare e target la stringa con cui sostituirlo.The format is {source1}:{target1},{source2}:{target2},{sourceN},{targetN} where source is the character to find and target the string to replace with.

Osservazioni:Remarks:

  • La funzione accetta ogni occorrenza delle origini definite e le sostituisce con le destinazioni.The function takes each occurrence of defined sources and replaces them with the targets.
  • Source deve corrispondere esattamente a un carattere (Unicode).The source must be exactly one (unicode) character.
  • Source non può essere una stringa vuota e non può essere più lunga di un carattere (errore di analisi).The source cannot be empty or longer than one character (parsing error).
  • Il target può contenere più caratteri, ad esempio ö:oe, β:ss.The target can have multiple characters, for example ö:oe, β:ss.
  • Target può essere una stringa vuota, per indicare che il carattere deve essere rimosso.The target can be empty indicating that the character should be removed.
  • Source fa distinzione tra maiuscole e minuscole e deve essere una corrispondenza esatta.The source is case-sensitive and must be an exact match.
  • I caratteri , (virgola) e : (due punti) sono riservati e non possono essere sostituiti usando questa funzione.The , (comma) and : (colon) are reserved characters and cannot be replaced using this function.
  • Spazi e altri caratteri vuoti nella stringa ReplacePattern vengono ignorati.Spaces and other white characters in the ReplacePattern string are ignored.

Esempio:Example:
%ReplaceString% = ’:,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o

ReplaceChars("Räksmörgås",%ReplaceString%)
Restituisce RaksmorgasReturns Raksmorgas

ReplaceChars("O’Neil",%ReplaceString%)
Restituisce "ONeil". Viene definita la rimozione della virgoletta singola.Returns "ONeil", the single tick is defined to be removed.


Descrizione:Description:
La funzione Right restituisce un numero di caratteri specificato a partire dalla destra (fine) di una stringa.The Right function returns a specified number of characters from the right (end) of a string.

Sintassi:Syntax:
str Right(str string, num NumChars)

  • string: stringa dalla quale restituire i caratteristring: the string to return characters from
  • NumChars: numero che identifica il numero di caratteri da restituire dalla fine (destra) della stringaNumChars: a number identifying the number of characters to return from the end (right) of string

Osservazioni:Remarks:
I caratteri NumChars vengono restituiti dall'ultima posizione della stringa.NumChars characters are returned from the last position of string.

Stringa contenente gli ultimi caratteri numChars in string:A string containing the last numChars characters in string:

  • Se numChars = 0, restituisce una stringa vuota.If numChars = 0, return empty string.
  • Se numChars < 0, restituisce una stringa di input.If numChars < 0, return input string.
  • Se string è Null, restituisce una stringa vuota.If string is null, return empty string.

Se string contiene un numero di caratteri inferiore al numero specificato in NumChars, viene restituita una stringa identica a string.If string contains fewer characters than the number specified in NumChars, a string identical to string is returned.

Esempio:Example:
Right("John Doe", 3)
Restituisce "Doe".Returns "Doe".


RTrimRTrim

Descrizione:Description:
La funzione RTrim rimuove gli spazi vuoti finali da una stringa.The RTrim function removes trailing white spaces from a string.

Sintassi:Syntax:
str RTrim(str value)

Esempio:Example:
RTrim(" Test ")
Restituisce "test".Returns " Test".


SelezionareSelect

Descrizione:Description:
Elabora tutti i valori in un attributo multivalore, o nell'output di un'espressione, in base alla funzione specificata.Process all values in a multi-valued attribute (or output of an expression) based on function specified.

Sintassi:Syntax:
mvattr Select(variable item, mvattr attribute, func function)
mvattr Select(variable item, exp expression, func function)

  • item: rappresenta un elemento nell'attributo multivaloreitem: Represents an element in the multi-valued attribute
  • attribute: l'attributo multivaloreattribute: the multi-valued attribute
  • expression: un'espressione che restituisce una raccolta di valoriexpression: an expression that returns a collection of values
  • condition: qualsiasi funzione in grado di elaborare un elemento nell'attributocondition: any function that can process an item in the attribute

Esempi:Examples:
Select($item,[otherPhone],Replace($item,"-",""))
Restituisce tutti i valori dell'attributo multivalore otherPhone dopo che sono stati rimossi i trattini (-).Return all the values in the multi-valued attribute otherPhone after hyphens (-) have been removed.


SplitSplit

Descrizione:Description:
La funzione Split accetta una stringa con valori separati da delimitatore e la converte in una stringa multivalore.The Split function takes a string separated with a delimiter and makes it a multi-valued string.

Sintassi:Syntax:
mvstr Split(str value, str delimiter)
mvstr Split(str value, str delimiter, num limit)

  • value: stringa con un carattere delimitatore da separare.value: the string with a delimiter character to separate.
  • delimiter: singolo carattere da usare come delimitatore.delimiter: single character to be used as the delimiter.
  • limit: numero massimo di valori che saranno restituiti.limit: maximum number of values that can return.

Esempio:Example:
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")
Restituisce una stringa multivalore con 2 elementi utili per l'attributo proxyAddress.Returns a multi-valued string with 2 elements useful for the proxyAddress attribute.


StringFromGuidStringFromGuid

Descrizione:Description:
La funzione StringFromGuid accetta un GUID binario e lo converte in una stringa.The StringFromGuid function takes a binary GUID and converts it to a string

Sintassi:Syntax:
str StringFromGuid(bin GUID)


StringFromSidStringFromSid

Descrizione:Description:
La funzione StringFromSid converte una matrice di byte contenente un ID di sicurezza in una stringa.The StringFromSid function converts a byte array containing a security identifier to a string.

Sintassi:Syntax:
str StringFromSid(bin ObjectSID)


SwitchSwitch

Descrizione:Description:
La funzione Switch viene usata per restituire un singolo valore basato sulle condizioni valutate.The Switch function is used to return a single value based on evaluated conditions.

Sintassi:Syntax:
var Switch(exp expr1, var value1[, exp expr2, var value … [, exp expr, var valueN]])

  • expr: espressione di tipo variant da valutare.expr: Variant expression you want to evaluate.
  • value: valore da restituire se l'espressione corrispondente è True.value: Value to be returned if the corresponding expression is True.

Osservazioni:Remarks:
L'elenco di argomenti della funzione Switch è costituito da coppie di espressioni e valori.The Switch function argument list consists of pairs of expressions and values. Le espressioni vengono valutate da sinistra a destra e viene restituito il valore associato alla prima espressione valutata in True.The expressions are evaluated from left to right, and the value associated with the first expression to evaluate to True is returned. Se le parti non vengono accoppiate correttamente, si verifica un errore di runtime.If the parts aren't properly paired, a run-time error occurs.

Ad esempio, se expr1 è True, Switch restituisce value1.For example, if expr1 is True, Switch returns value1. Se expr-1 è False, ma expr-2 è True, Switch restituisce value-2 e così via.If expr-1 is False, but expr-2 is True, Switch returns value-2, and so on.

Switch restituisce Nothing se:Switch returns a Nothing if:

  • Nessuna espressione è True.None of the expressions are True.
  • La prima espressione True ha un valore corrispondente Null.The first True expression has a corresponding value that is Null.

Switch valuta tutte le espressioni, anche se ne restituisce una sola.Switch evaluates all expressions, even though it returns only one of them. Per questo motivo, è opportuno considerare attentamente gli effetti collaterali indesiderati.For this reason, you should watch for undesirable side effects. Ad esempio, se la valutazione di un'espressione restituisce un errore di divisione per zero, viene generato un errore.For example, if the evaluation of any expression results in a division by zero error, an error occurs.

Value può anche essere la funzione Error che restituirà una stringa personalizzata.Value can also be the Error function, which would return a custom string.

Esempio:Example:
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))
Restituisce la lingua parlata in alcune città importanti. In caso contrario restituisce un errore.Returns the language spoken in some major cities, otherwise returns an Error.


TrimTrim

Descrizione:Description:
La funzione Trim rimuove gli spazi vuoti iniziali e finali da una stringa.The Trim function removes leading and trailing white spaces from a string.

Sintassi:Syntax:
str Trim(str value)

Esempio:Example:
Trim(" Test ")
Restituisce "test".Returns "Test".

Trim([proxyAddresses])
Rimuove gli spazi iniziali e finali per ogni valore nell'attributo proxyAddress.Removes leading and trailing spaces for each value in the proxyAddress attribute.


UCaseUCase

Descrizione:Description:
La funzione UCase converte tutti i caratteri in una stringa in lettere maiuscole.The UCase function converts all characters in a string to upper case.

Sintassi:Syntax:
str UCase(str string)

Esempio:Example:
UCase("TeSt")
Restituisce "test".Returns "TEST".


WhereWhere

Descrizione:Description:
Restituisce un subset di valori di un attributo multivalore, o dell'output di un'espressione, in base alla condizione specifica.Returns a subset of values from a multi-valued attribute (or output of an expression) based on specific condition.

Sintassi:Syntax:
mvattr Where(variable item, mvattr attribute, exp condition)
mvattr Where(variable item, exp expression, exp condition)

  • item: rappresenta un elemento nell'attributo multivaloreitem: Represents an element in the multi-valued attribute
  • attribute: l'attributo multivaloreattribute: the multi-valued attribute
  • condition: qualsiasi espressione che possa restituire true o falsecondition: any expression that can be evaluated to true or false
  • expression: un'espressione che restituisce una raccolta di valoriexpression: an expression that returns a collection of values

Esempio:Example:
Where($item,[userCertificate],CertNotAfter($item)>Now())
Restituisce i valori del certificato non scaduti nell'attributo multivalore userCertificate.Return the certificate values in the multi-valued attribute userCertificate which aren’t expired.


WithWith

Descrizione:Description:
La funzione With consente di semplificare un'espressione complessa usando una variabile per rappresentare una sottoespressione che appare una o più volte nell'espressione complessa.The With function provides a way to simplify a complex expression by using a variable to represent a subexpression which appears one or more times in the complex expression.

Sintassi With(var variable, exp subExpression, exp complexExpression)Syntax: With(var variable, exp subExpression, exp complexExpression)

  • variable: rappresenta la sottoespressione.variable: Represents the subexpression.
  • subExpression: sottoespressione rappresentata dalla variabile.subExpression: subexpression represented by variable.
  • complexExpression: un'espressione complessa.complexExpression: A complex expression.

Esempio:Example:
With($unExpiredCerts,Where($item,[userCertificate],CertNotAfter($item)>Now()),IIF(Count($unExpiredCerts)>0,$unExpiredCerts,NULL))
Dal punto di vista funzionale equivale a:Is functionally equivalent to:
IIF (Count(Where($item,[userCertificate],CertNotAfter($item)>Now()))>0, Where($item,[userCertificate],CertNotAfter($item)>Now()),NULL)
Che restituisce solo i valori del certificato non scaduti nell'attributo userCertificate.Which returns only unexpired certificate values in the userCertificate attribute.


WordWord

Descrizione:Description:
La funzione Word restituisce una parola contenuta in una stringa, in base ai parametri che descrivono i delimitatori da usare e il numero della parola da restituire.The Word function returns a word contained within a string, based on parameters describing the delimiters to use and the word number to return.

Sintassi:Syntax:
str Word(str string, num WordNumber, str delimiters)

  • string: stringa dalla quale restituire una parola.string: the string to return a word from.
  • WordNumber: numero che identifica il numero di parole da restituire.WordNumber: a number identifying which word number should return.
  • delimiters: stringa che rappresenta uno o più delimitatori da usare per identificare le paroledelimiters: a string representing the delimiter(s) that should be used to identify words

Osservazioni:Remarks:
Ogni stringa di caratteri contenuta nella stringa con valori separati da uno dei caratteri specificati nei delimitatori viene identificata come una parola:Each string of characters in string separated by the one of the characters in delimiters are identified as words:

  • Se number è < 1, restituisce una stringa vuota.If number < 1, returns empty string.
  • Se string è Null, restituisce una stringa vuota.If string is null, returns empty string.

Se la stringa contiene meno delle parole specificate in number o se non contiene alcuna parola identificata da delimiters, viene restituita una stringa vuota.If string contains less than number words, or string does not contain any words identified by delimiters, an empty string is returned.

Esempio:Example:
Word("The quick brown fox",3," ")
Restituisce "brown"Returns "brown"

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

Risorse aggiuntiveAdditional Resources