Udostępnij przez

Teams-Spirit (wersja zapoznawcza)

Łącznik Teams-Spirit umożliwia łączenie Teams-Spirit subskrypcji z przepływami.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Immanuel Fuchs
adres URL https://teams-spirit.de/#kontakt
Email info@digitalteamwork.de
Metadane łącznika
Publisher D.F.K. Digitalteamwork GmbH
Witryna internetowa https://teams-spirit.de
Zasady ochrony prywatności https://teams-spirit.de/datenschutz/
Kategorie Komunikacja; Produktywność

łącznik Teams-Spirit

Teams-Spirit udostępnia rozbudowany interfejs API REST. Korzystając z tego interfejsu API, możesz zarządzać zatwierdzeniami, zespołami i użytkownikami za pośrednictwem usługi Teams-Spirit.

Wydawca: D.F.K. Digital Teamwork GmbH

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

  • Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
  • Aplikacja Teams-Spirit Azure AD Dla przedsiębiorstw (zazwyczaj będzie to obecne, jeśli używasz Teams-Spirit)
  • Subskrypcja Teams-Spirit
  • Narzędzia interfejsu wiersza polecenia platformy Power Platform

Obsługiwane operacje

Łącznik udostępnia następujące wyzwalacze:

Action-Trigger

Można wyzwolić za pomocą akcji Teams-Spirit Łącznik obsługuje następujące operacje:

Pobieranie wszystkich zatwierdzeń

Wyświetla listę wszystkich zatwierdzeń

Zatwierdza

Zatwierdza zatwierdzenie

Odrzuć

Odrzucanie zatwierdzenia

Zespół archiwum

Archiwizowanie zespołu i opcjonalnie oznacza witrynę programu SharePoint jako tylko do odczytu

Usuń zespół

Usuwa zespół

Zmienianie roli na członka

Zmienia rolę użytkowników na członka

Zmienianie roli na właściciela

Zmienia rolę użytkowników na właściciela

Usuń wszystkich gości

Usuwa wszystkich gości z zespołu

Usuń wszystkich użytkowników z wyjątkiem właściciela

Usuwa wszystkich członków zespołu z wyjątkiem danego właściciela

Usuwanie użytkownika z zespołu

Usuwa użytkownika z zespołu

Zmień wartość tagu

Zmienia wartość tagu Teams-Spirit

Pobieranie wartości tagu

Zwraca wartość tagu Teams-Spirit

Przedłużanie daty wygaśnięcia

Rozszerza datę wygaśnięcia zespołów

Uzyskiwanie poświadczeń

Łącznik Teams-Spirit używa protokołu OAuth2 w usłudze Azure Active Directory (AD). Jest to ta sama metoda uwierzytelniania używana przez samą aplikację Teams-Spirit, dlatego użytkownik będzie miał te same uprawnienia zarówno w łączniku, jak i aplikacji.

Wprowadzenie

Jeśli chcesz, aby przepływ był wyzwalany przez regułę Teams-Spirit, możesz utworzyć nowy przepływ za pomocą wyzwalacza akcji. Po podaniu nazwy zostanie ona zarejestrowana w Teams-Spirit i będzie dostępna w a także w aule Rule-Engine. Każdy parametr dostępny w regule Teams-Spirit można wysłać do przepływu i użyć go do dalszej automatyzacji przepływów pracy.

Instrukcje dotyczące wdrażania

Ponieważ interfejs API Teams-Spirit jest zabezpieczony przez usługę Azure Active Directory (AD) za pośrednictwem protokołu OAuth2, najpierw musimy skonfigurować kilka rzeczy w usłudze Azure AD, aby nasze łączniki mogły bezpiecznie uzyskać dostęp do interfejsu API. Po zakończeniu możesz utworzyć i przetestować łącznik.

Konfigurowanie aplikacji usługi Azure AD dla łącznika niestandardowego

