Udostępnij za pośrednictwem

Synchronizacja programu Microsoft Entra Connect Sync: opis wyrażeń związanych z aprowizacją deklaratywną

  • Artykuł

Usługa Microsoft Entra Połączenie Sync jest oparta na aprowizacji deklaratywnej wprowadzonej po raz pierwszy w programie Forefront Identity Manager 2010. Umożliwia zaimplementowanie pełnej logiki biznesowej integracji tożsamości bez konieczności pisania skompilowanego kodu.

Istotną częścią aprowizacji deklaratywnej jest język wyrażeń używany w przepływach atrybutów. Używany język jest podzbiorem języka Microsoft® Visual Basic® for Applications (VBA). Ten język jest używany w pakiecie Microsoft Office, a użytkownicy korzystający z języka VBScript rozpoznają go również. Deklaratywny język wyrażeń aprowizacyjnych używa tylko funkcji i nie jest językiem ustrukturyzowanym. Nie ma metod ani instrukcji. Funkcje są zamiast tego zagnieżdżone w celu wyrażania przepływu programu.

Aby uzyskać więcej informacji, zobacz Welcome to the Visual Basic for Applications language reference for Office 2013 (Witamy w dokumentacji języka visual basic for Applications dla pakietu Office 2013).

Atrybuty są silnie typizowane. Funkcja akceptuje tylko atrybuty poprawnego typu. Uwzględniana jest również wielkość liter. Nazwy funkcji i nazwy atrybutów muszą mieć prawidłową wielkość liter lub zgłaszany jest błąd.

Definicje języka i identyfikatory

  • Funkcje mają nazwę, a następnie argumenty w nawiasach: FunctionName(argument 1, argument N).
  • Atrybuty są identyfikowane przez nawiasy kwadratowe: [attributeName]
  • Parametry są identyfikowane przez znaki procentowe: %ParameterName%
  • Stałe ciągów są otoczone cudzysłowami: na przykład "Contoso" (Uwaga: musi używać cudzysłowów prostych "", a nie cudzysłowów inteligentnych "")
  • Wartości liczbowe są wyrażane bez cudzysłowów i powinny być dziesiętne. Wartości szesnastkowe są poprzedzone prefiksem &H. Na przykład 98052, &HFF
  • Wartości logiczne są wyrażane przy użyciu stałych: Prawda, Fałsz.
  • Wbudowane stałe i literały są wyrażane tylko przy użyciu ich nazwy: NULL, CRLF, IgnoreThisFlow

Funkcje

Aprowizacja deklaratywna używa wielu funkcji, aby umożliwić przekształcanie wartości atrybutów. Te funkcje mogą być zagnieżdżone, więc wynik z jednej funkcji jest przekazywany do innej funkcji.

Function1(Function2(Function3()))

Pełną listę funkcji można znaleźć w dokumentacji funkcji.

Parametry

Parametr jest definiowany przez Połączenie or lub przez administratora przy użyciu programu PowerShell. Parametry zwykle zawierają wartości, które różnią się od systemu do systemu, na przykład nazwa domeny, w którą znajduje się użytkownik. Te parametry mogą być używane w przepływach atrybutów.

Usługa Active Directory Połączenie or dostarczyła następujące parametry dla reguł synchronizacji ruchu przychodzącego:

Nazwa parametru Komentarz
Domain.Netbios Format Netbios domeny aktualnie importowanej, na przykład FABRIKAMSALES
Domain.FQDN Format FQDN aktualnie importowanej domeny, na przykład sales.fabrikam.com
Domain.LDAP Format LDAP domeny aktualnie importowanej, na przykład DC=sales,DC=fabrikam,DC=com
Forest.Netbios Format Netbios nazwy lasu, który jest obecnie importowany, na przykład FABRIKAMCORP
Nazwa FQDN lasu Format FQDN aktualnie importowanej nazwy lasu, na przykład fabrikam.com
Forest.LDAP Format LDAP nazwy lasu, który jest obecnie importowany, na przykład DC=fabrikam, DC=com

System udostępnia następujący parametr, który służy do pobierania identyfikatora Połączenie or aktualnie uruchomionego:
Connector.ID

Oto przykład, który wypełnia domenę atrybutu metaverse nazwą netbios domeny, w której znajduje się użytkownik:
domain<- %Domain.Netbios%

Operatory

Można użyć następujących operatorów:

  • Porównanie: <, <=, <>, =, >, >=
  • Matematyka: +, -, *, -
  • Ciąg: & (połącz)
  • Logiczna: && (i), || (lub)
  • Kolejność oceny: ( )

Operatory są oceniane od lewej do prawej i mają ten sam priorytet oceny. Oznacza to, że * (mnożnik) nie jest obliczany przed - (odejmowanie). 2*(5+3) nie jest taka sama jak 2*5+3. Nawiasy kwadratowe ( ) są używane do zmiany kolejności oceny, gdy kolejność oceny od lewej do prawej nie jest odpowiednia.

Atrybuty wielowarte

Funkcje mogą działać zarówno na atrybutach jednowartych, jak i wielowartych. W przypadku atrybutów wielowartych funkcja działa nad każdą wartością i stosuje tę samą funkcję do każdej wartości.

Na przykład:
Trim([proxyAddresses]) Wykonaj przycinanie każdej wartości w atrybucie proxyAddress.
Word([proxyAddresses],1,"@") & "@contoso.com" Dla każdej wartości z znakiem @-zastąp domenę ciągiem @contoso.com.
IIF(InStr([proxyAddresses],"SIP:")=1,NULL,[proxyAddresses]) Wyszukaj adres SIP i usuń go z wartości.

Następne kroki

Tematy omówienia

Tematy referencyjne