Teams-Spirit (Preview)

Konektor Teams-Spirit umožňuje připojit své Teams-Spirit Předplatné k tokům.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
Email info@digitalteamwork.de
Metadata konektoru
Vydavatel D.F.K. Digitalteamwork GmbH
Internetová stránka https://teams-spirit.de
Zásady ochrany osobních údajů https://teams-spirit.de/datenschutz/
Kategorie Komunikace; Produktivita

konektor Teams-Spirit

Teams-Spirit poskytuje rozsáhlé rozhraní REST API. Pomocí tohoto rozhraní API můžete spravovat schválení, týmy a uživatele prostřednictvím aplikace Teams-Spirit.

Vydavatel: D.F.K. Digital Teamwork GmbH

Požadavky

Abyste mohli pokračovat, budete potřebovat následující:

  • Plán Microsoft Power Apps nebo Power Automate s funkcí vlastního konektoru
  • Podniková aplikace Teams-Spirit Azure AD (obvykle se zobrazí, pokud používáte Teams-Spirit)
  • Předplatné Teams-Spirit
  • Nástroje rozhraní příkazového řádku Power Platform

Podporované operace

Konektor poskytuje následující triggery:

Action-Trigger

Dá se aktivovat prostřednictvím akce Teams-Spirit Konektor podporuje následující operace:

Získat všechna schválení

Zobrazí seznam všech schválení.

Schvaluje

Schválí schválení.

Odmítat

Odmítnutí schválení

Archivovat tým

Archivuje tým a volitelně označí sharepointový web skupiny jako jen pro čtení.

Odstranit tým

Odstraní tým.

Změna role na člena

Změní roli uživatele na člena.

Změna role na vlastníka

Změní roli uživatele na vlastníka.

Odebrat všechny hosty

Odebere všechny hosty z týmu.

Odebrat všechny uživatele kromě vlastníka

Odebere všechny členy týmu s výjimkou daného vlastníka.

Odebrat uživatele z týmu

Odebere uživatele z týmu.

Změnit hodnotu značky

Změní hodnotu značky Teams-Spirit.

Získání hodnoty značky

Vrátí hodnotu značky Teams-Spirit.

Prodloužit datum vypršení platnosti

Rozšíří datum vypršení platnosti týmů.

Získání přihlašovacích údajů

Konektor Teams-Spirit používá OAuth2 pro Azure Active Directory (AD). Jedná se o stejnou metodu ověřování, kterou používá samotná aplikace Teams-Spirit, a proto uživatel bude mít stejná oprávnění jak v konektoru, tak v aplikaci.

Začínáme

Pokud chcete, aby tok aktivoval pravidlo Teams-Spirit, můžete vytvořit nový tok pomocí triggeru akce. Jakmile ho pojmenujete, zaregistruje se v Teams-Spirit a bude k dispozici v rule-engine. Do toku můžete odeslat všechny parametry, které jsou k dispozici v Teams-Spirit Pravidle, a použít ho k další automatizaci pracovních postupů.

Pokyny k nasazení

Vzhledem k tomu, že rozhraní API Teams-Spirit je zabezpečené službou Azure Active Directory (AD) přes OAuth2, musíme nejprve nastavit několik věcí v Azure AD, aby naše konektory mohly bezpečně přistupovat k rozhraní API. Po dokončení můžete konektor vytvořit a otestovat.

Nastavení aplikace Azure AD pro vlastní konektor

