Aracılığıyla paylaş

Teams-Spirit (Önizleme)

Teams-Spirit Bağlayıcısı, Teams-Spirit Aboneliğinizi akışlarınıza bağlamanıza olanak tanır.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
E-posta info@digitalteamwork.de
Bağlayıcı Meta Verileri
Publisher D.F.K. Digitalteamwork GmbH
Web sitesi https://teams-spirit.de
Gizlilik ilkesi https://teams-spirit.de/datenschutz/
Kategoriler İletişim; Verimli -lik

Teams-Spirit Bağlayıcısı

Teams-Spirit kapsamlı bir REST API sağlar. Bu API'yi kullanarak Teams-Spirit aracılığıyla onaylarınızı, ekiplerinizi ve kullanıcılarınızı yönetebilirsiniz.

Yayımcı: D.F.K. Digital Teamwork GmbH

Önkoşullar

Devam etmek için aşağıdakilere ihtiyacınız olacaktır:

  • Özel bağlayıcı özelliğine sahip bir Microsoft Power Apps veya Power Automate planı
  • Teams-Spirit Bir Azure AD Kurumsal Uygulaması (Teams-Spiritkullanıyorsanız genellikle bu olacaktır)
  • Teams-Spirit Aboneliği
  • Power platform CLI araçları

Desteklenen İşlemler

Bağlayıcı aşağıdaki tetikleyicileri sağlar:

Action-Trigger

Teams-Spirit Eylemi aracılığıyla Tetiklenebilir Bağlayıcı aşağıdaki işlemleri destekler:

Tüm Onayları Al

Tüm onayları listeler

Onayladı

Onay onaylar

Reddet

Onayı reddetme

Arşiv Ekibi

Bir ekibi arşivler ve isteğe bağlı olarak gruplar SharePoint sitesini salt okunur olarak işaretler

Ekibi Sil

Ekibi siler

Rolü Üye Olarak Değiştir

Bir kullanıcı rolünü üye olarak değiştirir

Rolü Sahip Olarak Değiştir

Kullanıcı rolünü sahip olarak değiştirir

Tüm Konukları Kaldır

Ekipten tüm konukları kaldırır

Sahip Dışındaki Tüm Kullanıcıları Kaldır

Belirli bir sahip dışındaki tüm ekip üyelerini kaldırır

Kullanıcıyı Ekipten Kaldır

Bir kullanıcıyı ekipten kaldırır

Etiket Değerini Değiştir

Teams-Spirit Etiketinin değerini değiştirir

Etiket Değeri Al

Teams-Spirit Etiketinin değerini verir

Süre Sonu Tarihini Uzat

Ekiplerin son kullanma tarihini uzatır

Kimlik Bilgilerini Alma

Teams-Spirit Bağlayıcısı, Azure Active Directory'ye (AD) karşı OAuth2 kullanır. Bu, Teams-Spirit Uygulamasının kendisi tarafından kullanılan Kimlik Doğrulama Yöntemi ile aynıdır ve bu nedenle kullanıcı hem bağlayıcıda hem de uygulamada aynı izinlere sahip olur.

Başlangıç Yapmak

Bir Akışın bir Teams-Spirit Kuralı tarafından tetiklanmasını istiyorsanız Eylem Tetikleyicisi ile yeni bir Akış oluşturabilirsiniz. Bir ad verdiğinizde, Teams-Spirit kaydolacak ve Kural Altyapısı'nda kullanılabilir olacaktır. Teams-Spirit Kuralı'nda bulunan tüm parametreleri Flow'a gönderebilir ve iş akışlarınızı daha da otomatikleştirmek için kullanabilirsiniz.

Dağıtım Yönergeleri

Teams-Spirit API'sinin güvenliği Azure Active Directory (AD) tarafından OAuth2 aracılığıyla sağlandığından, bağlayıcılarımızın API'ye güvenli bir şekilde erişebilmesi için öncelikle Azure AD'de birkaç şey ayarlamamız gerekir. Bu tamamlandıktan sonra bağlayıcıyı oluşturabilir ve test edebilirsiniz.

Özel bağlayıcınız için Azure AD uygulaması ayarlama

İlk olarak bağlayıcımızı Azure AD'de uygulama olarak kaydetmemiz gerekir. Bu, bağlayıcının kendisini Azure AD'ye tanıtarak son kullanıcı adına Teams-Spirit verilere erişim izni istemesine olanak tanır. Aşağıdaki adımları izleyebilirsiniz:

  1. Azure AD uygulaması oluşturma Bu Azure AD uygulaması, Teams-Spirit bağlayıcısını tanımlamak için kullanılır. Bu, buradaki adımları izleyerek [Azure Portal] ()https://portal.azure.com kullanılarak yapılabilir. Oluşturulduktan sonra Uygulama (İstemci) Kimliği değerini not edin. Buna daha sonra ihtiyacınız olacak.

  2. Azure AD uygulamanızı Teams-Spirit API'sine erişecek şekilde yapılandırın (Güncelleştirin) Bu adım, uygulamanızın kullanıcılarınız adına Teams-Spirit çağırmak üzere bir erişim belirtecini başarıyla alabilmesini sağlar. Bunu yapmak için buradaki adımları izleyin.

    • Yeniden yönlendirme URI'sini kullanmak için "https://global.consent.azure-apim.net/redirect" kullanın
    • Kimlik bilgileri için bir istemci gizli dizisi (sertifika değil) kullanın. Gizli diziyi not edin, daha sonra buna ihtiyacınız olacaktır ve yalnızca bir kez gösterilir.
    • API izinleri için Teams-Spirit access_as_user iznini ekleyin. Bunu yapmak için öğesine tıklayın Add a permission, adresine APIs my organization usesgidin, Teams-Spirit arayın ve izni ekleyin access_as_user .

