Udostępnij za pośrednictwem


Testowanie i dystrybuowanie łącznika niestandardowego

Ważne

Niektóre lub wszystkie te funkcje są dostępne w wersji zapoznawczej. Zawartość i funkcjonalność mogą ulec zmianie.

W tym artykule przedstawiono informacje na temat testowania i dystrybuowania niestandardowego łącznika importu danych Microsoft Sustainability Manager.

Testowanie łącznika UI

Postępując zgodnie z poniższymi krokami można zobaczyć, jak wygląda interfejs użytkownika łącznika.

  1. Wyeksportuj utworzone wcześniej rozwiązanie Power Platform, wykonując kroki opisane w Export solutions. Upewnij się, że eksportowany numer wersji rozwiązania jest wyższy niż bieżąca. Rozwiązanie zostanie zaimportowane ponownie po dodaniu utworzonego wcześniej pliku XML.

  2. Wyodrębnij wyeksportowane pliki ZIP i utwórz nowy folder o nazwie Zasoby.

  3. Zapisz plik msdyn_dataconnectors.xml (oraz plik msdyn_dataflowtemplates.xml dla łącznika szablonu Power Query) w folderze Zasoby.

    W przypadku Power Automate łącznika struktura folderów powinna teraz wyglądać tak:

    Zrzut ekranu przedstawiający folder i pliki w pliku ZIP dla łącznika Power Automate .

    W przypadku łącznika szablonu Power Query struktura folderów powinna teraz wyglądać tak:

    Zrzut ekranu przedstawiający folder i pliki w pliku ZIP dla szablonu łącznika Power Query .

  4. Zaznacz wszystkie pliki i skompresuj je do pliku ZIP. Po otwarciu nowo utworzonego pliku ZIP struktura folderów najwyższego poziomu powinna mieć następujące elementy:

    • Folder Zasoby
    • [Typy zawartości] plik
    • customizations.xml plik
    • solution.xml plik
    • Plik ZIP rozwiązania szablonów (dla szablonów łączników Power Query)
  5. Ponownie zaimportuj plik ZIP do tego samego Power Platform środowiska, w którym został wyeksportowany, zgodnie z krokami z procedury importowania rozwiązań.

  6. Po pomyślnym ukończeniu importowania w tym środowisku jest wyświetlany łącznik. W witrynie Sustainability Manager w obszarze Dane po lewej stronie nawigacji wybierz opcję Importy. Wybierz pozycję Nowe, a następnie wybierz pozycję ŁĄCZNIKI DOSTAWCY DANYCH. Kafelek łącznika zostanie wyświetlony na następnej stronie. Wybierz kafelek łącznika, a następnie wybierz przycisk Dalej.

    W przypadku łącznika Power Automate zostanie wyświetlony interfejs użytkownika dla zaprojektowanego formularza poświadczeń. Możesz upewnić się, że wygląda on dobrze, i debugowanie formularza za pośrednictwem tej strony.

    W przypadku łącznika szablonów Power Query zostanie wyświetlone okno importowania szablonów Power Query.

    Aby wprowadzić dowolne zmiany, wykonaj kroki opisane w celu wyeksportowania rozwiązania, zaktualizuj plik msdyn_dataconnectors.xml a następnie ponownie zaimportuj. Upewnij się, że eksportowana wersja jest większa niż bieżąca.

  7. Możesz wypełnić formularz przykładowym wartościami i zapisać go. Aby sprawdzić sposób przechowywania tych wartości, w Power Apps wybierz opcję Tabele. Wybierz Wszystkie i wyszukaj msdyn_providercredential. Pokażą się dane w tabeli. Jeśli połączenie jest używane po raz pierwszy, powinien być tylko jeden rekord poświadczeń. Należy sprawdzić w kolumnie Poświadczenia jaki sposób są przechowywane wartości podane w formularzu.

    Zrzut ekranu przedstawiający kolumnę Poświadczenia w tabeli msdyn_providercredential.

Testuj pod względem obsługi błędów

W przypadku łączników Power Automate istotne jest, aby obsługiwać błędy w przepływie połączenia. Jeśli z jakiegoś powodu dowolny krok przepływu nie powiedzie się, stan importu danych pozostanie zablokowany jako Zaplanowany.

Aby przetestować to zdarzenie, dodaj akcje w przepływie w blokach try/catch. W bloku "catch" nie można odświeżyć połączenia i połączenia.

Jeśli połączenie zakończy się niepowodzeniem, użytkownicy powinni mieć możliwość skontaktowania się z użytkownikiem, używając łącza obsługi zawartego w JSON interfejsu użytkownika łącznika. Ten rekord JSON jest wyświetlany w Kroku 2: Tworzenie rekordu łącznika.

Aby uznć połączenie za nieudane i nie odświeżyć go, należy użyć akcji Aktualizuj wiersz Dataverse zarówno dla Odświeżania połączenia i rekordu Połączenie.

  • W przypadku Odświeżania połączenia ustaw dla pola Stanu odświeżenia wartość Niepowodzenie:

    Zrzut ekranu przedstawiający sposób ustawienia pola stanu Odświeżanie rekordu Połączenie ma wartość Niepowodzenie w przepływie Power Automate .

  • W przypadku Połączenie ustaw dla pola Stanu wartość Błąd:

    Zrzut ekranu przedstawiający sposób ustawienia pola stanu Odświeżanie rekordu Połączenie ma wartość Niepowodzenie w przepływie Power Automate .

Aby uzyskać więcej informacji, zobacz Użyj przepływu, aby zaktualizować wiersz.

Aby uzyskać więcej informacji na temat obsługi błędów, przejdź do tematu Najlepsze wskazówki dotyczące obsługi błędów w przepływach Power Automate .

Testowanie łącznika

Po utworzeniu łącznika można go wyeksportować jako łącznik, rozwiązanie zarządzane, zgodnie z krokami Wyeksportuj rozwiązania.

Zaimportuj wyeksportowane rozwiązanie do innych środowisk, w których zainstalowano Sustainability Manager i przetestuj je, aby upewnić się, że działa zgodnie z przeznaczeniem.

Rozpowszechniaj swój łącznik

Po zakończeniu testowania można w sposób prywatny dystrybuować rozwiązanie bezpośrednio do użytkowników lub publicznie je dystrybuować Microsoft AppSource. Aby uzyskać więcej informacji o dystrybucji za pośrednictwem AppSource, przejdź do publikowania aplikacji AppSource.