Certifieringsprocess för andra utgivare än Microsoft

Den här processen gäller utgivare som inte är från Microsoft (utom oberoende utgivare). Om du är oberoende utgivare, gå till Certifieringsprocess för oberoende utgivare.

När du är färdig med utvecklingen av ditt anpassade anslutningsprogram följer du de här stegen för att förbereda den för certifiering samt för att generera filerna för anslutningsprogram som ska skickas till Microsoft.

Steg 1: Registrera ditt anslutningsprogram

Du behöver inte ha slutfört utvecklingen av din anpassade anslutningsapp för att kunna ansöka om certifiering. Du startar certifieringsprocessen genom att registrera ditt anslutningsprogram för certifiering genom att fylla i vårt registreringsformulär.

Förvänta dig ett e-postmeddelande inom två arbetsdagar från en Microsoft-kontakt som kommer att:

• Förstå ditt anpassade anslutningsprogram.
• Lära sig mer om din utvecklingsprocess.
• Vägleda dig genom certifieringsprocessen.

Steg 2: Uppfylla kraven för överföring

För att upprätthålla en hög kvalitets- och konsekvensnivå bland de certifierade anslutningarna har Microsoft en uppsättning krav och riktlinjer som din egen koppling måste följa för certifiering.

Ge anslutningsprogrammet en rubrik

• Måste finnas och vara skriven på engelska.
• Måste vara unik och urskiljningsbar från alla befintliga rubriker för anslutningsprogram.
• Bör vara namnet på produkten eller organisationen.
• Bör följa befintliga namnmönster för certifierade anslutningsprogram.
• Får inte vara längre än 30 tecken.
• Får inte innehålla texten "API", "Connector" eller något av våra Power Platform-produktnamn (till exempel "Power Apps ").
• Får inte sluta med ett icke-alfanumeriskt tecken, inklusive radmatning, ny rad eller mellanslag.

Exempel

• Bra rubriker för anslutningsprogram: "Azure Sentinel", "Office 365 Outlook"
• Sämre rubriker för anslutningsprogram: "Azure Sentinel's Power Apps-anslutningsprogram", " Office 365 Outlook API"

Skriv en beskrivning av anslutningsprogrammet

• Måste finnas och vara skriven på engelska.
• Måste vara fritt från grammatiska fel och stavfel.
• Bör exakt beskriva det huvudsakliga syftet och värdet som ditt anslutningsprogram ger.
• Får inte vara kortare än 30 tecken eller längre än 500 tecken.
• Får inte innehålla några Power Platform-produktnamn (till exempel "Power Apps").

Utforma en ikon för ditt anslutningsprogram

Det här avsnittet gäller inte oberoende utgivare.

