Przesyłanie łącznika do certyfikacji przez firmę Microsoft

W tym artykule przedstawiono następujące zagadnienia:

1. Opublikuj łącznik w repozytorium open-source.

2. (Ten krok nie dotyczy wydawców niezależnych). Prześlij informacje o zatwierdzeniu do certyfikacji w portalu certyfikacji łącznika.

Ogólnie w ramach programu certyfikacji wymagamy udostępniania w trybie open-source. W razie pytań należy poprosić o kontakt z firmy Microsoft.

Udostępnianie łącznika w trybie open-source

Ta sekcja dotyczy zweryfikowanych wydawców, uwzględniając wydawców niezależnych.

Ważne

Przed dodaniem łącznika do portalu certyfikacyjnego należy otworzyć łącznik w celu ograniczenia niespójności. Jeśli po raz pierwszy współtworzysz coś w GitHub należy wziąć udział w sesji Przykłady Power Platform - Współtwórca po raz pierwszy.

1. Otwórz zapytanie pull w repozytorium open-source.

2. Inżynier ds. certyfikacji firmy Microsoft przekaże opinię w ciągu 1–2 tygodni od pierwszego żądania. Jeśli opinia wymaga aktualizacji łącznika, należy przesłać aktualizację żądania ściągnięcia. Odczekaj na to dodatkowe 1 do 2 tygodni.

   Zachowujesz własność łącznika i możesz akceptować lub odrzucać wszelkie zmiany w łączniku.

3. Firma Microsoft zatwierdzi i scali żądanie pull. Po scaleniu żądania ściągnięcia łącznika możesz przesłać artefakty łącznika do portalu certyfikacji łącznika. Aby uzyskać instrukcje, przejdź do tematu Przesyłanie do portalu certyfikacji łącznika.

Korzyści z open-sourcingu Twojego łącznika

Istnieje wiele korzyści z otwartego źródła łącznika, w tym:

• Z łatwością dodawaj funkcje do wcześniej wydanego gotowego, niewymiennego złącza.

• Skorzystaj z wkładu społeczności deweloperów w zakresie ulepszeń i konserwacji łączników.

• Włącz platformę, na której użytkownicy mogą przesyłać i współtworzyć prośby o funkcje.

• Podaj bogatszą historię śledzenia zmian wprowadzonych w łączniku.

• Umożliwiaj współpracę wielu programistom.

Ważne są następujące punkty dotyczące naszego programu:

• Udostępniasz tylko pliki łącznika typu open source, a nie interfejs API. Te dane są już dostępne dla użytkowników Microsoft Power Platform za pośrednictwem publicznych interfejsów API.

• Artefakty łącznika są przechowywane i publicznie dostępne w naszym repozytorium GitHub. Możesz tam zobaczyć istniejące łączniki typu open-source.

• W repozytorium nie są przechowywane żadne dane osobowe ani własność intelektualna.

• Firma Microsoft uwzględnia Cię w pliku CODEOWNERS dla łącznika w usłudze GitHub, a wszelkie zmiany w łączniku są zarządzane przez Ciebie.

Przekazywanie z plików lokalnych

Jeśli przyznano Ci wyjątek od kodu open source, musisz przesłać łącznik, przekazując lokalne pliki łącznika:

1. Sformatuj pliki łącznika niestandardowego w archiwum .zip, które przesyłasz do firmy Microsoft.

2. Przesyłaj tylko archiwa, które przeszły walidację i zawierają wymagane trzy pliki artefaktów:

   • apiDefinition.swagger.json
   • apiProperties.json
   • Ikona łącznika

   Ważne

   W przypadku korzystania z systemu macOS upewnij się, że w archiwum zip znajdują się tylko trzy pliki artefaktów łącznika. Domyślnie system macOS uwzględnia inne foldery i pliki w archiwum zip.

Przesyłanie do portalu certyfikacji łączników

Ta sekcja dotyczy zweryfikowanych wydawców, wyłączając wydawców niezależnych.

Po scaleniu żądania ściągnięcia łącznika możesz przesłać artefakty łącznika do portalu certyfikacji łączników.

Jeśli Twoje zgłoszenie zostało rozpatrzone pozytywnie, możesz spodziewać się odpowiedzi od inżyniera certyfikacji w ciągu 1 do 2 tygodni. Jeśli wystąpią problemy z przesłaniem, musisz zaktualizować zgłoszenie na podstawie opinii. Inżynier certyfikacji potrzebuje dodatkowych 1 do 2 tygodni na odpowiedź.

Jeśli przyznano Ci wyjątek od kodu open source, nie przesyłaj łącznika, dopóki kontakt firmy Microsoft nie pokieruje Cię do. Upewnij się, że wykonano wszystkie kroki opisane w procesie certyfikacji i zweryfikowano artefakty przed przesłaniem.

Przycisk Prześlij do recenzji jest dostępny, gdy wszystkie pola zawierają prawidłowe dane wejściowe.

1. Upewnij się, że jest tworzymy wysyłanie wiadomości z aktywnym adresem e-mail.

