Sinkronisasi Microsoft Entra Connect: Memahami Ekspresi Penyediaan Deklaratif

  • Artikel

Microsoft Entra Koneksi Sync dibangun pada provisi deklaratif yang pertama kali diperkenalkan di Forefront Identity Manager 2010. Ini memungkinkan Anda untuk menerapkan logika bisnis integrasi identitas lengkap Anda tanpa perlu menulis kode yang dikompilasi.

Bagian penting dari penyediaan deklaratif adalah bahasa pernyataan yang digunakan dalam alur atribut. Bahasa yang digunakan adalah subset Microsoft® Visual Basic® for Applications (VBA). Bahasa ini digunakan di Microsoft Office dan pengguna dengan pengalaman VBScript juga akan mengenalinya. Bahasa Pernyataan Penyediaan Deklaratif hanya menggunakan fungsi dan bukan bahasa terstruktur. Tidak ada metode atau pernyataan. Sebaliknya, fungsi disimpan untuk menyatakan aliran program.

Untuk detail selengkapnya, lihat Selamat Datang di referensi bahasa Visual Basic for Applications untuk Office 2013.

Atributnya diketik dengan jelas. Fungsi hanya menerima atribut dari jenis yang benar. Ini juga peka huruf besar/kecil. Nama fungsi dan nama atribut harus memiliki casing yang tepat atau kesalahan akan ditampilkan.

Definisi bahasa dan Pengidentifikasi

  • Fungsi memiliki nama yang diikuti dengan argumen dalam bracket: FunctionName(argumen 1, argumen N).
  • Atribut diidentifikasi dengan square bracket: [attributeName]
  • Parameter diidentifikasi berdasarkan tanda persen: %ParameterName%
  • Konstanta string dikelilingi oleh tanda kutip: Misalnya, "Contoso" (Catatan: harus menggunakan tanda kutip lurus "" bukan tanda kutip miring{i>
  • Nilai numerik dinyatakan tanpa tanda kutip dan sebaiknya berupa desimal. Nilai heksadesimal diawali dengan &H. Misalnya, 98052, &HFF
  • Nilai Boolean dinyatakan dengan konstanta: True, False.
  • Konstanta dan literal bawaan hanya dinyatakan dengan namanya: NULL, CRLF, IgnoreThisFlow

Fungsi

Penyediaan deklaratif menggunakan banyak fungsi untuk memungkinkan potensi mengubah nilai atribut. Fungsi-fungsi ini dapat disimpan sehingga hasil dari satu fungsi diteruskan ke fungsi lain.

Function1(Function2(Function3()))

Daftar lengkap fungsi dapat ditemukan dalam referensi fungsi.

Parameter

Parameter ditentukan baik oleh Connector atau oleh administrator menggunakan PowerShell. Parameter biasanya berisi nilai yang berbeda dari sistem ke sistem, misalnya nama domain tempat pengguna berada. Parameter ini dapat digunakan dalam aliran atribut.

Active Directory Connector menyediakan parameter berikut untuk Aturan Sinkronisasi masuk:

Nama Parameter Komentar
Domain.Netbios Format netbios domain yang saat ini sedang diimpor, misalnya FABRIKAMSALES
Domain.FQDN Format FQDN dari domain yang saat ini sedang diimpor, misalnya sales.fabrikam.com
Domain.LDAP Format LDAP domain yang saat ini sedang diimpor, misalnya DC=sales,DC=fabrikam,DC=com
Forest.Netbios Format netbios nama forest yang saat ini sedang diimpor, misalnya FABRIKAMCORP
Forest.FQDN Format FQDN dari nama forest yang saat ini sedang diimpor, misalnya fabrikam.com
Forest.LDAP Format LDAP dari nama forest yang saat ini sedang diimpor, misalnya DC=fabrikam,DC=com

Sistem menyediakan parameter berikut, digunakan untuk mendapatkan pengidentifikasi Connector yang saat ini berjalan:
Connector.ID

Berikut adalah contoh yang mengisi domain atribut metaverse dengan nama netbios domain tempat pengguna berada:
domain<- %Domain.Netbios%

Operator

Operator berikut dapat digunakan:

  • Perbandingan: <, <=, <>, =, >, >=
  • Matematika: +, -, *, -
  • String: & (concatenate)
  • Logika: && (and), || (or)
  • Urutan evaluasi: ( )

Operator dievaluasi dari kiri ke kanan dan memiliki prioritas evaluasi yang sama. Artinya, * (pengali) tidak dievaluasi sebelumnya - (pengurangan). 2*(5+3) tidak sama dengan 2*5+3. Bracket ( ) digunakan untuk mengubah urutan evaluasi ketika urutan evaluasi kiri ke kanan tidak sesuai.

Atribut Multinilai

Fungsi ini dapat beroperasi pada atribut bernilai tunggal dan multinilai. Untuk atribut multinilai, fungsi ini beroperasi di setiap nilai dan menerapkan fungsi yang sama untuk setiap nilai.

Misalnya:
Trim([proxyAddresses]) Lakukan Trim dari setiap nilai di atribut proxyAddress.
Word([proxyAddresses],1,"@") & "@contoso.com" Untuk setiap nilai dengan tanda @, ganti domain dengan@contoso.com.
IIF(InStr([proxyAddresses],"SIP:")=1,NULL,[proxyAddresses]) Cari alamat SIP dan hapus dari nilai.

Langkah berikutnya

Topik ringkasan

Topik referensi