Referensi fungsi untuk Microsoft Identity Manager 2016

Di Microsoft Identity Manager (MIM) 2016, fungsi memungkinkan Anda mengubah nilai atribut sebelum mengalirkannya ke target dalam aktivitas fungsi atau provisi deklaratif. Tujuan dokumen ini adalah untuk memberi Anda gambaran umum tentang fungsi yang tersedia dan deskripsi tentang bagaimana Anda dapat menggunakannya.

Mengonfigurasi pemetaan aliran atribut adalah tugas dasar saat mengonfigurasi aturan sinkronisasi. Bentuk paling sederhana dari pemetaan aliran atribut adalah pemetaan langsung. Seperti yang ditunjukkan oleh namanya, pemetaan langsung mengambil nilai atribut sumber dan menerapkannya ke atribut tujuan yang dikonfigurasi. Ada kasus di mana Anda memerlukan nilai atribut yang ada untuk dimodifikasi atau nilai atribut baru untuk dihitung sebelum sistem menerapkannya ke tujuan.

Fungsi adalah metode bawaan yang digunakan untuk menentukan jenis modifikasi yang Anda butuhkan untuk diterapkan mesin sinkronisasi saat menghasilkan nilai atribut untuk tujuan.

Fungsi MIM didistribusikan ke dalam kategori berikut:

• Manipulasi data: Lakukan berbagai operasi manipulasi pada string.

• Pengambilan data: Mengekstrak data dari nilai atribut.

• Pembuatan data: Menghasilkan nilai.

• Logika: Melakukan operasi berdasarkan kondisi.

Bagian berikut memberikan detail selengkapnya tentang fungsi di setiap kategori.

Fungsi manipulasi data

Fungsi manipulasi data digunakan untuk melakukan berbagai operasi manipulasi pada string.

Concatenate	Detil
Deskripsi	Fungsi Concatenate menggabungkan dua string atau lebih.
Tanda tangan fungsi	string1 + string2...
Masukan	Dua string atau lebih.
Operasi	Semua parameter string input digabungkan satu sama lain.
Keluaran	Satu string.

Huruf Besar	Detil
Deskripsi	Fungsi UpperCase mengonversi semua karakter dalam string menjadi huruf besar.
Tanda tangan fungsi	String UpperCase(string)
Masukan	Satu string.
Operasi	Semua karakter huruf kecil parameter input dikonversi ke karakter huruf besar. Misalnya: UpperCase("test") menghasilkan "TEST".
Keluaran	Satu string.

Huruf kecil	Detil
Deskripsi	Fungsi LowerCase mengonversi semua karakter dalam string menjadi huruf kecil.
Tanda tangan fungsi	String LowerCase(string)
Masukan	Satu string.
Operasi	Semua karakter huruf besar parameter input dikonversi ke karakter huruf kecil. Misalnya: LowerCase("TeSt") menghasilkan "test".
Keluaran	Satu string.

ProperCase	Detil
Deskripsi	Fungsi ProperCase mengonversi karakter pertama dari setiap kata yang dibatasi spasi dalam string menjadi huruf besar. Semua karakter lainnya dikonversi ke huruf kecil.
Tanda tangan fungsi	String ProperCase(string)
Masukan	Satu string.
Operasi	Karakter pertama dari setiap kata yang dibatasi spasi dalam parameter input dikonversi ke huruf besar. Semua karakter huruf besar dikonversi ke karakter huruf kecil. Jika kata dalam parameter input dimulai dengan karakter non-alfabet, karakter pertama kata tidak dikonversi ke huruf besar. Contohnya: ProperCase("TEsT") "Test"menghasilkan . ProperCase("britta simon") "Britta Simon"menghasilkan . ProperCase(" TEsT") " Test"menghasilkan . ProperCase("\$TEsT") "\$Test"menghasilkan .
Keluaran	Satu string.

LTrim	Detil
Deskripsi	Fungsi LTrim menghapus spasi putih terkemuka dari string.
Tanda tangan fungsi	String LTrim(string)
Masukan	Satu string.
Operasi	Karakter spasi putih terkemuka yang terkandung dalam parameter input dihapus. Misalnya: LTrim(" Test ") menghasilkan "Test ".
Keluaran	Satu string.

