Ikke-Microsoft udgivercertificeringsproces

Denne proces er for udgivere, der ikke er Microsoft-udgivere (med undtagelse af uafhængige udgivere). Hvis du er uafhængig udgiver, skal du gå til en uafhængig udgivercertificeringsproces.

Når du er færdig med udviklingen af din brugerdefinerede connector, skal du følge disse trin for at forberede den til certificering og generere de connectorfiler, der skal indsendes til Microsoft.

Trin 1: Registrer den connector

Du behøver ikke at have færdiggjort udviklingen af din brugerdefinerede connector, for at du kan ansøge om certificering. Du kan starte certificeringsprocessen ved at registrere connectoren til certificering ved at udfylde registreringsformularen.

Forvent en mail inden for to arbejdsdage fra en Microsoft-kontakt, der vil:

• Forstå din brugerdefinerede connector.
• Få mere at vide om status for din udvikling.
• Vejleder dig gennem certificeringsprocessen.

Trin 2: Over opfyldte krav til afsendelse

Microsoft har et sæt krav og retningslinjer, som din brugerdefinerede connector skal overholde for at blive certificeret, for at sikre en høj kvalitet og ensartethed mellem vores certificerede connectorer.

Give connectoren en titel

• Skal findes og være skrevet på engelsk.
• Skal være entydig og kunne adskilles fra alle eksisterende connector-titler.
• Skal være navnet på dit produkt eller din organisation.
• Skal følge eksisterende navngivningsmønstre for certificerede connectorer.
• Navn må ikke være på mere end 30 tegn.
• Må ikke indeholde ordet "API", "Connector" eller nogen af vores Power Platform-produktnavne (f.eks. "Power Apps").
• Må ikke ende på et ikke-alfanumerisk tegn, herunder vognretur, ny linje eller tom plads.

Eksempler

• Good connector-titler: "Azure Sentinel", "Office 365 Outlook"
• Titler på forskellige connectorer: "Azure Sentinel's Power Apps Connector", "Office 365 Outlook API"

Skriv en beskrivelse af forbindelsen

• Skal findes og være skrevet på engelsk.
• Skal være fri for grammatik- og stavefejl.
• Skal beskrive det primære formål og den præcise værdi, som connectoren tilbyder.
• Må ikke være kortere end 30 tegn eller længere end 500 tegn.
• Må ikke indeholde Power Platform-produktnavne (f.eks. "Power Apps").

Design et ikon for din forbindelse

Dette afsnit gælder ikke for uafhængige udgivere.