Nejdřív musíme náš konektor zaregistrovat jako aplikaci v Azure AD. Tím umožníte konektoru identifikovat se v Azure AD, aby mohl požádat o oprávnění pro přístup k Teams-Spirit dat jménem koncového uživatele. Můžete postupovat podle následujících kroků:

  1. Vytvořte aplikaci Azure AD. Tato aplikace Azure AD se použije k identifikaci konektoru pro Teams-Spirit. Můžete to provést pomocí webu [Azure Portal] (https://portal.azure.com), a to pomocí zde uvedených kroků. Po vytvoření si poznamenejte hodnotu ID aplikace (klienta). Budete ho potřebovat později.

  2. Nakonfigurujte (aktualizovat) aplikaci Azure AD pro přístup k rozhraní Teams-Spirit API. Tento krok zajistí úspěšné načtení přístupového tokenu pro vyvolání Teams-Spirit jménem uživatelů. Postupujte podle těchto kroků.

    • Pro identifikátor URI přesměrování použijte "https://global.consent.azure-apim.net/redirect"
    • Pro přihlašovací údaje použijte tajný klíč klienta (a ne certifikáty). Nezapomeňte si poznamenat tajný kód, budete ho potřebovat později a zobrazí se pouze jednou.
    • Pro oprávnění rozhraní API přidejte oprávnění Teams-Spirit access_as_user . Chcete-li to provést, Add a permissionpřejděte na APIs my organization uses, vyhledejte Teams-Spirit a přidejte access_as_user oprávnění.

V tuto chvíli máme platnou aplikaci Azure AD, která se dá použít k získání oprávnění od koncových uživatelů a přístupu k Aplikaci Teams-Spirit.

Nasazení konektoru

Nejprve nahraďte {clientId}apiProperties.json ID klienta aplikací Azure AD.

V {resourceId} případě nasazení vlastního konektoru se api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user nahradí.

Pak spusťte následující příkazy a postupujte podle pokynů:

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

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Approve

Schválí dané schválení.
Archivovat tým

Archivuje tým.
Odebrat všechny hosty

Odebere všechny hosty z týmu.
Odebrat všechny uživatele kromě vlastníka

Odebere všechny uživatele s výjimkou jednoho vybraného vlastníka.
Odebrání uživatele z týmu

Odebere uživatele z týmu.
Odebrání všech vlastníků z týmu

Odebere všechny členy exept pro vlastníky z týmu.
Odmítat

Odmítat
Odstranit tým

Odstraní tým.
Prodloužit datum vypršení platnosti

Rozšíří datum vypršení platnosti skupin.
Změna role na vlastníka

Propaguje uživatele v týmu na vlastníka
Změna role na člena

Změní roli uživatelů na člena v týmu.
Změnit hodnotu značky

Změní hodnotu značky v daném týmu.
Získání hodnoty značky

Získá hodnotu Značky pro skupinu.
Získání všech schválení

Získání všech schválení

Approve

ID operace:
Approve

Schválí dané schválení.

Parametry

Name Klíč Vyžadováno Typ Description
ID schválení
 Approval-ID True string

ID schválení

Archivovat tým

ID operace:
ArchiveTeam

Archivuje tým.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
Nastavení sharepointového webu jen pro čtení pro členy týmu
 sharePointReadOnly True boolean

sharePointReadOnly

Odebrat všechny hosty

ID operace:
RemoveGuests

Odebere všechny hosty z týmu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny

Odebrat všechny uživatele kromě vlastníka

ID operace:
RemoveAllUsersExceptOneOwner

Odebere všechny uživatele s výjimkou jednoho vybraného vlastníka.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
ID vlastníka
 ownerId string

ID vlastníka

Odebrání uživatele z týmu

ID operace:
RemoveUser

Odebere uživatele z týmu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
ID uživatele
 userId string

userId

Odebrání všech vlastníků z týmu

ID operace:
RemoveAllUsersExeptOwners

Odebere všechny členy exept pro vlastníky z týmu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny

Odmítat

ID operace:
Reject

Odmítat

Parametry

Name Klíč Vyžadováno Typ Description
ID schválení
 Approval-ID True string

ID schválení

Odstranit tým

ID operace:
DeleteTeam

Odstraní tým.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny

Prodloužit datum vypršení platnosti

ID operace:
ExtendExpirationDate

Rozšíří datum vypršení platnosti skupin.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
Týdny
 weeks string

týdny

Změna role na vlastníka

ID operace:
ChangeRoleToOwner

Propaguje uživatele v týmu na vlastníka

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
ID uživatele
 userId string

userId

Změna role na člena

ID operace:
ChangeRoleToMember

Změní roli uživatelů na člena v týmu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
ID uživatele
 userId string

userId

Změnit hodnotu značky

ID operace:
ChangeTagValue

Změní hodnotu značky v daném týmu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
Štítek
 id string

identifikační číslo
Hodnota
 value string

value

Získání hodnoty značky

ID operace:
GetTagValue

Získá hodnotu Značky pro skupinu.

Parametry

Name Klíč Vyžadováno Typ Description
ID skupiny
 Group-ID True string

ID skupiny
ID značky
 Tag-ID True string

ID značky

Návraty

Hodnota značky
string

Získání všech schválení

ID operace:
GetApprovals

Získání všech schválení

Návraty

Name Cesta Typ Description
array of object
identifikační číslo
 id string

identifikační číslo
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
 expirationDateTime string

expirationDateTime
stav
 status integer

stav
groupName
 groupName string

groupName
groupDescription
 groupDescription string

groupDescription
důvod
 reason string

důvod
rejectReason
 rejectReason string

rejectReason
přístup
 access boolean

přístup
reactionTime
 reactionTime string

reactionTime
typ
 type string

typ
Čas
 tid string

Čas
ID šablony
 templateId string

ID šablony
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
typ
 attributeSettings.type integer

typ

Aktivační události

Action-Trigger

Action-Trigger

Action-Trigger

ID operace:
ActionTrigger

Action-Trigger

Parametry

Name Klíč Vyžadováno Typ Description
Název
 name True string

Název

Návraty

response
object

Definice

objekt

Toto je typ 'objekt'.

řetězec

Toto je základní datový typ String.