Konektor CSV Generik - Panduan Referensi Teknis (Pratinjau)

Artikel ini menjelaskan Konektor CSV Generik (GCSV). Artikel ini berlaku untuk produk berikut:

• Microsoft Entra Connect Provisioning Agent (ECMA2Host)
• Microsoft Identity Manager 2016 (MIM2016)

Untuk MIM 2016, Konektor tersedia sebagai unduhan dari Pusat Unduhan Microsoft.

Untuk melihat Konektor ini beraksi, lihat artikel langkah demi langkah Konektor SQL Generik .

Catatan

Layanan provisi Azure AD sekarang menyediakan solusi berbasis agen ringan untuk menyediakan pengguna ke dalam file CSV, tanpa penyebaran sinkronisasi MIM penuh. Sebaiknya evaluasi jika memenuhi kebutuhan Anda. Pelajari lebih lanjut.

Gambaran Umum Konektor CSV Generik

Konektor CSV Generik (GCSV) memungkinkan Anda mengintegrasikan data identitas Pengguna dan Grup yang dikelola dalam file CSV dengan produk Microsoft, seperti Microsoft Entra Connect Provisioning Agent (ECMA2Host) dan Microsoft Identity Manager 2016 (MIM2016).

Ini memiliki berbagai fitur, seperti kemampuan untuk mengatur penggunaan PowerShell untuk mengelola data identitas sebelum atau sesudah operasi impor atau ekspor. Ini menawarkan dukungan untuk beberapa jenis data termasuk biner dan referensi, dukungan untuk nilai string yang memenuhi syarat, dan string multinilai.

Artikel ini menjelaskan fitur dan fungsi Konektor CSV Generik, dan cara mengonfigurasinya untuk MIM 2016.

Tabel berikut mencantumkan fitur yang didukung rilis konektor saat ini, dari perspektif tingkat tinggi:

