Referenční informace ke službě Azure Active Directory Sync Functions
Aktualizováno: 22. července 2015
Důležitý
Toto téma bude brzy archivováno.
Existuje nový produkt s názvem "Azure Active Directory Connect", který nahrazuje AADSync a DirSync.
Azure AD Connect zahrnuje komponenty a funkce, které byly dříve vydány jako Dirsync a AAD Sync.
V budoucnu skončí podpora nástroje Dirsync a AAD Sync.
Tyto nástroje se už neaktualizují jednotlivě pomocí vylepšení funkcí a všechna budoucí vylepšení budou součástí aktualizací služby Azure AD Connect.
Ve službě Azure Active Directory Sync se funkce používají k manipulaci s hodnotou atributu během synchronizace.
Syntaxe funkcí je vyjádřena pomocí následujícího formátu:
<výstupní typ> FunctionName(<typ vstupu><název pozice>, ..)
Pokud je funkce přetížená a přijímá více syntaxí, jsou uvedeny všechny platné syntaxe.
Funkce jsou silného typu a ověřují, že typ předaný v dokumentu odpovídá dokumentu. Pokud se typ neshoduje, vyvolá se chyba.
Typy jsou vyjádřeny následující syntaxí:
bin – binární
bool – logická hodnota
dt – datum a čas UTC
výčtu – výčet známých konstant
exp – výraz, který se má vyhodnotit jako logická hodnota
mvbin – binární soubor s více hodnotami
mvstr – odkaz s více hodnotami
číslo – číselné
referenční – odkaz s jednou hodnotou
str – řetězec s jednou hodnotou
var – varianta (téměř) jakéhokoli jiného typu
void – nevrací hodnotu.
Seznam funkcí
Tato část obsahuje popisy následujících funkcí:
BitAnd
BitOr
CBool
Datum v jazyce CDate
CGuid
Obsahuje
ConvertFromBase64
ConvertFromUTF8Hex
ConvertToBase64
ConvertToUTF8Hex
Počítat
Číslo C
CRef
CStr
DateAdd
DateFromNum
DNComponent
DNComponentRev
Chyba
EscapeDNComponent
FormatDateTime
Identifikátor guid
IIF
Instr
InStrRev
IsBitSet
IsDate
IsEmpty
IsGuid
IsNull
IsNullOrEmpty
IsNumeric
IsString
IsPresent
Položka
ItemOrNull
Připojit
LCase
Vlevo
Len
LTrim
Střední
Teď
NumFromDate
PadLeft
PadRight
PCase
RandomNum
Odebrání duplicitních dat
Nahradit
ReplaceChars
Vpravo
RTrim
Rozdělit
StringFromGuid
StringFromSid
Vypínač
Zastřihnout
UCase
Slovo
BitAnd
popis |
Funkce BitAnd nastaví zadané bity na hodnotu. |
syntaxe |
num BitAnd(num value1; num value2) hodnota1, hodnota2: číselné hodnoty, které by měly být společně |
poznámky |
Tato funkce převede oba parametry na binární reprezentaci a nastaví bit na 0, pokud jeden nebo oba odpovídající bity v masce a příznak jsou 0, a na 1, pokud jsou oba odpovídající bity 1. Jinými slovy, vrátí hodnotu 0 ve všech případech s výjimkou případů, kdy odpovídající bity obou parametrů jsou 1. |
příklad |
BitAnd(&HF; &HF7) Vyhodnotí se jako 7, protože hexadecimální "F" AND "F7" se vyhodnotí na tuto hodnotu. |
BitOr
popis |
Funkce BitOr nastaví zadané bity na hodnotu. |
syntaxe |
num BitOr(num value1; num value2) hodnota1, hodnota2: číselné hodnoty, které by měly být společně |
poznámky |
Tato funkce převede oba parametry na binární reprezentaci a nastaví bit na 1, pokud je jeden nebo oba odpovídající bity v masce a příznaku 1, a na hodnotu 0, pokud jsou oba odpovídající bity 0. Jinými slovy, vrátí hodnotu 1 ve všech případech s výjimkou případů, kdy odpovídající bity obou parametrů jsou 0. |
příklad |
CBool
popis |
Funkce CBool vrátí logickou hodnotu na základě vyhodnoceného výrazu. |
syntaxe |
bool CBool(výraz exp) |
poznámky |
Pokud se výraz vyhodnotí jako nenulová hodnota CBool, vrátí hodnotu True. V opačném případě vrátí hodnotu False. |
příklad |
CBool([attrib1] = [attrib2]) Vrátí hodnotu True, pokud oba atributy mají stejnou hodnotu. |
Datum v jazyce CDate
popis |
Funkce CDate vrátí hodnotu DateTime UTC z řetězce. DateTime není nativní typ atributu v Sync, ale používá některé funkce. |
syntaxe |
dt CDate(str value) Hodnota: Řetězec s datem, časem a volitelným časovým pásmem |
poznámky |
Vrácený řetězec je vždy ve standardu UTC. |
Příklad |
CDate([employeeStartTime]) Vrátí hodnotu DateTime na základě času zahájení zaměstnance. CDate("2013-01-10 13:00 -8") Vrátí hodnotu DateTime představující "2013-01-11 12:00" |
CGuid
popis |
Funkce CGuid převede řetězcovou reprezentaci identifikátoru GUID na binární reprezentaci identifikátoru GUID. |
syntaxe |
bin CGuid(str GUID)GUID: Řetězec formátovaný v tomto vzoru: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx nebo {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} |
poznámky |
|
příklad |
Obsahuje
popis |
Funkce Contains najde řetězec uvnitř atributu s více hodnotami. |
syntaxe |
num Contains (atribut mvstring, str search) // malá a velká písmena num Contains (atribut mvstring, str search, enum Casetype) num Contains (atribut mvref, str search) // malá a velká písmena attribute: atribut s více hodnotami, který se má prohledávat. Hledání: řetězec, který se má v atributu najít. Casetype: CaseInsensitive or CaseSensitive Vrátí index v atributu s více hodnotami, ve kterém byl řetězec nalezen. Pokud řetězec nebyl nalezen, vrátí se hodnota 0. |
poznámky |
U atributů řetězce s více hodnotami hledání vyhledá podřetězce v hodnotách. Pro referenční atributy musí hledaný řetězec přesně odpovídat hodnotě, která má být považována za shodu. |
příklad |
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("Nebyla nalezena primární adresa SMTP.")) Pokud má atribut proxyAddresses primární e-mailovou adresu (označenou velkým písmenem SMTP:), vraťte atribut proxyAddress, jinak vraťte chybu. |
ConvertFromBase64
popis |
Funkce ConvertFromBase64 převede zadanou hodnotu s kódováním base64 na běžný řetězec. |
syntaxe |
str ConvertFromBase64(str source) // předpokládá kódování Unicode. str ConvertFromBase64(str source, enum Encoding) Zdroj: Řetězec kódovaný v Base64 Kódování: Unicode, ASCII, UTF8 |
poznámky |
|
příklad |
ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA") ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8) Oba se vrátí "Hello world!" |
ConvertFromUTF8Hex
popis |
Funkce ConvertFromUTF8Hex převede zadanou hodnotu kódování UTF8 Hex na řetězec. |
syntaxe |
str ConvertFromUTF8Hex(zdroj str) zdroj: kódování UTF8 2-byte sting |
poznámky |
Tato funkce se liší od funkce ConvertFromBase64([],UTF8) v tom, že výsledek je popisný pro atribut DN. Tento formát používá Azure Active Directory jako DN. |
příklad |
ConvertFromUTF8Hex("48656C6C6F20776F726C6421") Vrátí text "Hello world!". |
ConvertToBase64
popis |
Funkce ConvertToBase64 převede řetězec na řetězec Unicode base64. Převede hodnotu pole celých čísel na ekvivalentní řetězcové vyjádření, které je kódováno pomocí číslic base-64. |
syntaxe |
str ConvertToBase64(zdroj str) |
Poznámky |
|
příklad |
ConvertToBase64("Hello world!") Vrátí "SABlAGwAbABvACAAdwBvAHIAbABkACEA" |
ConvertToUTF8Hex
popis |
Funkce ConvertToUTF8Hex převede řetězec na šestnáctkovou hodnotu UTF8. |
syntaxe |
str ConvertToUTF8Hex(zdroj str) |
poznámky |
Výstupní formát této funkce používá Azure Active Directory jako formát atributu DN. |
příklad |
ConvertToUTF8Hex("Hello world!") Vrátí hodnotu 48656C6C6F20776F726C6421. |
Počítat
popis |
Funkce Count vrátí počet prvků v atributu s více hodnotami. |
syntaxe |
num Count(mvstr attribute) |
poznámky |
|
příklad |
Číslo C
popis |
Funkce CNum přebírá řetězec a vrací číselný datový typ. |
syntaxe |
num CNum(str value) |
poznámky |
|
příklad |
CRef
popis |
Převede řetězec na atribut odkazu. |
syntaxe |
ref CRef(str value) |
poznámky |
|
příklad |
CRef("CN=LC Services;CN=Microsoft;CN=lcspool01; CN=Pools;CN=RTC Service;" & %Forest. LDAP%) |
CStr
popis |
Funkce CStr se převede na datový typ řetězce. |
syntaxe |
str CStr(hodnota čísla) str CStr(referenční hodnota) str CStr(bool value) Hodnota: Může to být číselná hodnota, atribut odkazu nebo logická hodnota. |
poznámky |
|
příklad |
CStr([dn]) Mohl by vrátit "cn=Joe,dc=contoso,dc=com" |
DateAdd
popis |
Vrátí datum obsahující datum, do kterého byl přidán zadaný časový interval. |
syntaxe |
dt DateAdd(str interval, hodnota čísla, datum dt) Interval: Řetězcový výraz, který je intervalem času, který chcete přidat. Řetězec musí mít jednu z následujících hodnot: yyyy Year q Quarter mMonth yDay of year dDay wWeekday wwWeek hHour nMinute sSecond Hodnota: Počet jednotek, které chcete přidat. Může to být kladné (získání kalendářních dat v budoucnu) nebo záporné (pro získání dat v minulosti). Datum: DateTime představující datum, ke kterému je interval přidán. |
poznámky |
|
příklad |
DateAdd("m"; 3; CDate("2001-01-01")); Přidá 3 měsíce a vrátí hodnotu DateTime představující hodnotu 2001-04-01. |
DateFromNum
popis |
Funkce DateFromNum převede hodnotu ve formátu data AD na typ DateTime. |
syntaxe |
dt DateFromNum(hodnota čísla) |
poznámky |
|
příklad |
DateFromNum([lastLogonTimestamp]) DateFromNum(129699324000000000) Vrátí hodnotu DateTime představující datum 2012-01-01 23:00:00. |
DNComponent
popis |
Funkce DNComponent vrátí hodnotu zadané součásti DN, která se vrací zleva. |
syntaxe |
str DNComponent(ref dn, číslo ComponentNumber) dn: atribut odkazu, který se má interpretovat ComponentNumber: Komponenta v DN, která se má vrátit |
poznámky |
|
příklad |
DNComponent([dn],1) Pokud je dn "cn=Joe,ou=... To by vrátil Joea. |
DNComponentRev
popis |
Funkce DNComponentRev vrátí hodnotu zadané součásti DN, která jde zprava (konec). |
syntaxe |
str DNComponentRev(odkaz dn, číslo ComponentNumber) str DNComponentRev(ref dn, num ComponentNumber, enum Options)dn: referenční atribut pro interpretaci ComponentNumber: Komponenta v DN, která se má vrátit Možnosti: DC – ignorujte všechny komponenty pomocí "dc=" |
poznámky |
|
příklad |
Pokud je dn "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" pak DNComponentRev([dn],3) DNComponentRev([dn],1;"DC") by obě vrátily USA. |
Chyba
popis |
Funkce Error se používá k vrácení vlastní chyby. |
syntaxe |
void Error(str ErrorMessage) |
poznámky |
|
příklad |
IIF(IsPresent([accountName]);[accountName],Error("AccountName is required")) Pokud atribut accountName není k dispozici, vyvolá chybu objektu. |
EscapeDNComponent
popis |
Funkce EscapeDNComponent přebírá jednu komponentu DN a uchycuje ji, aby ji bylo možné znázornět v protokolu LDAP. |
syntaxe |
str EscapeDNComponent(str value) |
poznámky |
|
příklad |
EscapeDNComponent("cn=" & [displayName]) & ";" & %ForestLDAP% Zajišťuje, aby byl objekt vytvořen v adresáři LDAP, i když atribut displayName obsahuje znaky, které musí být v protokolu LDAP ukazovány. |
FormatDateTime
popis |
Funkce FormatDateTime se používá k formátování data a času na řetězec se zadaným formátem. |
syntaxe |
str FormatDateTime(dt value, str format)value: hodnota ve formátu DateTime format: řetězec představující formát, na který se má převést. |
poznámky |
Možné hodnoty pro formát najdete tady: |
příklad |
FormatDateTime(CDate("12/25/2007"),"rrrr-mm-dd") Výsledkem je "2007-12-25". FormatDateTime(DateFromNum([pwdLastSet]);"yyyYMdDHHmmss.0Z") Výsledkem může být "20140905081453.0Z" |
Identifikátor guid
popis |
Identifikátor GUID funkce vygeneruje nový náhodný identifikátor GUID. |
syntaxe |
str GUID() |
poznámky |
|
příklad |
IIF
popis |
Funkce IIF vrátí jednu ze sady možných hodnot na základě zadané podmínky. |
syntaxe |
var IIF(exp condition; var valueIfTrue, var valueIfFalse)condition: libovolná hodnota nebo výraz, které lze vyhodnotit na hodnotu true nebo false. valueIfTrue: hodnota, která bude vrácena, pokud podmínka vyhodnotí hodnotu true. valueIfFalse: hodnota, která bude vrácena, pokud podmínka vyhodnotí hodnotu false. |
poznámky |
|
příklad |
IIF([employeeType]="Intern";"t-"&[alias],[alias]) Vrátí alias uživatele s přidaným t-, pokud je uživatel internem, jinak vrátí alias uživatele tak, jak je. |
Instr
popis |
Funkce InStr najde první výskyt podřetězce v řetězci. |
syntaxe |
num InStr(str stringcheck; str stringmatch) num InStr(str stringcheck; str stringmatch; num start) num InStr(str stringcheck, str stringmatch, num start , enum compare) Kontrola řetězců: řetězec, který se má prohledávat Stringmatch: řetězec, který se má najít Začátek: počáteční pozice pro vyhledání podřetězdce Porovnání: vbTextCompare nebo vbBinaryCompare |
Poznámky |
Vrátí pozici, kde byl nalezen podřetězen nebo 0, pokud nebyl nalezen. |
příklad |
InStr("Rychlá hnědá liška";"quick") Evalues to 5 InStr("repEated";"e";3;vbBinaryCompare) Vyhodnotí se jako 7. |
InStrRev
popis |
Funkce InStrRev najde poslední výskyt podřetězce v řetězci. |
syntaxe |
num InstrRev(str stringcheck; str stringmatch) num InstrRev(str stringcheck, str stringmatch, num start) num InstrRev(str stringcheck, str stringmatch, num start, enum compare) Kontrola řetězců: řetězec, který se má prohledávat Stringmatch: řetězec, který se má najít Začátek: počáteční pozice pro vyhledání podřetězdce Porovnání: vbTextCompare nebo vbBinaryCompare |
poznámky |
Vrátí pozici, kde byl nalezen podřetězen nebo 0, pokud nebyl nalezen. |
příklad |
InStrRev("abbcdbbbef";"bb") Vyhodnotí se jako 7. |
IsBitSet
popis |
Funkce IsBitSet Tests, pokud je bit nastavený nebo ne |
syntaxe |
bool IsBitSet(hodnota čísla, příznak čísla) value: číselná hodnota, která je vyhodnocena.flag: číselná hodnota s bitem, který má být vyhodnocen. |
poznámky |
|
příklad |
IsBitSet(&HF;4) Vyhodnotí se jako True, protože bit "4" je nastaven v šestnáctkové hodnotě "F" |
IsDate
popis |
Funkce IsDate se vyhodnotí jako True, pokud je možné výraz vyhodnotit jako typ DateTime. |
syntaxe |
bool IsDate(var – výraz) |
poznámky |
Slouží k určení, jestli bude funkce CDate() úspěšná. |
příklad |
IsEmpty
popis |
Funkce IsEmpty se vyhodnotí jako True, pokud je atribut v CS nebo MV, ale vyhodnotí se jako prázdný řetězec. |
syntaxe |
bool IsEmpty(var – výraz) |
poznámky |
|
příklad |
IsGuid
popis |
Funkce IsGuid je vyhodnocena jako true, pokud je možné řetězec převést na identifikátor GUID. |
syntaxe |
bool IsGuid(str GUID) |
poznámky |
Identifikátor GUID je definován jako řetězec s jedním z těchto vzorů: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx nebo {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} Používá se k určení, jestli bude CGuid() úspěšný. |
příklad |
IIF(IsGuid([strAttribute]);CGuid([strAttribute]);NULL) Pokud strAttribute má formát GUID, vrátit binární reprezentaci, jinak vrátit Hodnotu Null. |
IsNull
popis |
Funkce IsNull vrátí hodnotu true, pokud se výraz vyhodnotí jako Null. |
syntaxe |
bool IsNull(var Expression) |
poznámky |
Pro atribut je null vyjádřena absencí atributu. |
příklad |
IsNull([displayName]) Hodnota True by se vyhodnotila, pokud atribut není v cs nebo MV. |
IsNullOrEmpty
popis |
Funkce IsNullOrEmpty vrátí hodnotu true, pokud je výraz null nebo prázdný řetězec. |
syntaxe |
bool IsNullOrEmpty(var Expression) |
poznámky |
U atributu by se tento atribut vyhodnotil jako True, pokud atribut chybí nebo je k dispozici, ale je prázdný řetězec. Inverzní funkce má název IsPresent. |
příklad |
IsNull([displayName]) Hodnota True by se vyhodnotila, pokud atribut neexistuje nebo je prázdný řetězec v cs nebo MV. |
IsNumeric
popis |
Funkce IsNumeric vrátí logickou hodnotu označující, zda lze výraz vyhodnotit jako typ čísla. |
syntaxe |
bool IsNumeric(var Expression) |
poznámky |
Používá se k určení, jestli bude CNum() úspěšný k analýze výrazu. |
příklad |
IsString
Popis |
Funkce IsString se vyhodnotí jako True, pokud lze výraz vyhodnotit na typ řetězce. |
syntaxe |
bool IsString(var expression) |
poznámky |
Slouží k určení, jestli bude CStr() úspěšný k analýze výrazu. |
příklad |
IsPresent
popis |
Funkce IsPresent vrátí hodnotu true, pokud se výraz vyhodnotí jako řetězec, který není null a není prázdný. |
syntaxe |
bool IsPresent(var expression) |
poznámky |
Inverzní funkce má název IsNullOrEmpty. |
příklad |
Switch(IsPresent([directManager]);[directManager], IsPresent([skiplevelManager]);[skiplevelManager], IsPresent([director]);[director]) |
Položka
popis |
Funkce Item vrátí jednu položku z vícehodnotového řetězce nebo atributu. |
syntaxe |
var Item(mvstr attribute; num index) attribute: atribut s více hodnotami index: index na položku v řetězci s více hodnotami. |
poznámky |
Funkce Item je užitečná společně s funkcí Contains, protože druhá funkce vrátí index k položce v atributu s více hodnotami. Vyvolá chybu, pokud je index mimo hranice. |
příklad |
Mid(Item([proxyAddress],Contains([proxyAddress], "SMTP:"));6) vrátí primární e-mailovou adresu. |
ItemOrNull
popis |
Funkce ItemOrNull vrátí jednu položku z vícehodnotového řetězce nebo atributu. |
syntaxe |
var ItemOrNull(atribut mvstr, index čísla) attribute: atribut s více hodnotami index: index na položku v řetězci s více hodnotami. |
poznámky |
Funkce ItemOrNull je užitečná společně s funkcí Contains, protože druhá funkce vrátí index k položce v atributu s více hodnotami. Vrátí hodnotu Null, pokud je index mimo hranice. |
příklad |
Připojit
popis |
Funkce Join přebírá řetězec s více hodnotami a vrátí řetězec s jednou hodnotou s zadaným oddělovačem vloženým mezi každou položku. |
syntaxe |
str Join(mvstr attribute) str Join(mvstr attribute; str Delimiter)attribute: Atribut s více hodnotami obsahující řetězce, které mají být spojeny. Oddělovač: Libovolný řetězec, který slouží k oddělení podřetězců ve vráceném řetězci. Pokud tento argument vynecháte, použije se znak mezery (" "). Pokud je oddělovačem řetězec nulové délky ("") nebo Nothing, všechny položky v seznamu jsou zřetězeny bez oddělovačů. |
poznámky |
Mezi funkcemi Join a Split existuje parita. Funkce Join vezme pole řetězců a spojí je pomocí řetězce oddělovače a vrátí jeden řetězec. Funkce Split přebírá řetězec a odděluje ho v oddělovači, aby vrátila pole řetězců. Klíčovým rozdílem však je, že Join může zřetězení řetězců s libovolným řetězcem oddělovače rozdělit pouze řetězce pomocí jednoho znakového oddělovače. |
příklad |
Join([proxyAddresses],";") Mohl by vrátit: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com" |
LCase
popis |
Funkce LCase převede všechny znaky v řetězci na malá písmena. |
syntaxe |
str LCase(str hodnota) |
poznámky |
|
příklad |
LCase("TeSt") Výsledkem je "test". |
Vlevo
popis |
Funkce Vlevo vrátí zadaný počet znaků zleva od řetězce. |
syntaxe |
str Left(str string, num NumChars)string: řetězec pro vrácení znaků z NumChars: číslo určující počet znaků, které se mají vrátit od začátku (vlevo) řetězce |
poznámky |
Řetězec obsahující první znaky numChars v řetězci. •Pokud numChars = 0, vrátí prázdný řetězec. •Pokud numChars < 0, vrátí vstupní řetězec. •Pokud je řetězec null, vraťte prázdný řetězec. Pokud řetězec obsahuje méně znaků než číslo zadané v numChars, vrátí se řetězec shodný s řetězcem (tj. obsahující všechny znaky v parametru 1). |
příklad |
Left("John Doe"; 3) Vrátil by "Joh". |
Len
popis |
Funkce Číslo vrátí počet znaků v řetězci. |
syntaxe |
num Len(str value) |
poznámky |
|
příklad |
Len("John Doe") Vrátí hodnotu 8. |
LTrim
popis |
Funkce LTrim odebere z řetězce úvodní prázdné znaky. |
syntaxe |
str LTrim(str hodnota) |
poznámky |
|
Příklad |
LTrim(" Test ") Výsledky ve výrazu "Test" |
Střední
popis |
Funkce Mid vrátí zadaný počet znaků ze zadané pozice v řetězci. |
syntaxe |
str Mid(str řetězec, začátek čísla, numChars) string: řetězec pro vrácení znaků z start: číslo identifikující počáteční pozici v řetězci pro vrácení znaků z NumChars: číslo určující počet znaků, které se mají vrátit z pozice v řetězci |
poznámky |
Vrátí znaky numChars začínající od pozice začínající v řetězci. Řetězec obsahující znaky numChars od pozice začíná v řetězci. •Pokud numChars = 0, vrátí prázdný řetězec. •Pokud numChars < 0, vrátí vstupní řetězec. •Pokud > délku řetězce, vraťte vstupní řetězec. •Pokud je počáteční <= 0, vraťte vstupní řetězec. •Pokud je řetězec null, vraťte prázdný řetězec. Pokud v řetězci od začátku pozice nezůstaly znaky numChar, vrátí se tolik znaků, kolik je možné vrátit. |
příklad |
Mid("John Doe"; 3; 5) Vrátil by "hn Do". Mid("John Doe", 6, 999) Vrátilo by se "Doe" |
Teď
popis |
Funkce Now vrátí dateTime určující aktuální datum a čas podle systémového data a času počítače. |
syntaxe |
dt Now() |
poznámky |
|
příklad |
NumFromDate
popis |
Funkce NumFromDate vrátí datum ve formátu data AD. |
syntaxe |
num NumFromDate(dt value) |
poznámky |
|
příklad |
NumFromDate(CDate("2012-01-01 23:00:00")) Vrátí 129699324000000000 |
PadLeft
popis |
Funkce PadLeft vlevo vycpá řetězec na zadanou délku pomocí zadaného znaku odsazení. |
syntaxe |
str PadLeft(str řetězec, délka čísla, str padCharacter) řetězec: řetězec, který se má vysunout. délka: Celé číslo představující požadovanou délku řetězce. padCharacter: Řetězec skládající se z jednoho znaku, který se má použít jako znak oblasti |
poznámky |
Pokud je délka řetězce menší než délka, pak padCharacter je opakovaně připojen k začátku (vlevo) řetězce, dokud nemá délku rovnou délce. padCharacter může být znak mezery, ale nemůže to být hodnota null. Pokud je délka řetězce rovna nebo větší než délka, vrátí se řetězec beze změny. Pokud má řetězec délku větší nebo rovnou délce, vrátí se řetězec shodný s řetězcem. Pokud je délka řetězce menší než délka, vrátí se nový řetězec požadované délky obsahující řetězec vycpaný s padCharacter. Pokud je řetězec null, vrátí funkce prázdný řetězec. |
příklad |
PadLeft("Uživatel"; 10; "0") Výsledkem by bylo 0000000User. |
PadRight
popis |
Funkce PadRight zprava vloží řetězec na zadanou délku pomocí poskytnutého znaku odsazení. |
syntaxe |
str PadRight(str string, délka čísla, str padCharacter) řetězec: řetězec, který se má vysunout. délka: Celé číslo představující požadovanou délku řetězce. padCharacter: Řetězec skládající se z jednoho znaku, který se má použít jako znak oblasti |
poznámky |
Pokud je délka řetězce menší než délka, pak padCharacter se opakovaně připojí ke konci (vpravo) řetězce, dokud se délka nerovná délce. padCharacter může být znak mezery, ale nemůže to být hodnota null. Pokud je délka řetězce rovna nebo větší než délka, vrátí se řetězec beze změny. Pokud má řetězec délku větší nebo rovnou délce, vrátí se řetězec shodný s řetězcem. Pokud je délka řetězce menší než délka, vrátí se nový řetězec požadované délky obsahující řetězec vycpaný s padCharacter. Pokud je řetězec null, vrátí funkce prázdný řetězec. |
příklad |
PadRight("User"; 10; "0") Výsledkem by bylo "User0000000". |
PCase
popis |
Funkce PCase převede první znak každého slova odděleného mezerou v řetězci na velká písmena a všechny ostatní znaky se převedou na malá písmena. |
syntaxe |
Řetězec PCase(řetězec) |
poznámky |
|
příklad |
PCase("TEsT") Výsledkem je "Test". |
RandomNum
popis |
Funkce RandomNum vrátí náhodné číslo mezi zadaným intervalem. |
syntaxe |
num RandomNum(num start, num end) start: číslo identifikující dolní limit náhodné hodnoty, která se má vygenerovat end: číslo určující horní mez náhodné hodnoty, která se má vygenerovat. |
poznámky |
|
příklad |
Náhodná(100 999) by mohla vrátit hodnotu 734. |
Odebrání duplicitních dat
popis |
Funkce RemoveDuplicates přebírá řetězec s více hodnotami a ujistěte se, že každá hodnota je jedinečná. |
syntaxe |
mvstr RemoveDuplicates(atribut mvstr) |
poznámky |
|
příklad |
RemoveDuplicates([proxyAddresses]) Vrátí sanitizovaný atribut proxyAddress, kde byly odebrány všechny duplicitní hodnoty. |
Nahradit
popis |
Funkce Replace nahradí všechny výskyty řetězce jiným řetězcem. |
syntaxe |
str Replace(str string, str OldValue, str NewValue) řetězec: Řetězec, ve které se mají nahradit hodnoty. OldValue: Řetězec, který chcete vyhledat a nahradit. NewValue: Řetězec, na který se má nahradit. |
poznámky |
Funkce rozpozná následující speciální monikers. \n – nový řádek \r – návrat na začátek řádku \t – tab |
příklad |
Replace([address],"\r\n";"; ") Nahraďte CRLF čárkou a mezerou a mohlo by vést k "One Microsoft Way, Redmond, WA, USA" |
ReplaceChars
popis |
Funkce ReplaceChars nahrazuje všechny výskyty znaků nalezených v řetězci ReplacePattern. |
syntaxe |
str ReplaceChars(str string, str ReplacePattern) řetězec: Řetězec, ve které se mají nahradit znaky. ReplacePattern: řetězec obsahující slovník se znaky, které chcete nahradit. Formát je {source1}:{target1},{source2}:{target2},{sourceN},{targetN}, kde zdrojem je znak, kterým se má řetězec najít, a cílit na řetězec, kterým se má nahradit. |
poznámky |
Funkce převezme každý výskyt definovaných zdrojů a nahradí je cíli. Zdroj musí být přesně jeden znak (unicode). Zdroj nemůže být prázdný nebo delší než jeden znak (chyba analýzy). Cíl může mít více znaků, například ö:oe, β:ss. Cíl může být prázdný, což znamená, že by se měl znak odebrat. Zdroj rozlišují malá a velká písmena a musí být přesná shoda. Znak , (čárka) a : (dvojtečka) jsou vyhrazené znaky a nelze je nahradit pomocí této funkce. Mezery a další bílé znaky v řetězci ReplacePattern jsou ignorovány. |
příklad |
%ReplaceString% = ':,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o ReplaceChars("Räksmörgås";%ReplaceString%) Vrátí Raksmorgas ReplaceChars("O'Neil";%ReplaceString%) Vrátí hodnotu "ONeil", je definováno, že se odebere jednotlivá značka. |
Vpravo
popis |
Funkce Vpravo vrátí zadaný počet znaků z pravého (konce) řetězce. |
syntaxe |
str Right(str string, num NumChars) string: řetězec pro vrácení znaků z NumChars: číslo určující počet znaků, které se mají vrátit z konce (vpravo) řetězce |
Poznámky |
Znaky NumChars se vrátí z poslední pozice řetězce. Řetězec obsahující poslední znakyChars v řetězci. •Pokud numChars = 0, vrátí prázdný řetězec. •Pokud numChars < 0, vrátí vstupní řetězec. •Pokud je řetězec null, vraťte prázdný řetězec. Pokud řetězec obsahuje méně znaků než číslo zadané v NumChars, vrátí se řetězec shodný s řetězcem. |
příklad |
Right("John Doe", 3) Vrátil by "Doe". |
RTrim
popis |
Funkce RTrim odebere koncové mezery z řetězce. |
syntaxe |
str RTrim(str hodnota) |
poznámky |
|
příklad |
RTrim(" Test ") Výsledkem je "Test". |
Rozdělit
popis |
Funkce Split vezme řetězec oddělený oddělovačem a vytvoří ho jako řetězec s více hodnotami. |
syntaxe |
mvstr Split(str hodnota, oddělovač str) mvstr Split(hodnota str, oddělovač str, limit čísla) Hodnota: řetězec s oddělovačem, který se má oddělit. Oddělovač: jeden znak, který se má použít jako oddělovač Limit: maximální počet vrácených hodnot |
poznámky |
|
příklad |
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com";";") vrátí řetězec s více hodnotami s 2 prvky užitečnými pro atribut proxyAddress. |
StringFromGuid
Popis |
Funkce StringFromGuid přebírá binární identifikátor GUID a převede ji na řetězec. |
Syntax |
str StringFromGuid(bin GUID) |
Poznámky |
|
Příklad |
StringFromSid
popis |
Funkce StringFromSid převede bajtové pole nebo pole s více hodnotami obsahující identifikátor zabezpečení na řetězec nebo vícehodnotový řetězec. |
syntaxe |
str StringFromSid(bin ObjectSID) mvstr StringFromSid(mvbin ObjectSID) |
poznámky |
|
příklad |
Vypínač
popis |
Funkce Switch slouží k vrácení jedné hodnoty na základě vyhodnocených podmínek. |
syntaxe |
var Switch(výraz1; var value1[; výraz2; var value ... [, výraz výraz, var valueN]) Výraz: Výraz variant, který chcete vyhodnotit. Hodnota: Hodnota, která se má vrátit, pokud je odpovídající výraz True. |
poznámky |
Seznam argumentů funkce Switch se skládá z dvojic výrazů a hodnot. Výrazy se vyhodnocují zleva doprava a vrátí se hodnota přidružená k prvnímu výrazu, který se vyhodnotí jako True. Pokud nejsou části správně spárované, dojde k chybě za běhu. Pokud je například výraz1 true, vrátí switch hodnotu1. Pokud výraz-1 je False, ale výraz-2 je True, Switch vrátí hodnotu-2 atd. Přepínač vrátí hodnotu Nothing if:
Switch vyhodnotí všechny výrazy, i když vrátí jenom jeden z nich. Z tohoto důvodu byste měli sledovat nežádoucí vedlejší účinky. Pokud například vyhodnocení jakéhokoli výrazu vede k dělení nulou chybou, dojde k chybě. Hodnota může být také funkce Error, která by vrátila vlastní řetězec. |
příklad |
Switch([city] = "London"; "English"; [city] = "Rome"; "Italian", [city] = "Paris", "French", True, Error("Unknown city")) Vrátí jazyk mluvený v některých hlavních městech, jinak vrátí chybu. |
Zastřihnout
popis |
Funkce Trim odebere z řetězce úvodní a koncové mezery. |
syntaxe |
str Trim(str value) mvstr Trim(hodnota mvstr) |
poznámky |
|
příklad |
Trim(" Test ") Výsledkem je "Test". Trim([proxyAddresses]) Odebere úvodní a koncové mezery pro každou hodnotu v atributu proxyAddress. |
UCase
Popis |
Funkce UCase převede všechny znaky v řetězci na velká písmena. |
syntaxe |
str UCase(str string) |
poznámky |
|
příklad |
UCase("TeSt") výsledkem je "TEST". |
Slovo
popis |
Funkce Word vrátí slovo obsažené v řetězci na základě parametrů popisujících oddělovače, které se mají použít, a čísla slova, které se mají vrátit. |
syntaxe |
str Word(řetězec str, číslo WordNumber, oddělovače str) řetězec: řetězec pro vrácení slova z Číslo aplikace WordNumber: číslo určující, které číslo slova má být vráceno oddělovače: řetězec představující oddělovače, které by se měly použít k identifikaci slov |
poznámky |
Každý řetězec znaků v řetězci oddělený jedním z znaků v oddělovači se identifikuje jako slova. •Pokud je číslo < 1, vraťte prázdný řetězec. •Pokud je řetězec null, vraťte prázdný řetězec. Pokud řetězec obsahuje méně než číselná slova nebo řetězec neobsahuje žádná slova identifikovaná pomocí delimetrů, vrátí se prázdný řetězec. |
příklad |
Word("Rychlá hnědá liška";3;" ") Vrátí "hnědou" Word("This;string!has&many seperators";3;";!&#") Vrátilo by se "has" (má). |