Microsoft Entra Koneksi Sync: Referensi Fungsi

  • Artikel

Di Microsoft Entra Koneksi, fungsi digunakan untuk memanipulasi nilai atribut selama sinkronisasi.
Sintaksis fungsi diekspresikan menggunakan format berikut:
<output type> FunctionName(<input type> <position name>, ..)

Jika suatu fungsi kelebihan beban dan menerima beberapa sintaks, semua sintaks yang valid dicantumkan.
Fungsi-fungsi tersebut digolongkan dengan kuat dan fungsi-fungsi memverifikasi bahwa jenis yang diteruskan cocok dengan jenis yang didokumentasikan.
Jika jenisnya tidak cocok, kesalahan dilemparkan.

Jenisnya diekspresikan dengan sintaks berikut:

  • bin – Biner
  • bool - Boolean
  • dt – Tanggal/Waktu UTC
  • enum - Enumerasi konstanta yang dikenal
  • exp - Ekspresi, yang diharapkan untuk mengevaluasi ke Boolean
  • mvbin – Biner Multinilai
  • mvstr – String Multinilai
  • mvref – Referensi Multinilai
  • num – Numerik
  • ref – Referensi
  • str – String
  • var – Varian (hampir) tipe lainnya
  • void – tidak mengembalikan nilai

Fungsi dengan jenis mvbin, mvstr, dan mvref hanya dapat bekerja pada atribut Multinilai. Fungsi dengan bin, str, dan ref bekerja pada atribut bernilai tunggal dan Multinilai.

Referensi Fungsi

BitAnd

Deskripsi:
Fungsi BitAnd menetapkan bit yang ditentukan terhadap suatu nilai.

Sintaks:
num BitAnd(num value1, num value2)

  • value1, value2: nilai numerik yang seharusnya di-AND secara bersamaan

Keterangan:
Fungsi ini mengubah kedua parameter menjadi representasi biner dan menetapkan sedikit ke:

  • 0 - jika salah satu atau kedua bit terkait dalam value1 dan value2 adalah 0
  • 1 - jika kedua bit terkait adalah 1.

Dengan kata lain, Dengan kata lain, 0 ditampilkan dalam semua kasus kecuali saat bit yang sesuai dari kedua parameter adalah 1.

Contoh:
BitAnd(&HF, &HF7)
Menampilkan 7 karena heksadesimal "F" AND "F7" mengevaluasi nilai ini.

BitOr

Deskripsi:
Fungsi BitOr menetapkan bit tertentu pada sebuah nilai.

Sintaks:
num BitOr(num value1, num value2)

  • value1, value2: nilai numerik yang harus digabungkan dengan OR

Keterangan:
Fungsi ini mengubah kedua parameter menjadi representasi biner dan menetapkan bit ke 1 jika salah satu atau kedua bit yang sesuai dalam mask dan bendera adalah 1, dan ke 0 jika kedua bit yang sesuai adalah 0. Dengan kata lain, ia mengembalikan 1 dalam semua kasus kecuali jika bit yang sesuai dari kedua parameter adalah 0.

CBool

Deskripsi:
Fungsi CBool menampilkan Boolean berdasarkan ekspresi yang dievaluasi

Sintaks:
bool CBool(exp Expression)

Keterangan:
Jika ekspresi tersebut mengevaluasi nilai yang bukan nol, maka CBool menampilkan nilai True, sebaliknya menampilkan nilai False.

Contoh:
CBool([attrib1] = [attrib2])

Menampilkan nilai True jika kedua atribut memiliki nilai yang sama.

CDate

Deskripsi:
Fungsi CDate mengembalikan DateTime UTC dari string. DateTime bukan tipe atribut asli di Sync tetapi digunakan oleh beberapa fungsi.

Sintaks:
dt CDate(str value)

  • Nilai: Sebuah string dengan tanggal, waktu, dan zona waktu opsional

Keterangan:
String yang dikembalikan selalu dalam UTC.

Contoh:
CDate([employeeStartTime])
Mengembalikan DateTime berdasarkan waktu mulai karyawan

CDate("2013-01-10 4:00 PM -8")
Mengembalikan DateTime yang mewakili "2013-01-11 12:00 AM"

CertExtensionOids

Deskripsi:
Mengembalikan nilai Oid dari semua ekstensi penting dari objek sertifikat.

