Informacje dotyczące funkcji Microsoft Identity Manager 2016

BitOr
Opis Funkcja BitOr ustawia określony bit dla flagi na 1.
Podpis funkcji Int BitOr(mask, flag)
Dane wejściowe
  • mask: wartość szesnastkowa określająca bit, który ma być ustawiony na flagę.
  • flaga:wartość szesnastkowa, która ma mieć zmodyfikowany określony bit.
Operacje Ta funkcja konwertuje oba parametry na reprezentację binarną i porównuje je:
  • Ustawia bit na 1, jeśli jeden lub oba odpowiednie bity w masce i flaga są 1.
  • Ustawia bit na 0, jeśli oba odpowiednie bity są 0.
  • Zwraca wartość 1 we wszystkich przypadkach, z wyjątkiem sytuacji, gdy odpowiednie bity obu parametrów mają wartość 0.
  • Wynikowy wzorzec bitowy to bity "set" (1 lub true) dowolnego z dwóch operandów.
  • Można ustawić wiele bitów flagi, jeśli wiele bitów ma wartość 1 w masce.
Dane wyjściowe Nowa wersja flagi z bitami określonymi w masce ustawioną na 1.

BitAnd
Opis Funkcja BitAnd ustawia określony bit na flagi na 0.
Podpis funkcji Int BitOr(mask, flag)
Dane wejściowe
  • mask: wartość szesnastkowa określająca bit, który ma być modyfikowany w flagi.
  • flaga:wartość szesnastkowa, która ma mieć zmodyfikowany określony bit.
Operacje Ta funkcja konwertuje oba parametry na reprezentację binarną i porównuje je:
  • Ustawia bit na 0, jeśli jeden lub oba odpowiednie bity w masce i flaga są 0.
  • Ustawia bit na 1, jeśli oba odpowiednie bity są 1.
  • Zwraca wartość 0 we wszystkich przypadkach, z wyjątkiem sytuacji, gdy odpowiednie bity obu parametrów mają wartość 1.
  • Wiele bitów flagi można ustawić na 0, jeśli wiele bitów ma wartość 0 w masce.
Dane wyjściowe Nowa wersja flagi z bitami określonymi w masce ustawioną na 0.

Datetimeformat
Opis Funkcja DateTimeFormat służy do formatowania wartości DateTime w postaci ciągu do określonego formatu.
Podpis funkcji String DateTimeFormat(dateTime, format)
Dane wejściowe
  • dateTime:ciąg reprezentujący wartość dateTime do sformatowania.
  • format:ciąg reprezentujący format, na który ma zostać przekonwertowany ciąg.

Uwaga:Aby uzyskać informacje o znakach akceptowanych do tworzenia formatów zdefiniowanych przez użytkownika, zobacz Formaty daty/godziny zdefiniowane przez użytkownika.
Operacje Ciąg formatu określony w formacie jest stosowany do wartości DateTime w ciągu dateTime. Ciąg określony w formacie musi być prawidłowym formatem DateTime. Jeśli tak nie jest, zwracany jest błąd wskazujący, że format nie jest prawidłowym formatem DateTime. Na przykład: DateTime("12/25/2007", "yyyy-MM-dd") wyniki w . "2007-12-25"
Dane wyjściowe Ciąg wynikowy zastosowania formatu dodaty/daty/godziny.

ConvertSidToString
Opis ConvertSidToString konwertuje tablicę bajtów zawierającą identyfikator zabezpieczeń na ciąg.
Podpis funkcji String ConvertSidToString(ObjectSID)
Dane wejściowe ObjectSID:tablica bajtów zawierająca identyfikator zabezpieczeń (SID).
Operacje Określony binarny identyfikator SID jest konwertowany na ciąg.
Dane wyjściowe Reprezentacja ciągu identyfikatora SID.

ConvertStringToGuid
Opis Funkcja ConvertStringToGuid konwertuje reprezentację ciągu identyfikatora GUID na binarną reprezentację identyfikatora GUID.
Podpis funkcji Byte[] ConvertStringToGuid(stringGuid)
Dane wejściowe stringGuid:ciąg sformatowany we wzorcu , gdzie wartość identyfikatora GUID jest reprezentowana jako seria cyfr szesnastkowych w grupach 8, 4, 4, 4 i 12 cyfr oraz oddzielona łącznikami. Przykładem wartości zwracanej jest 382c74c3-721d-4f34-80e557657b6cbc27 .
Operacje Wartość stringGuid jest konwertowana na reprezentację binarną. Jeśli ciąg nie jest reprezentacją prawidłowego identyfikatora GUID, funkcja odrzuca argument z błędem "Parametr funkcji ConvertStringToGuid musi być ciągiem reprezentującym prawidłowy identyfikator GUID".
Dane wyjściowe Reprezentacja binarna identyfikatora GUID.