• Opret et logo på ca. 160 × 160 pixel i et firkantet felt på ca. 230 × 230 pixel (uden afrunding).
• Skal indeholde en ikke-transparent, ikke-hvid farve (#ffffff) som baggrund og ikke-standardfarve (#007ee5), der svarer til den angivne baggrundsfarve for ikon.
• Skal være entydigt for ethvert andet certificeret connector-ikon.
• Skal sendes i PNG-format som icon.png.

Definere operations- og parameteroversigter og beskrivelser

• Skal findes og være skrevet på engelsk.
• Skal være fri for grammatik- og stavefejl.
• Oversigter for handlinger og parametre skal være sætninger på 80 tegn eller kortere, og må kun indeholde alfanumeriske tegn eller parenteser.
• Beskrivelser af handlinger og parametre skal være fulde, beskrivende sætninger og slutte med punktum.
• Må ikke indeholde noget af Microsoft Power Platform-produktnavne (f.eks. "Power Apps").

Definer nøjagtige operationsresponser

• Definer kun operationsresponser med et nøjagtigt skema med forventede responser.
• Brug ikke standardsvar med en nøjagtig skemadefinition.
• Angiv gyldige svarskemadefinitioner for alle handlinger i Swagger. Tomme svarskemaer er ikke tilladt. Det betyder, at der ikke vises dynamisk indhold i outputtet, og opretterne skal bruge JSON til at fortolke svaret.

Oprette strenge på engelsk af høj kvalitet

Connectorer er oversat som en del af oversættelsen af Power Automate. Når du udvikler en connector, er kvaliteten af de engelske strenge derfor nøglen til oversættelseskvaliteten. Her er nogle vigtige områder, du skal fokusere på, når du opretter værdierne af de strenge, du skal angive.

• Sørg for at køre et program til stavekontrol for at sikre, at alle strengværdier er fri for skrivefejl. Hvis en streng på engelsk er ufuldstændig, vil oversættelsesresultatet være ufuldstændigt eller forkert i sammenhængen.

• Kontrollér, at sætningen er fuldstændig. Hvis sætningen ikke er fuldstændig, kan det også medføre oversættelser af lavere kvalitet.

• Kontrollér, at betydningen af sætningen er klar. Hvis betydningen af sætningen er tvetydig, kan det også medføre dårligere eller forkerte oversættelser.

• Undgå sammensatte kørselsstrenge, hvis det er muligt. Brug i stedet fuldt udskrevne sætninger. Sammensatte strenge eller sætninger gør det vanskeligt at oversætte, eller de kan medføre en forkert oversættelse.

• Hvis du bruger forkortelser, skal du sørge for at bruge store bogstaver for at gøre det klart. Derved reduceres risikoen for, at den misforstås på grund af en skrivefejl.

• Strenge i CaMel-form (for eksempel minimizeHighways eller MinimizeHighways) opfattes som regel som strenge, der ikke kan oversættes. Hvis du vil lokalisere strengværdien, skal du løse CaMel-formularstrengen.

Trin 3: Tilføj metadata

Connector-artefakterne (filerne) skal indeholde bestemte metadata, som beskriver connectoren og dens slutservice. De oplysninger, der angives i metadata, udgives i vores connector-dokumentation og er offentligt tilgængelige for alle brugere. Du skal ikke angive private eller fortrolige oplysninger og give os besked via din Microsoft-kontakt, hvis der er problemer med at give os disse oplysninger. Hvis du vil læse om, hvordan metadata skal dokumenteres, skal du besøge en af de connector-specifikke sider i dokumentationen under Reference til connector.

Trin 3a: egenskaber for udgiver og stackOwner

• "udgiver" er navnet på din virksomhed eller organisation. Angiv hele virksomhedens navn (f.eks. "Contoso Corporation"). Dette skal være i alfanumerisk format.

• "stackOwner" er den virksomhed, der ejer eller organisation af den backend-servicestakke, som connectoren opretter forbindelse til. Dette skal være i alfanumerisk format.

Filplacering: apiProperties.json

Syntaks: Egenskaberne udgiver og stackOwner findes som egenskaber på øverste niveau i filen apiProperties.json. Tilføj følgende fremhævede linjer som vist. Sørg for at angive egenskabsnavnet og skemaet nøjagtigt som vist.

Trin 3c: eksempelkodestykker

Du kan bruge følgende kodestumps til at kopiere og angive oplysninger. Sørg for at føje kodestuderne til de rette filer på de rette placeringer som beskrevet i det foregående afsnit.

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

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

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

Trin 3d: Valider dine brugerdefinerede connectorfiler

Kør paconn validate --api-def [Location of apiDefinition.swagger.json]. Dette værktøj validerer din connectordefinition og giver dig besked om eventuelle fejl, du skal løse inden indsendelse.

Hvis din connector bruger OAuth som godkendelsestype, skal du føje disse tilladte URL-adresser til omdirigering til din app:

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

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

Trin 4: Forberedelse af connectorartefakter

Det bør tage ca. en uge at fuldføre dette trin.

Du sender et sæt filer kaldet connector-artefakter til Microsoft, som downloades vha. et CLI-værktøj på kommandolinjegrænsefladen, der leveres af Microsoft. Dette værktøj validerer forbindelsen for eventuelle de seneste fejl.

Kom i gang ved at følge disse trin:

1. Installer værktøjet Microsoft Power Platform Connectors CLI ved at følge installationsanvisningerne.

2. Log på Microsoft Power Platform via kommandolinjen ved at køre paconn login. Følg instruktionerne for at logge på vha. Microsofts proces for enhedskoder.

3. Når du er godkendt, skal du hente dine brugerdefinerede connectorfiler:

   • Kør paconn download. Vælg det miljø, din tilpassede connector findes i, ved at angive dens nummer på kommandolinjen og derefter navnet på den tilpassede connector.

   Værktøjet downloader dine connector-artefakter i en mappe til den placering i filsystemet, hvor du har kørt paconn. Afhængigt af udgivertypen kan du se forskellige artefakter:

   Udgiver	Artefakt
   Uafhængig udgiver	apiDefinition.swagger.json apiProperties.json
   Udgiver der er ikke-Microsoft (bortset fra uafhængig)	apiDefinition.swagger.json apiProperties.json settings.json Connector-ikon

Oprette en vigtig artefaktfil

En Vigtigt.md-fil er nødvendig for både uafhængige udgivere og ikke-Microsoft-udgivere. Du skal oprette en Vigtigt.md-fil for at dokumentere din connectors funktioner og funktionalitet. Hvis du vil se et eksempel på dokumentation, du kan medtage, skal du gå til Eksempel på Vigtig.md.

Trin 5: Indsend connectoren til installation

1. Følg instruktionerne i Sende din connector til Microsoft-certificering for at sende den til GitHub og certificeringsportalen.

2. Når du har indsendt en pull-anmodning til lageret med åben kildekode, vil Microsoft installere og validere connectoren inden for to arbejdsdage. Hvis der kræves opdateringer, skal der gå yderligere to arbejdsdage.

   Som en del af afsendelsen validerer Microsoft din connector ved hjælp af værktøjerne CLA-bot, Swagger Validator og Breaking Change Detector. Hvis du har brug for at foretage fejlfinding af Swagger-fejl, skal du gå til Rette fejl i Swagger-validering.

Trin 6: Forventninger til test udført af ikke-Microsoft-udgivere

Når vi har valideret din connector, bliver du bedt om at foretage en grundig test.

1. Følg instruktionerne i Test connectoren i certificeringen for at oprette et miljø i eksempelområdet som forberedelse til testen.

2. Giv din Microsoft-kontakt besked om, at du har udført testen, inden for en uge, så vi kan begynde udrulningen.

3. Når funktionaliteten og indholdet af din connector er valideret af både Microsoft og dig selv, vil vi overføre connectoren til udrulning i forhåndsversionsområdet til test.

Trin 7: Vent på udrulning

Når connectoren er godkendt til test, udruller vi den på tværs af alle produkter og områder.

Vi sender dig en mail med navnene på de områder, connectoren installeres i, da udrulningen til områder udføres i trin. Hvis udrulningen forsinkes eller fastfryses, kan ikke-Microsoft-udgivere finde statussen i Aktivitetskontrol på ISV-portalen. Uafhængige udgivere får besked via mail.

Produktionsinstallation

Vores udrulningsplaner for en connector starter mandag og onsdag morgen, PST/PDT. Giv din Microsoft-kontakt besked, når du er klar til produktionsinstallationen, mindst 24 timer i forvejen, så vi kan inkludere din connector i den næste planlagte udrulning. Udgivere, der ikke er Microsoft, kan give os besked i Aktivitetskontrol på ISV-portalen. Uafhængige udgivere kan give deres Microsoft-kontakt besked.

Installationsområde

Installationen til forskellige områder sker i en forudbestemt daglig rækkefølge. Der findes følgende områder:

• Test.
• Amerikansk forhåndsversion.
• Asien med undtagelse af Japan og Indien.
• Europa, undtagen Storbritannien.
• Brasilien, Canada, Japan og Indien.
• Australien, Storbritannien og USA.

Hvis connectoren f.eks. er planlagt til at blive udrullet mandag, udrulles den i testområdet på dag 1. Derefter udrulles den til det amerikanske forhåndsversionsområde på dag 2. Udrulningen fortsætter dagligt, indtil connectoren er udrullet til alle seks områder.

Vi udruller ikke på fredage, lørdage, søndage og helligdage i USA.

Efterhånden som din connector er ved at blive certificeret, giver vi dig oplysninger om en marketingmulighed for connectoren på Power Automate-bloggen.

Trin 8: Undersøg indstillinger efter installationen

Her er nogle muligheder, du kan undersøge, når tilslutningen er installeret:

• Du kan altid få vist telemetrien til tilslutning i ISV-portalen. Hvis du vil have vist tilstand og brug af din connector, skal du gå til Få vigtig indsigt om den certificerede tilslutning i ISV-portalen.

• Send opdateringer til din connector. Du kan finde flere oplysninger under Opdatering af den certificerede connector.

• Overvåg din connector i communitydebatforummet for at finde ud af, om kunder støder på problemer eller har funktionsanmodninger for din connector.

• Anmod om fjernelse af mærket forhåndsversion. Når connectoren har været offentligt tilgængelig i et stykke tid og overholder visse krav, kan den tildeles mærket generelt tilgængelig igen. Dette mærke viser, at connectoren er et produkt, der er klar til produktion. Du kan finde flere yderligere oplysninger i Flyt din connector fra forhåndsversion til generel tilgængelighed.

Tjekliste før du sender

Før du går videre til Send din connector til Microsoft-certificering, skal du kontrollere, at:

• Din connector opfylder alle de standarder, der er angivet i Trin 2: Opfyld afsendelseskrav og Trin 3: Tilføj metadata.

• Ingen handlinger mangler en oversigt, beskrivelse eller synlighedsoplysninger.

• Du har testet den brugerdefinerede tilslutning for at sikre, at driften fungerer som forventet (mindst 10 vellykkede opkald pr. handling).

• Der ikke vises fejl under kørsel eller skemavalidering i testsektionen i guiden for den brugerdefinerede connector.

Hvis du ikke er Microsoft-udgiver (og ikke en uafhængig udgiver), bliver du bedt om at acceptere partneraftalen og aftalen om hemmeligholdelse, når du indsender til Microsoft-certificering. Hvis du vil gennemse disse vilkår og sprog, før du indsender, skal du kontakte din Microsoft-kontakt.

Næste trin

Indsende dine connectorer til Microsoft-certificering