Teams-Spirit(미리 보기)

Teams-Spirit 커넥터를 사용하면 Teams-Spirit 구독을 흐름에 연결할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
논리 앱	스탠다드	다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD)
Power Apps	Premium	다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)
Power Automate	Premium	다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD)

연락처
이름	이마누엘 푹스
URL	https://teams-spirit.de/#kontakt
전자 메일	info@digitalteamwork.de

커넥터 메타데이터
게시자	D.F.K. Digitalteamwork GmbH
웹 사이트	https://teams-spirit.de
개인 정보 보호 정책	https://teams-spirit.de/datenschutz/
카테고리	통신; 생산력

Teams-Spirit 커넥터

Teams-Spirit 광범위한 REST API를 제공합니다. 이 API를 사용하여 Teams-Spirit을 통해 승인, 팀 및 사용자를 관리할 수 있습니다.

게시자: D.F.K. 디지털 팀워크 GmbH

필수 조건

계속하려면 다음이 필요합니다.

사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
Teams-Spirit Azure AD 엔터프라이즈 애플리케이션(일반적으로 Teams-Spirit사용하는 경우 해당 애플리케이션이 있음)
Teams-Spirit 구독
Power Platform CLI 도구

지원되는 작업

커넥터는 다음 트리거를 제공합니다.

Action-Trigger

Teams-Spirit 작업을 통해 트리거할 수 있습니다. 커넥터는 다음 작업을 지원합니다.

모든 승인 가져오기

모든 승인을 나열합니다.

승인

승인 승인

거절하다

승인 거부

보관 팀

팀을 보관하고 필요에 따라 그룹 SharePoint 사이트를 읽기 전용으로 표시합니다.

팀 삭제

팀을 삭제합니다.

역할을 멤버로 변경

사용자 역할을 멤버로 변경

소유자로 역할 변경

사용자 역할을 소유자로 변경

모든 게스트 제거

팀에서 모든 게스트를 제거합니다.

소유자를 제외한 모든 사용자 제거

지정된 소유자를 제외한 모든 팀 구성원을 제거합니다.

팀에서 사용자 제거

팀에서 사용자를 제거합니다.

태그 값 변경

Teams-Spirit 태그의 값을 변경합니다.

태그 값 가져오기

Teams-Spirit Tag의 값을 반환합니다.

만료 날짜 연장

팀 만료 날짜 연장

자격 증명 가져오기

Teams-Spirit 커넥터는 Azure AD(Active Directory)에 대해 OAuth2를 사용합니다. 이는 Teams-Spirit 애플리케이션 자체에서 사용하는 것과 동일한 인증 방법이므로 사용자는 커넥터와 앱 모두에서 동일한 권한을 갖습니다.

시작하기

Teams-Spirit 규칙에 의해 흐름을 트리거하려면 Action-Trigger를 사용하여 새 흐름을 만들 수 있습니다. 이름을 지정하면 Teams-Spirit 등록되며 규칙 엔진에서 사용할 수 있습니다. Teams-Spirit 규칙에서 사용할 수 있는 모든 매개 변수를 흐름으로 보내고 이를 사용하여 워크플로를 추가로 자동화할 수 있습니다.

배포 지침

Teams-Spirit API는 OAuth2를 통해 Azure AD(Active Directory)에 의해 보호되므로 먼저 커넥터가 API에 안전하게 액세스할 수 있도록 Azure AD에서 몇 가지를 설정해야 합니다. 이 작업이 완료되면 커넥터를 만들고 테스트할 수 있습니다.

사용자 지정 커넥터에 대한 Azure AD 애플리케이션 설정

먼저 커넥터를 Azure AD에서 애플리케이션으로 등록해야 합니다. 이렇게 하면 커넥터가 Azure AD에 대해 자신을 식별할 수 있으므로 최종 사용자를 대신하여 Teams-Spirit 데이터에 액세스할 수 있는 권한을 요청할 수 있습니다. 아래 단계를 수행할 수 있습니다.