RTrim	Detil
Deskripsi	Fungsi RTrim menghapus spasi putih berikutnya dari string.
Tanda tangan fungsi	String RTrim(string)
Masukan	Satu string.
Operasi	Karakter spasi putih berikutnya yang terkandung dalam parameter input dihapus. Misalnya: RTrim(" Test ") menghasilkan " Test".
Keluaran	Satu string.

Pangkas	Detil
Deskripsi	Fungsi Pangkas menghapus spasi putih di depan dan di belakang dari string.
Tanda tangan fungsi	String Trim(string)
Masukan	Satu string.
Operasi	Karakter spasi putih di depan dan di belakang yang terkandung dalam string akan dihapus. Misalnya: Trim(" Test ") menghasilkan "Test".
Keluaran	Satu string.

RightPad	Detil
Deskripsi	Fungsi RightPad mem-pad kanan string ke panjang tertentu dengan menggunakan karakter padding yang disediakan.
Tanda tangan fungsi	String RightPad(string, length, padCharacter)
Masukan	string: String ke pad. length: Bilangan bulat yang mewakili panjang string yang diinginkan. padCharacter: String yang terdiri dari satu karakter yang akan digunakan sebagai karakter pad.
Operasi	Jika panjang string kurang dari panjang, maka padCharacter berulang kali ditambahkan ke akhir string hingga panjang string sama dengan panjang. Contohnya: RightPad("User", 10, "0") "User000000"menghasilkan . RightPad(RandomNum(1,10), 5, "0") mungkin mengakibatkan "9000".
Keluaran	Jika string memiliki panjang yang lebih besar dari atau sama dengan panjang, string yang identik dengan string dikembalikan. Jika panjang string kurang dari panjang, string baru dengan panjang yang diinginkan dikembalikan. String baru berisi string yang diisi dengan padCharacter. Jika string null, fungsi mengembalikan string kosong. Catatan: padCharacter bisa menjadi karakter spasi, tetapi tidak boleh berupa nilai null. Jika panjang string sama dengan atau lebih besar dari panjang, string dikembalikan tidak berubah.

LeftPad	Detil
Deskripsi	Fungsi LeftPad mengalihkan string ke panjang tertentu dengan menggunakan karakter padding yang disediakan.
Tanda tangan fungsi	String LeftPad(string, length, padCharacter)
Masukan	string: String ke pad. length: Bilangan bulat yang mewakili panjang string yang diinginkan. padCharacter: String yang terdiri dari satu karakter yang akan digunakan sebagai karakter pad.
Operasi	Jika panjang string kurang dari panjang, maka padCharacter berulang kali ditambahkan ke awal string hingga panjang string sama dengan panjang. Contohnya: RightPad("User", 10, "0") "000000User"menghasilkan . RightPad(RandomNum(1,10), 5, "0") mungkin mengakibatkan "0009".
Keluaran	Jika string memiliki panjang yang lebih besar dari atau sama dengan panjang, string yang identik dengan string dikembalikan. Jika panjang string kurang dari panjang, string baru dengan panjang yang diinginkan dikembalikan. String baru berisi string yang diisi dengan padCharacter. Jika string null, fungsi mengembalikan string kosong. Catatan: padCharacter bisa menjadi karakter spasi, tetapi tidak boleh berupa nilai null. Jika panjang string sama dengan atau lebih besar dari panjang, string dikembalikan tidak berubah.

BitOr	Detil
Deskripsi	Fungsi BitOr mengatur bit tertentu pada bendera ke 1.
Tanda tangan fungsi	Int BitOr(mask, flag)
Masukan	masker: Nilai heksadesimal yang menentukan bit untuk diatur pada bendera. flag: Nilai heksadesimal yaitu memiliki bit tertentu yang dimodifikasi.
Operasi	Fungsi ini mengonversi kedua parameter menjadi representasi biner dan membandingkannya: Mengatur sedikit ke 1 jika satu atau kedua bit yang sesuai dalam mask danbendera adalah 1. Mengatur sedikit ke 0 jika kedua bit yang sesuai adalah 0. Mengembalikan 1 dalam semua kasus, kecuali di mana bit yang sesuai dari kedua parameter adalah 0. Pola bit yang dihasilkan adalah bit "set" (1 atau true) dari salah satu dari dua operan. Beberapa bit bendera dapat diatur jika beberapa bit memiliki nilai 1 dalam mask.
Keluaran	Versi baru bendera dengan bit yang ditentukan dalam mask diatur ke 1.