Najpierw musimy zarejestrować nasz łącznik jako aplikację w usłudze Azure AD. Pozwoli to łącznikowi zidentyfikować się w usłudze Azure AD, aby mógł poprosić o uprawnienia dostępu do danych Teams-Spirit w imieniu użytkownika końcowego. Możesz wykonać poniższe kroki:

  1. Tworzenie aplikacji usługi Azure AD Ta aplikacja usługi Azure AD będzie używana do identyfikowania łącznika w aplikacji Teams-Spirit. Można to zrobić przy użyciu witryny [Azure Portal] (https://portal.azure.com), wykonując kroki opisane tutaj. Po utworzeniu zanotuj wartość identyfikatora aplikacji (klienta). Będzie to potrzebne później.

  2. Skonfiguruj (aktualizuj) aplikację usługi Azure AD, aby uzyskać dostęp do interfejsu API Teams-Spirit Ten krok zapewni, że aplikacja będzie mogła pomyślnie pobrać token dostępu w celu wywołania Teams-Spirit w imieniu użytkowników. Aby to zrobić, wykonaj kroki opisane tutaj.

    • W przypadku identyfikatora URI przekierowania użyj ciągu "https://global.consent.azure-apim.net/redirect"
    • W przypadku poświadczeń należy użyć klucza tajnego klienta (a nie certyfikatów). Pamiętaj, aby zanotować wpis tajny, będzie on potrzebny później i będzie wyświetlany tylko raz.
    • W przypadku uprawnień interfejsu API dodaj uprawnienie Teams-Spirit access_as_user . Aby to zrobić, kliknij Add a permissionpozycję , przejdź do APIs my organization usespozycji , wyszukaj Teams-Spirit i dodaj access_as_user uprawnienie.

W tym momencie mamy teraz prawidłową aplikację usługi Azure AD, która może służyć do uzyskiwania uprawnień od użytkowników końcowych i uzyskiwania dostępu do aplikacji Teams-Spirit.

Wdrażanie łącznika

Najpierw zastąp element {clientId} identyfikatorem apiProperties.json klienta aplikacji usługi Azure AD.

Element {resourceId} zostanie zastąpiony api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user w przypadku wdrożenia łącznika niestandardowego.

Następnie uruchom następujące polecenia i postępuj zgodnie z instrukcjami:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Approve

Zatwierdza daną zatwierdzenie
Odrzuć

Odrzuć
Pobieranie wartości tagu

Pobiera wartość tagów dla grupy
Pobieranie wszystkich zatwierdzeń

Pobieranie wszystkich zatwierdzeń
Przedłużanie daty wygaśnięcia

Rozszerza datę wygaśnięcia grup
Usuwanie użytkownika z zespołu

Usuwa użytkownika z zespołu
Usuń wszystkich gości

Usuwa wszystkich gości z zespołu
Usuń wszystkich niewłaścicieli z zespołu

Usuwa wszystkich członków exept dla właścicieli z zespołu
Usuń wszystkich użytkowników z wyjątkiem właściciela

Usuwa wszystkich użytkowników z wyjątkiem jednego wybranego właściciela
Usuń zespół

Usuwa zespół
Zespół archiwum

Archiwizowanie zespołu
Zmień rolę na Członek

Zmienia rolę użytkowników na członka zespołu
Zmień rolę na Właściciel

Promuje użytkownika w zespole do właściciela
Zmień wartość tagu

Zmienia wartość tagu w danym zespole

Approve

Identyfikator operacji:
Approve

Zatwierdza daną zatwierdzenie

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zatwierdzenia
 Approval-ID True string

Identyfikator zatwierdzenia

Odrzuć

Identyfikator operacji:
Reject

Odrzuć

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zatwierdzenia
 Approval-ID True string

Identyfikator zatwierdzenia

Pobieranie wartości tagu

Identyfikator operacji:
GetTagValue

Pobiera wartość tagów dla grupy

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Identyfikator tagu
 Tag-ID True string

Identyfikator tagu

Zwraca

Wartość tagu
string

Pobieranie wszystkich zatwierdzeń

Identyfikator operacji:
GetApprovals

Pobieranie wszystkich zatwierdzeń

Zwraca

Nazwa Ścieżka Typ Opis
array of object
id
 id string

id
userName
 userName string

userName
userId
 userId string

userId
createForExternalUser
 createForExternalUser boolean

createForExternalUser
externalUserId
 externalUserId string

externalUserId
reactingUserId
 reactingUserId string

reactingUserId
reactingUserName
 reactingUserName string

reactingUserName
requestTime
 requestTime string

requestTime
expirationDateTime (data wygaśnięcia)
 expirationDateTime string

expirationDateTime (data wygaśnięcia)
stan
 status integer

stan
groupName
 groupName string

groupName
groupDescription (Opis grupy)
 groupDescription string

groupDescription (Opis grupy)
powód
 reason string

powód
rejectReason
 rejectReason string

rejectReason
dostęp
 access boolean

dostęp
reactionTime
 reactionTime string

reactionTime
typ
 type string

typ
Tid
 tid string

Tid
Identyfikator szablonu
 templateId string

Identyfikator szablonu
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
typ
 attributeSettings.type integer

typ

Przedłużanie daty wygaśnięcia

Identyfikator operacji:
ExtendExpirationDate

Rozszerza datę wygaśnięcia grup

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Tygodnie
 weeks string

Tygodni

Usuwanie użytkownika z zespołu

Identyfikator operacji:
RemoveUser

Usuwa użytkownika z zespołu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Identyfikator użytkownika
 userId string

userId

Usuń wszystkich gości

Identyfikator operacji:
RemoveGuests

Usuwa wszystkich gości z zespołu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy

Usuń wszystkich niewłaścicieli z zespołu

Identyfikator operacji:
RemoveAllUsersExeptOwners

Usuwa wszystkich członków exept dla właścicieli z zespołu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy

Usuń wszystkich użytkowników z wyjątkiem właściciela

Identyfikator operacji:
RemoveAllUsersExceptOneOwner

Usuwa wszystkich użytkowników z wyjątkiem jednego wybranego właściciela

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Identyfikator właściciela
 ownerId string

Identyfikator właściciela

Usuń zespół

Identyfikator operacji:
DeleteTeam

Usuwa zespół

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy

Zespół archiwum

Identyfikator operacji:
ArchiveTeam

Archiwizowanie zespołu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Ustaw witrynę programu SharePoint jako tylko do odczytu dla członków zespołu
 sharePointReadOnly True boolean

sharePointReadOnly

Zmień rolę na Członek

Identyfikator operacji:
ChangeRoleToMember

Zmienia rolę użytkowników na członka zespołu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Identyfikator użytkownika
 userId string

userId

Zmień rolę na Właściciel

Identyfikator operacji:
ChangeRoleToOwner

Promuje użytkownika w zespole do właściciela

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Identyfikator użytkownika
 userId string

userId

Zmień wartość tagu

Identyfikator operacji:
ChangeTagValue

Zmienia wartość tagu w danym zespole

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
 Group-ID True string

Identyfikator grupy
Tag
 id string

id
Wartość
 value string

value

Wyzwalacze

Action-Trigger

Action-Trigger

Action-Trigger

Identyfikator operacji:
ActionTrigger

Action-Trigger

Parametry

Nazwa Klucz Wymagane Typ Opis
Name
 name True string

Name

Zwraca

response
object

Definicje

obiekt

Jest to typ 'obiekt'.

ciąg

Jest to podstawowy typ danych "string".