ReplaceString
Opis Funkcja ReplaceString zastępuje wszystkie wystąpienia ciągu innym ciągiem.
Podpis funkcji String ReplaceString(string, OldValue, NewValue)
Dane wejściowe
  • string:ciąg, w którym mają zostać zastąpione wartości.
  • OldValue:ciąg do wyszukania i zastąpienia.
  • NewValue:ciąg, który ma zostać zastąpiony.
Operacje Wszystkie wystąpienia wartości OldValue w ciągu są zastępowane ciągiem NewValue. Funkcja musi być w stanie obsługiwać znaki specjalne \n. nowy wiersz, znak powrotu karetki \r. i karta \t. Na przykład: zwraca wartość .
Dane wyjściowe Ciąg ze wszystkimi wystąpieniami wartości OldValue w ciągu zastąpionym ciągiem NewValue.

Funkcje pobierania danych

Funkcje pobierania danych są używane do wykonywania operacji, które pobierają żądane znaki z ciągu.

Word
Opis Funkcja Word zwraca słowo zawarte w ciągu na podstawie parametrów opisujących ograniczniki do użycia oraz liczbę słów do zwrócenia.
Podpis funkcji String Word(string, number, delimiters)
Dane wejściowe
  • string:ciąg, z którego ma być zwracany wyraz.
  • number: liczba identyfikująca, który wyraz ma być zwracany.
  • ograniczniki:ciąg reprezentujący ograniczniki, które powinny być używane do identyfikowania wyrazów.
Operacje Każdy ciąg znaków w ciągu, który jest oddzielony jednym ze znaków w ogranicznikach, jest identyfikowany jako wyraz. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg. Zostanie zwrócony wyraz znaleziony na pozycji określonej w liczbie. Jeśli liczba 1, funkcja zwraca pusty ciąg. Na przykład:
  • Word("Test;of%function;", 3, ";$&%") Funkcja zwraca "function" wartość .
  • Word("Test;;Function" , 2 , ";") zwraca "" wartość (pusty ciąg).
  • Word("Test;of%function;", 0, ";$&%") zwraca "" wartość (pusty ciąg).
Dane wyjściowe Ciąg zawierający wyraz w miejscu, o które pyta użytkownik. Jeśli ciąg zawiera mniej niż liczba wyrazów lub ciąg nie zawiera żadnych wyrazów identyfikowanych przez ograniczniki, zwracany jest pusty ciąg.

Lewe
Opis Funkcja Left zwraca określoną liczbę znaków z lewej strony (początku) ciągu.
Podpis funkcji String Left(string, numChars)
Dane wejściowe
  • string:ciąg, z którego mają być zwracane znaki.
  • numChars:liczba identyfikująca liczbę znaków, które mają być zwracane od początku ciągu.
Operacje Znaki numChars są zwracane z pierwszej pozycji ciągu. Na przykład: Left("Britta Simon", 3) zwraca wartość "Bri" .
Dane wyjściowe Ciąg zawierający pierwsze znaki numChars w ciągu. Jeśli argument numChars = 0, funkcja zwraca pusty ciąg. Jeśli argument numChars 0, funkcja zwraca ciąg wejściowy. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg.

Prawe
Opis Funkcja Right zwraca określoną liczbę znaków z prawej strony (końca) ciągu.
Podpis funkcji String Right(string, numChars)
Dane wejściowe
  • string:ciąg, z którego mają być zwracane znaki.
  • numChars:liczba identyfikująca liczbę znaków, które mają być zwracane od końca ciągu.
Operacje Zwraca znaki numChars z końca ciągu. Na przykład: Right("Britta Simon", 3) zwraca wartość "mon" .
Dane wyjściowe Ciąg zawierający ostatnie znaki numChars w ciągu. Jeśli argument numChars = 0, funkcja zwraca pusty ciąg. Jeśli argument numChars 0, funkcja zwraca ciąg wejściowy. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg. Jeśli ciąg zawiera mniej znaków niż liczba określona w argumentach numChars,zwracany jest ciąg.