BitAnd	Detil
Deskripsi	Fungsi BitAnd menetapkan bit tertentu pada bendera ke 0.
Tanda tangan fungsi	Int BitOr(mask, flag)
Masukan	masker: Nilai heksadesimal yang menentukan bit untuk dimodifikasi pada bendera. flag: Nilai heksadesimal yaitu memiliki bit tertentu yang dimodifikasi.
Operasi	Fungsi ini mengonversi kedua parameter menjadi representasi biner dan membandingkannya: Mengatur sedikit ke 0 jika satu atau kedua bit yang sesuai dalam masker dan bendera adalah 0. Mengatur sedikit ke 1 jika kedua bit yang sesuai adalah 1. Mengembalikan 0 dalam semua kasus, kecuali di mana bit yang sesuai dari kedua parameter adalah 1. Beberapa bit bendera dapat diatur ke 0 jika beberapa bit memiliki nilai 0 dalam mask.
Keluaran	Versi baru bendera dengan bit yang ditentukan dalam mask diatur ke 0.

DateTimeFormat	Detil
Deskripsi	Fungsi DateTimeFormat digunakan untuk memformat DateTime dalam formulir string ke format tertentu.
Tanda tangan fungsi	String DateTimeFormat(dateTime, format)
Masukan	dateTime: String yang mewakili DateTime untuk diformat. format: String yang mewakili format yang akan dikonversi. Catatan: Untuk karakter yang diterima untuk membuat format yang ditentukan pengguna, lihat Format Tanggal/Waktu yang ditentukan pengguna.
Operasi	String format yang ditentukan dalam format diterapkan ke DateTime dalam string dateTime . String yang ditentukan dalam format harus berupa format DateTime yang valid. Jika tidak, kesalahan dikembalikan yang menunjukkan bahwa formatnya bukan format DateTime yang valid. Misalnya: DateTime("12/25/2007", "yyyy-MM-dd") menghasilkan "2007-12-25".
Keluaran	String yang dihasilkan dari menerapkan format ke dateTime.

ConvertSidToString	Detil
Deskripsi	ConvertSidToString mengonversi array byte yang berisi pengidentifikasi keamanan menjadi string.
Tanda tangan fungsi	String ConvertSidToString(ObjectSID)
Masukan	ObjectSID: Array byte yang berisi pengidentifikasi keamanan (SID).
Operasi	SID biner yang ditentukan dikonversi menjadi string.
Keluaran	Representasi string dari SID.

ConvertStringToGuid	Detil
Deskripsi	Fungsi ConvertStringToGuid mengonversi representasi string GUID menjadi representasi biner GUID.
Tanda tangan fungsi	Byte[] ConvertStringToGuid(stringGuid)
Masukan	stringGuid: String yang diformat dalam pola xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, di mana nilai GUID diwakili sebagai serangkaian digit heksadesimal dalam grup 8, 4, 4, 4, dan 12 digit dan dipisahkan oleh tanda hubung. Contoh nilai yang dikembalikan adalah 382c74c3-721d-4f34-80e557657b6cbc27.
Operasi	StringGuid dikonversi ke representasi binernya. Jika string bukan representasi GUID yang valid, fungsi menolak argumen dengan kesalahan "Parameter untuk fungsi ConvertStringToGuid harus berupa string yang mewakili Guid yang valid."
Keluaran	Representasi biner GUID.

ReplaceString	Detil
Deskripsi	Fungsi ReplaceString menggantikan semua kemunculan string ke string lain.
Tanda tangan fungsi	String ReplaceString(string, OldValue, NewValue)
Masukan	string: String untuk mengganti nilai. OldValue: String yang akan dicari dan diganti. NewValue: String yang akan diganti.
Operasi	Semua kemunculan OldValue dalam string diganti dengan NewValue. Fungsi harus dapat menangani karakter khusus \n. baris baru, \r. carriage return, dan \t. tab. Misalnya: ReplaceString("One\n\rMicrosoft\n\r\Way","\n\r"," ") mengembalikan "One Microsoft Way".
Keluaran	String dengan semua kemunculan OldValue dalam string diganti dengan NewValue.