Sintaks:
mvstr CertExtensionOids(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertFormat

Deskripsi:
Menampilkan nama format sertifikat X.509v3 ini.

Sintaks:
str CertFormat(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertFriendlyName

Deskripsi:
Mengembalikan alias terkait untuk sertifikat.

Sintaks:
str CertFriendlyName(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertHashString

Deskripsi:
Mengembalikan nilai hash SHA1 untuk sertifikat X.509v3 sebagai string heksadesimal.

Sintaks:
str CertHashString(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertIssuer

Deskripsi:
Menampilkan nama otoritas sertifikat yang menerbitkan sertifikat X.509v3.

Sintaks:
str CertIssuer(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertIssuerDN

Deskripsi:
Mengembalikan nama dibedakan dari penerbit sertifikat.

Sintaks:
str CertIssuerDN(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertIssuerOid

Deskripsi:
Mengembalikan Oid penerbit sertifikat.

Sintaks:
str CertIssuerOid(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertKeyAlgorithm

Deskripsi:
Mengembalikan informasi algoritme kunci untuk sertifikat X.509v3 ini sebagai string.

Sintaks:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertKeyAlgorithmParams

Deskripsi:
Mengembalikan parameter algoritme kunci untuk sertifikat X.509v3 sebagai string heksadesimal.

Sintaks:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertNameInfo

Deskripsi:
Mengembalikan subjek dan nama penerbit dari sertifikat.

Sintaks:
str CertNameInfo(binary certificateRawData, str x509NameType, bool includesIssuerName)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.
  • X509NameType: Nilai X509NameType untuk subjek.
  • includeIssuerName: true untuk menyertakan nama penerbit; jika tidak, salah.

CertNotAfter

Deskripsi:
Mengembalikan tanggal dalam waktu lokal setelah sertifikat tidak lagi valid.

Sintaks:
dt CertNotAfter(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertNotBefore

Deskripsi:
Mengembalikan tanggal dalam waktu lokal di mana sertifikat menjadi valid.

Sintaks:
dt CertNotBefore(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertPublicKeyOid

Deskripsi:
Mengembalikan Oid dari kunci publik untuk sertifikat X.509v3.

Sintaks:
str CertKeyAlgorithm(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertPublicKeyParametersOid

Deskripsi:
Mengembalikan Oid dari parameter kunci publik untuk sertifikat X.509v3.

Sintaks:
str CertPublicKeyParametersOid(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertSerialNumber

Deskripsi:
Menampilkan nomor seri sertifikat X.509v3.

Sintaks:
str CertSerialNumber(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertSignatureAlgorithmOid

Deskripsi:
Mengembalikan Oid dari algoritme yang digunakan untuk membuat tanda tangan sertifikat.

Sintaks:
str CertSignatureAlgorithmOid(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertSubject

Deskripsi:
Mendapat nama yang dibedakan subjek dari sertifikat.

Sintaks:
str CertSubject(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertSubjectNameDN

Deskripsi:
Mengembalikan subjek yang dibedakan nama dari sertifikat.

Sintaks:
str CertSubjectNameDN(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertSubjectNameOid

Deskripsi:
Mengembalikan Oid dari nama subjek dari sertifikat.

Sintaks:
str CertSubjectNameOid(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertThumbprint

Deskripsi:
Mengembalikan cap jempol sertifikat.

Sintaks:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CertVersion

Deskripsi:
Mengembalikan versi format X.509 dari sertifikat.

Sintaks:
str CertThumbprint(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

CGuid

Deskripsi:
Fungsi CGuid mengubah representasi string dari GUID ke representasi binernya.

Sintaks:
bin CGuid(str GUID)

  • String yang diformat dalam pola ini: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx atau {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Contains

Deskripsi:
Fungsi Contains menemukan string di dalam atribut multi-nilai

Sintaks:
num Contains (mvstring attribute, str search) - peka huruf besar/kecil
num Contains (mvstring attribute, str search, enum Casetype)
num Contains (mvref attribute, str search) - peka huruf besar/kecil

  • atribut: atribut multi-nilai yang akan dicari.
  • cari: string untuk ditemukan di atribut.
  • Casetype: CaseInsensitive atau CaseSensitive.

Mengembalikan indeks dalam atribut multi-nilai tempat string itu ditemukan. 0 dikembalikan jika string tidak ditemukan.

Keterangan:
Untuk atribut string multi-nilai, pencarian menemukan substring dalam nilai.
Untuk atribut referensi, string yang dicari harus sama persis dengan nilai agar dianggap cocok.

Contoh:
IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("No primary SMTP address found."))
Jika atribut proxyAddresses memiliki alamat email primer (ditunjukkan dengan huruf besar "SMTP:"), kembalikan atribut proxyAddress, jika tidak, kembalikan kesalahan.

ConvertFromBase64

Deskripsi:
Fungsi ConvertFromBase64 mengonversi nilai base64 tertentu yang dikodekan menjadi string reguler.

Sintaks:
str ConvertFromBase64(str source) - menggunakan Unicode untuk pengodean
str ConvertFromBase64(str source, enum Encoding)

  • sumber: String Base64 yang dikodekan
  • Pengodean: Unicode, ASCII, UTF8

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

Kedua contoh menampilkan "Halo dunia!"

ConvertFromUTF8Hex

Deskripsi:
Fungsi ConvertFromUTF8Hex mengonversi nilai yang dikodekan UTF8 Hex menjadi string.

Sintaks:
str ConvertFromUTF8Hex(str source)

  • sumber: string berenkode UTF8 2-byte

Keterangan:
Perbedaan antara fungsi ini dan ConvertFromBase64 ([], UTF8) adalah hasilnya ramah untuk atribut DN.
Format ini digunakan oleh MICROSOFT Entra ID sebagai DN.

Contoh:
ConvertFromUTF8Hex("48656C6C6F20776F726C6421")
Kembali "Halo dunia!"

ConvertToBase64

Deskripsi:
Fungsi ConvertToBase64 mengonversi sebuah string menjadi string base64 Unicode.
Mengonversi nilai suatu array bilangan bulat ke representasi string yang setara yang dikodekan dengan digit base-64.

Sintaks:
str ConvertToBase64(str source)

Contoh:
ConvertToBase64("Hello world!")
Mengembalikan "SABlAGwAbABvACAAdwBvAHIAbABkACEA"

ConvertToUTF8Hex

Deskripsi:
Fungsi ConvertToUTF8Hex mengonversi sebuah string menjadi nilai UTF8 Hex yang dikodekan.

Sintaks:
str ConvertToUTF8Hex(str source)

Keterangan:
Format output fungsi ini digunakan oleh MICROSOFT Entra ID sebagai format atribut DN.

Contoh:
ConvertToUTF8Hex("Hello world!")
Mengembalikan 48656C6C6F20776F726C6421

Hitung

Deskripsi:
Fungsi Count menampilkan jumlah elemen dalam atribut multinilai

Sintaks:
num Count(mvstr attribute)

CNum

Deskripsi:
Fungsi CNum mengambil string dan mengembalikan tipe data numerik.

Sintaks:
num CNum(str value)

CRef

Deskripsi:
Mengonversi string menjadi atribut referensi

Sintaks:
ref CRef(str value)

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

Cstr

Deskripsi:
Fungsi CStr mengonversi menjadi jenis data string.

Sintaks:
str CStr(num value)
str CStr(ref value)
str CStr(bool value)

  • nilai: Dapat berupa nilai numerik, atribut referensi, atau Boolean.

Contoh:
CStr([dn])
Dapat menampilkan "cn=Joe,dc=contoso,dc=com"

DateAdd

Deskripsi:
Mengembalikan Tanggal yang berisi tanggal di mana interval waktu tertentu telah ditambahkan.

Sintaks:
dt DateAdd(str interval, num value, dt date)

  • interval: Ekspresi string yang merupakan interval waktu yang ingin Anda tambahkan. String harus memiliki salah satu nilai berikut:
    • Tahun yyyy
    • q Kuartal
    • m Bulan
    • y Hari dalam setahun
    • d Hari
    • w Hari kerja
    • ww Minggu
    • h Jam
    • n Menit
    • s Detik
  • nilai: Jumlah unit yang ingin Anda tambahkan. Bisa positif (mendapatkan tanggal di masa mendatang) atau negatif (mendapatkan tanggal di masa lalu).
  • tanggal: DateTime mewakili tanggal di mana interval ditambahkan.

Contoh:
DateAdd("m", 3, CDate("2001-01-01"))
Menambahkan 3 bulan dan mengembalikan DateTime yang mewakili "2001-04-01".

DateFromNum

Deskripsi:
Fungsi DateFromNum mengonversi nilai dalam format tanggal AD menjadi jenis DateTime.

Sintaks:
dt DateFromNum(num value)

Contoh:
DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
Mengembalikan DateTime yang mewakili 2012-01-01 23:00:00

DNComponent

Deskripsi:
Fungsi DNComponent menampilkan nilai suatu komponen DN tertentu dari sebelah kiri.

Sintaks:
str DNComponent(ref dn, num ComponentNumber)

  • dn: atribut referensi untuk diartikan
  • ComponentNumber: Komponen dalam DN untuk ditampilkan

Contoh:
DNComponent(CRef([dn]),1)
Jika dn adalah "cn=Joe,ou=…," akan menampilkan Joe

DNComponentRev

Deskripsi:
Fungsi DNComponentRev mengembalikan nilai komponen DN yang ditentukan dari kanan (akhir).

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

  • dn: atribut referensi untuk diartikan
  • ComponentNumber - Komponen dalam DN yang akan dikembalikan
  • Opsi: DC - Abaikan semua komponen dengan "dc="

Contoh:
Jika dn adalah "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" maka
DNComponentRev(CRef([dn]),3)
DNComponentRev(CRef([dn]),1,"DC")
Keduanya kembali AS.

Kesalahan

Deskripsi:
Fungsi Error digunakan untuk menampilkan kesalahan kustom.

Sintaks:
void Error(str ErrorMessage)

Contoh:
IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))
Jika atribut accountName tidak ada, melemparkan kesalahan pada objek.

EscapeDNComponent

Deskripsi:
Fungsi EscapeDNComponent mengambil satu komponen DN dan meloloskan diri sehingga dapat direpresentasikan dalam LDAP.

Sintaks:
str EscapeDNComponent(str value)

Contoh:
EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%)
Memastikan objek dapat dibuat di direktori LDAP meskipun atribut displayName memiliki karakter yang harus di-escape di LDAP.

FormatDateTime

Deskripsi:
Fungsi FormatDateTime digunakan untuk memformat DateTime menjadi string dengan format tertentu

Sintaks:
str FormatDateTime(dt value, str format)

  • nilai: nilai dalam format DateTime
  • format: string yang mewakili format untuk dikonversi ke.

Keterangan:
Nilai yang mungkin untuk format dapat ditemukan di sini: Format tanggal dan waktu kustom untuk fungsi FORMAT.

Contoh:

FormatDateTime(CDate("12/25/2007"),"yyyy-MM-dd")
Menghasilkan "2007-12-25".

FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")
Dapat menghasilkan "20140905081453.0Z"

Guid

Deskripsi:
Fungsi Guid menghasilkan GUID baru secara acak

Sintaks:
str Guid()

IIF

Deskripsi:
Fungsi IIF menampilkan salah satu kemungkinan set nilai berdasarkan syarat yang ditentukan.

Sintaks:
var IIF(exp condition, var valueIfTrue, var valueIfFalse)

  • condition: nilai atau ekspresi yang dapat dievaluasi menjadi nilai true atau false.
  • valueIfTrue: Jika condition mengevaluasi nilai true, nilai yang ditampilkan.
  • valueIfFalse: Jika condition mengevaluasi nilai false, nilai yang ditampilkan.

Contoh:
IIF([employeeType]="Intern","t-" & [alias],[alias])
Jika pengguna adalah pegawai magang, menampilkan nama alias pengguna dengan "t-" yang ditambahkan di depan, jika tidak menampilkan nama alias pengguna sesuai yang tertera.

InStr

Deskripsi:
Fungsi InStr menemukan kemunculan pertama suatu substring dalam sebuah string

Sintaks:

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: string untuk dicari
  • stringmatch: string untuk ditemukan
  • start: posisi awal untuk menemukan substring
  • compare: vbTextCompare atau vbBinaryCompare

Keterangan:
Menampilkan posisi di mana substring ditemukan atau 0 jika tidak ditemukan.

Contoh:
InStr("The quick brown fox","quick")
Mengevaluasi ke 5

InStr("repEated","e",3,vbBinaryCompare)
Mengevaluasi ke 7

InStrRev

Deskripsi:
Fungsi InStrRev menemukan kemunculan terakhir substring dalam sebuah string

Sintaks:
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: string untuk dicari
  • stringmatch: string untuk ditemukan
  • start: posisi awal untuk menemukan substring
  • compare: vbTextCompare atau vbBinaryCompare

Keterangan:
Menampilkan posisi di mana substring ditemukan atau 0 jika tidak ditemukan.

Contoh:
InStrRev("abbcdbbbef","bb")
Mengembalikan 7

IsBitSet

Deskripsi:
Fungsi IsBitSet Menguji apakah bit disetel atau tidak

Sintaks:
bool IsBitSet(num value, num flag)

  • nilai: nilai numerik yang dievaluasi. bendera: nilai numerik yang memiliki bit untuk dievaluasi

Contoh:
IsBitSet(&HF,4)
Mengembalikan True karena bit "4" diatur dalam nilai heksadesimal "F"

IsDate

Deskripsi:
Jika ekspresi dapat dievaluasi sebagai tipe DateTime, maka fungsi IsDate mengevaluasi ke True.

Sintaks:
bool IsDate(var Expression)

Keterangan:
Digunakan untuk menentukan apakah CDate () bisa berhasil.

IsCert

Deskripsi:
Mengembalikan nilai true jika data mentah dapat diserialkan ke dalam objek sertifikat .NET X509Certificate2.

Sintaks:
bool CertThumbprint(binary certificateRawData)

  • certificateRawData: Representasi array byte dari sertifikat X.509. Array byte dapat berupa data berenkode biner (DER) atau X.509 berenkode Base64.

IsEmpty

Deskripsi:
Jika atribut ada di CS atau MV tetapi dievaluasi ke string kosong, maka fungsi IsEmpty mengevaluasi ke True.

Sintaks:
bool IsEmpty(var Expression)

IsGuid

Deskripsi:
Jika string dapat dikonversi ke GUID, maka fungsi IsGuid dievaluasi ke benar.

Sintaks:
bool IsGuid(str GUID)

Keterangan:
GUID didefinisikan sebagai string yang mengikuti salah satu pola berikut: xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx atau {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Digunakan untuk menentukan apakah CGuid () bisa berhasil.

Contoh:
IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)
Jika StrAttribute memiliki format GUID, kembalikan representasi biner, jika tidak, kembalikan Null.

IsNull

Deskripsi:
Jika ekspresi tersebut mengevaluasi Null, maka fungsi IsNull menampilkan nilai true.

Sintaks:
bool IsNull(var Expression)

Keterangan:
Untuk atribut, Null dinyatakan oleh tidak adanya atribut.

Contoh:
IsNull([displayName])
Menampilkan nilai True jika atribut tidak ada dalam CS atau MV.

IsNullOrEmpty

Deskripsi:
Jika ekspresi adalah null atau string kosong, maka fungsi IsNullOrEmpty menampilkan nilai true.

Sintaks:
bool IsNullOrEmpty(var Expression)

Keterangan:
Untuk atribut, ini akan mengevaluasi ke nilai True jika atribut tidak ada atau ada tetapi merupakan string kosong.
Inversi dari fungsi ini bernama IsPresent.

Contoh:
IsNullOrEmpty([displayName])
Menampilkan nilai True jika atribut tidak ada atau merupakan string kosong dalam CS atau MV.

IsNumeric

Deskripsi:
Fungsi IsNumeric mengembalikan nilai Boolean yang menunjukkan apakah ekspresi dapat dievaluasi sebagai tipe angka.

Sintaks:
bool IsNumeric(var Expression)

Keterangan:
Digunakan untuk menentukan apakah CNum () bisa berhasil mengurai ekspresi.

IsString

Deskripsi:
Jika ekspresi dapat dievaluasi ke dalam jenis string, maka evaluasi fungsi IsString menunjukkan nilai True.

Sintaks:
bool IsString(var expression)

Keterangan:
Digunakan untuk menentukan jika CStr() dapat berhasil mengurai ekspresi tersebut.

IsPresent

Deskripsi:
Jika ekspresi tersebut mengevaluasi string yang tidak Null dan tidak kosong, maka fungsi IsPresent menampilkan nilai true.

Sintaks:
bool IsPresent(var expression)

Keterangan:
Inversi dari fungsi ini bernama IsNullOrEmpty.

Contoh:
Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])

Item

Deskripsi:
Fungsi Item menampilkan satu item dari string/atribut multinilai.

Sintaks:
var Item(mvstr attribute, num index)

  • attribute: atribut multinilai
  • index: indeks suatu item dalam string multinilai.

Keterangan:
Fungsi Item berguna saat dipadukan dengan fungsi Contains karena fungsi Item menampilkan indeks suatu item dalam atribut multinilai.

Melemparkan kesalahan jika indeks berada di luar jangkauan.

Contoh:
Mid(Item([proxyAddresses],Contains([proxyAddresses], "SMTP:")),6)
Menampilkan alamat email utama.

ItemOrNull

Deskripsi:
Fungsi ItemOrNull mengembalikan satu item dari string / atribut multi-nilai.

Sintaks:
var ItemOrNull(mvstr attribute, num index)

  • attribute: atribut multinilai
  • index: indeks suatu item dalam string multinilai.

Keterangan:
Fungsi ItemOrNull berguna bersama dengan fungsi Contains karena fungsi terakhir mengembalikan indeks ke item dalam atribut multi-nilai.

Jika indeks di luar batas, maka mengembalikan nilai Null.

Bergabung

Deskripsi:
Fungsi Gabung mengambil string multi-nilai dan mengembalikan string bernilai tunggal dengan pemisah tertentu yang disisipkan di antara setiap item.

Sintaks:
str Join(mvstr attribute)
str Join(mvstr attribute, str Delimiter)

  • atribut: Atribut multi-nilai yang berisi string yang akan digabungkan.
  • pembatas: String apa pun, digunakan untuk memisahkan substring dalam string yang dikembalikan. Jika dihilangkan, karakter spasi (" ") digunakan. Jika Pembatas adalah string panjang nol ("") atau Tidak Ada, semua item dalam daftar disaat tanpa pembatas.

Keterangan
Ada kesamaan antara fungsi Gabung dan Pisahkan. Fungsi Gabung mengambil array string dan menggabungkannya menggunakan string pemisah, untuk mengembalikan satu string. Fungsi Split mengambil string dan memisahkannya di pemisah, untuk mengembalikan array string. Namun, perbedaan utamanya adalah Gabung dapat menggabungkan string dengan string pemisah apa pun, Pisahkan hanya dapat memisahkan string menggunakan pemisah karakter tunggal.

Contoh:
Join([proxyAddresses],",")
Bisa kembali: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"

LCase

Deskripsi:
Fungsi LCase mengubah semua karakter dalam string menjadi huruf kecil.

Sintaks:
str LCase(str value)

Contoh:
LCase("TeSt")
Mengembalikan "Pengujian".

Left

Deskripsi:
Fungsi Left menampilkan sejumlah karakter tertentu dari bagian kiri string.

Sintaks:
str Left(str string, num NumChars)

  • string: string yang akan menampilkan karakter
  • NumChars: angka yang menunjukkan jumlah karakter untuk ditampilkan dari awal (kiri) string

Keterangan:
String yang berisi karakter numChars pertama dalam string:

  • Jika numChars = 0, mengembalikan string kosong.
  • Jika numChars < 0, kembalikan string input.
  • Jika string null, mengembalikan string kosong.

Jika string berisi lebih sedikit karakter daripada jumlah yang ditentukan dalam numChars, string yang identik dengan string (yaitu, berisi semua karakter dalam parameter 1) ditampilkan.

Contoh:
Left("John Doe", 3)
Menampilkan "Joh".

Len

Deskripsi:
Fungsi Len mengembalikan jumlah karakter dalam sebuah string.

Sintaks:
num Len(str value)

Contoh:
Len("John Doe")
Mengembalikan 8

LTrim

Deskripsi:
Fungsi LTrim menghapus spasi putih terdepan dari sebuah string.

Sintaks:
str LTrim(str value)

Contoh:
LTrim(" Test ")
Mengembalikan "Pengujian"

Mid

Deskripsi:
Fungsi Mid mengembalikan sejumlah karakter tertentu dari posisi tertentu dalam string.

Sintaks:
str Mid(str string, num start, num NumChars)

  • string: string yang akan menampilkan karakter
  • start: angka yang mengidentifikasi posisi awal dalam string untuk mengembalikan karakter
  • NumChars: angka yang mengidentifikasi jumlah karakter yang akan dikembalikan dari posisi dalam string

Keterangan:
Kembalikan karakter numChars mulai dari posisi awal dalam string.
Sebuah string yang berisi karakter numChars dari posisi awal dalam string:

  • Jika numChars = 0, mengembalikan string kosong.
  • Jika numChars < 0, kembalikan string input.
  • Jika memulai > panjang string, kembalikan input string.
  • Jika memulai <= 0, kembalikan string masukan.
  • Jika string null, mengembalikan string kosong.

Jika tidak ada karakter numChar yang tersisa dalam string dari posisi awal, sebanyak mungkin karakter dikembalikan.

Contoh:
Mid("John Doe", 3, 5)
Mengembalikan "hn Do".

Mid("John Doe", 6, 999)
Mengembalikan "Doe"

Now

Deskripsi:
Fungsi Now mengembalikan DateTime yang menentukan tanggal dan waktu saat ini, sesuai dengan tanggal dan waktu sistem komputer Anda.

Sintaks:
dt Now()

NumFromDate

Deskripsi:
Fungsi NumFromDate mengembalikan tanggal dalam format tanggal AD.

Sintaks:
num NumFromDate(dt value)

Contoh:
NumFromDate(CDate("2012-01-01 23:00:00"))
Mengembalikan 129699324000000000

padLeft

Deskripsi:
Fungsi PadLeft meninggalkan string dengan panjang tertentu menggunakan karakter padding yang disediakan.

Sintaks:
str PadLeft(str string, num length, str padCharacter)

  • string: string ke pad.
  • panjang: bilangan bulat yang mewakili panjang string yang diinginkan.
  • padCharacter: Sebuah string yang terdiri dari satu karakter untuk digunakan sebagai karakter pad

Keterangan:

  • Jika panjang string kurang dari panjang, maka padCharacter berulang kali ditambahkan ke awal (kiri) string hingga panjangnya sama dengan panjang.
  • PadCharacter bisa menjadi karakter spasi, tetapi tidak bisa menjadi nilai kosong.
  • Jika panjang string sama dengan atau lebih besar dari panjang, string dikembalikan tidak berubah.
  • Jika string memiliki panjang lebih dari atau sama dengan panjang, string yang identik dengan string dikembalikan.
  • Jika panjang string kurang dari panjang, maka string baru dengan panjang yang diinginkan dikembalikan berisi string yang diisi padCharacter.
  • Jika string nol, fungsi mengembalikan string kosong.

Contoh:
PadLeft("User", 10, "0")
Mengembalikan "000000User".

PadRight

Deskripsi:
Fungsi PadRight memasukkan string ke kanan ke panjang tertentu menggunakan karakter padding yang disediakan.

Sintaks:
str PadRight(str string, num length, str padCharacter)

  • string: string ke pad.
  • panjang: bilangan bulat yang mewakili panjang string yang diinginkan.
  • padCharacter: Sebuah string yang terdiri dari satu karakter untuk digunakan sebagai karakter pad

Keterangan:

  • Jika panjang string kurang dari panjang, maka padCharacter berulang kali ditambahkan ke ujung (kanan) string hingga memiliki panjang yang sama dengan panjangnya.
  • PadCharacter bisa menjadi karakter spasi, tetapi tidak bisa menjadi nilai kosong.
  • Jika panjang string sama dengan atau lebih besar dari panjang, string dikembalikan tidak berubah.
  • Jika string memiliki panjang lebih dari atau sama dengan panjang, string yang identik dengan string dikembalikan.
  • Jika panjang string kurang dari panjang, maka string baru dengan panjang yang diinginkan dikembalikan berisi string yang diisi padCharacter.
  • Jika string nol, fungsi mengembalikan string kosong.

Contoh:
PadRight("User", 10, "0")
Mengembalikan "User000000".

PCase

Deskripsi:
Fungsi PCase mengubah karakter pertama dari setiap kata yang dipisahkan spasi dalam string menjadi huruf besar, dan semua karakter lainnya diubah menjadi huruf kecil.

Sintaks:
String PCase(string)

Keterangan:

  • Fungsi ini saat ini tidak menyediakan kapitalisasi yang tepat untuk mengubah kata yang seluruhnya menggunakan huruf besar, seperti akronim.

Contoh:
PCase("TEsT")
Mengembalikan "Pengujian".

PCase(LCase("TEST"))
Mengembalikan "Pengujian"

RandomNum

Deskripsi:
Fungsi RandomNum mengembalikan angka acak di antara interval yang ditentukan.

Sintaks:
num RandomNum(num start, num end)

  • memulai: angka yang mengidentifikasi batas bawah dari nilai acak yang akan dihasilkan
  • mengakhiri: angka yang mengidentifikasi batas atas dari nilai acak yang akan dihasilkan

Contoh:
Random(100,999)
Bisa mengembalikan 734.

RemoveDuplicates

Deskripsi:
Fungsi RemoveDuplicates mengambil string multinilai dan memastikan bahwa setiap nilai bersifat unik.

Sintaks:
mvstr RemoveDuplicates(mvstr attribute)

Contoh:
RemoveDuplicates([proxyAddresses])
Menampilkan atribut proxyAddress yang sudah dibersihkan di mana semua nilai duplikat sudah dihapus.

Menggantikan

Deskripsi:
Fungsi Replace menggantikan semua kemunculan string ke string lain.

Sintaks:
str Replace(str string, str OldValue, str NewValue)

  • string: String untuk menggantikan nilai.
  • OldValue: String yang akan dicari dan diganti.
  • NewValue: String yang akan diganti.

Keterangan:
Fungsi ini mengenali moniker khusus berikut:

  • \n – Baris Baru
  • \r – Pengembalian Pengangkutan
  • \t – Tab

Contoh:
Replace([address],"\r\n",", ")
Mengganti CRLF dengan koma dan ruang, dan dapat menyebabkan "One Microsoft Way, Redmond, WA, USA"

ReplaceChars

Deskripsi:
Fungsi ReplaceChars menggantikan semua kemunculan karakter yang ditemukan dalam string ReplacePattern.

Sintaks:
str ReplaceChars(str string, str ReplacePattern)

  • string: String untuk menggantikan karakter.
  • ReplacePattern: string yang berisi kamus dengan karakter untuk diganti.

Formatnya adalah {source1}:{target1},{source2}:{target2},{sourceN},{targetN} di mana sumber adalah karakter untuk menemukan dan menargetkan string untuk diganti.

Keterangan:

  • Fungsi ini mengambil setiap kemunculan sumber yang ditentukan dan menggantinya dengan target.
  • Sumbernya harus persis satu (unicode) karakter.
  • Sumber tidak boleh kosong atau lebih panjang dari satu karakter (kesalahan penguraian).
  • Target dapat memiliki beberapa karakter, misalnya ö:oe, β:ss.
  • Target dapat kosong menunjukkan bahwa karakter harus dihapus.
  • Sumbernya peka huruf besar/kecil dan harus sama persis.
  • , (koma) dan : (titik dua) adalah karakter yang dipesan dan tidak dapat diganti menggunakan fungsi ini.
  • Spasi dan karakter putih lainnya dalam string ReplacePattern diabaikan.

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

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

ReplaceChars("O’Neil",%ReplaceString%)
Mengembalikan "ONeil", satu tanda centang didefinisikan untuk dihapus.

Deskripsi:
Fungsi Right mengembalikan sejumlah karakter tertentu dari kanan (ujung) string.

Sintaks:
str Right(str string, num NumChars)

  • string: string yang akan menampilkan karakter
  • NumChars: angka yang mengidentifikasi jumlah karakter yang akan dikembalikan dari akhir (kanan) string

Keterangan:
Karakter NumChars dikembalikan dari posisi terakhir string.

String yang berisi karakter numChars terakhir dalam string:

  • Jika numChars = 0, mengembalikan string kosong.
  • Jika numChars < 0, kembalikan string input.
  • Jika string null, mengembalikan string kosong.

Jika string berisi karakter lebih sedikit dari jumlah yang ditentukan di NumChars, string yang identik dengan string dikembalikan.

Contoh:
Right("John Doe", 3)
Mengembalikan "Doe".

RTrim

Deskripsi:
Fungsi RTrim menghapus spasi putih berikutnya dari string.

Sintaks:
str RTrim(str value)

Contoh:
RTrim(" Test ")
Mengembalikan "Pengujian".

Pilih

Deskripsi:
Memproses semua nilai dalam atribut multi-nilai (atau keluaran ekspresi) berdasarkan fungsi yang ditentukan.

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

  • item: Mewakili elemen dalam atribut multi-nilai
  • attribute: atribut multinilai
  • ekspresi: ekspresi yang mengembalikan kumpulan nilai
  • kondisi: fungsi apa pun yang dapat memproses item dalam atribut

Contoh:
Select($item,[otherPhone],Replace($item,"-",""))
Mengembalikan semua nilai dalam atribut multi-nilai otherPhone setelah tanda hubung (-) dihapus.

Split

Deskripsi:
Fungsi Split mengambil string yang dipisahkan dengan pemisah dan menjadikannya string multi-nilai.

Sintaks:
mvstr Split(str value, str delimiter)
mvstr Split(str value, str delimiter, num limit)

  • nilai: string dengan karakter pembatas untuk dipisahkan.
  • pembatas: karakter tunggal yang akan digunakan sebagai pembatas.
  • batas: jumlah maksimum nilai yang dapat dikembalikan.

Contoh:
Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")
Mengembalikan string multinilai dengan 2 elemen yang berguna untuk atribut proxyAddress.

StringDariGuid

Deskripsi:
Fungsi StringFromGuid mengambil GUID biner dan mengubahnya menjadi string

Sintaks:
str StringFromGuid(bin GUID)

StringFromSid

Deskripsi:
Fungsi StringFromSid mengonversi array byte yang berisi pengidentifikasi keamanan menjadi sebuah string.

Sintaks:
str StringFromSid(bin ObjectSID)

Mengalihkan

Deskripsi:
Fungsi Switch digunakan untuk mengembalikan satu nilai berdasarkan kondisi yang dievaluasi.

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

  • expr: Ekspresi varian yang ingin Anda evaluasi.
  • nilai: Nilai yang akan dikembalikan jika ekspresi terkait adalah True.

Keterangan:
Daftar argumen fungsi Switch terdiri dari pasangan ekspresi dan nilai. Ekspresi dievaluasi dari kiri ke kanan, dan nilai yang terkait dengan ekspresi pertama yang akan dievaluasi ke True dikembalikan. Jika bagian-bagian tersebut tidak dipasangkan dengan benar, kesalahan waktu proses akan terjadi.

Misalnya, jika expr1 true, Switch mengembalikan value1. Jika expr-1 False, tetapi expr-2 adalah True, Switch mengembalikan value-2, dan seterusnya.

Switch mengembalikan Nothing jika:

  • Tidak ada ekspresi yang Benar.
  • Ekspresi Benar pertama memiliki nilai terkait yaitu Null.

Switch mengevaluasi semua ekspresi, meskipun hanya mengembalikan salah satu dari ekspresi tersebut. Untuk alasan ini, Anda harus mengawasi efek samping yang tidak diinginkan. Misalnya, jika evaluasi ekspresi apa pun menghasilkan kesalahan pembagian dengan nol, kesalahan terjadi.

Nilai juga bisa menjadi fungsi Kesalahan, yang akan mengembalikan string kustom.

Contoh:
Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))
Mengembalikan bahasa yang digunakan di beberapa kota besar, jika tidak mengembalikan Kesalahan.

Trim

Deskripsi:
Fungsi Trim menghapus spasi kosong di awal dan akhir suatu string.

Sintaks:
str Trim(str value)

Contoh:
Trim(" Test ")
Mengembalikan "Pengujian".

Trim([proxyAddresses])
Menghapus spasi di depan dan di belakang untuk setiap nilai dalam atribut proxyAddress.

UCase

Deskripsi:
Fungsi UCase mengonversi semua karakter dalam string ke huruf besar.

Sintaks:
str UCase(str string)

Contoh:
UCase("TeSt")
Mengembalikan "PENGUJIAN".

Di mana

Deskripsi:
Mengembalikan subset nilai dari atribut multi-nilai (atau keluaran ekspresi) berdasarkan kondisi tertentu.

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

  • item: Mewakili elemen dalam atribut multi-nilai
  • attribute: atribut multinilai
  • condition: ekspresi apa pun yang dapat dievaluasi menjadi benar atau salah
  • ekspresi: ekspresi yang mengembalikan kumpulan nilai

Contoh:
Where($item,[userCertificate],CertNotAfter($item)>Now())
Mengembalikan nilai sertifikat dalam atribut multinilai userCertificate yang tidak kedaluwarsa.

With

Deskripsi:
Fungsi With menyediakan cara untuk menyederhanakan ekspresi kompleks dengan menggunakan variabel untuk merepresentasikan subekspresi yang muncul satu kali atau lebih dalam ekspresi kompleks.

Sintaks:With(var variable, exp subExpression, exp complexExpression)

  • variabel: Mewakili subekspresi.
  • subExpression: subekspresi yang diwakili oleh variabel.
  • complexExpression: Ekspresi yang kompleks.

Contoh:
With($unExpiredCerts,Where($item,[userCertificate],CertNotAfter($item)>Now()),IIF(Count($unExpiredCerts)>0,$unExpiredCerts,NULL))
Secara fungsional setara dengan:
IIF (Count(Where($item,[userCertificate],CertNotAfter($item)>Now()))>0, Where($item,[userCertificate],CertNotAfter($item)>Now()),NULL)
Yang mengembalikan hanya nilai sertifikat yang belum terekspirasi di atribut userCertificate.

Word

Deskripsi:
Fungsi Word menampilkan kata yang terkandung di dalam suatu string, berdasarkan parameter yang menjelaskan pemisah yang harus digunakan serta jumlah kata yang ditampilkan.

Sintaks:
str Word(str string, num WordNumber, str delimiters)

  • string: string untuk menampilkan kata.
  • WordNumber: angka yang mengidentifikasi angka kata mana yang akan ditampilkan.
  • delimiters: string yang mewakili pemisah yang harus digunakan untuk mengidentifikasi kata

Keterangan:
Setiap string karakter dalam string yang dipisahkan oleh salah satu karakter dalam pemisah diidentifikasi sebagai kata:

  • Jika jumlah < 1, menampilkan string kosong.
  • Jika string null, menampilkan string kosong.

Jika string berisi kurang dari kata angka, atau string tidak berisi kata apa pun yang diidentifikasi oleh pemisah, string kosong akan ditampilkan.

Contoh:
Word("The quick brown fox",3," ")
Menampilkan "coklat"

Word("This,string!has&many separators",3,",!&#")
Akan menampilkan "telah"

Sumber Daya Tambahan