Uw connector indienen voor Microsoft-certificering

  • Artikel

In dit onderwerpl wordt uitgelegd hoe:

  1. Publiceer uw connector naar de opensource-opslagplaats.

  2. De vastleggingsinformatie indienen voor certificering in ISV Studio. (Deze stap is niet van toepassing op onafhankelijke uitgevers.)

Over het algemeen vereisen we opensourcing als onderdeel van ons certificeringsprogramma. Vraag uw Microsoft-contactpersoon als er problemen zijn.

De connector opensourcen

Deze sectie is van toepassing op geverifieerde uitgevers, inclusief onafhankelijke uitgevers.

Belangrijk

U moet de connector beschikbaar maken als open source voordat deze wordt toegevoegd aan de certificeringsportal om inconsistenties te verminderen. Als het de eerste keer is dat u bijdraagt aan GitHub, neem dan deel aan de sessie Power Platform-voorbeelden - voor de eerste keer inzenden.

  1. Open een pull-verzoek in de opensource-opslagplaats.

  2. Een Microsoft-certificeringstechnicus zal binnen één tot twee weken na uw eerste verzoek feedback geven. Als de feedback een update van de connector vereist, moet u een update voor het pull-verzoek indienen. Houd hiervoor rekening met één of twee weken extra.

    U behoudt het eigendom van uw connector, en u kunt wijzigingen in de connector accepteren of afwijzen.

  3. Microsoft zal het pull-verzoek goedkeuren en samenvoegen. Zodra het pull-verzoek van uw connector is samengevoegd, kunt u uw connectorartefacten indienen bij ISV Studio. Ga naar Verzenden naar ISV Studio voor instructies.

Voordelen van open source voor uw connector

Er zijn verschillende voordelen voor het opensourcen van uw connector, waaronder:

  • Eenvoudig functionaliteit toevoegen aan een eerder kant-en-klaar uitgebrachte, onveranderbare connector.

  • Profiteren van bijdragen uit de ontwikkelaarscommunity voor uitbreidingen en onderhoud van de connector.

  • Een platform voor gebruikers de mogelijkheid bieden om verzoeken om functieaanvragen in te dienen en bijdragen te doen.

  • Uitgebreidere traceringsgeschiedenis voor wijzigingen die zijn aangebracht in de connector.

  • Samenwerking voor meerdere ontwikkelaars mogelijk maken.

De volgende punten over ons programma zijn belangrijk:

  • U kunt alleen de connectorbestanden opensourcen, niet uw API. Deze gegevens zijn al toegankelijk voor gebruikers via de Microsoft Power Platform openbare API's.

  • De connectorartefacten worden opgeslagen en zijn openbaar beschikbaar in onze GitHub-opslagplaats. U kunt hier onze bestaande opensource-connectors bekijken.

  • Er worden geen persoonsgegevens of intellectueel eigendom opgeslagen in de opslagplaats.

  • Microsoft neemt u in het bestand CODEOWNERS op als eigenaar van de connector in GitHub en elke wijziging van de connector wordt door u beheerd.

Uploaden vanuit lokale bestanden

Als u een uitzondering van opensourcing hebt gekregen, moet u uw connector indienen door uw lokale connectorbestanden te uploaden.

  1. Plaats de aangepaste connectorbestanden in een zip-archief dat u bij Microsoft gaat indienen.

  2. Dien alleen archieven in die zijn gevalideerd en de drie vereiste artefactbestanden bevatten:

    • apiDefinition.swagger.json
    • apiProperties.json
    • Het connectorpictogram

    Belangrijk

    Wanneer u gebruik maakt van macOS, moet u ervoor zorgen dat alleen de drie artefactbestanden van de connector zich in de .zip bevinden. Standaard neemt macOS andere mappen en bestanden op in een .zip-archief.

Indienen bij ISV Studio

Deze sectie is van toepassing op geverifieerde uitgevers, exclusief onafhankelijke uitgevers.

Zodra het pull-verzoek van uw connector is samengevoegd, kunt u uw connectorartefacten indienen bij het tabblad Connectorcertificering in ISV Studio.

Als uw inzending succesvol is, kunt u binnen één tot twee weken een antwoord verwachten van een certificeringstechnicus. Als er problemen zijn met de inzending, moet u de inzending bijwerken op basis van de feedback. De certificeringsengineer heeft één tot twee extra weken nodig om te antwoorden.

Als u een uitzondering voor open sourcing hebt gekregen, dient u uw connector pas in als uw Microsoft-contactpersoon u heeft doorverwezen. Zorg ervoor dat u alle stappen in Certificeringsproces hebt gevolgd en de artefacten hebt gevalideerd voordat u indient.