Mid
Opis Funkcja Mid zwraca określoną liczbę znaków z określonej pozycji w ciągu.
Podpis funkcji String Mid(string, pos, numChars)
Dane wejściowe
  • string:ciąg, z którego mają być zwracane znaki.
  • pos:liczba identyfikująca pozycję początkową w ciągu dla zwracanych znaków.
  • numChars:liczba identyfikująca liczbę znaków, które mają być zwracane z pozycji w ciągu.
Operacje Zwraca znaki numChars, zaczynając od pozycji pos w ciągu. Na przykład: Mid("Britta Simon", 3, 5) zwraca wartość "itta " .
Dane wyjściowe Ciąg zawierający znaki numChars z pozycji pos w ciągu. Jeśli argument numChars = 0, funkcja zwraca pusty ciąg. Jeśli argument numChars 0, funkcja zwraca pusty ciąg. Jeśli posunie długość ciągu, funkcja zwraca ciąg wejściowy. Jeśli pos = 0, funkcja zwraca ciąg wejściowy. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg. Jeśli w ciągu nie ma żadnych znaków numChar z pozycji pos,zwracana jest jak najwięcej znaków.

Funkcje generowania danych

Funkcje generowania danych są używane do generowania wartości dla określonych typów danych.

CRLF
Opis Funkcja CRLF generuje powrót karetki/źródło wiersza. Użyj tej funkcji, aby dodać nowy wiersz.
Podpis funkcji String CRLF
Dane wejściowe Brak.
Operacje Zwracany jest crlf. Na przykład:
AddressLine1 + CRLF() + AddressLine2
wyniki w AddressLine1
AddressLine2.
Dane wyjściowe CrLF to dane wyjściowe.

RandomNum
Opis Funkcja RandomNum zwraca liczbę losową w określonym interwale.
Podpis funkcji Int RandomNum(start, end)
Dane wejściowe
  • start:liczba identyfikująca dolny limit wartości losowej do wygenerowania.
  • end:liczba identyfikująca górny limit wartości losowej do wygenerowania.
Operacje Generowana jest liczba losowa większa lub równa wartości startowej i mniejszej lub równej wartości końcowej. Na przykład: Random(0,999) może zwrócić . 100
Dane wyjściowe Liczba losowa w zakresie określonym przez początek ikoniec.

