Gebruikersdocumentatie bieden voor uw aangepaste connector
Wanneer u klaar bent met het ontwerpen van uw Power Query aangepaste connector, moet u een artikel indienen met instructies voor het gebruik van uw connector voor publicatie op docs.microsoft.com. In dit artikel wordt de indeling van een dergelijk artikel besproken en wordt beschreven hoe u de tekst van uw artikel kunt opmaken.
Artikelindeling
In deze sectie wordt de algemene indeling van de artikelen Power Query connector beschreven. Uw artikel over aangepaste connectors moet deze algemene indeling volgen.
Ondersteunings opmerking
Voeg direct na de titel van het artikel de volgende opmerking in.
Notitie
Het volgende connectorartikel wordt geleverd door , de eigenaar van deze connector en een lid van het <company name> Microsoft Power Query Connector Certification Program. Als u vragen hebt over de inhoud van dit artikel of als u wijzigingen wilt aanbrengen in dit artikel, gaat u naar de website en gebruikt u daar de <company name> ondersteuningskanalen.
Vervang <company name> door de naam van uw bedrijf.
Samenvattingstabel
Geef na de ondersteuningsnota een samenvattingstabel op die de volgende informatie bevat:
- Release-status: geeft aan of de connector in preview of algemeen beschikbaar is. Gebruik 'Preview' of 'Algemene beschikbaarheid'.
- Ondersteunde producten: hier worden de producten vermeld die uw aangepaste connector kunnen gebruiken.
- Ondersteunde verificatietypen: hier worden de verificatietypen vermeld die door uw aangepaste connector worden ondersteund.
- Functieverwijzings docs: bevat alle M-formuletaal docs die zijn gekoppeld aan uw aangepaste connector.

Als uw aangepaste connector is geïmplementeerd op verschillende producten, maar verschillende mogelijkheden heeft voor deze producten, moet u de volgende of vergelijkbare opmerking in uw artikel opnemen na de samenvattingstabel.
Notitie
Sommige mogelijkheden zijn mogelijk aanwezig in het ene product, maar niet in andere vanwege implementatieschema's en hostspecifieke mogelijkheden.
Vereisten
Als uw aangepaste connector vereist dat andere toepassingen worden geïnstalleerd op het systeem met uw connector of als er een installatieprocedure moet worden uitgevoerd voordat u de aangepaste connector gebruikt, moet u een sectie Vereisten opnemen met een beschrijving van deze installatie- en installatieprocedures. Deze sectie bevat ook informatie over het instellen van verschillende versies van uw connector (indien van toepassing).
Ondersteunde mogelijkheden
Deze sectie moet een lijst bevatten met de mogelijkheden die worden ondersteund door uw aangepaste connector. Deze mogelijkheden zijn meestal een lijst met opsommingstekens die aangeeft of de connector de import- en DirectQuery-modi ondersteunt, en ook eventuele geavanceerde opties die beschikbaar zijn in het eerste dialoogvenster dat wordt weergegeven nadat de gebruiker uw connector heeft geselecteerd in Gegevens verkrijgen.
Verbindingsinstructies
Deze sectie bevat de procedures die nodig zijn om verbinding te maken met gegevens. Als uw aangepaste connector alleen wordt gebruikt in Power Query Desktop, is slechts één procedure vereist. Als uw aangepaste connector echter wordt gebruikt op zowel Power Query Desktop als Power Query Online, moet u een afzonderlijke procedure in afzonderlijke secties voor elk exemplaar leveren. Dat wil zeggen dat als uw aangepaste connector alleen wordt gebruikt door Power Query Desktop, u één procedure hebt die begint met een tweede bestellingskoppen en één stapsgewijs procedure. Als uw aangepaste connector wordt gebruikt door Power Query Desktop en Power Query Online, hebt u twee procedures. Elke procedure begint met een tweede order kop en bevat een afzonderlijke stapsgewijs procedure onder elke kop. Ga naar Voorbeelden van connectorartikelen voor voorbeelden van elk van deze typen procedures.
De procedure bestaat uit een genummerde lijst die elke stap bevat die nodig is om de informatie in te vullen die nodig is om een normale verbinding met de gegevens te kunnen maken (zonder dat daarvoor opties voor vooraf zijn vereist).
Verbinding maken geavanceerde opties gebruiken (optioneel)
Als uw aangepaste connector geavanceerde opties bevat die kunnen worden gebruikt om verbinding te maken met de gegevens, moet deze informatie worden behandeld in een afzonderlijke sectie van de documentatie. Elk van de geavanceerde opties moet worden gedocumenteerd en het doel van elke geavanceerde optie wordt uitgelegd in deze sectie.
Problemen oplossen (optioneel)
Als u weet dat er veelvoorkomende fouten kunnen optreden met uw aangepaste connector, kunt u een sectie voor probleemoplossing toevoegen om manieren te beschrijven om de fout op te lossen of om de fout te verhelpen. Deze sectie kan ook informatie bevatten over bekende beperkingen van uw connector of het ophalen van gegevens. U kunt ook bekende problemen opnemen met het gebruik van uw connector om verbinding te maken met gegevens.
Aanvullende instructies (optioneel)
Andere instructies of informatie over uw connector die niet in de vorige secties is behandeld, kunnen in deze sectie worden be gegeven.
Locatie en indeling van artikel
Uw artikel moet beschikbaar worden gesteld op GitHub onder de map Connectors in de Power Query docs-repo: https://github.com/MicrosoftDocs/powerquery-docs/tree/master/powerquery-docs/Connectors . Zorg ervoor dat u ook een koppeling naar uw artikel toevoegt in de lijst met connectors die verwijzen naar de juiste logoafbeelding die is geüpload naar de /Connectors/media/index map. Zorg er ten laatste voor dat u een koppeling naar uw artikel toevoegt in het inhoudsopgavebestand ( TOC.yml ). Gecertificeerde connectors zijn alleen beschikbaar onder Power BI (gegevenssets).
Zie de Microsoft Docs voor inzenders over hoe u kunt bijdragen aan onze repo.
Het artikel moet worden opgemaakt en verzonden als een Markdown-bestand. Gebruik de Stijl van Microsoft voor het beschrijven van procedures en de indeling van de gebruikersinterface.
De volgende artikelen bevatten instructies voor het opmaken van uw document in Markdown en de Microsoft-stijl die u moet volgen bij het schrijven van uw artikel:
Voorbeeld van connectorartikelen
Hier volgen enkele voorbeeldartikelen Power Query connectors die u als uitgangspunt kunt gebruiken:
- Adobe Analytics (alleen Power Query Desktop)
- Azure SQL-database (Power Query Desktop en Power Query Online)