Azure AD 애플리케이션 만들기 이 Azure AD 애플리케이션은 Teams-Spirit에 대한 커넥터를 식별하는 데 사용됩니다. 이 작업은 다음 단계를 수행하여 [Azure Portal](https://portal.azure.com)을 사용하여 수행할 수 있습니다. 만든 후에는 애플리케이션(클라이언트) ID의 값을 적어둡니다. 나중에 이 항목이 필요합니다.
Teams-Spirit API에 액세스하도록 Azure AD 애플리케이션을 구성(업데이트)합니다. 이 단계에서는 애플리케이션이 사용자를 대신하여 Teams-Spirit 호출하는 액세스 토큰을 성공적으로 검색할 수 있도록 합니다. 이렇게 하려면 다음 단계를 수행 합니다.
- 리디렉션 URI의 경우 "https://global.consent.azure-apim.net/redirect"를 사용합니다.
- 자격 증명의 경우 인증서가 아닌 클라이언트 암호를 사용합니다. 비밀을 적어 두면 나중에 이 항목이 필요하며 한 번만 표시됩니다.
- API 권한의 경우 Teams-Spirit access_as_user 권한을 추가합니다. 이렇게 하려면 클릭하여 Add a permission이동하여 APIs my organization usesTeams-Spirit 검색하고 권한을 추가합니다 access_as_user .

이제 최종 사용자로부터 권한을 얻고 Teams-Spirit에 액세스하는 데 사용할 수 있는 유효한 Azure AD 애플리케이션이 있습니다.

커넥터 배포

먼저 Azure AD 애플리케이션 클라이언트 ID로 바꿉 {clientId}apiProperties.json 니다.

사용자 지정 커넥터 배포의 경우 교체 {resourceId} 해야 api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user 합니다.

그런 다음, 다음 명령을 실행하고 프롬프트를 따릅니다.

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

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.


기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	60초

동작

Approve	지정된 승인을 승인합니다.
거절하다	거절하다
만료 날짜 연장	그룹 만료 날짜를 확장합니다.
모든 게스트 제거	팀에서 모든 게스트를 제거합니다.
모든 승인 가져오기	모든 승인 가져오기
보관 팀	팀을 보관합니다.
소유자로 역할 변경	팀의 사용자를 소유자로 승격
소유자를 제외한 모든 사용자 제거	선택한 소유자를 제외한 모든 사용자를 제거합니다.
역할을 멤버로 변경	사용자 역할을 팀의 구성원으로 변경
태그 값 가져오기	그룹에 대한 태그 값을 가져옵니다.
태그 값 변경	지정된 팀의 태그 값을 변경합니다.
팀 삭제	팀을 삭제합니다.
팀에서 모든 비소유자 제거	팀에서 소유자에 대한 모든 멤버를 제거합니다.
팀에서 사용자 제거	팀에서 사용자를 제거합니다.

Approve

작업 ID:: Approve

지정된 승인을 승인합니다.

매개 변수

Name	키	필수	형식	Description
승인 ID	Approval-ID	True	string	승인 ID

거절하다

작업 ID:: Reject

거절하다

매개 변수

Name	키	필수	형식	Description
승인 ID	Approval-ID	True	string	승인 ID

만료 날짜 연장

작업 ID:: ExtendExpirationDate

그룹 만료 날짜를 확장합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
Weeks	weeks		string	주

모든 게스트 제거

작업 ID:: RemoveGuests

팀에서 모든 게스트를 제거합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID

모든 승인 가져오기

작업 ID:: GetApprovals

모든 승인 가져오기

반환

Name	경로	형식	Description
		array of object
아이디	id	string	아이디
사용자 이름	userName	string	사용자 이름
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
status	status	integer	status
groupName	groupName	string	groupName
groupDescription	groupDescription	string	groupDescription
이유	reason	string	이유
rejectReason	rejectReason	string	rejectReason
접근	access	boolean	접근
reactionTime	reactionTime	string	reactionTime
type	type	string	type
타이드	tid	string	타이드
템플릿ID	templateId	string	템플릿ID
attributeSettings	attributeSettings	array of object	attributeSettings
attributeId	attributeSettings.attributeId	string	attributeId
value	attributeSettings.value	string	value
type	attributeSettings.type	integer	type

보관 팀

작업 ID:: ArchiveTeam

팀을 보관합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
팀 구성원에 대해 SharePoint 사이트를 읽기 전용으로 만들기	sharePointReadOnly	True	boolean	sharePointReadOnly

소유자로 역할 변경

작업 ID:: ChangeRoleToOwner

팀의 사용자를 소유자로 승격

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
사용자 ID	userId		string	userId

소유자를 제외한 모든 사용자 제거

작업 ID:: RemoveAllUsersExceptOneOwner

선택한 소유자를 제외한 모든 사용자를 제거합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
소유자 ID	ownerId		string	소유자 ID

역할을 멤버로 변경

작업 ID:: ChangeRoleToMember

사용자 역할을 팀의 구성원으로 변경

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
사용자 ID	userId		string	userId

태그 값 가져오기

작업 ID:: GetTagValue

그룹에 대한 태그 값을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
태그 ID	Tag-ID	True	string	태그 ID

반환

태그 값: string

태그 값 변경

작업 ID:: ChangeTagValue

지정된 팀의 태그 값을 변경합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
Tag	id		string	아이디
가치	value		string	value

팀 삭제

작업 ID:: DeleteTeam

팀을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID

팀에서 모든 비소유자 제거

작업 ID:: RemoveAllUsersExeptOwners

팀에서 소유자에 대한 모든 멤버를 제거합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID

팀에서 사용자 제거

작업 ID:: RemoveUser

팀에서 사용자를 제거합니다.

매개 변수

Name	키	필수	형식	Description
그룹의 ID	Group-ID	True	string	그룹의 ID
사용자 ID	userId		string	userId

트리거

Action-Trigger

작업 ID:: ActionTrigger

Action-Trigger

매개 변수

Name	키	필수	형식	Description
이름	name	True	string	이름

반환

response: object

정의

객체

'object' 형식입니다.

문자열

기본 데이터 형식 'string'입니다.

다음을 통해 공유

Teams-Spirit(미리 보기)

Teams-Spirit 커넥터

게시자: D.F.K. 디지털 팀워크 GmbH

필수 조건

지원되는 작업

Action-Trigger

모든 승인 가져오기

승인

거절하다

보관 팀

팀 삭제

역할을 멤버로 변경

소유자로 역할 변경

모든 게스트 제거

소유자를 제외한 모든 사용자 제거

팀에서 사용자 제거

태그 값 변경

태그 값 가져오기

만료 날짜 연장

자격 증명 가져오기

시작하기

배포 지침

사용자 지정 커넥터에 대한 Azure AD 애플리케이션 설정

커넥터 배포

연결을 만드는 중

기본값

제한 한도

동작

Approve

매개 변수

거절하다

매개 변수

만료 날짜 연장

매개 변수

모든 게스트 제거

매개 변수

모든 승인 가져오기

반환

보관 팀

매개 변수

소유자로 역할 변경

매개 변수

소유자를 제외한 모든 사용자 제거

매개 변수

역할을 멤버로 변경

매개 변수

태그 값 가져오기

매개 변수

반환

태그 값 변경

매개 변수

팀 삭제

매개 변수

팀에서 모든 비소유자 제거

매개 변수

팀에서 사용자 제거

매개 변수

트리거

Action-Trigger

매개 변수

반환

정의

객체

문자열