• Skapa en logotyp på cirka 160 × 160 pixlar i en fyrkant på cirka 230 × 230 pixlar (utan rundade kanter).
• Måste innehålla en icke-färgade, icke-vita (#ffffff)-bakgrund och inte standardfärg (#007ee5) som överensstämmer med den angivna ikonens bakgrundsfärg.
• Måste vara unik jämfört med alla andra ikoner för certifierade anslutningsprogram.
• Måste skickas i PNG-format som icon.png.

Definiera åtgärds- och parametersammanfattningar och -beskrivningar

• Måste finnas och vara skriven på engelska.
• Måste vara fritt från grammatiska fel och stavfel.
• Åtgärds- och parametersammanfattningar bör vara fraser på 80 tecken eller kortare, och får endast innehålla alfanumeriska tecken eller parenteser.
• Beskrivningar av åtgärder och parametrar ska vara fullständiga, beskrivande meningar och sluta med skiljetecken.
• Får inte innehålla några Microsoft Power Platform-produktnamn (till exempel "Power Apps").

Ange exakta åtgärdssvar

• Definiera åtgärdssvar med ett exakt schema endast med förväntade svar.
• Använd inte standardsvar med en exakt schemadefinition.
• Ange giltiga svarsschemadefinitioner för alla åtgärder i swagger. Tomma svarsscheman tillåts inte. Det innebär att inget dynamiskt innehåll visas i utdata och skaparna måste använda JSON för att parsa svaret.

Skapa engelska språksträngar av hög kvalitet

Anslutningsprogram lokaliseras som en del av Power Automate lokaliseringen. När du utvecklar en anslutning är kvaliteten på de engelska språksträngarna därför mycket viktigt för översättningskvaliteten. Här är några huvudområden att fokusera på när du skapar värdena för strängarna som du anger.

• Se till att du kör ett stavningskontrollprogram för att se till att alla strängvärden är fria från typografiska fel. Om det inte finns någon engelskspråkig sträng blir översättningsresultatet ofullständigt eller felaktigt i sitt sammanhang.

• Se till att meningen är i fullständig form. Om meningarna inte är fullständiga kan det också skapa översättningar av lägre kvalitet.

• Kontrollera att meningarnas betydelse är tydlig. Om meningarnas betydelse är flertydig kan det också leda till lägre kvalitet eller felaktiga översättningar.

• Undvik att använda sammansatta strängar under körning om det är möjligt. Använd helt skapade meningar i stället. Sammanfogade strängar eller meningar gör det svårt att översätta, eller kan orsaka fel översättning.

• Om du använder förkortningar, se till att använda versaler för att göra det tydligt. Detta minskar risken för att det uppstår fel.

• Strängar i CaMel-formulär (t.ex. minimizeHighways eller MinimizeHighways) kan vanligtvis inte översättas. Om du vill lokalisera strängvärdet bör du åtgärda CaMel-formulärsträngen.

Steg 3: Lägg till metadata

Dina kopplingsartefakter (filer) måste innehålla specifika metadata som beskriver kopplingen och dess sluttjänst. Informationen i metadata kommer att publiceras i vår kopplingsdokumentation och är offentligt tillgänglig för alla användare. Tillhandahåll ingen privat eller konfidentiell information, och meddela oss via din Microsoft-kontakt om det finns några problem med att ge oss den här informationen. Om du vill se hur metadatan dokumenteras kan du gå till någon av de anslutningsprogramspecifika dokumentsidorna under Referens för anslutningsprogram.

Steg 3a: egenskaper för utgivare och stackOwner-egenskaper

• "utgivare" är namnet på ditt företag eller din organisation. Ange företagets fullständiga namn (t.ex. Contoso Corporation). Detta måste vara i alfanumeriskt format.

• "stackOwner" är det företag eller den organisation för den backend-tjänstestack som anslutningsprogrammet ansluter till. Detta måste vara i alfanumeriskt format.

Filsökväg: apiProperties.json

Syntax: Egenskaperna Utgivare och stackOwner finns som en egenskap på den högsta nivån i filen apiProperties.json. Lägg till följande markerade rader enligt bild. Kontrollera att du anger egenskapsnamnet och schemat exakt som det visas.

Steg 3c: Exempel på kodfragment

Du kan använda följande kod för att kopiera och ange information. Se till att du lägger till rätt filer på rätt platser enligt beskrivningen i föregående avsnitt.

    "publisher": "_____",
    "stackOwner": "_____"

    "contact": {
      "name": "_____",
      "url": "_____",
      "email": "_____"
    }

    "x-ms-connector-metadata": [
      {
        "propertyName": "Website",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Privacy policy",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Categories",
        "propertyValue": "_____;_____"
      }
    ]

Steg 3d: Verifiera dina anpassade anslutningsfiler

Kör paconn validate --api-def [Location of apiDefinition.swagger.json]. Med det här verktyget verifieras definitionen för anslutningsprogrammet, och du får reda på eventuella fel som du måste åtgärda innan du överför.

Om din anslutning använder OAuth som autentiseringstyp lägger du till dessa tillåtna omdirigerings-URL:er i din app:

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

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

Steg 4: Förbereda artefakterna för anslutningsprogram

Det här steget tar ungefär en vecka att slutföra.

Du kommer attsk icka en uppsättning filer som kallas artefakter för anslutningsprogram till Microsoft. Dessa laddas ned med hjälp av ett verktyg (CLI) för kommandoradsgränssnitt som du får från Microsoft. Med det här verktyget verifieras ditt anslutningsprogram för eventuella fel.

Följ dessa steg för att komma igång:

1. Installera CLI-verktyget för Microsoft Power Platform-anslutningsprogram genom att följa installationsanvisningarna.

2. Logga in på Microsoft Power Platform via kommandoraden genom att köra paconn login. Följ anvisningarna för att logga in med Microsofts enhetskodprocess.

3. När du har autentiserats hämtar du dina anpassade anslutningsfiler:

   • Kör paconn download. Välj den miljö som ditt anpassade anslutningsprogram finns i genom att ange dess nummer i kommandoradsgränssnittet. Välj sedan namnet på det anpassade anslutningsprogrammet.

   Verktyget hämtar dina kopplingsartefakter i en mapp till filsystemplatsen där du körde paconn. Beroende på vilken typ av utgivare det finns olika funktioner för:

   Utgivare	Artefakt
   Oberoende utgivare	apiDefinition.swagger.json apiProperties.json
   Utgivare från andra utgivare än Microsoft (andra än oberoende)	apiDefinition.swagger.json apiProperties.json settings.json Ikon för anslutningsprogrammet

Skapa en artefakt för Viktigt-fil

En Readme.md-fil krävs för både oberoende utgivare och utgivare från andra utgivare än Microsoft. Du måste skapa en Readme.md för att dokumentera funktionerna och funktionerna i kopplingen. Ett exempel på dokumentation som ska ingå finns i exemplet Readme.md.

Steg 5: Skicka in ditt anslutningsprogram för distribution

1. Följ instruktionerna i Skicka din Microsoft-certifiering för anslutningsprogram för att skicka GitHub och certifieringsportalen.

2. När du har skickat en pull-förfrågan till databasen med öppen källkod distribuerar och verifierar Microsoft din anslutning inom två arbetsdagar. Om det krävs uppdateringar bör du ytterligare två arbetsdagar.

   Som en del av överföringen verifierar Microsoft ditt anslutningsprogram med hjälp av verktygen CLA-robot, Swagger-valideraren och Breaking Change Detector. Om du behöver felsöka swagger-fel går du till Åtgärda swagger-validatorfel.

Steg 6: Förväntningar på att kunna testas av utgivare från andra utgivare än Microsoft

När vi har verifierat kopplingen ber vi dig att utföra omfattande tester.

1. Följ anvisningarna i Testa ditt anslutningsprogram under certifiering för att skapa en miljö i förhandsversionsregionen som förberedelse för dina tester.

2. Inom en vecka meddelar du Microsoft-kontakten att du har genomfört tester så att vi kan börja distribuera.

3. När både Microsoft och du har verifierat funktionerna och innehållet för kopplingen ska vi arrangera kopplingen för distribution i förhandsgranskningsregionen för testning.

Steg 7: Vänta på distribution

När ditt anslutningsprogram har validerats för testning kommer vi att distribuera det i samtliga produkter och regioner.

Vi meddelar dig via e-post med namnen på de regioner som anslutningsprogram ska distribueras till, allt eftersom distributionen till regioner sker i steg. Om distributionen är fördröjd eller låser sig kan andra utgivare än Microsoft hitta statusen i aktivitetskontrollen på ISV-portalen. Oberoende utgivare meddelas via e-post.

Produktionsdistribution

Våra distributionsscheman för anslutningsprogram för produktionsstart måndag och förmiddag, PST/PDT. Du måste meddela Microsoft att du är redo för produktionsdistributionen minst 24 timmar i förväg så att vi kan ta med ditt anslutningsprogram i nästa schemalagda distribution. Andra utgivare än Microsoft kan meddela oss i aktivitetskontrollen på ISV-portalen. Oberoende utgivare kan meddela sin Microsoft-kontakt.

Regionsdistribution

Distributionen till olika regioner sker i en förbestämd dagsekvens. Områdena är:

• Testar.
• USA förhandsversion.
• Asien utom Japan och Indien.
• Europa utom Storbritannien.
• Brasilien, Kanada, Japan och Indien.
• Australien, Storbritannien och USA.

Om ditt anslutningsprogram exempelvis schemaläggs för att distribueras på måndag, distribueras den till testområdet dag 1. Den distribueras sedan till förhandsgranskningsregionen i USA dag 2. Distributionen fortsätter dagligen tills anslutningsprogrammet har distribuerats till alla sex regioner.

Vi distribuerar inte på fredagar, helger, söndag och USA.

När ditt anslutningsprogram är klar med certifieringen tar vi hjälp av dig om en marknadsföringsmöjlighet för anslutningsprogrammet på -Power Automatebloggen.

Steg 8: Utforska alternativ efter distributionen

Här följer några alternativ som du kan utforska när anslutningsprogrammet väl har distribuerats:

• Visa telemetri för anslutningsprogram när som helst i ISV-portalen. Om du vill visa hälsa och användning för ditt anslutningsprogram, se Få viktiga insikter om ditt certifierade anslutningsprogram i ISV-portalen.

• Skicka uppdateringar till ditt anslutningsprogram. Mer information finns i Uppdatera ditt certifierade anslutningsprogram.

• Övervaka anslutningen i diskussionsforumet för communityn och ta reda på om kunderna har problem eller har funktionsförfrågningar för din anslutning.

• Begär att taggen förhandsgranskning tas bort. När kopplingen har varit offentlig under en tid och uppfyller vissa krav kan den kvalificeras för att tilldelas om taggen allmän tillgänglighet. Den här taggen visar att anslutningsprogrammet är en produktionsklar produkt. För mer information, gå till Flytta anslutningsprogrammet från förhandsgranskning till allmän tillgänglighet.

Checklista innan du skickar

Innan du går vidare till Skicka ditt anslutningsprogram för Microsoft-certifiering ska du se till att:

• Anslutningsprogrammet förser dig med alla standarder som anges i Steg 2: Uppfyll insändningskraven och Steg 3: Lägg till metadata.

• Inga åtgärder saknar en sammanfattning, beskrivning eller synlighetsinformation.

• Du har testat ditt anpassade anslutningsprogram för att säkerställa att åtgärderna fungerar som de ska (minst tio lyckade anrop per åtgärd).

• Inga körtids- eller schemavalideringsfel visas i Testavsnittet i guiden för anpassat anslutningsprogram.

Om du inte är en Microsoft-utgivare (och inte en oberoende utgivare) uppmanas du att godkänna vårt partneravtal och sekretessavtal när du skickar in en Microsoft-certifiering. Kontakta din Microsoft-kontakt om du vill granska dessa villkor och språk innan du skickar in.

Nästa steg

Skicka in dina kopplingar för Microsoft-certifiering