Teamflect(미리 보기)
Teamflect를 사용하여 워크플로 효율성을 향상시킵니다. 목표, 피드백 및 검토를 비롯한 Teamflect의 강력한 성능 관리 기능을 기존 에코시스템에 원활하게 통합합니다. 일상적인 작업을 자동화하고, 플랫폼 간에 데이터를 동기화하고, 동적 데이터 기반 워크플로를 만들어 조직 전체에서 생산성과 참여를 향상시킵니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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://teamflect.com/contact-us |
| 전자 메일 | support@teamflect.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Teamflect |
| 웹 사이트 | https://teamflect.com |
| 개인 정보 보호 정책 | https://teamflect.com/privacy |
| 카테고리 | 경영 관리 |
Teamflect Power Automate 커넥터
참고: Power Automate 및 Power Apps의 자동화된 워크플로에 Teamflect의 광범위한 API를 통합하기 위해 제공되는 사용자 지정 커넥터입니다.
Teamflect Power Automate Connector를 사용하면 자동화된 워크플로에서 직접 목표, 피드백, 인식 및 작업을 관리하고 상호 작용할 수 있습니다. 사용자는 이 커넥터를 활용하여 Microsoft Power Automate와 원활하게 통합하여 성능 관리 프로세스를 간소화할 수 있습니다.
필수 조건
이 커넥터를 사용하려면 다음이 필요합니다.
사용자 지정 커넥터에 대한 지원을 포함하는 Microsoft Power Apps 또는 Power Automate 계획입니다.
관련 데이터에 액세스하는 데 필요한 API 권한이 있는 Teamflect 계정입니다.
커넥터를 빌드하고 배포하는 Power Platform CLI 도구입니다.
커넥터 빌드
Teamflect API는 API 키를 통해 보호됩니다. 이 커넥터를 통해 API에 액세스하려면 Teamflect API 키를 가져와서 Power Automate 내에서 안전하게 구성해야 합니다.
커넥터를 빌드하고 구성하는 단계:
API 키 가져오기:
Teamflect 계정에 로그인하고 API 설정 페이지로 이동합니다.
API 키를 생성하고 안전하게 유지합니다. 커넥터를 구성하는 동안 이 키를 사용해야 합니다.
커넥터 파일 다운로드:
- Teamflect API에 대한 API 정의(OpenAPI/Swagger 파일)가 있는지 확인합니다. 이 파일은 커넥터에서 지원하는 작업 및 데이터 구조를 정의합니다.
커넥터 배포:
Power Platform CLI를 사용하여 커넥터를 배포합니다.
다음 명령을 실행하여 커넥터를 만듭니다.
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
커넥터 테스트:
- 배포되면 지원되는 작업을 사용하여 Power Automate 흐름을 만들어 커넥터를 테스트합니다.
지원되는 작업
Teamflect 커넥터는 다음 작업을 지원합니다.
피드백 관리
피드백 요청 보내기: 지정된 사용자에 대한 피드백 요청을 시작합니다.
외부 피드백 요청 보내기: 외부 전자 메일 주소로 피드백 요청을 보냅니다.
목표 관리
ID로 목표 가져오기: 특정 목표의 세부 정보를 검색합니다.
목표 가져오기: 검색 조건에 따라 여러 목표를 나열합니다.
새 목표 만들기: 사용자에 대한 새 목표를 만듭니다.
목표 진행률 업데이트: 목표의 진행률 또는 상태를 업데이트합니다.
목표에 대한 설명: 목표에 댓글을 추가합니다.
인정
인식 만들기: 하나 이상의 사용자에 대한 새 인식을 만듭니다.
ID로 인식 가져오기: 특정 인식의 세부 정보를 검색합니다.
인식 가져오기: 여러 인식을 나열합니다.
작업 관리
ID로 작업 가져오기: 고유 식별자를 사용하여 작업을 검색합니다.
작업 가져오기: 검색 조건에 따라 작업을 나열합니다.
배포 정보
API 키가 안전하게 저장되고 공개적으로 공유되지 않는지 확인합니다.
API 속도 제한에 도달하지 않도록 커넥터를 책임감 있게 사용합니다.
오류 코드 및 추가 매개 변수를 포함하여 API에 대한 자세한 내용은 Teamflect API 설명서를 참조하세요.
추가 정보
Teamflect 플랫폼에 대한 자세한 내용은 웹 사이트를 방문하세요. 문제가 발생하거나 도움이 필요한 경우 지원 팀에 support@teamflect.com문의하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| ID로 목표 가져오기 |
ID로 목표 가져오기 |
| ID로 인식 가져오기 |
ID로 인식 가져오기 |
| ID로 작업을 가져옵니다. |
ID로 작업을 가져옵니다. |
| 메일로 사용자를 가져옵니다. |
메일로 사용자를 가져옵니다. |
| 목표 진행률 업데이트 |
목표 진행률 업데이트 |
| 목표에 메모 추가 |
목표에 새 주석 추가 |
| 새 목표를 만듭니다. |
새 목표를 만듭니다. |
| 새 외부 피드백 요청을 보냅니다. |
새 외부 피드백 요청을 보냅니다. |
| 새 인식 만들기 |
새 인식 만들기 |
| 새 피드백 요청을 보냅니다. |
새 피드백 요청을 보냅니다. |
| 선택한 특성으로 사용자를 업데이트합니다. |
사용자의 특성을 업데이트합니다. |
| 적용된 필터에 따라 목표를 반환합니다. |
적용된 필터에 따라 목표를 반환합니다. |
| 적용된 필터에 따라 인식을 반환합니다. |
적용된 필터에 따라 인식을 반환합니다. |
| 적용된 필터에 따라 작업을 반환합니다. |
적용된 필터에 따라 작업을 반환합니다. |
ID로 목표 가져오기
ID로 인식 가져오기
ID로 인식 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인식 ID
|
recognitionId | True | string |
검색할 인식의 고유 식별자 |
반환
ID로 작업을 가져옵니다.
메일로 사용자를 가져옵니다.
메일로 사용자를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 Email
|
userMail | True | string |
검색할 사용자의 전자 메일 주소 |
반환
- 몸
- User
목표 진행률 업데이트
목표 진행률 업데이트
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목표 ID
|
goalId | True | string |
업데이트할 목표의 고유 식별자 |
|
새 진행률 값
|
newValue | True | string |
목표에 대한 새 진행률 값 |
|
메모 업데이트
|
comment | string |
진행률 업데이트에 대한 설명 |
|
|
새 상태
|
status | string |
목표에 대한 새 상태 |
|
|
Updater 유형
|
goalUpdater | True | string |
목표를 업데이트하는 사람(소유자 또는 시스템) |
|
시스템 이름
|
goalUpdaterSystemName | True | string |
목표를 업데이트하는 시스템의 이름 |
반환
- 몸
- Goal
목표에 메모 추가
목표에 새 주석 추가
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목표의 ID
|
goalId | True | string |
목표의 ID |
|
주석 작성자의 개체 ID 또는 사용자 계정 이름
|
commenterIdOrUPN | True | string |
주석 작성자의 개체 ID 또는 사용자 계정 이름 |
|
주석 자체
|
commentText | True | string |
주석 자체 |
반환
- 몸
- Goal
새 목표를 만듭니다.
새 목표를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
목표 제목
|
title | True | string |
새 목표의 제목 |
|
Description
|
description | True | string |
새 목표에 대한 자세한 설명 |
|
시작 날짜
|
startDate | True | string |
목표를 시작해야 하는 날짜 |
|
기한
|
dueDate | True | string |
목표를 완료해야 하는 날짜 |
|
목표 유형
|
goalType | True | string |
목표 유형 |
|
목표 소유자
|
goalOwnerUPNorId | True |
목표 소유자의 전자 메일 또는 ID |
|
|
목표 작성자
|
goalCreatorUPNorId | True | string |
목표 작성자의 전자 메일 또는 ID |
|
비공개임
|
isPrivate | True | boolean |
목표가 비공개여야 하는지 여부 |
|
진행률 형식
|
progressFormatType | True | string |
진행 상황을 추적하기 위한 형식 형식 |
|
통화 코드
|
currencyCode | True | string |
통화 목표에 대한 통화 코드 |
|
초기 값
|
initialValue | True | number |
초기 진행률 값 |
|
대상 값
|
targetValue | True | number |
대상 진행률 값 |
|
부모 목표 ID
|
parentGoalId | True | string |
하위 목표인 경우 부모 목표의 ID |
|
소유자에게 알림
|
sendNotificationToOwner | True | boolean |
목표 소유자에게 알릴지 여부 |
반환
- 몸
- Goal
새 외부 피드백 요청을 보냅니다.
새 외부 피드백 요청을 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
피드백 제목
|
feedbackAboutUPNorId | True | string |
피드백을 받는 사람의 전자 메일 또는 ID |
|
외부 전자 메일
|
externalEmail | True | string |
외부 피드백 공급자의 이메일 주소 |
|
공급자 이름
|
onBehalfName | True | string |
외부 피드백 공급자에 대해 표시할 이름 |
|
요청 참고 사항
|
feedbackNote | True | string |
피드백 요청에 포함할 참고 사항 |
|
템플릿 제목
|
templateTitle | True | string |
사용할 피드백 템플릿의 제목 |
|
기한
|
dueDateInDays | True | number |
피드백이 기한이 될 때까지의 일 수 |
|
비공개임
|
isPrivate | True | boolean |
피드백이 비공개여야 하는지 여부 |
|
익명인 경우
|
isAnonymous | True | boolean |
피드백이 익명이어야 하는지 여부 |
반환
- 몸
- Feedback
새 인식 만들기
새 인식 만들기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인식 보낸 사람
|
senderIdOrUPN | True | string |
인식을 보내는 사람의 전자 메일 또는 ID |
|
인식 받는 사람
|
recipientsIdsOrUPNS | True | array of string |
인식을 받은 사람의 전자 메일 또는 ID 목록 |
|
배지 제목
|
badgeTitle | True | string |
인식 배지의 제목 |
|
비공개임
|
isPrivate | True | boolean |
인식이 프라이빗인지 여부 |
|
인식 메시지
|
description | True | string |
인식에 포함된 메시지 |
반환
새 피드백 요청을 보냅니다.
새 피드백 요청을 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
피드백 제목
|
feedbackAboutUPNorId | True | string |
피드백을 받는 사람의 전자 메일 또는 ID |
|
피드백 공급자
|
feedbackRequestReceiverUPNorId | True | string |
피드백을 제공할 사용자의 전자 메일 또는 ID |
|
요청 참고 사항
|
feedbackNote | True | string |
피드백 요청에 포함할 참고 사항 |
|
템플릿 제목
|
templateTitle | True | string |
사용할 피드백 템플릿의 제목 |
|
기한
|
dueDateInDays | True | number |
피드백이 기한이 될 때까지의 일 수 |
|
비공개임
|
isPrivate | True | boolean |
피드백이 비공개여야 하는지 여부 |
반환
- 몸
- Feedback
선택한 특성으로 사용자를 업데이트합니다.
사용자의 특성을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 Email
|
userMail | string |
업데이트할 사용자의 전자 메일 주소입니다. |
|
|
특성 레이블
|
label | string |
업데이트할 특성의 이름입니다. |
|
|
특성 값
|
value | string |
업데이트할 특성의 값입니다. |
적용된 필터에 따라 목표를 반환합니다.
적용된 필터에 따라 목표를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID
|
userOID | string |
검색할 목표가 있는 사용자의 개체 ID |
|
|
사용자 Email
|
userUPN | string |
검색할 사용자의 사용자 계정 이름(이메일) |
|
|
텍스트 검색
|
search | string |
목표 제목 및 설명에서 검색할 텍스트 |
|
|
목표 레이블
|
selectedLabels | string |
목표를 필터링할 레이블 |
|
|
결과 제한
|
limit | string |
반환할 최대 목표 수 |
|
|
개수 건너뛰기
|
skip | string |
페이지 매김을 위해 건너뛸 목표 수 |
|
|
시작 날짜
|
startDate | string |
목표 필터링 시작 날짜 |
|
|
종료 날짜
|
endDate | string |
목표 필터링 종료 날짜 |
반환
- 아이템
- Goals
적용된 필터에 따라 인식을 반환합니다.
적용된 필터에 따라 인식을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색할 받는 사람
|
recipientsIdsOrUPNS | True | array of string |
검색할 받는 사람 전자 메일 또는 ID 목록 |
|
인식 제목
|
title | True | string |
검색할 인식 제목 |
|
업데이트 날짜
|
updated | True | string |
필터링할 마지막 업데이트 날짜 |
|
만든 날짜
|
created | True | string |
필터링할 생성 날짜 |
반환
적용된 필터에 따라 작업을 반환합니다.
적용된 필터에 따라 작업을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 개체 ID
|
userOID | string |
검색할 태스크가 있는 사용자의 개체 ID |
|
|
사용자 Email
|
userUPN | string |
작업을 검색할 사용자의 사용자 계정 이름(이메일) |
|
|
텍스트 검색
|
search | string |
작업 제목 및 설명에서 검색할 텍스트 |
|
|
결과 제한
|
limit | number |
반환할 최대 작업 수 |
|
|
개수 건너뛰기
|
skip | number |
페이지 매김을 위해 건너뛸 작업 수 |
|
|
시작 날짜
|
startDate | string |
작업 필터링 시작 날짜 |
|
|
종료 날짜
|
endDate | string |
작업 필터링 종료 날짜 |
반환
- 아이템
- Tasks
정의
Feedback
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
피드백 ID
|
id | string |
피드백의 고유 식별자 |
|
만든 날짜
|
createdAt | string |
피드백이 만들어진 날짜 및 시간 |
|
OID (오브젝트 식별자)
|
createdBy.oid | string | |
|
표시 이름
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
OID (오브젝트 식별자)
|
feedbackAboutUser.oid | string | |
|
표시 이름
|
feedbackAboutUser.displayName | string | |
|
userPrincipalName
|
feedbackAboutUser.userPrincipalName | string | |
|
OID (오브젝트 식별자)
|
feedbackRequestRecipient.oid | string | |
|
표시 이름
|
feedbackRequestRecipient.displayName | string | |
|
userPrincipalName
|
feedbackRequestRecipient.userPrincipalName | string | |
|
메모
|
note | string | |
|
isPrivate
|
isPrivate | boolean |
목표
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OID (오브젝트 식별자)
|
createdBy.oid | string | |
|
표시 이름
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
startDate
|
startDate | string | |
|
기한날짜
|
dueDate | string | |
|
소유자
|
owners | array of object | |
|
메일
|
owners.mail | string | |
|
표시 이름
|
owners.displayName | string | |
|
userPrincipalName
|
owners.userPrincipalName | string | |
|
부서
|
owners.department | string | |
|
직책
|
owners.jobTitle | string | |
|
OID (오브젝트 식별자)
|
owners.oid | string | |
|
title
|
title | string | |
|
goalType
|
goalType | string | |
|
isPrivate
|
isPrivate | boolean | |
|
생성일시
|
createdAt | string | |
|
relatedGroups
|
relatedGroups | array of object | |
|
items
|
relatedGroups | object | |
|
labels
|
labels | array of object | |
|
title
|
labels.title | string | |
|
description
|
labels.description | string | |
|
아이디
|
id | string | |
|
description
|
description | string | |
|
아이디
|
parentGoal.id | string | |
|
title
|
parentGoal.title | string | |
|
형식 유형
|
progress.formatType | string | |
|
initialValue
|
progress.initialValue | number | |
|
targetValue
|
progress.targetValue | number | |
|
currentValue (현재값)
|
progress.currentValue | number | |
|
status
|
status | string | |
|
결과
|
outcome | string |
목표
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
Goal |
RecognitionCreateResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
successfullyTransactions
|
successfullyTransactions | array of object | |
|
거래 ID
|
successfullyTransactions.transactionId | string | |
|
받는 사람
|
successfullyTransactions.recipients | array of object | |
|
메일
|
successfullyTransactions.recipients.mail | string | |
|
표시 이름
|
successfullyTransactions.recipients.displayName | string | |
|
userPrincipalName
|
successfullyTransactions.recipients.userPrincipalName | string | |
|
OID (오브젝트 식별자)
|
successfullyTransactions.recipients.oid | string | |
|
description
|
successfullyTransactions.badge.description | string | |
|
title
|
successfullyTransactions.badge.title | string | |
|
imageUrl
|
successfullyTransactions.badge.imageUrl | string | |
|
bgImage
|
successfullyTransactions.badge.bgImage | string | |
|
순위
|
successfullyTransactions.badge.rank | number | |
|
description
|
successfullyTransactions.description | string | |
|
comments
|
successfullyTransactions.comments | array of object | |
|
items
|
successfullyTransactions.comments | object | |
|
좋아하는
|
successfullyTransactions.likes | array of object | |
|
items
|
successfullyTransactions.likes | object | |
|
failedTransactions
|
failedTransactions | array of string |
RecognitionResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
받는 사람
|
recipients | array of object | |
|
메일
|
recipients.mail | string | |
|
표시 이름
|
recipients.displayName | string | |
|
userPrincipalName
|
recipients.userPrincipalName | string | |
|
description
|
badge.description | string | |
|
title
|
badge.title | string | |
|
imageUrl
|
badge.imageUrl | string | |
|
bgImage
|
badge.bgImage | string | |
|
OID (오브젝트 식별자)
|
badge.updatedBy.oid | string | |
|
표시 이름
|
badge.updatedBy.displayName | string | |
|
userPrincipalName
|
badge.updatedBy.userPrincipalName | string | |
|
메일
|
badge.updatedBy.mail | string | |
|
description
|
description | string | |
|
comments
|
comments | array of object | |
|
businessPhones
|
comments.user.businessPhones | array of string | |
|
표시 이름
|
comments.user.displayName | string | |
|
이름 (Given Name)
|
comments.user.givenName | string | |
|
직책
|
comments.user.jobTitle | string | |
|
메일
|
comments.user.mail | string | |
|
officeLocation
|
comments.user.officeLocation | string | |
|
선호 언어
|
comments.user.preferredLanguage | string | |
|
성씨
|
comments.user.surname | string | |
|
userPrincipalName
|
comments.user.userPrincipalName | string | |
|
아이디
|
comments.user.id | string | |
|
주석
|
comments.comment | string | |
|
좋아하는
|
likes | array of object | |
|
items
|
likes | object |
RecognitionResponses
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
RecognitionResponse |
과업
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
title
|
title | string | |
|
description
|
description | string | |
|
assignedTo
|
assignedTo | array of object | |
|
userPrincipalName
|
assignedTo.user.userPrincipalName | string | |
|
표시 이름
|
assignedTo.user.displayName | string | |
|
individualComments
|
assignedTo.individualComments | array of object | |
|
items
|
assignedTo.individualComments | object | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object | |
|
labels
|
labels | array of string | |
|
descriptionAttachments
|
descriptionAttachments | array of object | |
|
items
|
descriptionAttachments | object |
업무
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
Task |
사용자
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
userPrincipalName
|
userPrincipalName | string | |
|
생성일시
|
createdAt | string | |
|
lastLoginDate
|
lastLoginDate | string | |
|
부서
|
department | string | |
|
직원 채용 날짜
|
employeeHireDate | string | |
|
역할
|
role | string | |
|
country
|
country | string | |
|
hasManager
|
hasManager | boolean | |
|
isManager
|
isManager | boolean | |
|
직책
|
jobTitle | string | |
|
officeLocation
|
officeLocation | string | |
|
선호 언어
|
preferredLanguage | string | |
|
이름
|
name | string | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object |