Bu noktada artık son kullanıcılardan izin almak ve Teams-Spirit'e erişmek için kullanılabilecek geçerli bir Azure AD uygulamamız var.

Bağlayıcıyı dağıtma

öğesini ilk olarak Azure AD uygulamaları İstemci Kimliğiniz ile değiştirin {clientId}apiProperties.json .

{resourceId} özel bağlayıcı dağıtımı durumunda ile api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user değiştirilmelidir.

Ardından aşağıdaki komutları çalıştırın ve istemleri izleyin:

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

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Approve

Verilen onayı onaylar
Arşiv Ekibi

Ekibi Arşivler
Ekibi Sil

Ekibi siler
Etiket Değeri Al

Bir grup için Etiketler değeri alır
Etiket Değerini Değiştir

Belirli bir Ekipteki Etiketin Değerini Değiştirir
Kullanıcıyı Ekipten Kaldır

Bir Kullanıcıyı Ekipten Kaldırır
Reddet

Reddet
Rolü Sahip olarak değiştirme

Ekipteki Bir Kullanıcıyı Sahip Olarak Yükselter
Rolü Üye olarak değiştirme

Ekipteki bir kullanıcı rolünü üye olarak değiştirir
Sahip dışındaki tüm Kullanıcıları kaldır

Seçili sahip dışındaki tüm Kullanıcıları kaldırır
Sahip Olmayan Tüm Sahipleri Ekipten Kaldır

Sahipler için örnek olarak gösterilen tüm Üyeleri Ekipten kaldırır
Süre Sonu Tarihini Uzat

Grupların Süre Sonu Tarihini Genişletir
Tüm Konukları Kaldır

Tüm Konukları Ekipten Kaldırır
Tüm Onayları Al

Tüm Onayları Al

Approve

İşlem Kimliği:
Approve

Verilen onayı onaylar

Parametreler

Name Anahtar Gerekli Tür Description
Onay kimliği
 Approval-ID True string

Onay kimliği

Arşiv Ekibi

İşlem Kimliği:
ArchiveTeam

Ekibi Arşivler

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Ekip üyeleri için SharePoint sitesini salt okunur hale getirme
 sharePointReadOnly True boolean

sharePointReadOnly

Ekibi Sil

İşlem Kimliği:
DeleteTeam

Ekibi siler

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği

Etiket Değeri Al

İşlem Kimliği:
GetTagValue

Bir grup için Etiketler değeri alır

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Etiket kimliği
 Tag-ID True string

Etiket kimliği

Döndürülenler

Etiket Değeri
string

Etiket Değerini Değiştir

İşlem Kimliği:
ChangeTagValue

Belirli bir Ekipteki Etiketin Değerini Değiştirir

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Etiket
 id string

kimlik
Değer
 value string

value

Kullanıcıyı Ekipten Kaldır

İşlem Kimliği:
RemoveUser

Bir Kullanıcıyı Ekipten Kaldırır

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Kullanıcı Kimliği
 userId string

userId

Reddet

İşlem Kimliği:
Reject

Reddet

Parametreler

Name Anahtar Gerekli Tür Description
Onay kimliği
 Approval-ID True string

Onay kimliği

Rolü Sahip olarak değiştirme

İşlem Kimliği:
ChangeRoleToOwner

Ekipteki Bir Kullanıcıyı Sahip Olarak Yükselter

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Kullanıcı Kimliği
 userId string

userId

Rolü Üye olarak değiştirme

İşlem Kimliği:
ChangeRoleToMember

Ekipteki bir kullanıcı rolünü üye olarak değiştirir

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Kullanıcı Kimliği
 userId string

userId

Sahip dışındaki tüm Kullanıcıları kaldır

İşlem Kimliği:
RemoveAllUsersExceptOneOwner

Seçili sahip dışındaki tüm Kullanıcıları kaldırır

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Sahip Kimliği
 ownerId string

ownerId (sahip kimliği)

Sahip Olmayan Tüm Sahipleri Ekipten Kaldır

İşlem Kimliği:
RemoveAllUsersExeptOwners

Sahipler için örnek olarak gösterilen tüm Üyeleri Ekipten kaldırır

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği

Süre Sonu Tarihini Uzat

İşlem Kimliği:
ExtendExpirationDate

Grupların Süre Sonu Tarihini Genişletir

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği
Hafta
 weeks string

Hafta

Tüm Konukları Kaldır

İşlem Kimliği:
RemoveGuests

Tüm Konukları Ekipten Kaldırır

Parametreler

Name Anahtar Gerekli Tür Description
Grup kimliği
 Group-ID True string

Grup kimliği

Tüm Onayları Al

İşlem Kimliği:
GetApprovals

Tüm Onayları Al

Döndürülenler

Name Yol Tür Description
array of object
kimlik
 id string

kimlik
kullanıcı adı
 userName string

kullanıcı adı
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
statü
 status integer

statü
groupName
 groupName string

groupName
groupDescription
 groupDescription string

groupDescription
sebep
 reason string

sebep
rejectReason
 rejectReason string

rejectReason
erişim
 access boolean

erişim
reactionTime
 reactionTime string

reactionTime
type
 type string

type
Tid
 tid string

Tid
şablonId
 templateId string

şablonId
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
type
 attributeSettings.type integer

type

Tetikleyiciler

Action-Trigger

Action-Trigger

Action-Trigger

İşlem Kimliği:
ActionTrigger

Action-Trigger

Parametreler

Name Anahtar Gerekli Tür Description
İsim
 name True string

İsim

Döndürülenler

response
object

Tanımlar

object

Bu , 'object' türüdür.

String

Bu, 'string' temel veri türüdür.