Algemene CSV-connector - Technische referentiegids (voorbeeld)

In dit artikel wordt de algemene CSV-connector (GCSV) beschreven. Het artikel is van toepassing op de volgende producten:

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

Voor MIM 2016 is de connector beschikbaar als download van het Microsoft Downloadcentrum.

Als u deze Connector in actie wilt zien, raadpleegt u het stapsgewijze artikel over de algemene SQL-connector.

Notitie

De Azure AD-inrichting-service biedt nu een lichtgewicht oplossing op basis van agents voor het inrichten van gebruikers in CSV-bestanden, zonder een volledige MIM-synchronisatie-implementatie. We raden u aan te evalueren of deze voldoet aan uw behoeften. Meer informatie.

Overzicht van de algemene CSV-connector

Met de algemene CSV-connector (GCSV) kunt u identiteitsgegevens van gebruikers en groepen integreren die worden onderhouden in CSV-bestanden met Microsoft-producten, zoals de Microsoft Entra Connect Provisioning Agent (ECMA2Host) en Microsoft Identity Manager 2016 (MIM2016).

Het heeft verschillende functies, zoals de mogelijkheid om het gebruik van PowerShell in te delen voor het beheren van identiteitsgegevens vóór of na import- of exportbewerkingen. Het biedt ondersteuning voor meerdere gegevenstypen, waaronder binaire en verwijzingen, ondersteuning voor waarden voor gekwalificeerde tekenreeksen en tekenreeksen met meerdere waarden.

In dit artikel worden de functies en functies van de algemene CSV-connector beschreven en hoe u deze configureert voor MIM 2016.

De volgende tabel bevat de functies die door de huidige versie van de connector worden ondersteund, vanuit een algemeen perspectief:

Kenmerk	Bijzonderheden
Ondersteuning voor meerdere producten	Het gebruik van deze connector wordt ondersteund met de volgende Microsoft-producten: Microsoft Entra Connect Provisioning Agent (ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
CSV-bestanden ondersteund	Deze connector ondersteunt het beheer van gebruikers (vereist) en groepen (optioneel), via de configuratie van maximaal drie CSV-bestanden: CSV-bestand van gebruikers (bijvoorbeeld Users.csv) CSV-bestand voor groepen (bijvoorbeeld Groups.csv) CSV-bestand groepsleden (bijvoorbeeld Members.csv)
Verwerking van pre-/postbewerkingen met PowerShell	Deze connector ondersteunt de configuratie van maximaal vier (4) PowerShell-scripts om de verwerking van identiteitsgegevens van gebruikers en groepen vóór of na het importeren of exporteren te vergemakkelijken.
Ondersteunde CSV-bestandscodering	De connector ondersteunt alle standaard (of geïnstalleerde) servercoderingstypen: (bijvoorbeeld Unicode, UTF-8, UTF-7, ASCII, enzovoort)
Ondersteunde gegevenstypen voor CSV-velden	De connector ondersteunt de volgende kenmerkgegevenstypen: Binair – (als base64-tekenreeksen) Booleaanse waarde – (als Waar/Onwaar) Gehele getallen Tekenreeksen/tekenreeksen met meerdere waarden Referentie
Scheidingsteken van CSV-velden	Ondersteuning voor komma's (,) of een afdrukbaar alfanumeriek teken ter kwalificatie van het begin en einde van een tekenreekswaarde.
Ondersteuning voor stringkwalificatie	Ondersteuning voor dubbele aanhalingstekens (") of een afdrukbaar alfameerteken om het begin en einde van een tekenreekswaarde te kwalificeren.
Ondersteuning voor tekenreeksen met meerdere waarden	Ondersteuning voor tekenreeksen met meerdere waarden
Ondersteunde connectorbewerkingen	De connector ondersteunt de volgende bewerkingen: Volledige import Exporteren Volledige export
Schema	Schemadetectie is dynamisch, maar vereist handmatige configuratie voor voltooiing. Velden worden dynamisch geïdentificeerd op basis van een opgegeven scheidingsteken (of ook wel een waardescheidingsteken genoemd).) Veldgegevenstypen worden handmatig aangewezen tijdens de configuratie.

Voorwaarden

Voordat u de connector gebruikt, moet u ervoor zorgen dat u het volgende op de synchronisatieserver hebt:

• Microsoft .NET 4.6.2 Framework of hoger
• CSV-bestanden die het gewenste schema bevatten voor de volgende identiteitstypen:
  • Gebruikersbestand (vereist)
  • Groepen (optioneel)
  • Groepsleden (vereist als groepen worden gebruikt)
• (Optioneel) PowerShell-scripts voor het beheren van pre- en postverwerking voor de volgende bewerkingstypengebeurtenissen:
  • Vooraf importeren: dit script wordt uitgevoerd voordat een importbewerking wordt uitgevoerd.
  • Na importeren: dit script wordt uitgevoerd nadat een importbewerking is uitgevoerd.
  • Vooraf exporteren: dit script wordt uitgevoerd voordat een exportbewerking wordt uitgevoerd.
  • Post-Export: dit script wordt uitgevoerd nadat een exportbewerking is uitgevoerd.

Machtigingen voor MIM-synchronisatieserviceaccounts

Belangrijk

Het MIM 2016-synchronisatieserviceaccount is de beveiligingscontext waarmee de bestandsbewerkingen naar CSV-bestanden worden uitgevoerd en de PowerShell-scripts vóór/na de verwerking worden uitgevoerd. Dit serviceaccount heeft lees-/schrijfmachtigingen nodig voor alle CSV- en PowerShell-bestanden die zijn geconfigureerd. Het heeft ook de juiste PowerShell ExecutePolicy-machtigingen nodig om scripts uit te voeren die zijn geconfigureerd.

Een nieuwe connector maken

De volgende lijst is een algemeen overzicht van de stappen die in deze handleiding worden beschreven. Om te beginnen moet een account met de MIM-synchronisatiebeheerder rol worden gebruikt om deze taken uit te voeren:

• Open het MA-venster (Create New Management Agent) vanuit de MIM Sync Service Manager-.
• Selecteer de algemene CSV-connector als verbindingslijntype.
• Geef het bestandspad en de naam op van het CSV-bestand dat moet worden geïmporteerd of geëxporteerd.
• Specificeer de bestandscodering, het waardescheidingsteken, het scheidingsteken voor meerdere waarden en de tekstscheidingstekens voor het CSV-bestand.
• Kies of u de waarden in de eerste rij wilt gebruiken als veldnamen of niet.
• Selecteer de objecttypen en kenmerken die moeten worden geïmporteerd of geëxporteerd uit het CSV-bestand.
• Configureer de partitie, het run-profiel en de toewijzingsgegevens voor de MA.
• Geef de scriptpaden en -parameters op voor de PowerShell-scripts, indien van toepassing.
• Voer de MA uit om de import-, synchronisatie- of exportbewerkingen uit te voeren.

Als u een algemene CSV-connector wilt maken, selecteert u in Synchronization ServiceManagement Agent en Maken. Selecteer de Algemene CSV (Microsoft) Connector.

Connectiviteit

De pagina Connectiviteit bevat de bestandslocaties van de CSV-bestanden Gebruikers, Groepen en Groepsleden.

De volgende afbeelding is een voorbeeld van de pagina Connectivity.

De locaties van de volgende CSV-bestanden worden op deze pagina opgegeven:

• gebruikersbestand: het volledig gekwalificeerde pad van het CSV-bestand dat de gebruikersrecords en hun kenmerkwaarden bevat. Dit bestand is verplicht.
• groepenbestand: het volledig gekwalificeerde pad van het CSV-bestand dat de groepsrecords bevat. Dit bestand is optioneel.
• ledenbestand: het volledig gekwalificeerde pad van het CSV-bestand dat referentierecords voor groepsleden bevat.

Belangrijk

Het MIM Sync-serviceaccount moet leestoegang en schrijfmachtigingen hebben voor alle toegewezen CSV-bestanden. Zoals eerder vermeld, zijn de groeps- en lidbestanden niet nodig als alleen gebruikers zijn geconfigureerd.

Het scherm Connectiviteit is het eerste wanneer u een nieuwe Generieke SQL-connector maakt. U moet eerst de volgende sectiegegevens opgeven:

Mogelijkheden

Op deze pagina worden de mogelijkheden van de connector beschreven. Connectormogelijkheden staan vast en kunnen niet worden gewijzigd, maar deze worden hier uitgelegd om informatie te verschaffen over de werking van de connector.

De volgende afbeelding is een voorbeeld van de pagina Capabilities.

De volgende sectie bevat een overzicht van de afzonderlijke configuraties en de betekenis ervan:

• Distinguished Name Style (LDAP): de GCSV-connector maakt gebruik van de LDAP-syntaxis (Lightweight Directory Access Protocol) om de DN (distinguished name) samen te stellen om elk Gebruikers- of Groepsobject uniek te identificeren in zijn connectorruimte. Alle DN-waarden worden uitgedrukt in de volgende indeling: CN=[ANCHOR_VALUE],Object=[Gebruiker|Groep],O=CSV-.
• objectbevestiging (normaal): normaal gesproken gaat de synchronisatie-engine ervan uit dat het object opnieuw kan worden opgehaald in een volgende deltaimport na een export. Dit is hoe de synchronisatie-engine meestal werkt, maar niet alle verbonden systemen werken op deze manier. Deze instelling van Normal zorgt ervoor dat er geen exported-change-not-reimported waarschuwing is in de follow-up-import.
• Exporttype (MultivaluedReferenceAttributeUpdate): Het exporttype geeft aan hoe objecten tijdens de synchronisatie worden opgemaakt en verzonden naar het doelsysteem. MultivaluedReferenceAttributeUpdate is een exporttype dat is ontworpen voor gebruik met Microsoft Entra-id. Alleen de kenmerken die zijn gewijzigd, worden verzonden. Voor kenmerken van het waardetype wordt AttributeReplace gebruikt en voor referentiekenmerken wordt AttributeUpdate gebruikt.
• Normalizations (None): Normalisaties verwijzen naar het standaardiseren van gegevens naar een consistente indeling. Geen betekent dat er geen specifieke normalisatieregels worden toegepast. Gegevens blijven as-is zonder extra transformaties door de connector.

Schema 1 (configuraties voor CSV-bestandsindelingen)

De GCSV Connector maakt gebruik van drie soorten scheidingstekens om CSV-velden en hun waarden te scheiden en te parseren.

Deze pagina bevat de tekenwaarde-instellingen voor deze scheidingstekens en het coderingstype dat is gebruikt om het bestand als CSV te maken.

De volgende afbeelding is een afbeelding van de pagina Schema 1 (CSV-bestandsindelingsconfiguraties).

De volgende sectie is een lijst met de afzonderlijke configuraties:

• Headers gebruiken voor schemadetectie: wanneer deze optie is geselecteerd, krijgt de connector de opdracht om de eerste record van elk CSV-bestand te behandelen als een headerrecord en niet als identiteitsgegevensrecord. Als deze optie niet is geselecteerd, wijst de connector de naam het kenmerk toe met een unieke incrementele waarde (bijvoorbeeld Kenmerk1, Kenmerk2, enzovoort) en behandelt de eerste rij als een identiteitsgegevensrecord.
• waarden scheidingsteken: Met dit teken worden de velden, oftewel de waarden, van de CSV-records gescheiden. De komma (,) is de standaardwaarde, maar elk alfanumerieke teken dat kan worden afgedrukt, is toegestaan.
• scheidingsteken voor meerdere waarden: dit type scheidingsteken wordt gebruikt om de afzonderlijke waarden van een tekenreeks met meerdere waarden (bijvoorbeeld proxyadressen) of verwijzingskenmerken (bijvoorbeeld onderliggende waarden) te scheiden.) De standaardwaarde is een puntkomma (;), maar een afdrukbaar alfanumerieke teken is acceptabel.
• tekstscheidingstekens: wanneer een tekenreekswaarde tekens bevat die anders worden geïnterpreteerd als scheidingstekens (bijvoorbeeld komma's), moet de waarde worden gekwalificeerd, zodat de CSV-parser de tekenreeks correct kan interpreteren als één veld. De dubbele aanhalingstekens (") zijn de standaardwaarde, maar elk alfanumerieke teken dat kan worden afgedrukt, is toegestaan.

Notitie

Hoewel de schema's van CSV-bestanden mogelijk geen velden met meerdere waarden bevatten of geen waarden bevatten waarvoor tekenreekskwalificatie is vereist, is de aanduiding van een uniek afdrukbaar teken vereist voor elk scheidingstekentype.

• bestandscodering: deze instelling geeft de codering aan die wordt gebruikt voor de CSV-bestanden die zijn toegevoegd op het tabblad Connectiviteit. Zorg ervoor dat deze overeenkomt met de codering van uw CSV-bestanden.

Notitie

Als u niet zeker weet wat het coderingstype van uw CSV-bestanden is, moet u proberen het standaard unicode-coderingstype te gebruiken. Unicode is een veelgebruikte standaard die veel tekens en symbolen ondersteunt, waardoor het een goede optie is voor het coderen van tekstgegevens in de meeste talen of tekenset.

Schema 2 (identiteits- en verwijzingsveldconfiguraties)

De ankerwaarde is een unieke id voor een record in een CSV-bestand. Het onderscheidt één record van de andere. De GCSV-connector gebruikt deze waarde ook om de DN (Distinguished Name) te maken waarmee het gerelateerde connectorruimteobject wordt geïdentificeerd.

Op deze pagina worden de instellingen voor het ankerkenmerk ingesteld voor elk van de CSV-bestanden die worden vermeld op de pagina Connectiviteit.

De volgende afbeelding is een voorbeeld van de Schema 2 (Identiteits- en verwijzingsveldconfiguraties) pagina.

De volgende sectie is een lijst met de afzonderlijke configuraties op deze pagina:

• gebruiker
  • User Anchor: het veld in het gebruikersbestand dat fungeert als de ankerwaarde voor het gebruikersrecord. Het eerste koptekstveld in het bestand Gebruikers is de standaardoptie.
  • User Anchor-attribuuttype: Dit is het attribuuttype van het geselecteerde anker.
• groep
  • Groepanker: het veld in het groepsbestand dat fungeert als de ankerwaarde voor de groepsrecord. Het eerste koptekstveld in het groepsbestand is de standaardoptie.
  • Groepanker kenmerktype: Dit is het kenmerktype van het geselecteerde anker.
• lid
  • bovenliggende groeps-ID: het veld in het Ledenbestand met dezelfde (kern)waarde als de bovenliggende groep in het Groepen CSV-bestand. Het eerste veld in het ledenbestand wordt standaard gebruikt.
  • lid-id: het veld in het bestand Leden met dezelfde waarde (anker) als in het CSV-bestand Gebruikers of Groepen. Het tweede veld in het bestand Leden is standaard geselecteerd.
• lidobjecttype: het veld met de tekenreekswaarde 'User' of 'Group' om het objecttype van het lid aan te geven. Dit veld is alleen vereist als het lidbestand meer dan twee velden bevat. Het veld Objecttype mag alleen de tekenreekswaarde 'User' of 'Group' bevatten. Als dit veld ontbreekt, gaat de connector ervan uit dat de records van het Members-bestand verwijzen naar een gebruikersobjectlid. Het derde veld in het bestand Leden is standaard geselecteerd.

Belangrijk

De namen van de kenmerken die als ankers moeten worden gebruikt, moeten uniek zijn in alle objecttypeschema's. Dit omvat de ankers die zijn opgegeven in het Groepsleden-bestand.

Schema 3 (Schemaconfiguraties voor bestandskenmerken van gebruikers)

Deze pagina is bedoeld voor het opgeven en uitleggen van het gegevenstype van elk van de velden die zijn geïdentificeerd in het schema van het CSV-bestand gebruikers en of ze meer dan één waarde kunnen hebben.

De volgende afbeelding is een voorbeeld van de Schema 3 (Schemaconfiguraties voor gebruikersbestandskenmerken) pagina.

De volgende sectie bevat overwegingen bij het maken van toewijzingen van kenmerkgegevenstypen.

Ondersteunde gegevenstypen

De GCSV-connector ondersteunt het gebruik van de volgende sectiegegevenstypen:

• Booleaanse: een waarde die waar of onwaar kan zijn.
• Binaire: een waarde die wordt opgeslagen als een reeks bytes, die doorgaans wordt gebruikt voor het opslaan van gegevens zoals afbeeldingen of andere bestanden.
• Integer: een waarde die een geheel getal is zonder decimale plekken.
• tekenreeks: een waarde die een reeks tekens is, die doorgaans wordt gebruikt voor het opslaan van tekstgegevens.
• Verwijzing: een waarde die een verwijzing naar een ander gebruikersobject is. Als u een verwijzingswaarde in een CSV-bestand wilt opgeven, vult u het veld in met de ankerwaarde van het bedoelde gebruikersobject.

Belangrijk

Gebruikers- of groepsreferentiekenmerken kunnen alleen worden gebruikt om te verwijzen naar gebruikersobjecten. Dit is niet van toepassing op het kenmerk Member van groepsobjecten, die zowel gebruikers- als groepsverwijzingen kunnen bevatten zolang het veld voor het objecttype is opgegeven.

Ondersteunde Multiple-Value gegevenstypen

De connector ondersteunt het gebruik van kenmerken met meerdere waarden voor alleen de volgende gegevenstypen:

• Snaar

Notitie

Als het schema van zowel de objecten Gebruiker als Groep beide een kenmerk (niet-anker) met dezelfde naam heeft, worden er mogelijk geen verschillende gegevenstypen toegewezen. Beide moeten hetzelfde gegevenstype delen.

Schema 4 (schemaconfiguraties voor groepsbestandskenmerken)

Deze pagina is bedoeld voor het opgeven en uitleggen van het gegevenstype van elk van de velden die zijn geïdentificeerd in het schema van het CSV-bestand Groepen en of ze meer dan één waarde kunnen hebben.

De volgende afbeelding is een voorbeeld van de pagina Schema 4 (Configuraties van bestandskenmerkenschema's voor groepen).

De richtlijnen in Schema 3 (configuraties van gebruikersbestandskenmerken) zijn ook van toepassing op deze sectie. .

Na het uitvoeren van een eerste volledige importbewerking ziet de connectorruimte er ongeveer uit als in de volgende afbeelding:

Globale parameters (Configuratie van PowerShell-scripts)

Op deze pagina kunt u PowerShell-scripts configureren die vóór en/of na het importeren en/of exporteren worden uitgevoerd. Deze functies bieden mogelijkheden om een groot aantal acties vóór en na verwerking uit te voeren op uw identiteitsgebruikers- en groepsrecords.

De volgende afbeelding is een voorbeeld van de pagina Globale parameters.

De volgende sectie bevat de afzonderlijke configuratie-instellingen op deze pagina:

• scripttime-out (minuten): het aantal minuten dat een script wordt uitgevoerd voordat het automatisch wordt afgebroken. De standaardwaarde voor deze instelling is 100 en vereist een waarde die groter is dan nul (0).
• scriptbestand vooraf importeren: het volledig gekwalificeerde pad naar het PowerShell-script dat vóór een import moet worden uitgevoerd. Deze instelling is optioneel en vereist geen waarde.
• scriptbestand na importeren: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd na een import. Deze instelling is optioneel en vereist geen waarde.
• scriptbestand vooraf exporteren: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd vóór een export. Deze instelling is optioneel en vereist geen waarde.
• scriptbestand na exporteren: het volledig gekwalificeerde pad naar het PowerShell-script dat moet worden uitgevoerd na een export. Deze instelling is optioneel en vereist geen waarde.

PowerShell-scriptuitvoering en invoerparameters

De GCSV-connector voert elk van de geconfigureerde PowerShell-scripts in een eigen sessie uit en biedt geen ondersteuning voor het doorgeven van parameters tussen fasen.

De connector geeft één invoerparameter door aan elk script met de naam OperationType. De waarde van deze parameter varieert afhankelijk van de bewerking Run Profile die wordt uitgevoerd en kan een van de volgende drie waarden zijn:

Belangrijk

Het dynamisch maken van CSV-bestanden voordat import- of exportbewerkingen worden uitgevoerd, wordt niet ondersteund. Alle CSV-bestanden moeten aanwezig zijn voordat een van de Run-profielen wordt uitgevoerd.

PowerShell-invoerparameter: OperationType

Hoewel het gebruik van invoerparameters niet wordt ondersteund, geeft de GCSV-connector één invoerparameter door aan de uitvoering van elk PowerShell-script: OperationType.

• Volledige: deze waarde wordt opgegeven tijdens volledige import- of volledige exportbewerkingen.
• Delta-: deze waarde wordt opgegeven tijdens exportbewerkingen.

Deze parameterwaarde kan worden gebruikt in de logica van de PowerShell-scripts om de juiste bewerking vóór/na de verwerking of actie te bepalen die moet worden uitgevoerd.  

Inrichtingshiërarchie

Omdat CSV-bestanden geen gegevens opslaan in een hiërarchische structuur, biedt de GCSV-connector geen ondersteuning voor hiërarchische inrichtingsconfiguraties.

De volgende afbeelding is een voorbeeld van de pagina Inrichtingshiërarchie.

Partities en hiërarchieën

De GCSV-connector bouwt een unieke DN (Distinguished Name) voor elke gebruikers- en groepsrecord in de connectorruimte, volgens deze LDAP-indeling:

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

De volgende afbeelding is een voorbeeld van de pagina Partities en hiërarchieën.

Objecttypen

Voor de GCSV-connector moet ten minste het gebruikersobjecttype zijn geselecteerd. De keuze van het groepsobjecttype is optioneel.

De volgende afbeelding is een voorbeeld van de Objecttypen pagina.

Kenmerken

Op deze pagina wordt een genormaliseerde lijst met alle kenmerken in alle geselecteerde objecttypeschema's weergegeven.

De volgende afbeelding is een voorbeeld van de pagina Kenmerken.

Notitie

Het kenmerk Lid bestaat alleen als groepen zijn geselecteerd en de verwijzingen bevatten naar objecten die worden onderhouden in de CSV-bestanden van de groepsleden.

Ankers

De GCSV-connector biedt geen ondersteuning voor het gebruik van complexe ankers of configuraties van ankerkenmerken die verschillen van de bijbehorende anker-id-velden van het CSV-bestand.

Als u ankeraanduidingen wilt wijzigen die op deze pagina worden weergegeven, gaat u terug naar Schema 2 (Ankerconfiguraties).

De volgende afbeelding is een voorbeeld van de pagina Anchors.

CSV-records inrichten

Als u wilt dat de GCSV-connector nieuwe gebruikers- of groepsobjecten toevoegt aan de bijbehorende CSV-bestanden, moet er een nieuw connectorruimteobject worden ingericht.

Of u nu MIM 2016 declaratieve inrichtings- of uw eigen MIM-synchronisatieregelsextensiesschrijft, nieuwe connectorruimteobjecten moeten een DN hebben die de volgende indeling heeft:

CN=[ANCHOR_VALUE],Object=Gebruiker|Groep,O=CSV

De volgende tabel bevat details over elk van de onderdeelwaarden:

Bestanddeel	Notities
CN=[ANKERWAARDE]	De algemene naam (CN) moet een unieke waarde zijn voor en wordt geschreven in het aangewezen ankerveld van het CSV-bestand.
Object=Gebruiker/Groep	Dit onderdeel geeft het objecttype van deze connector aan. Ondersteunt alleenUserofGroup.
O=CSV	Het hoofdonderdeel dat gemeenschappelijk is voor alle GCSV-connectorruimteobjecten.

De volgende afbeelding is een synchronisatieregel die laat zien hoe u een DN correct maakt bij het inrichten van een nieuw gebruikersobject in een GCSV-connector:

De volgende code demonstreert de equivalente inrichtingslogica met behulp van Metaverse Rules Extensions.

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();
		}
	}
}