Fungsi pengambilan data

Fungsi pengambilan data digunakan untuk melakukan operasi yang mengambil karakter yang diinginkan dari string.

Word	Detil
Deskripsi	Fungsi Word menampilkan kata yang terkandung di dalam suatu string, berdasarkan parameter yang menjelaskan pemisah yang harus digunakan serta jumlah kata yang ditampilkan.
Tanda tangan fungsi	String Word(string, number, delimiters)
Masukan	string: String tempat mengembalikan kata. number: Angka yang mengidentifikasi nomor kata mana yang harus dikembalikan. pemisah: String yang mewakili pemisah yang harus digunakan untuk mengidentifikasi kata- kata.
Operasi	Setiap string karakter dalam string yang dipisahkan oleh salah satu karakter dalam pemisah diidentifikasi sebagai kata. Jika string null, fungsi mengembalikan string kosong. Kata yang ditemukan pada posisi yang ditentukan dalam angka dikembalikan. Jika angka< 1, fungsi mengembalikan string kosong. Contohnya: Word("Test;of%function;", 3, ";$&%") menghasilkan "function". Word("Test;;Function" , 2 , ";") "" mengembalikan (string kosong). Word("Test;of%function;", 0, ";$&%") "" mengembalikan (string kosong).
Keluaran	String yang berisi kata pada posisi yang diminta pengguna. Jika string berisi kurang dari jumlah kata, atau string tidak berisi kata apa pun yang diidentifikasi oleh pemisah, string kosong akan dikembalikan.

Kiri	Detil
Deskripsi	Fungsi Kiri mengembalikan jumlah karakter tertentu dari kiri (awal) string.
Tanda tangan fungsi	String Left(string, numChars)
Masukan	string: String untuk mengembalikan karakter. numChars: Angka yang mengidentifikasi jumlah karakter yang akan dikembalikan dari awal string.
Operasi	karakter numChars dikembalikan dari posisi pertama string. Misalnya: Left("Britta Simon", 3) mengembalikan "Bri".
Keluaran	String yang berisi karakter numChars pertama dalam string. Jika numChars = 0, fungsi mengembalikan string kosong. Jika numChars< 0, fungsi mengembalikan string input. Jika string null, fungsi mengembalikan string kosong.

Benar	Detil
Deskripsi	Fungsi Right mengembalikan sejumlah karakter tertentu dari kanan (ujung) string.
Tanda tangan fungsi	String Right(string, numChars)
Masukan	string: String untuk mengembalikan karakter. numChars: Angka yang mengidentifikasi jumlah karakter yang akan dikembalikan dari akhir string.
Operasi	Mengembalikan karakter numChars dari akhir string. Misalnya: Right("Britta Simon", 3) mengembalikan "mon".
Keluaran	String yang berisi karakter numChars terakhir dalam string. Jika numChars = 0, fungsi mengembalikan string kosong. Jika numChars< 0, fungsi mengembalikan string input. Jika string null, fungsi mengembalikan string kosong. Jika string berisi lebih sedikit karakter daripada angka yang ditentukan dalam numChars, string akan dikembalikan.

Pertengahan	Detil
Deskripsi	Fungsi Mid mengembalikan sejumlah karakter tertentu dari posisi tertentu dalam string.
Tanda tangan fungsi	String Mid(string, pos, numChars)
Masukan	string: String untuk mengembalikan karakter. pos: Angka yang mengidentifikasi posisi awal dalam string untuk mengembalikan karakter. numChars: Angka yang mengidentifikasi jumlah karakter yang akan dikembalikan dari posisi dalam string.
Operasi	Mengembalikan karakter numChars yang dimulai dari pos posisi dalam string. Misalnya: Mid("Britta Simon", 3, 5) mengembalikan "itta ".
Keluaran	String yang berisi karakter numChars dari pos posisi dalam string. Jika numChars = 0, fungsi mengembalikan string kosong. Jika numChars< 0, fungsi mengembalikan string kosong. Jika memposisikan> panjang string, fungsi mengembalikan string input. Jika pos<= 0, fungsi mengembalikan string input. Jika string null, fungsi mengembalikan string kosong. Jika tidak ada karakter numChar yang tersisa dalam string dari pos posisi, sebanyak mungkin karakter dikembalikan.