EscapeDNComponent
Opis Do wykonania tej operacji jest używana metoda EscapeDNComponent z miisutils. Ta metoda przetwarza ciąg wejściowy na podstawie używanego typu agenta zarządzania (MA).
Podpis funkcji String EscapeDNComponent(string)
Dane wejściowe string:ciąg używany do przetwarzania nazwy wyróżniania. Ciąg nie powinien zawierać znaków ucieczki.
Operacje Różne konta mA wymagają różnych formatów nazw wyróżniających. Ta metoda przetwarza ciąg wejściowy w oparciu o następujące typy MA:
  • Nazwa wyróżniająa LDAP:przykłady tego typu ma następujące typy: Active Directory Domain Services, Sun Directory Server (dawniej iPlanet Directory Server) i Microsoft Exchange Server.
    • Wszelkie nieprawidłowe znaki XML w części wartości danej części są zakodowane szesnastkowo.
    • Wszelkie niedozwolone znaki (w tym nieprawidłowe znaki XML) w części nazwy danej części generują błąd.
    • Znaki ucieczki obejmują przecinek (,), równości (=), plus (+), mniejsze niż ( ), większe niż ( ), liczba (#), średnik (;), ukośnik odwrotny () i podwójny <> cudzysłów ().
    • Jeśli ostatnim znakiem w ciągu jest spacja ( ), ta spacja jest znakem ucieczki.
    • Wszelkie dodatkowe spacje wiodące lub końcowe wokół nazwy części są usuwane.
    • W przypadku ma xml, jeśli istnieje wiele części, a następnie części są alfabetyczne.
    • Jeśli określono wiele części, złożony ciąg nazwy wyróżniania jest dzieleniem poszczególnych ciągów oddzielonych znakami plus (+).
    • Jeśli ciąg wejściowy nie jest dobrze uformowanym ciągiem nazwy wyróżniania w stylu protokołu LDAP, generowany jest błąd.
  • Hierarchiczne dane inne niż LDAP:przykładem tego typu ma być program Microsoft Lotus Notes.
    • Ten typ MA nie obsługuje składników wieloczęściowych.
    • Jeśli do funkcji jest przekazywanych wiele EscapeDNComponent ciągów, zgłaszany jest wyjątek EscapeDNComponent
    • Jeśli dowolny ze znaków w ciągu wejściowym jest nieprawidłowym znakiem XML, zgłaszany jest wyjątek ArgumentException.
    • Wszystkie przecinki (,) i ukośniki odwrotne (/) w ciągu wejściowym są znakami ucieczki.
    • Jeśli ostatnim znakiem w ciągu jest spacja ( ), ta spacja jest znakem ucieczki.
  • Extrinsic:Przykłady tego typu ma zawierać bazy danych lub XML bez nazwy wyróżniania LDAP.
    • Jeśli jakakolwiek część jest binarna lub zawiera nieprawidłowy znak XML, ta część jest przechowywana jako zakodowana szesnastkowo wersja danych pierwotnych ze znakiem cyfry (#) poprzedzonym prefiksem na początku ciągu. Jeśli na przykład część to (gdzie x reprezentuje niedozwolony znak XML, taki jak ), ta AxC0x10 część jest kodowana jako #410010004300 . W przeciwnym razie wszystkie wystąpienia tych znaków są znakami ucieczki: ukośnik odwrotny (), przecinek (,), plus (+) i liczba (#).
    • Jeśli ostatnim znakiem w danym ciągu części jest spacja ( ), ta spacja jest znakem ucieczki.
    • Jeśli określono wiele części, złożony ciąg nazwy wyróżniania jest ujednorzeniem wszystkich poszczególnych ciągów oddzielonych znakami plus.
Dane wyjściowe Ciąg zawierający prawidłową nazwę domeny.

Uwaga

Walidacja nazw wyróżniających jest mniej rygorystyczna niż składnia zdefiniowana w specyfikacjach LDAP. EscapeDNComponent(String[]) Umożliwia, aby nazwa części zawierała dowolną kombinację jednego lub większej liczby znaków "a"-"z", "A"-"Z", "0"-"9", "-" i ".".

Za pomocą tej metody nie można określić części binarnej. Można jednak mieć część binarną w pliku CommitNewConnector, jeśli nazwa wyróżniająca jest zbudowana z atrybutów zakotwiczenia, a jeden z atrybutów zakotwiczenia jest typem binarnym.


Zero
Opis Funkcja Null służy do określania, że ma on nie mieć atrybutu, który ma zostać dodany, i że pierwszeństwo atrybutu powinno być kontynuowane przy następnym machinie.
Podpis funkcji String Null
Dane wejściowe Brak.
Operacje Zwracana jest wartość Null. Na przykład: IIF(Eq(domain), "unknown", Null()) zwraca wartość Null .
Dane wyjściowe Wartość null jest wartością wyjściową.

Funkcje logiki

Funkcje logiki są używane do wykonywania operacji na podstawie warunków ocenianych przez system.

IIF
Opis Funkcja IIF zwraca jedną z możliwych wartości na podstawie określonego warunku.
Podpis funkcji Object IIF(condition, valueIfTrue, valueIfFalse)
Dane wejściowe
  • warunek:dowolna wartość lub wyrażenie, które można oszacować na wartość true lub false. Następujące funkcje są dostępne do użycia jako wyrażenia w funkcji IIF dla warunku:
    • Eq:Ta funkcja porównuje dwa argumenty równości.
    • NotEquals:ta funkcja porównuje dwa argumenty pod względem nierówności, zwracając wartość true, jeśli nie są równe, i wartość false, jeśli są równe. Na przykład: NotEquals(EmployeeType, "Contractor").
    • LessThan:ta funkcja porównuje dwie liczby, zwracając wartość true, jeśli pierwsza jest mniejsza niż druga, a w przeciwnym razie wartość false. Na przykład: LessThan(Salary, 100000).
    • GreaterThan:ta funkcja porównuje dwie liczby, zwracając wartość true, jeśli pierwsza jest większa niż druga, a w przeciwnym razie wartość false. Na przykład: GreaterThan(Salary, 100000).
    • LessThanOrEquals:ta funkcja porównuje dwie liczby, zwracając wartość true, jeśli pierwsza jest mniejsza niż lub równa drugiej, a w przeciwnym razie wartość false. Na przykład: LessThanOrEquals(Salary, 100000).
    • GreaterThanOrEquals:ta funkcja porównuje dwie liczby, zwracając wartość true, jeśli pierwsza jest większa niż lub jest równa drugiej, a w przeciwnym razie wartość false. Na przykład: GreaterThanOrEquals(Salary, 100000).
    • IsPresent:ta funkcja przyjmuje jako dane wejściowe atrybut w schemacie ILM i zwraca wartość true, jeśli atrybut nie ma wartości null i false, jeśli atrybut ma wartość null.
  • valueIfTrue:wartość zwracana, jeśli warunek ma wartość true.
  • valueIfFalse:wartość zwracana, jeśli warunek ma wartość false.
Operacje Jeśli warunek ma wartość true, funkcja zwraca wartość valueIfTrue. W przeciwnym razie funkcja zwraca wartość valueIfFalse. Na przykład: zwraca alias użytkownika z wartością "t-" dodaną na początku aliasu, jeśli użytkownik IIF(Eq(EmployeeType,"Intern"),"t-" + Alias, Alias) jest internem. W przeciwnym razie funkcja zwraca alias użytkownika w as-is.
Dane wyjściowe Dane wyjściowe to valueIfTrue, jeśli warunek ma wartość true, lub valueIfFalse, jeśli warunek ma wartość false.

W Microsoft Identity Manager (MIM) 2016 funkcje umożliwiają modyfikowanie wartości atrybutów przed ich przepływem do obiektu docelowego w działaniu funkcji lub aprowizowania deklaratywnego. Celem tego dokumentu jest omówienie dostępnych funkcji i opis sposobu ich używania.

Konfigurowanie mapowania przepływu atrybutów jest podstawowym zadaniem podczas konfigurowania reguł synchronizacji. Najprostszą formą mapowania przepływu atrybutów jest mapowanie bezpośrednie. Jak wskazuje nazwa, bezpośrednie mapowanie pobiera wartość atrybutu źródłowego i stosuje ją do skonfigurowanego atrybutu docelowego. Istnieją przypadki, w których należy zmodyfikować istniejące wartości atrybutów lub obliczyć nowe wartości atrybutów przed zastosowaniem ich przez system do miejsca docelowego.

Funkcje to wbudowana metoda używana do definiowania typu modyfikacji, który aparat synchronizacji ma zastosować podczas generowania wartości atrybutu dla miejsca docelowego.

Funkcje MIM są podzielone na następujące kategorie:

  • Manipulowanie danymi: wykonywanie różnych operacji manipulowania ciągami.

  • Pobieranie danych: wyodrębnianie danych z wartości atrybutów.

  • Generowanie danych: generowanie wartości.

  • Logika: wykonywanie operacji na podstawie warunków.

Poniższe sekcje zawierają więcej szczegółów na temat funkcji w każdej kategorii.

Funkcje manipulowania danymi

Funkcje manipulowania danymi są używane do wykonywania różnych operacji na ciągach.

Concatenate
Opis Funkcja Concatenate łączy co najmniej dwa ciągi.
Podpis funkcji string1 + string2...
Dane wejściowe Co najmniej dwa ciągi.
Operacje Wszystkie parametry ciągu wejściowego są ze sobą łączyne.
Dane wyjściowe Jeden ciąg.

Wielkie
Opis Funkcja UpperCase konwertuje wszystkie znaki w ciągu na wielkie litery.
Podpis funkcji String UpperCase(string)
Dane wejściowe Jeden ciąg.
Operacje Wszystkie małe litery parametru wejściowego są konwertowane na wielkie litery. Na przykład: UpperCase("test") wyniki w . "TEST"
Dane wyjściowe Jeden ciąg.

Małe litery
Opis Funkcja Małe litery konwertuje wszystkie znaki w ciągu na małe litery.
Podpis funkcji String LowerCase(string)
Dane wejściowe Jeden ciąg.
Operacje Wszystkie wielkie litery parametru wejściowego są konwertowane na małe litery. Na przykład: LowerCase("TeSt") wyniki w . "test"
Dane wyjściowe Jeden ciąg.

ProperCase
Opis Funkcja ProperCase konwertuje pierwszy znak każdego słowa rozdzielanego spacją w ciągu na wielkie litery. Wszystkie inne znaki są konwertowane na małe litery.
Podpis funkcji String ProperCase(string)
Dane wejściowe Jeden ciąg.
Operacje Pierwszy znak każdego słowa rozdzielanego spacją w parametrze wejściowym jest konwertowany na wielkie litery. Wszystkie wielkie litery są konwertowane na małe litery. Jeśli wyraz w parametrze wejściowym rozpoczyna się znakiem innym niż alfabet, pierwszy znak słowa nie jest konwertowany na wielkie litery. Na przykład:
  • ProperCase("TEsT") w "Test" wyniku .
  • ProperCase("britta simon") w "Britta Simon" wyniku .
  • ProperCase(" TEsT") w " Test" wyniku .
  • ProperCase("\$TEsT") w "\$Test" wyniku .
Dane wyjściowe Jeden ciąg.

Ltrim
Opis Funkcja LTrim usuwa wiodące białe spacje z ciągu.
Podpis funkcji String LTrim(string)
Dane wejściowe Jeden ciąg.
Operacje Wiodące znaki odstępu zawarte w parametrze wejściowym są usuwane. Na przykład: LTrim(" Test ") wyniki w . "Test "
Dane wyjściowe Jeden ciąg.

Rtrim
Opis Funkcja RTrim usuwa końcowe białe spacje z ciągu.
Podpis funkcji String RTrim(string)
Dane wejściowe Jeden ciąg.
Operacje Końcowe znaki odstępu zawarte w parametrze wejściowym są usuwane. Na przykład: RTrim(" Test ") wyniki w . " Test"
Dane wyjściowe Jeden ciąg.

Trim
Opis Funkcja Trim usuwa wiodące i końcowe białe spacje z ciągu.
Podpis funkcji String Trim(string)
Dane wejściowe Jeden ciąg.
Operacje Wiodące i końcowe znaki odstępu zawarte w ciągu są usuwane. Na przykład: Trim(" Test ") wyniki w . "Test"
Dane wyjściowe Jeden ciąg.

RightPad
Opis Funkcja RightPad dopełnia ciąg do określonej długości za pomocą podanego znaku dopełnienia.
Podpis funkcji String RightPad(string, length, padCharacter)
Dane wejściowe
  • string:ciąg do domięć.
  • length:liczba całkowita reprezentująca żądaną długość ciągu.
  • padCharacter:ciąg składający się z pojedynczego znaku, który ma być używany jako znak wsadu.
Operacje Jeśli długość ciągu jest mniejsza niż długość , ciąg padCharacter jest wielokrotnie dołączany na końcu ciągu, aż długość ciągu będzie równa długości. Na przykład:
  • RightPad("User", 10, "0") w "User000000" wyniku .
  • RightPad(RandomNum(1,10), 5, "0") Może to spowodować "9000" .
Dane wyjściowe Jeśli ciąg ma długość większą lub równą długości,zwracany jest ciąg identyczny z ciągiem. Jeśli długość ciągu jest mniejsza niż długość, zwracany jest nowy ciąg o żądanej długości. Nowy ciąg zawiera ciąg wsadowany za pomocą padCharacter. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg.

Uwaga:padCharacter może być znakiem spacji, ale nie może być wartością null. Jeśli długość ciągu jest równa lub większa niż długość,ciąg jest zwracany bez zmian.

LeftPad
Opis Funkcja LeftPad dodaje ciąg do określonej długości przy użyciu podanego znaku dopełnienia.
Podpis funkcji String LeftPad(string, length, padCharacter)
Dane wejściowe
  • string:ciąg do domięć.
  • length:liczba całkowita reprezentująca żądaną długość ciągu.
  • padCharacter:ciąg składający się z pojedynczego znaku, który ma być używany jako znak wsadu.
Operacje Jeśli długość ciągu jest mniejsza niż długość , ciąg padCharacter jest wielokrotnie dołączany do początku ciągu, aż długość ciągu będzie równa długości. Na przykład:
  • RightPad("User", 10, "0") w "000000User" wyniku .
  • RightPad(RandomNum(1,10), 5, "0") Może to spowodować "0009" .
Dane wyjściowe Jeśli ciąg ma długość większą lub równą długości,zwracany jest ciąg identyczny z ciągiem. Jeśli długość ciągu jest mniejsza niż długość, zwracany jest nowy ciąg o żądanej długości. Nowy ciąg zawiera ciąg wsadowany za pomocą padCharacter. Jeśli ciąg ma wartość null, funkcja zwraca pusty ciąg.

Uwaga:padCharacter może być znakiem spacji, ale nie może być wartością null. Jeśli długość ciągu jest równa lub większa niż długość,ciąg jest zwracany bez zmian.