Wysyłanie komunikatów usługi Teams za pomocą działania usługi Teams

Działanie usługi Teams w usłudze Data Factory dla usługi Microsoft Fabric umożliwia wysyłanie wiadomości do kanałów usługi Teams lub czatów grupowych. Można dostosować komunikaty, używając wyrażeń dynamicznych, aby uwzględnić informacje z potoku.

Warunki wstępne

Dodawanie działania usługi Teams do potoku

Aby zintegrować komunikaty usługi Teams z potokiem, musisz dodać działanie usługi Teams. W tej sekcji opisano kroki, które należy wykonać, aby uwzględnić i skonfigurować działanie usługi Teams w potoku.

  1. Utwórz nowy rurociąg w obszarze roboczym.

  2. W okienku Działania wyszukaj pozycję Teams i wybierz ją, aby dodać ją do kanwy potoku.

    Zrzut ekranu przedstawiający interfejs użytkownika Fabric z wyróżnionym okienkiem Działania i działalnością Teams.

  3. Wybierz nowe działanie usługi Teams na kanwie.

    Zrzut ekranu przedstawiający kartę Ustawienia ogólne działania usługi Teams.

Aby uzyskać szczegółowe informacje na temat karty Ustawienia ogólne , zobacz Ustawienia ogólne.

Konfigurowanie ustawień działań usługi Teams

Skonfiguruj działanie usługi Teams, wykonując następujące kroki:

  1. Dodaj połączenie do swojej aktywności w Teams. Możesz utworzyć nowe połączenie lub użyć istniejącego.

    Uwaga / Notatka

    • Jeśli używasz uwierzytelniania użytkownika i wdrażasz potok z funkcją Teams w innym obszarze roboczym, funkcja będzie nieaktywna do momentu utworzenia nowego połączenia uwierzytelniania użytkownika w docelowym obszarze roboczym.
    • Jeśli nie masz dostępu do połączeń używanych w działaniu usługi Teams, początkowe wdrożenie zakończy się niepowodzeniem. Aby rozwiązać problemy, możesz edytować potok docelowy i zmienić autoryzację lub ustawić działanie na nieaktywne.

    Zrzut ekranu przedstawiający kartę Ustawienia działania usługi Teams z wyróżnionymi miejscami tworzenia nowego połączenia lub używania istniejącego połączenia.

  2. Wybierz miejsce publikowania wiadomości przy użyciu ustawienia Opublikuj w . Możesz publikować w kanale lub czacie grupowym.

    Zrzut ekranu przedstawiający kartę Ustawienia działania usługi Teams z wyróżnionymi miejscami, w których należy wybrać publikowanie w kanale lub czacie grupowym.

  3. Jeśli wybierzesz czat grupowy, użyj listy rozwijanej, aby wybrać czat grupowy, którego jesteś częścią. Jeśli wybierzesz kanał, wybierz najpierw zespół, a następnie kanał z rozwijanej listy.

  4. Napisz wiadomość w obszarze Wiadomość . Użyj wyrażeń dynamicznych , aby uwzględnić zmienne systemowe lub użytkownika, wyrażenia lub funkcje. Wybierz opcję Zobacz w kreatorze wyrażeń, aby dodać wyrażenia dynamiczne.

    Zrzut ekranu przedstawiający kartę Ustawienia działania usługi Teams z wyróżnionym linkiem, aby wybrać opcję używania wyrażeń dynamicznych.

  5. Jeśli publikujesz w kanale, możesz dodać temat dla wiadomości w polu tekstowym Temat .

    Zrzut ekranu przedstawiający kartę Ustawienia w aplikacji Teams, z zaznaczonymi polami do dodawania tematu.

Znane ograniczenia

  • Funkcjonalność w Microsoft Teams będzie nieaktywna w przypadku korzystania z CI/CD.

Uwierzytelnianie i właściciel połączenia

Aktywność Microsoft Teams wykorzystuje uwierzytelnianie oparte na użytkowniku. Każde połączenie Teams jest powiązane z tożsamością i tokenem uwierzytelniającym użytkownika, który je utworzył.

Przy konfigurowaniu połączeń Teams obowiązują następujące kwestie:

  • Połączenia specyficzne dla użytkownika: Każdy użytkownik, który chce uruchomić pipeline wysyłający wiadomości do Teams, musi utworzyć i uwierzytelnić własne połączenie Teams.
  • Współdzielenie połączeń: Połączenia Teams nie mogą być współdzielone między użytkownikami. Utworzenie połączenia za pomocą konta administratora nie pozwala innym użytkownikom na ponowne użycie go.
  • Konfiguracja przestrzeni roboczej: Podczas wdrażania potoków między przestrzeniami roboczymi upewnij się, że odpowiednie połączenie Teams jest skonfigurowane i uwierzytelnione dla użytkownika uruchamiającego potok.
  • Środowiska produkcyjne: Aktywność Teams wymaga uwierzytelniania użytkownika i obecnie nie obsługuje uwierzytelniania za pomocą jednostki usługi (SPN) ani tożsamości obszaru roboczego (WI). Potoki produkcyjne wykorzystujące aktywność Teams muszą więc korzystać z połączenia uwierzytelnianego przez użytkownika.

Uwaga / Notatka

Połączenia Teams są powiązane z tożsamością uwierzytelnionego użytkownika, niezależnie od tego, czy konto posiada uprawnienia administratora. W scenariuszach produkcyjnych weź pod uwagę wymagania organizacji dotyczące zarządzania tożsamością i ładu organizacyjnego przy ustalaniu, które konto utworzy i utrzyma połączenie.