Fungsi pembuatan data

Fungsi pembuatan data digunakan untuk menghasilkan nilai untuk jenis data tertentu.

CRLF	Detil
Deskripsi	Fungsi CRLF menghasilkan Umpan Kembali/Baris Pengangkutan. Gunakan fungsi ini untuk menambahkan baris baru.
Tanda tangan fungsi	String CRLF
Masukan	Tidak ada.
Operasi	CRLF dikembalikan. Contohnya: AddressLine1 + CRLF() + AddressLine2 hasil dalam AddressLine1 AddressLine2.
Keluaran	CRLF adalah outputnya.

RandomNum	Detil
Deskripsi	Fungsi RandomNum mengembalikan angka acak dalam interval tertentu.
Tanda tangan fungsi	Int RandomNum(start, end)
Masukan	start: Angka yang mengidentifikasi batas bawah nilai acak yang akan dihasilkan. akhir: Angka yang mengidentifikasi batas atas nilai acak yang akan dihasilkan.
Operasi	Angka acak yang lebih besar dari atau sama dengan awal dan kurang dari atau sama dengan akhir dihasilkan. Misalnya: Random(0,999) mungkin mengembalikan 100.
Keluaran	Angka acak dalam rentang yang ditentukan oleh awal dan akhir.

EscapeDNComponent	Detil
Deskripsi	Metode EscapeDNComponent dari MIISUtils digunakan untuk melakukan operasi ini. Metode ini memproses string input berdasarkan jenis agen manajemen (MA) yang sedang digunakan.
Tanda tangan fungsi	String EscapeDNComponent(string)
Masukan	string: String yang digunakan untuk memproses nama khusus. String tidak boleh berisi karakter yang lolos.
Operasi	MAs yang berbeda memerlukan format nama khusus yang berbeda. Metode ini memproses string input berdasarkan jenis MA berikut: Nama khusus LDAP: Contoh jenis MA ini termasuk Active Directory Domain Services, Sun Directory Server (sebelumnya iPlanet Directory Server), dan Microsoft Exchange Server. Setiap karakter XML yang tidak valid dalam bagian nilai dari bagian tertentu dikodekan heksadesimal. Setiap karakter ilegal (termasuk karakter XML yang tidak valid) dalam bagian nama dari bagian tertentu menghasilkan kesalahan. Karakter escape termasuk koma (,), sama dengan (=), plus (+), kurang dari (<), lebih besar dari (>), angka (#), titik koma (;), garis miring terbalik (), dan tanda kutip ganda ("). Jika karakter terakhir dalam string adalah spasi ( ), spasi tersebut akan lolos. Spasi awal atau akhir yang asing di sekitar nama bagian akan dihapus. Untuk XML MA, jika ada beberapa bagian, maka bagian-bagiannya dijadikan alfabet. Jika beberapa bagian ditentukan, string nama khusus komposit adalah perangkaian string individual yang dipisahkan oleh tanda plus (+). Kesalahan dihasilkan jika string input bukan string nama khusus bergaya LDAP yang terbentuk dengan baik. Non-LDAP hierarkis: Contoh jenis MA ini adalah Microsoft Lotus Notes. Jenis MA ini tidak mendukung komponen multipihak. Jika beberapa string diteruskan ke EscapeDNComponent, ArgumentException akan dilemparkan. Jika salah satu karakter dalam string input adalah karakter XML yang tidak valid, ArgumentException akan dilemparkan. Semua koma (,) dan garis miring terbelakang (/) dalam string input diloloskan. Jika karakter terakhir dalam string adalah spasi ( ), spasi tersebut akan lolos. Ekstrinsik: Contoh jenis MA ini mencakup database atau XML tanpa nama khusus LDAP. Jika ada bagian yang biner atau berisi karakter XML yang tidak valid, bagian tersebut disimpan sebagai versi data mentah yang dikodekan heksadesimal dengan karakter angka (#) yang diawali ke bagian depan string. Misalnya, jika bagian adalah AxC (di mana x mewakili karakter XML ilegal seperti 0x10), bagian tersebut dikodekan sebagai #410010004300. Jika tidak, semua instans karakter ini diloloskan: garis miring terbelakang (), koma (,), plus (+), dan angka (#). Jika karakter terakhir dalam string bagian tertentu adalah spasi ( ), spasi tersebut akan lolos. Jika beberapa bagian ditentukan, string nama khusus komposit adalah perangkaian semua string individual yang dipisahkan oleh tanda plus.
Keluaran	String yang berisi nama domain yang valid.

Nota

Validasi nama khusus kurang ketat daripada sintaks yang ditentukan dalam spesifikasi LDAP. EscapeDNComponent(String[]) memungkinkan nama bagian berisi kombinasi satu atau beberapa karakter 'a'-'z', 'A'-'Z', '0'-'9', '-', dan '.'.

Tidak dimungkinkan untuk menentukan bagian biner dengan metode ini. Namun, dimungkinkan untuk memiliki bagian biner dalam CommitNewConnector jika nama khusus dibuat dari atribut jangkar dan salah satu atribut jangkar adalah jenis biner.

Nol	Detil
Deskripsi	Fungsi Null digunakan untuk menentukan bahwa MA tidak memiliki atribut untuk berkontribusi, dan atribut tersebut harus dilanjutkan dengan MA berikutnya.
Tanda tangan fungsi	String Null
Masukan	Tidak ada.
Operasi	Null dikembalikan. Misalnya: IIF(Eq(domain), "unknown", Null()) mengembalikan Null.
Keluaran	Null adalah output.

Fungsi Logika

Fungsi logika digunakan untuk melakukan operasi berdasarkan kondisi yang dievaluasi oleh sistem.

IIF	Detil
Deskripsi	Fungsi IIF menampilkan salah satu kemungkinan set nilai berdasarkan syarat yang ditentukan.
Tanda tangan fungsi	Object IIF(condition, valueIfTrue, valueIfFalse)
Masukan	kondisi: Nilai atau ekspresi apa pun yang dapat dievaluasi ke true atau false. Fungsi berikut tersedia untuk digunakan sebagai ekspresi dalam fungsi IIF untuk kondisi tersebut: Eq: Fungsi ini membandingkan dua argumen untuk kesetaraan. NotEquals: Fungsi ini membandingkan dua argumen untuk ketidaksetaraan, mengembalikan true jika tidak sama dan salah jika sama. Misalnya: NotEquals(EmployeeType, "Contractor"). LessThan: Fungsi ini membandingkan dua angka, mengembalikan true jika yang pertama kurang dari yang kedua dan salah jika tidak. Misalnya: LessThan(Salary, 100000). GreaterThan: Fungsi ini membandingkan dua angka, mengembalikan true jika yang pertama lebih besar dari yang kedua dan salah jika tidak. Misalnya: GreaterThan(Salary, 100000). LessThanOrEquals: Fungsi ini membandingkan dua angka, mengembalikan true jika yang pertama kurang dari atau sama dengan yang kedua dan salah sebaliknya. Misalnya: LessThanOrEquals(Salary, 100000). GreaterThanOrEquals: Fungsi ini membandingkan dua angka, mengembalikan true jika yang pertama lebih besar dari atau sama dengan yang kedua dan salah sebaliknya. Misalnya: GreaterThanOrEquals(Salary, 100000). IsPresent: Fungsi ini mengambil sebagai input atribut dalam skema ILM dan mengembalikan true jika atribut tidak null dan false jika atribut null. valueIfTrue: Nilai yang dikembalikan jika kondisi mengevaluasi ke true. valueIfFalse: Nilai yang dikembalikan jika kondisi mengevaluasi ke false.
Operasi	Jika kondisi mengevaluasi ke true, fungsi mengembalikan valueIfTrue. Jika tidak, fungsi mengembalikan valueIfFalse. Misalnya: IIF(Eq(EmployeeType,"Intern"),"t-" + Alias, Alias) mengembalikan alias pengguna dengan "t-" yang ditambahkan ke awal alias jika pengguna adalah magang. Jika tidak, fungsi mengembalikan alias pengguna as-is.
Keluaran	Outputnya adalah valueIfTrue jika kondisinya benar, atau valueIfFalse jika kondisinya salah.