In de vorige afbeelding ziet u het gebruik van de functie EcapeDNComponent() om ervoor te zorgen dat de ankerwaarde juist ge-escaped wordt om te voldoen aan de LDAP-syntaxis.

Belangrijk

Het incorrect escaparen van de ankerwaarde bij het maken van een DN, resulteert in een invalid‑dn fout.

Voorbeelden van CSV-veldopmaak

De volgende secties bevatten voorbeelden van het opmaken van verschillende gegevenstypen in CSV-bestanden. Alle voorbeelden In de volgende sectie wordt ervan uitgegaan dat de standaardinstellingen voor veldscheidingstekens van de connector worden gebruikt:

• Waarde gescheiden: komma (,)
• Scheidingsteken voor meerdere waarden: Semi-Colon (;)
• Tekstkoppelaar: dubbele aanhalingstekens (")

Voorbeeld: Tekstkwalificatie

Als een tekenreekswaarde tekens bevat die anders zouden worden geïnterpreteerd als scheidingstekens (bijvoorbeeld komma's), moet de waarde worden gekwalificeerd, zodat de CSV-parser de tekenreeks correct kan interpreteren als één veld.

In het volgende csv-voorbeeld van de sectie ziet u hoe het veld DisplayName waarden bevat die zijn opgemaakt als gekwalificeerde tekst:

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

Voorbeeld: Multivalued tekenreeksen afbakenen

Als u meerdere tekenreekswaarden in één tekenreeksveld wilt opgeven, moet u de waarden scheiden met het scheidingsteken voor meerdere waarden. In het volgende onderdeel van het CSV-voorbeeld ziet u hoe het veld ProxyAddress meerdere waarden heeft:

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

Notitie

Tekenreeks met meerdere waarden biedt ook ondersteuning voor het gebruik van gekwalificeerde tekenreekswaarden. Tekstgekwalificeerde waarden kunnen worden gescheiden door scheidingstekens met meerdere waarden.

Voorbeeld: Verwijzingsvelden

Als u een verwijzingswaarde in een CSV-bestand wilt opgeven, vult u het veld in met de ankerwaarde van het bedoelde gebruikersobject. In het volgende voorbeeld van de sectie CSV bevat het veld Manager de ankerwaarde van de gebruikersrecord waar het naar verwijst.

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

Voorbeeld: Binaire velden

Als u binaire waarden wilt uitdrukken in CSV-bestanden, moeten ze worden geconverteerd naar base64-tekenreeksen die hetzelfde coderingstype gebruiken als het CSV-bestand. In het volgende gedeelte wordt een PowerShell-functie getoond die laat zien hoe een tekenreekswaarde kan worden gecodeerd naar een base64-gecodeerde tekenreeks in Unicode.

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

Dit is de equivalente functie in C# die een invoerparameter met de naam tekst accepteert en een met base64 gecodeerde tekenreeks retourneert in Unicode.

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

Voorbeeld: Booleaanse velden

CSV-bestanden die Booleaanse velden bevatten, moeten de tekst Waar of Onwaar gebruiken om hun waarde aan te geven. De volgende sectie is een

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

Bekende beperkingen

De volgende lijst bevat de bekende beperkingen van de GCSV-connector.

• referentiekenmerken
  • Met uitzondering van de groep kenmerk Lid worden verwijzingskenmerken met meerdere waarden niet ondersteund.
  • Referentiewaarde moet verwijzen naar gebruikersobjecten. Verwijzingen naar groepsobjecten worden niet ondersteund.
• Ankers
  • Dubbele ankerwaarden tussen gebruikers- en groepsobjecten worden niet ondersteund.
  • De namen van de ankerkenmerken moeten uniek zijn in gebruikers- en groepsschema's.
• PowerShell
  • Het doorgeven van invoervariabelen in PowerShell-scripts wordt niet ondersteund.