Fitur	Detail
Dukungan Beberapa Produk	Penggunaan konektor ini didukung dengan produk Microsoft berikut: Microsoft Entra Connect Provisioning Agent (ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
File CSV Didukung	Konektor ini mendukung manajemen pengguna (diperlukan) dan grup (opsional), melalui konfigurasi hingga tiga file CSV: File CSV Pengguna (misalnya Users.csv) File CSV Grup (misalnya Groups.csv) File CSV Anggota Grup (mis. Members.csv)
Pemrosesan Pra/Pasca Operasi dengan PowerShell	Konektor ini mendukung konfigurasi hingga empat (4) Skrip PowerShell untuk memfasilitasi pemrosesan data identitas Pengguna dan Grup sebelum atau sesudah impor atau ekspor.
Pengodean File CSV Didukung	Konektor mendukung semua jenis pengodean server default (atau terinstal): (mis. Unicode, UTF-8, UTF-7, ASCII, dll.)
Jenis Data Bidang CSV Didukung	Konektor mendukung jenis data atribut berikut: Biner – (sebagai string base64) Boolean – (sebagai Benar/Salah) Bilangan bulat String / String Multinila Referensi
Pembatas Bidang CSV	Dukungan untuk koma (,) atau karakter alfamerik apa pun yang dapat dicetak untuk memenuhi syarat awal dan akhir nilai string apa pun.
Dukungan Kualifikasi String	Dukungan untuk tanda kutip ganda (") atau karakter alfamerik apa pun yang dapat dicetak untuk memenuhi syarat awal dan akhir nilai string apa pun.
Dukungan String Multinila	Dukungan untuk string multinila
Operasi Konektor yang Didukung	Konektor mendukung operasi berikut: Impor Penuh Ekspor Ekspor Penuh
Skema	Penemuan skema bersifat dinamis, tetapi memerlukan konfigurasi manual untuk penyelesaian. Bidang diidentifikasi secara dinamis berdasarkan pemisah tertentu (atau dikenal sebagai "Pemisah Nilai.") Jenis data bidang ditunjuk secara manual selama konfigurasi.

Prasyarat

Sebelum Anda menggunakan konektor, pastikan Anda memiliki yang berikut ini di server sinkronisasi:

• Microsoft .NET 4.6.2 Framework atau yang lebih baru
• File CSV yang berisi skema yang diinginkan untuk jenis identitas berikut:
  • File Pengguna (diperlukan)
  • Grup (opsional)
  • Anggota Grup (diperlukan jika grup digunakan)
• (Opsional) Skrip PowerShell untuk mengelola pemrosesan pra-dan-posting untuk peristiwa Jenis Operasi berikut:
  • Pra-Impor – Skrip ini dijalankan sebelum operasi impor dijalankan.
  • Pasca-Impor – Skrip ini dijalankan setelah operasi impor dijalankan.
  • Pra-Ekspor – Skrip ini dijalankan sebelum operasi ekspor dijalankan.
  • Pasca-Ekspor – Skrip ini dijalankan setelah operasi ekspor dijalankan.

Izin Akun Layanan Sinkronisasi MIM

Penting

Akun layanan Sinkronisasi MIM 2016 adalah konteks keamanan yang melakukan operasi file ke file CSV dan menjalankan skrip PowerShell pra/pasca-pemrosesan. Akun layanan ini memerlukan izin Baca/Tulis untuk semua file CSV dan PowerShell yang dikonfigurasi. Ini juga memerlukan izin PowerShell ExecutePolicy yang sesuai untuk menjalankan skrip apa pun yang dikonfigurasi.

Membuat Konektor baru

Daftar berikut adalah gambaran umum tingkat tinggi dari langkah-langkah yang diuraikan dalam panduan ini. Untuk memulai, akun dengan peran ADMIN Sinkronisasi MIM perlu digunakan untuk melakukan tugas-tugas ini:

• Buka jendela Buat Agen Manajemen Baru (MA) dari MIM Sync Service Manager.
• Pilih Konektor CSV Generik sebagai jenis konektor.
• Berikan jalur file dan nama file CSV yang akan diimpor atau diekspor.
• Tentukan pengodean file, pemisah nilai, pemisah multinilai, dan kualifikasi teks untuk file CSV.
• Pilih apakah akan menggunakan nilai di baris pertama sebagai bidang header atau tidak.
• Pilih jenis objek dan atribut yang akan diimpor atau diekspor dari file CSV.
• Konfigurasikan partisi, jalankan profil, dan detail pemetaan untuk MA.
• Berikan jalur dan parameter skrip untuk skrip PowerShell, jika ada.
• Jalankan MA untuk melakukan operasi impor, sinkronisasi, atau ekspor.

Untuk Membuat konektor CSV Generik, di Layanan Sinkronisasi pilih Agen Manajemen dan Buat. Pilih Konektor CSV Generik (Microsoft).

Konektivitas

Halaman Konektivitas berisi lokasi file file CSV Pengguna, Grup, dan Anggota Grup.

Gambar berikut adalah contoh halaman Konektivitas .

Lokasi file CSV berikut ditentukan di halaman ini:

• File Pengguna: Jalur file CSV yang sepenuhnya memenuhi syarat yang berisi catatan pengguna dan nilai atribut mereka. File ini diperlukan.
• File Grup: Jalur file CSV yang sepenuhnya memenuhi syarat yang berisi rekaman grup. File ini bersifat opsional.
• File Anggota: Jalur file CSV yang sepenuhnya memenuhi syarat yang berisi rekaman referensi anggota grup.

Penting

Akun layanan Sinkronisasi MIM harus memiliki izin baca dan tulis ke semua file CSV yang ditunjuk. Seperti disebutkan sebelumnya, file grup dan anggota tidak diperlukan jika hanya pengguna yang dikonfigurasi.

Layar Konektivitas adalah yang pertama saat Anda membuat Konektor SQL Generik baru. Anda harus terlebih dahulu memberikan informasi bagian berikut:

Kemampuan

Halaman ini menjelaskan kemampuan konektor. Kemampuan konektor diperbaiki dan tidak dapat diubah, tetapi dijelaskan di sini untuk memberikan informasi tentang cara konektor beroperasi.

Gambar berikut adalah contoh halaman Kapabilitas .

Bagian berikut mencantumkan konfigurasi individual dan artinya:

• Distinguished Name Style (LDAP): Konektor GCSV menggunakan sintaks LDAP (Lightweight Directory Access Protocol) untuk membangun DN (nama khusus) untuk mengidentifikasi setiap objek Pengguna atau Grup secara unik di ruang konektornya. Semua nilai DN dinyatakan dalam format berikut: CN=[ANCHOR_VALUE],Object=[User|Grup],O=CSV.
• Konfirmasi Objek (Normal): Biasanya, mesin sinkronisasi mengasumsikan bahwa ia dapat mengambil objek lagi dalam impor delta berikutnya setelah ekspor. Ini adalah cara kerja mesin sinkronisasi biasanya, tetapi tidak semua sistem yang terhubung beroperasi dengan cara ini. Pengaturan Normal ini memastikan bahwa tidak exported-change-not-reimported ada peringatan dalam impor tindak lanjut.
• Jenis Ekspor (MultivaluedReferenceAttributeUpdate): Jenis ekspor menentukan bagaimana objek diformat dan dikirim ke sistem target selama sinkronisasi. MultivaluedReferenceAttributeUpdate adalah jenis ekspor yang dirancang untuk bekerja dengan Microsoft Entra ID. Ini hanya mengirim atribut yang telah berubah. Untuk atribut jenis nilai, ia menggunakan AttributeReplace dan untuk atribut referensi, ia menggunakan AttributeUpdate.
• Normalisasi (Tidak Ada): Normalisasi mengacu pada standardisasi data ke format yang konsisten. Tidak ada berarti bahwa tidak ada aturan normalisasi tertentu yang diterapkan. Data tetap apa adanya tanpa transformasi tambahan oleh konektor.

Skema 1 (Konfigurasi Format File CSV)

Konektor GCSV menggunakan tiga jenis pemisah (atau pemisah) untuk memisahkan dan mengurai bidang CSV dan nilainya.

Halaman ini berisi pengaturan nilai karakter untuk pemisah ini dan jenis pengodean yang digunakan untuk membuat file sebagai CSV.

Gambar berikut adalah gambar halaman Skema 1 (Konfigurasi Format File CSV).

Bagian berikut adalah daftar konfigurasi individual:

• Gunakan header untuk penemuan skema: Saat opsi ini dipilih, ia menginstruksikan konektor untuk memperlakukan rekaman pertama setiap file CSV sebagai rekaman header dan bukan rekaman data identitas. Jika opsi ini tidak dipilih, konektor menetapkan nama Atribut dengan tambahan nilai bilangan bulat bertahap unik (misalnya, Attribute1, Attribute2, dll.) dan memperlakukan baris pertama sebagai rekaman data identitas.
• Pemisah nilai: Karakter ini memisahkan bidang (yaitu, nilai) rekaman CSV. Koma (,) adalah default, tetapi karakter alfanumerik apa pun yang dapat dicetak diizinkan.
• Pemisah multinilai: Jenis pemisah ini digunakan untuk memisahkan nilai individual string multinilai (misalnya, alamat proksi) atau atribut referensi (misalnya, subordinat.) Defaultnya adalah titik koma (;) tetapi karakter alfanumerik yang dapat dicetak dapat diterima.
• Pengualifikasi teks: Saat nilai string berisi karakter yang jika tidak akan ditafsirkan sebagai pemisah (misalnya, seperti koma), nilai tersebut mengharuskan nilai memenuhi syarat sehingga pengurai CSV dapat menginterpretasikan string dengan benar sebagai bidang tunggal. Tanda kutip ganda (") adalah default, tetapi karakter alfanumerik apa pun yang dapat dicetak diizinkan.

Catatan

Meskipun skema file CSV mungkin tidak berisi bidang multinilai atau mungkin tidak berisi nilai apa pun yang memerlukan kualifikasi string, penunjukan karakter unik yang dapat dicetak untuk setiap jenis pemisah diperlukan.

• Pengodean file: Pengaturan ini menunjukkan pengodean yang digunakan pada file CSV yang ditambahkan di tab Konektivitas. Pastikan file tersebut cocok dengan pengodean file CSV Anda.

Catatan

Jika Anda tidak yakin tentang jenis pengodean file CSV Anda, Anda harus mencoba menggunakan jenis pengodean Unicode default. Unicode adalah standar umum yang mendukung banyak karakter dan simbol, menjadikannya pilihan yang baik untuk mengodekan data teks di sebagian besar bahasa atau kumpulan karakter digunakan.

Skema 2 (Konfigurasi Bidang Identitas dan Referensi)

Nilai jangkar adalah pengidentifikasi unik untuk rekaman dalam file CSV. Ini membedakan satu catatan dari yang lain. Konektor GCSV juga menggunakan nilai ini untuk membuat nama yang dibedakan (DN) yang mengidentifikasi objek ruang konektor terkait.

Pada halaman ini, pengaturan atribut jangkar disiapkan untuk setiap file CSV yang tercantum di halaman Konektivitas.

Gambar berikut adalah contoh halaman Skema 2 (Konfigurasi Bidang Identitas dan Referensi).

Bagian berikut adalah daftar konfigurasi individual di halaman ini:

• Pengguna
  • Jangkar Pengguna: Bidang dalam file Pengguna yang berfungsi sebagai nilai jangkar untuk rekaman pengguna. Bidang header pertama dalam file Pengguna adalah pilihan default.
  • Jenis atribut User Anchor: Ini adalah jenis atribut jangkar yang dipilih.
• Grup
  • Jangkar Grup: Bidang dalam file Grup yang berfungsi sebagai nilai jangkar untuk rekaman grup. Bidang header pertama dalam file Grup adalah pilihan default.
  • Jenis atribut Group Anchor: Ini adalah jenis atribut jangkar yang dipilih.
• Anggota
  • ID Grup Induk: Bidang dalam file Anggota yang memiliki nilai (jangkar) yang sama dengan grup induk dalam file CSV Grup. Bidang pertama dalam file Anggota digunakan secara default.
  • ID Anggota: Bidang dalam file Anggota yang memiliki nilai (jangkar) yang sama seperti dalam file CSV Pengguna atau Grup. Bidang kedua dalam file Anggota dipilih secara default.
• Jenis Objek Anggota: Bidang yang berisi nilai string "Pengguna" atau "Grup" untuk menunjukkan jenis objek anggota. Bidang ini hanya diperlukan jika file Anggota berisi lebih dari dua bidang. Bidang Jenis Objek hanya boleh berisi nilai string "Pengguna" atau "Grup." Jika bidang ini hilang, konektor mengasumsikan bahwa rekaman file Anggota merujuk ke anggota objek Pengguna. Bidang ketiga yang ditemukan pada file Anggota dipilih secara default.

Penting

Nama atribut yang ditunjuk untuk digunakan sebagai jangkar harus unik di semua skema jenis objek. Ini termasuk jangkar yang ditentukan dalam file Anggota Grup.

Skema 3 (Konfigurasi Skema Atribut File Pengguna)

Halaman ini untuk menentukan dan menjelaskan jenis data masing-masing bidang yang diidentifikasi dalam skema file CSV Pengguna dan apakah mereka dapat memiliki lebih dari satu nilai.

Gambar berikut adalah contoh halaman Skema 3 (Konfigurasi Skema Atribut File Pengguna).

Bagian berikut mencantumkan pertimbangan saat membuat penetapan jenis data atribut.

Jenis data yang didukung

Konektor GCSV mendukung penggunaan Jenis data bagian berikut:

• Boolean: nilai yang dapat berupa true atau false.
• Biner: nilai yang disimpan sebagai urutan byte, biasanya digunakan untuk menyimpan data seperti gambar atau file lainnya.
• Bilangan bulat: nilai yang merupakan bilangan bulat, tanpa tempat desimal apa pun.
• String: nilai yang merupakan urutan karakter, biasanya digunakan untuk menyimpan data teks.
• Referensi: nilai yang merupakan referensi ke objek pengguna lain. Untuk menentukan nilai referensi dalam file CSV, isi bidangnya dengan nilai jangkar objek pengguna yang dirujuk.

Penting

Atribut referensi Pengguna atau Grup hanya dapat digunakan untuk merujuk ke objek pengguna. Ini tidak berlaku untuk atribut Anggota objek Grup, yang dapat berisi referensi pengguna atau grup selama bidang jenis objek ditentukan.

Jenis Data Multiple-Value yang didukung

Konektor mendukung penggunaan atribut multinilai hanya untuk jenis data berikut:

• String

Catatan

Jika skema objek Pengguna dan Grup keduanya memiliki atribut (non-jangkar) dengan nama yang sama, jenis data yang berbeda mungkin tidak ditetapkan di antara mereka. Keduanya harus berbagi jenis data yang sama.

Skema 4 (Konfigurasi Skema Atribut File Grup)

Halaman ini untuk menentukan dan menjelaskan jenis data masing-masing bidang yang diidentifikasi dalam skema file CSV Grup dan apakah mereka dapat memiliki lebih dari satu nilai.

Gambar berikut adalah contoh halaman Skema 4 (Konfigurasi Skema Atribut File Grup).

Panduan yang ditawarkan dalam Skema 3 (Konfigurasi Atribut File Pengguna juga berlaku untuk bagian ini. .

Setelah menjalankan operasi impor penuh awal, ruang konektor akan terlihat mirip dengan gambar gambar berikut:

Parameter Global (Konfigurasi Skrip PowerShell)

Halaman ini memungkinkan konfigurasi skrip PowerShell yang akan berjalan sebelum dan/atau setelah operasi impor dan/atau ekspor. Fitur-fitur ini memberikan peluang untuk melakukan berbagai tindakan pemrosesan pra-dan-pasca-posting pada pengguna identitas dan catatan grup Anda.

Gambar berikut adalah contoh halaman Parameter Global .

Bagian berikut mencantumkan pengaturan konfigurasi individual di halaman ini:

• Batas Waktu Skrip (Menit): jumlah menit skrip akan berjalan sebelum dibatalkan secara otomatis. Nilai default untuk pengaturan ini adalah 100 dan memerlukan nilai yang lebih besar dari nol (0).
• File skrip pra-impor: jalur yang sepenuhnya memenuhi syarat ke skrip PowerShell yang harus berjalan sebelum impor. Pengaturan ini bersifat opsional dan tidak memerlukan nilai.
• File skrip pasca-impor: jalur yang sepenuhnya memenuhi syarat ke skrip PowerShell yang harus berjalan setelah impor. Pengaturan ini bersifat opsional dan tidak memerlukan nilai.
• File skrip pra-ekspor: jalur yang sepenuhnya memenuhi syarat ke skrip PowerShell yang harus berjalan sebelum ekspor. Pengaturan ini bersifat opsional dan tidak memerlukan nilai.
• File skrip pasca-ekspor: jalur yang sepenuhnya memenuhi syarat ke skrip PowerShell yang harus berjalan setelah ekspor. Pengaturan ini bersifat opsional dan tidak memerlukan nilai.

Eksekusi Skrip PowerShell dan Parameter Input

Konektor GCSV menjalankan setiap skrip PowerShell yang dikonfigurasi dalam sesinya sendiri dan tidak mendukung lolosnya parameter antar tahap tidak didukung.

Konektor meneruskan satu parameter input ke dalam setiap skrip bernama OperationType. Nilai parameter ini bervariasi tergantung pada operasi Jalankan Profil yang dilakukan, dan dapat menjadi salah satu dari tiga nilai:

Penting

Pembuatan dinamis file CSV sebelum operasi impor atau ekspor tidak didukung. Semua file CSV harus ada sebelum ada untuk Jalankan Profil akan dijalankan.

Parameter Input PowerShell: OperationType

Meskipun penggunaan parameter input tidak didukung, konektor GCSV memang meneruskan satu parameter input ke dalam eksekusi setiap skrip PowerShell: OperationType.

• Penuh – nilai ini disediakan selama operasi Impor Penuh atau Ekspor Penuh.
• Delta – nilai ini disediakan selama operasi Ekspor.

Nilai parameter ini dapat digunakan dalam logika skrip PowerShell untuk menentukan operasi atau tindakan pra/pasca pemrosesan yang sesuai untuk diambil.  

Hierarki Provisi

Karena file CSV tidak menyimpan informasi dalam struktur hierarkis, Konektor GCSV tidak mendukung konfigurasi provisi hierarkis apa pun.

Gambar berikut adalah contoh halaman Hierarki Provisi .

Partisi dan Hierarki

Konektor GCSV membangun nama khusus (DN) yang berbeda untuk setiap pengguna dan rekaman grup di ruang konektornya, mengikuti format LDAP ini:

CN=[ANCHOR_VALUE],Object=User|Group,O=CSV

Gambar berikut adalah contoh halaman Partisi dan Hierarki .

Tipe Objek

Konektor GCSV mengharuskan setidaknya jenis objek Pengguna dipilih. Pilihan jenis objek Grup bersifat opsional.

Gambar berikut adalah contoh halaman Tipe Objek .

Atribut

Halaman ini menampilkan daftar semua atribut yang dinormalisasi di semua skema jenis objek yang dipilih.

Gambar berikut adalah contoh halaman Atribut .

Catatan

Atribut Anggota hanya akan ada jika Grup dipilih dan akan berisi referensi ke objek yang dikelola dalam file CSV anggota grup.

Jangkar

Konektor GCSV tidak mendukung penggunaan jangkar kompleks atau konfigurasi atribut jangkar yang berbeda dari bidang ID jangkar file CSV yang sesuai.

Untuk mengubah penetapan jangkar yang ditampilkan di halaman ini, kembali ke Skema 2 (Konfigurasi Jangkar).

Gambar berikut adalah contoh halaman Anchors .

Menyediakan Rekaman CSV

Agar konektor GCSV menambahkan objek Pengguna atau Grup baru ke dalam file CSV yang sesuai, Objek Ruang Konektor baru harus disediakan untuk itu.

Baik menggunakan Provisi Deklaratif MIM 2016 atau menulis Ekstensi Aturan Sinkronisasi MIM Anda sendiri, objek Ruang Konektor baru harus memiliki DN yang dibangun menggunakan format berikut:

CN=[ANCHOR_VALUE],Object=User|Group,O=CSV

Tabel berikut ini menyediakan detail tentang setiap nilai komponen:

Komponen	Catatan
CN=[NILAI JANGKAR]	Nama Umum (CN) harus merupakan nilai unik dan akan ditulis dalam bidang jangkar yang ditunjuk file CSV.
Object=User/Group	Komponen ini menunjukkan jenis objek konektor ini. Hanya mendukung "Pengguna" atau "Grup".
O=CSV	Komponen akar umum untuk semua objek ruang konektor GCSV.

Gambar berikut adalah Aturan Sinkronisasi yang menunjukkan cara membuat DN dengan benar saat menyediakan objek Pengguna baru ke dalam Konektor GCSV:

Kode berikut menunjukkan logika provisi yang setara menggunakan Ekstensi Aturan Metaverse.

void IMVSynchronization.Provision(MVEntry mventry)
{
	if (mventry["employeeID"].IsPresent)
	{
		ConnectedMA GCSVConnector = = mventry.ConnectedMAs["Generic CSV Conenctor"];

		if (GCSVConnector.Connectors.Count == 0)
		{
			CSEntry csentry = GCSVConnector.Connectors.StartNewConnector("user");

			//Sets DN to "CN=[ANCHOR_VALUE],OBJECT=[User|Group],O=CSV"
			csentry.DN = GCSVConnector.EscapeDNComponent("CN=" + mventry["employeeID"].Value).Concat("OBJECT=User,O=CSV");

			csentry["AccountName"].StringValue = mventry["accountName"].StringValue;
			csentry["CountryCode"].IntegerValue = 1;
			csentry["DisplayName"].Value = mventry["displayName"].Value;
			csentry["ProxyAddresses"].Value = mventry["proxyAddressCollection"].Value;
			csentry["IsActive"].BooleanValue = true;
			csentry["Manager"].Value = mventry["manager"].Value;
			csentry["ProfilePic"].Value = mventry["pic"].Value;

			csentry.CommitNewConnector();
		}
	}
}

Pada gambar sebelumnya, perhatikan penggunaan EcapeDNComponent() fungsi untuk memastikan bahwa nilai jangkar diloloskan dengan benar agar sesuai dengan sintaks LDAP-nya.

Penting

Pelepasan nilai jangkar secara tidak benar saat membuat DN akan mengakibatkan kesalahan invalid‑dn .

Contoh Pemformatan Bidang CSV

Bagian berikut ini mencantumkan contoh cara memformat jenis data yang berbeda dalam file CSV. Semua contoh Bagian berikut mengasumsikan penggunaan pengaturan pemisah bidang default konektor:

• Nilai terpisah: Koma (,)
• Pemisah multinilai: Semi-Colon (;)
• Kualifikasi teks: Tanda kutip ganda (")

Contoh: Kualifikasi Teks

Jika nilai string berisi karakter yang ditafsirkan sebagai pemisah (misalnya, koma), nilai tersebut harus memenuhi syarat sehingga pengurai CSV dapat menginterpretasikan string dengan benar sebagai satu bidang.

Contoh CSV bagian berikut menunjukkan bagaimana bidang DisplayName memiliki nilai yang diformat sebagai teks yang memenuhi syarat:

EmployeeID,DisplayName
E001,"Smith, John"
E002,"Doe, Jane"
E003,"Perez, Juan"

Contoh: Memisahkan String Multinilai

Untuk menyediakan beberapa nilai string dalam satu bidang string, batalkan nilai dengan pemisah Multinilai. Contoh CSV bagian berikut menunjukkan bagaimana bidang ProxyAddress dengan beberapa nilai:

EmployeeID,DisplayName,ProxyAddresses
E001,"Smith, John",SMTP:john.smith@contoso.com;smtp:js001@contoso.com
E002,"Doe, Jane",SMTP:jane.doe@contoso.com;smtp:jd002@contoso.com

Catatan

String Multinilai juga mendukung penggunaan nilai yang memenuhi syarat string. Nilai teks yang memenuhi syarat dapat dibatasi oleh pemisah multinilai.

Contoh: Bidang Referensi

Untuk menentukan nilai referensi dalam file CSV, isi bidangnya dengan nilai jangkar objek pengguna yang dirujuk. Di bagian berikut contoh CSV, bidang Manajer berisi nilai jangkar rekaman pengguna yang merujuknya:

EmployeeID,DisplayName,Manager
E001,"Smith, John",
E002,"Doe, Jane",E001
E003,"Doe, Jane", 
E004,"Perez, Juan",

Contoh: Bidang Biner

Untuk mengekspresikan nilai biner dalam file CSV, nilai biner harus dikonversi ke string base64 yang menggunakan jenis pengodean yang sama dengan file CSV. Bagian berikut fungsi PowerShell menunjukkan cara mengodekan nilai string ke dalam string yang dikodekan base64 di Unicode:

function ConvertTo-Base64([string]$text) 
{
    $bytes = [System.Text.Encoding]::Unicode.GetBytes($text)
    $encodedText = [System.Convert]::ToBase64String($bytes)
    return $encodedText
}

Berikut adalah fungsi yang setara dalam C# yang menerima parameter input yang disebut teks dan mengembalikan string yang dikodekan base64 di Unicode.

public static string ConvertToBase64(string text)
{
    byte[] bytes = System.Text.Encoding.UTF8.GetBytes(text);
    string encodedText = System.Convert.ToBase64String(bytes);
    return encodedText;
}

Contoh: Bidang Boolean

File CSV yang berisi bidang Boolean harus menggunakan teks Benar atau Salah untuk menunjukkan nilainya. Bagian berikut adalah

EmployeeID,DisplayName,IsActive
E001,"Smith, John",true
E002,"Doe, Jane",true
E003,"Perez, Juan",false

Batasan Umum

Daftar berikut berisi batasan konektor GCSV yang diketahui.

• Atribut Referensi
  • Selain atribut Anggota grup, atribut referensi multinila tidak didukung.
  • Nilai referensi harus merujuk ke objek pengguna. Referensi ke objek grup tidak didukung.
• Jangkar
  • Nilai jangkar duplikat antara objek pengguna dan grup tidak didukung.
  • Nama atribut jangkar harus unik di seluruh skema pengguna dan grup.
• PowerShell
  • Meneruskan variabel input ke skrip PowerShell tidak didukung.