2. W portalu certyfikacji łącznika zostanie wyświetlony monit o przesłanie plików przez:

   • Wprowadzenie informacji o zatwierdzeniu w usłudze GitHub z łącznika udostępnionego w trybie open-source.

     Uwaga

     Upewnij się, że jest podany ostatnio identyfikator zatwierdzenia działu PR łącznika.

   • Przekazanie archiwum ZIP utworzonego w poprzednim kroku.

3. W portalu certyfikacji łączników wprowadź następujące informacje:

   • Informacje na temat testowania łącznika i poświadczenia:

     • Podaj możliwie najwięcej szczegółowych informacji, aby zapewnić bezproblemowe testowanie. Upewnij się, że są podane prawidłowe informacje testowe.

     

     Ważne

     Jeśli typ Twojego oprogramowania sprzęgającego to OAuth, upewnij się, że podajesz prawidłowy identyfikator klienta i tajny klucz klienta. Informacje te nie mogą być zmieniane po przesłaniu. Po jego otrzymaniu będzie on przechowywany w Azure Key Vault.

     Jeśli chcesz to zmienić, skontaktuj się z przedstawicielem firmy Microsoft.

     • Jeśli łącznik używa standardu OAuth jako typu uwierzytelniania, należy dodać te dozwolone adresy URL przekierowania do aplikacji:

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

     • Unikaj udostępniania konta korzystającego z uwierzytelniania wieloskładnikowego (MFA) lub przedstaw zespołowi certyfikującemu kroki, aby prawidłowo uzyskać dostęp do konta chronionego MFA.

   • W razie problemów wyślij wiadomość e-mail do działu pomocy technicznej Microsoft.

4. Skontaktuj się z osobą kontaktową w Microsoft, jeśli napotkasz trudności podczas przesyłania artefaktów łącznika.

5. Po przesłaniu artefaktów dołącz oddzielnie do intro.md obszaru Kontrola aktywności lub Dokumentacja funkcjonalna. Jest to intro.md zawarte w publicznej dokumentacji łącznika. Jest to element inny niż readme.md przesłany podczas kroku udostępniania w trybie open-source.

   Nie dołączaj informacji o akcjach ani wyzwalaczach łącznika w programie intro.md, ponieważ te informacje są generowane automatycznie podczas certyfikacji.

6. (Wymagane) Jako przykładu szablonu do użycia należy użyć następującego znacznika w pliku intro.md:

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.

## 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. 

## 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.

## 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.

## 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.

## 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.

## 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.

Po przesłaniu łącznika i intro.md możesz przygotować się do jego testowania. Zobacz Testowanie łącznika w ramach certyfikacji.

Aktualizowanie przesyłania przed certyfikacją

Ta sekcja dotyczy zweryfikowanych wydawców, wyłączając wydawców niezależnych.

Należy zaktualizować tylko łącznik, który jest w trakcie certyfikacji, ale nie jest jeszcze certyfikowany, w następujących sytuacjach:

• Gdy firma Microsoft zażąda zmian.

• Gdy znajdziesz krytyczny problem, który należy rozwiązać przed certyfikacją.

Ważne

Wszelkie aktualizacje podczas procesu certyfikacji resetują proces. Po przesłaniu aktualizacji prosimy przesłać zapytanie pull z zaktualizowanymi artefaktami w repozytorium open-source.

Aby przesłać aktualizację:

1. Przejdź do portalu certyfikacji łączników, a następnie wybierz istniejące przesłanie.

2. W okienku, które zostanie otwarte po prawej stronie, wybierz najnowszą wersję.

   

3. W lewym dolnym rogu widoku Przesyłanie łącznika wybierz opcję Prześlij aktualizację.

4. W oknie dialogowym Potwierdź edycję wybierz Potwierdź. Spowoduje to zresetowanie procesu certyfikacji.

5. Usuń istniejącą archiwizację łączników, wybierając pozycję Usuń. Wykonaj jedną z następujących czynności:

   • Użyj integracji z usługą GitHub w celu pozyskania zaktualizowanych artefaktów z repozytorium typu open-source
   • Przekazanie zaktualizowanego archiwum ZIP

   

6. Wypełnij pola w formularzu przesyłania. Upewnij się, że podajesz odpowiednie informacje—w tym testowanie—ponieważ ma to zastosowanie do najnowszej aktualizacji.

7. W lewym dolnym rogu widoku Przesyłanie łącznika wybierz opcję Prześlij do analizy. Zostanie wyświetlone potwierdzenie zilustrowane na poniższej ilustracji, a firma Microsoft rozpocznie proces przeglądu.

   

Ważne

Po zakończeniu kroku 7 nie wybieraj ponownie opcji Prześlij aktualizację. Spowoduje to ponowne zresetowanie postępu.

Jeśli chcesz przesłać aktualizację do łącznika, który jest już certyfikowany, przejdź do tematu Aktualizowanie certyfikowanego łącznika.

Następny krok

Testowanie łącznika w ramach certyfikacji

Przekazywanie opinii

Jesteśmy wdzięczni za opinie na temat problemów z platformą łączników oraz pomysły na nowe funkcje. Aby przekazać opinię, przejdź na stronę Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.