De knop Ter beoordeling indienen is beschikbaar wanneer alle velden geldige invoer bevatten.

  1. Zorg ervoor dat u een indiening maakt met een actief e-mailadres.

  2. Op het tabblad Connectorcertificering in ISV Studio, wordt u gevraagd uw bestanden in te dienen door:

    • GitHub-vastleggingsinformatie in te voeren vanuit uw opensource-connector.

      Notitie

      Zorg ervoor dat u de recente vastleggings-id van de PR van uw connector opgeeft.

    • Uw zip-archief uploaden dat u in de vorige stap hebt gemaakt.

  3. Voer de volgende gegevens in ISV Studio in:

    • Testinformatie en referenties voor de connector:

      • Verstrek zo veel mogelijk details om het testen zo soepel mogelijk te laten verlopen. Zorg ervoor dat u geldige testinformatie verstrekt.

      Schermafbeelding van details van de connector-inzending.

      Belangrijk

      Als uw connectortype OAuth is, zorg er dan voor dat u een geldige Client-id en Clientgeheim opgeeft. Deze informatie kan na indiening niet meer worden gewijzigd. Zodra dit is ontvangen, wordt het opgeslagen in Azure Key Vault.

      Als u dit wilt wijzigen, neemt u contact op met uw Microsoft-contactpersoon.

      • Als de connector gebruikmaakt van OAuth als verificatietype, voegt u deze goedgekeurde omleidings-URL's toe aan uw app:

        https://global.consent.azure-apim.net/redirect
        https://global-test.consent.azure-apim.net/redirect

      • Verstrek geen account dat gebruik maakt van meervoudige verificatie of verschaf stappen aan het certificeringsteam om op de juiste manier toegang te krijgen tot het via meervoudige verificatie–beveiligde account.

    • Een ondersteuningse-mail waarmee Microsoft contact kan opnemen als er problemen zijn.

  4. Neem contact op met de contactpersoon van Microsoft als u problemen ondervindt bij het indienen van uw connectorartefacten.

  5. Nadat u uw artefacten hebt ingediend, voegt u afzonderlijk een intro.md toe aan het gebied Activiteitscontrole of Functionele documentatie. Deze intro.md wordt opgenomen in de openbare documentatie voor uw connector. Dit staat los van de readme.md dat u tijdens de opensourcing-stap hebt ingediend.

    Neem geen informatie over de acties of triggers van uw connector op in de intro.md, aangezien deze informatie tijdens de certificering automatisch voor u wordt gegenereerd.

  6. (Vereist) Gebruik de volgende markdown als een voorbeeld van een sjabloon voor een intro.md-bestand:

Provide a detailed description here, distinct from your connector's description, of the value that the connector offers users and a high-level overview of functionality that the connector supports. This description should be no more than one paragraph of eight sentences.

## <a name="prerequisites"></a>Prerequisites

Provide information about any prerequisites that are required to use this connector. For example, an account on your website or a paid service plan. 

## <a name="how-to-get-credentials"></a>How to get credentials

Provide detailed information about how a user can get credentials to use the connector. Where possible, this should be step-by-step instructions with links pointing to relevant parts of your website.

If your connector doesn't require authentication, this section can be removed.

## <a name="get-started-with-your-connector"></a>Get started with your connector

Provide users with a step-by-step process for getting started with your connector. This is where you should highlight common use cases, such as your expected popular triggers and actions, and how they can help in automation scenarios. Include images where possible.

## <a name="known-issues-and-limitations"></a>Known issues and limitations

If your connector has any known issues and limitations, include a detailed description of them here. This information should be as robust as possible so users have plenty of information should they run into problems. If any workarounds are known, include them here.

## <a name="common-errors-and-remedies"></a>Common errors and remedies

Highlight any errors that might commonly occur when using the connector (such as HTTP status code errors), and what the user should do to resolve the error.

## <a name="faq"></a>FAQ

Provide a breakdown of frequently asked questions and their respective answers here. This can cover FAQs about interacting with the underlying service or about the connector itself.

Wanneer u de connector en intro.md, hebt ingediend, kunt u zich gaan voorbereiden op het testen van uw connector. Zie Uw connector tijdens certificering testen voor instructies.

Indiening bijwerken vóór certificering

Deze sectie is van toepassing op geverifieerde uitgevers, exclusief onafhankelijke uitgevers.

In deze situaties moet u alleen een connector bijwerken die zich in het certificeringsproces bevindt, maar nog niet gecertificeerd is:

  • Wanneer Microsoft om wijzigingen heeft verzocht.

  • Als u een kritiek probleem bent tegengekomen dat vóór certificering moet worden opgelost.

Belangrijk

Met alle updates tijdens het certificeringsproces wordt het proces gereset. Nadat u een update hebt ingediend, dient u een pull-aanvraag in met de bijgewerkte artefacten in onze opensource-opslagplaats.

Een update indienen:

  1. Ga naar het tabblad Connectorcertificering van ISV Studio en selecteer uw bestaande inzending.

  2. Selecteer uw meest recente versie in het deelvenster dat aan de rechterkant wordt geopend.

    Ingediende lijst met connectorversies

  3. In de linkerbenedenhoek van de Connector-inzendingen weergave, selecteer Een update indienen.

  4. In de Bevestig Bewerken prompt, selecteer Bevestigen. Hiermee wordt het certificeringsproces opnieuw ingesteld.

  5. Verwijder uw bestaande connectorarchief door Verwijderen te selecteren. Voer een van de volgende stappen uit:

    • Gebruik de GitHub-integratie om de bijgewerkte artefacten uit de opensource-opslagplaats op te nemen.
    • Upload het bijgewerkte zip-archief.

    Bestaand ZIP-archief verwijderen

  6. Vul de velden in het indieningsformulier in. Zorg ervoor dat u de juiste informatie verstrekt—inclusief testen—aangezien het van toepassing is op uw laatste update.

  7. In de linkerbenedenhoek van de Connector-inzendingen weergave, selecteer Een update indienen. U ziet de bevestiging weergegeven in de afbeelding hieronder en Microsoft begint met het beoordelingsproces.

    Bevestiging van ontvangst van indiening

Belangrijk

Selecteer Een update indienen niet nogmaals na het voltooien van stap 7. Als u dat wel doet, wordt de voortgang nogmaals opnieuw ingesteld.

Als u een update voor uw reeds gecertificeerde connector wilt indienen, raadpleegt u Uw gecertificeerde connector bijwerken.

Volgende stap

Uw connector in certificering testen

Feedback geven

We stellen feedback over problemen met ons connectorplatform of ideeën voor nieuwe functies zeer op prijs. Om feedback te geven, gaat u naar Problemen melden of hulp krijgen met connectoren en selecteer uw feedbacktype.