Udostępnij przez

Teamflect (wersja zapoznawcza)

Zwiększ wydajność przepływu pracy dzięki zespołowi. Bezproblemowo integrowanie niezawodnych funkcji zarządzania wydajnością usługi Teamflect, w tym celów, opinii i przeglądów, do istniejącego ekosystemu. Automatyzowanie rutynowych zadań, synchronizowanie danych na różnych platformach i tworzenie dynamicznych przepływów pracy opartych na danych w celu zwiększenia produktywności i zaangażowania w całej organizacji.

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 Bora Unlu
adres URL https://teamflect.com/contact-us
Email support@teamflect.com
Metadane łącznika
Publisher Teamflect
Witryna internetowa https://teamflect.com
Zasady ochrony prywatności https://teamflect.com/privacy
Kategorie Zarządzanie biznesem

Teamflect Power Automate Connector

Uwaga: jest to łącznik niestandardowy udostępniany w celu zintegrowania rozbudowanych interfejsów API teamflect z zautomatyzowanymi przepływami pracy w usługach Power Automate i Power Apps.

Łącznik Teamflect Power Automate umożliwia zarządzanie celami, opiniami, funkcjami rozpoznawania i zadaniami bezpośrednio z zautomatyzowanych przepływów pracy i zarządzanie nimi. Dzięki wykorzystaniu tego łącznika użytkownicy mogą usprawnić procesy zarządzania wydajnością, bezproblemowo integrując je z usługą Microsoft Power Automate.

Wymagania wstępne

Aby użyć tego łącznika, potrzebne są następujące elementy:

  1. Plan usługi Microsoft Power Apps lub Power Automate obejmujący obsługę łączników niestandardowych.

  2. Konto teamflect z niezbędnymi uprawnieniami interfejsu API w celu uzyskania dostępu do odpowiednich danych.

  3. Narzędzia interfejsu wiersza polecenia platformy Power Platform do kompilowania i wdrażania łącznika.

Tworzenie łącznika

Interfejsy API teamflect są zabezpieczone za pomocą kluczy interfejsu API. Aby uzyskać dostęp do interfejsów API za pośrednictwem tego łącznika, musisz uzyskać klucz interfejsu API teamflect i skonfigurować go bezpiecznie w usłudze Power Automate.

Kroki tworzenia i konfigurowania łącznika:

  1. Uzyskaj klucz interfejsu API:

    • Zaloguj się do konta teamflect i przejdź do strony ustawień interfejsu API.

    • Wygeneruj klucz interfejsu API i zachowaj go bezpiecznie. Ten klucz należy użyć podczas konfigurowania łącznika.

  2. Pobierz pliki łącznika:

    • Upewnij się, że masz definicję interfejsu API (plik OpenAPI/Swagger) dla interfejsu API Teamflect. Ten plik definiuje operacje i strukturę danych obsługiwaną przez łącznik.

  3. Wdróż łącznik:

    • Użyj interfejsu wiersza polecenia platformy Power Platform, aby wdrożyć łącznik.

    • Uruchom następujące polecenie, aby utworzyć łącznik:

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

  4. Przetestuj łącznik:

    • Po wdrożeniu przetestuj łącznik, tworząc przepływ usługi Power Automate przy użyciu dowolnej z obsługiwanych operacji.

Obsługiwane operacje

Łącznik Teamflect obsługuje następujące operacje:

Zarządzanie opiniami

  • Wyślij żądanie opinii: zainicjuj żądanie opinii dla określonego użytkownika.

  • Wyślij żądanie opinii zewnętrznej: wyślij żądanie opinii na zewnętrzny adres e-mail.

Zarządzanie celami

  • Uzyskiwanie celu według identyfikatora: pobieranie szczegółów określonego celu.

  • Uzyskiwanie celów: wyświetlanie listy wielu celów na podstawie kryteriów wyszukiwania.

  • Utwórz nowy cel: utwórz nowy cel dla użytkownika.

  • Postęp aktualizowania celu: aktualizowanie postępu lub stanu celu.

  • Komentarz do celu: Dodaj komentarz do celu.

Wyróżnienia

  • Tworzenie rozpoznawania: utwórz nowe rozpoznawanie dla co najmniej jednego użytkownika.

  • Uzyskiwanie rozpoznawania według identyfikatora: pobieranie szczegółów określonego rozpoznawania.

  • Uzyskiwanie rozpoznawania: wyświetlanie listy wielu rozpoznawania.

Zarządzanie zadaniami

  • Pobierz zadanie według identyfikatora: pobierz zadanie według jego unikatowego identyfikatora.

  • Pobieranie zadań: Wyświetlanie listy zadań na podstawie kryteriów wyszukiwania.

Uwagi dotyczące wdrażania

  • Upewnij się, że klucz interfejsu API jest przechowywany bezpiecznie i nie jest udostępniany publicznie.

  • Użyj łącznika w sposób odpowiedzialny, aby uniknąć osiągnięcia limitów szybkości interfejsu API.

  • Zapoznaj się z dokumentacją interfejsu API Teamflect, aby uzyskać szczegółowe informacje o interfejsie API, w tym kody błędów i dodatkowe parametry.

Dodatkowe informacje

Aby uzyskać więcej informacji na temat platformy Teamflect, odwiedź naszą witrynę internetową. Jeśli napotkasz jakiekolwiek problemy lub potrzebujesz pomocy, skontaktuj się z naszym zespołem pomocy technicznej pod adresem support@teamflect.com.

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.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda

Limity ograniczania

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

Akcje

Aktualizowanie postępu celu

Aktualizowanie postępu celu
Aktualizuje użytkownika z wybranymi atrybutami

Aktualizuje atrybuty użytkownika
Dodaje komentarz do celu

Dodaje nowy komentarz do celu
Pobiera cel według identyfikatora

Pobiera cel według identyfikatora
Pobiera rozpoznawanie według identyfikatora

Pobiera rozpoznawanie według identyfikatora
Pobiera użytkownika pocztą

Pobiera użytkownika pocztą
Pobiera zadanie według identyfikatora

Pobiera zadanie według identyfikatora
Tworzy nowe rozpoznawanie

Tworzy nowe rozpoznawanie
Tworzy nowy cel

Tworzy nowy cel
Wysyła nowe żądanie opinii

Wysyła nowe żądanie opinii.
Wysyła nowe żądanie opinii zewnętrznej

Wysyła nowe żądanie opinii zewnętrznej
Zwraca cele na podstawie zastosowanych filtrów

Zwraca cele na podstawie zastosowanych filtrów
Zwraca rozpoznawanie na podstawie zastosowanych filtrów

Zwraca rozpoznawanie na podstawie zastosowanych filtrów
Zwraca zadania na podstawie zastosowanych filtrów

Zwraca zadania na podstawie zastosowanych filtrów

Aktualizowanie postępu celu

Identyfikator operacji:
Update_goal

Aktualizowanie postępu celu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator celu
 goalId True string

Unikatowy identyfikator celu do zaktualizowania
Nowa wartość postępu
 newValue True string

Nowa wartość postępu dla celu
Aktualizuj komentarz
 comment string

Komentarz dotyczący aktualizacji postępu
Nowy stan
 status string

Nowy stan celu
Typ aktualizatora
 goalUpdater True string

Kto aktualizuje cel (właściciel lub system)
Nazwa systemu
 goalUpdaterSystemName True string

Nazwa systemu aktualizującego cel

Zwraca

Body
Goal

Aktualizuje użytkownika z wybranymi atrybutami

Identyfikator operacji:
Update_user

Aktualizuje atrybuty użytkownika

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail użytkownika
 userMail string

Adres e-mail użytkownika do aktualizacji.
Etykieta atrybutu
 label string

Nazwa atrybutu do zaktualizowania.
Wartość atrybutu
 value string

Wartość atrybutu do zaktualizowania.

Dodaje komentarz do celu

Identyfikator operacji:
Add_comment_goal

Dodaje nowy komentarz do celu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator celu
 goalId True string

Identyfikator celu
Identyfikator obiektu lub główna nazwa użytkownika komentatora
 commenterIdOrUPN True string

Identyfikator obiektu lub główna nazwa użytkownika komentatora
Sam komentarz
 commentText True string

Sam komentarz

Zwraca

Body
Goal

Pobiera cel według identyfikatora

Identyfikator operacji:
Get_goal

Pobiera cel według identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator celu
 goalId True string

Unikatowy identyfikator celu do pobrania

Zwraca

Body
Goal

Pobiera rozpoznawanie według identyfikatora

Identyfikator operacji:
Get_recognition

Pobiera rozpoznawanie według identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator rozpoznawania
 recognitionId True string

Unikatowy identyfikator rozpoznawania do pobrania

Zwraca

Body
RecognitionResponse

Pobiera użytkownika pocztą

Identyfikator operacji:
Get_user

Pobiera użytkownika pocztą

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail użytkownika
 userMail True string

Adres e-mail użytkownika do pobrania

Zwraca

Body
User

Pobiera zadanie według identyfikatora

Identyfikator operacji:
Get_task

Pobiera zadanie według identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zadania
 taskId True string

Unikatowy identyfikator zadania do pobrania

Zwraca

Body
Task

Tworzy nowe rozpoznawanie

Identyfikator operacji:
Create_recognition

Tworzy nowe rozpoznawanie

Parametry

Nazwa Klucz Wymagane Typ Opis
Nadawca rozpoznawania
 senderIdOrUPN True string

Adres e-mail lub identyfikator osoby wysyłającej rozpoznawanie
Odbiorcy rozpoznawania
 recipientsIdsOrUPNS True array of string

Lista wiadomości e-mail lub identyfikatorów osób odbierających uznanie
Tytuł znaczka
 badgeTitle True string

Tytuł wskaźnika rozpoznawania
Jest prywatny
 isPrivate True boolean

Czy rozpoznawanie jest prywatne
Komunikat rozpoznawania
 description True string

Komunikat dołączony do rozpoznawania

Zwraca

Body
RecognitionCreateResponse

Tworzy nowy cel

Identyfikator operacji:
Create_goal

Tworzy nowy cel

Parametry

Nazwa Klucz Wymagane Typ Opis
Tytuł celu
 title True string

Tytuł nowego celu
Description
 description True string

Szczegółowy opis nowego celu
Data rozpoczęcia
 startDate True string

Data rozpoczęcia celu
Data upływu
 dueDate True string

Data zakończenia celu
Typ celu
 goalType True string

Typ celu
Właściciel celu
 goalOwnerUPNorId True

Adres e-mail lub identyfikator właściciela celu
Twórca celów
 goalCreatorUPNorId True string

Adres e-mail lub identyfikator twórcy celu
Jest prywatny
 isPrivate True boolean

Czy cel powinien być prywatny
Format postępu
 progressFormatType True string

Typ formatu na potrzeby śledzenia postępu
Kod waluty
 currencyCode True string

Kod waluty dla celów pieniężnych
Wartość początkowa
 initialValue True number

Początkowa wartość postępu
Wartość docelowa
 targetValue True number

Wartość postępu docelowego
Identyfikator celu nadrzędnego
 parentGoalId True string

Identyfikator celu nadrzędnego, jeśli jest to cel podrzędny
Powiadom właściciela
 sendNotificationToOwner True boolean

Czy powiadomić właściciela celu

Zwraca

Body
Goal

Wysyła nowe żądanie opinii

Identyfikator operacji:
Send_feedback_request

Wysyła nowe żądanie opinii.

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat opinii
 feedbackAboutUPNorId True string

Adres e-mail lub identyfikator osoby odbierającej opinię
Dostawca opinii
 feedbackRequestReceiverUPNorId True string

Adres e-mail lub identyfikator osoby, która przekaże opinię
Uwaga dotycząca żądania
 feedbackNote True string

Uwaga do uwzględnienia w żądaniu opinii
Tytuł szablonu
 templateTitle True string

Tytuł szablonu opinii do użycia
Dni ukończenia
 dueDateInDays True number

Liczba dni do ukończenia opinii
Jest prywatny
 isPrivate True boolean

Czy opinia powinna być prywatna

Zwraca

Body
Feedback

Wysyła nowe żądanie opinii zewnętrznej

Identyfikator operacji:
Send_external_feedback_Request

Wysyła nowe żądanie opinii zewnętrznej

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat opinii
 feedbackAboutUPNorId True string

Adres e-mail lub identyfikator osoby odbierającej opinię
Zewnętrzna poczta e-mail
 externalEmail True string

Adres e-mail zewnętrznego dostawcy opinii
Nazwa dostawcy
 onBehalfName True string

Nazwa wyświetlana dla zewnętrznego dostawcy opinii
Uwaga dotycząca żądania
 feedbackNote True string

Uwaga do uwzględnienia w żądaniu opinii
Tytuł szablonu
 templateTitle True string

Tytuł szablonu opinii do użycia
Dni ukończenia
 dueDateInDays True number

Liczba dni do ukończenia opinii
Jest prywatny
 isPrivate True boolean

Czy opinia powinna być prywatna
Jest anonimowy
 isAnonymous True boolean

Czy opinia powinna być anonimowa

Zwraca

Body
Feedback

Zwraca cele na podstawie zastosowanych filtrów

Identyfikator operacji:
Get_goals

Zwraca cele na podstawie zastosowanych filtrów

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu użytkownika
 userOID string

Identyfikator obiektu użytkownika, którego cele do pobrania
Adres e-mail użytkownika
 userUPN string

Główna nazwa użytkownika (adres e-mail) użytkownika, którego cele do pobrania
Tekst wyszukiwania
 search string

Tekst do wyszukania w tytułach i opisach celu
Etykiety celów
 selectedLabels string

Etykiety do filtrowania celów według
Limit wyników
 limit string

Maksymalna liczba celów do zwrócenia
Pomiń liczbę
 skip string

Liczba celów do pominięcia na potrzeby stronicowania
Data rozpoczęcia
 startDate string

Data rozpoczęcia filtrowania celów
Data zakończenia
 endDate string

Data zakończenia filtrowania celów

Zwraca

Przedmioty
Goals

Zwraca rozpoznawanie na podstawie zastosowanych filtrów

Identyfikator operacji:
Get_recognitions

Zwraca rozpoznawanie na podstawie zastosowanych filtrów

Parametry

Nazwa Klucz Wymagane Typ Opis
Adresaci do wyszukiwania
 recipientsIdsOrUPNS True array of string

Lista wiadomości e-mail adresatów lub identyfikatorów do wyszukania
Tytuł rozpoznawania
 title True string

Tytuł rozpoznawania do wyszukania
Data aktualizacji
 updated True string

Data ostatniej aktualizacji do filtrowania według
Data utworzenia
 created True string

Data utworzenia do filtrowania według

Zwraca

Przedmioty
RecognitionResponses

Zwraca zadania na podstawie zastosowanych filtrów

Identyfikator operacji:
Get_tasks

Zwraca zadania na podstawie zastosowanych filtrów

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu użytkownika
 userOID string

Identyfikator obiektu użytkownika, którego zadania do pobrania
Adres e-mail użytkownika
 userUPN string

Główna nazwa użytkownika (adres e-mail) użytkownika, którego zadania do pobrania
Tekst wyszukiwania
 search string

Tekst do wyszukania w tytułach i opisach zadań
Limit wyników
 limit number

Maksymalna liczba zadań do zwrócenia
Pomiń liczbę
 skip number

Liczba zadań do pominięcia na potrzeby stronicowania
Data rozpoczęcia
 startDate string

Data rozpoczęcia filtrowania zadań
Data zakończenia
 endDate string

Data zakończenia filtrowania zadań

Zwraca

Przedmioty
Tasks

Definicje

Informacje zwrotne

Nazwa Ścieżka Typ Opis
Identyfikator opinii
 id string

Unikatowy identyfikator opinii
Data utworzenia
 createdAt string

Data i godzina utworzenia opinii
oid
 createdBy.oid string
nazwa wyświetlana
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
oid
 feedbackAboutUser.oid string
nazwa wyświetlana
 feedbackAboutUser.displayName string
userPrincipalName
 feedbackAboutUser.userPrincipalName string
oid
 feedbackRequestRecipient.oid string
nazwa wyświetlana
 feedbackRequestRecipient.displayName string
userPrincipalName
 feedbackRequestRecipient.userPrincipalName string
nuta
 note string
isPrivate (Prywatny)
 isPrivate boolean

Goal

Nazwa Ścieżka Typ Opis
oid
 createdBy.oid string
nazwa wyświetlana
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
startDate
 startDate string
data ukończenia
 dueDate string
Właścicieli
 owners array of object
poczta
 owners.mail string
nazwa wyświetlana
 owners.displayName string
userPrincipalName
 owners.userPrincipalName string
departament
 owners.department string
tytuł stanowiska
 owners.jobTitle string
oid
 owners.oid string
title
 title string
goalType
 goalType string
isPrivate (Prywatny)
 isPrivate boolean
createdAt
 createdAt string
relatedGroups
 relatedGroups array of object
items
 relatedGroups object
labels
 labels array of object
title
 labels.title string
opis
 labels.description string
id
 id string
opis
 description string
id
 parentGoal.id string
title
 parentGoal.title string
formatType (typ formatu)
 progress.formatType string
initialValue
 progress.initialValue number
targetValue
 progress.targetValue number
currentValue (aktualna wartość)
 progress.currentValue number
stan
 status string
wynik
 outcome string

Cele

Nazwa Ścieżka Typ Opis
Przedmioty
 Goal

RecognitionCreateResponse

Nazwa Ścieżka Typ Opis
pomyślnie transakcje
 successfullyTransactions array of object
transactionId (identyfikator transakcji)
 successfullyTransactions.transactionId string
recipients
 successfullyTransactions.recipients array of object
poczta
 successfullyTransactions.recipients.mail string
nazwa wyświetlana
 successfullyTransactions.recipients.displayName string
userPrincipalName
 successfullyTransactions.recipients.userPrincipalName string
oid
 successfullyTransactions.recipients.oid string
opis
 successfullyTransactions.badge.description string
title
 successfullyTransactions.badge.title string
imageUrl
 successfullyTransactions.badge.imageUrl string
bgImage
 successfullyTransactions.badge.bgImage string
pozycjonować
 successfullyTransactions.badge.rank number
opis
 successfullyTransactions.description string
comments
 successfullyTransactions.comments array of object
items
 successfullyTransactions.comments object
Lubi
 successfullyTransactions.likes array of object
items
 successfullyTransactions.likes object
transakcje, które zakończyły się niepowodzeniem
 failedTransactions array of string

RecognitionResponse

Nazwa Ścieżka Typ Opis
recipients
 recipients array of object
poczta
 recipients.mail string
nazwa wyświetlana
 recipients.displayName string
userPrincipalName
 recipients.userPrincipalName string
opis
 badge.description string
title
 badge.title string
imageUrl
 badge.imageUrl string
bgImage
 badge.bgImage string
oid
 badge.updatedBy.oid string
nazwa wyświetlana
 badge.updatedBy.displayName string
userPrincipalName
 badge.updatedBy.userPrincipalName string
poczta
 badge.updatedBy.mail string
opis
 description string
comments
 comments array of object
telefony biznesowe
 comments.user.businessPhones array of string
nazwa wyświetlana
 comments.user.displayName string
givenName
 comments.user.givenName string
tytuł stanowiska
 comments.user.jobTitle string
poczta
 comments.user.mail string
officeLocation
 comments.user.officeLocation string
preferowanyJęzyk
 comments.user.preferredLanguage string
nazwisko
 comments.user.surname string
userPrincipalName
 comments.user.userPrincipalName string
id
 comments.user.id string
komentarz
 comments.comment string
Lubi
 likes array of object
items
 likes object

Responses rozpoznawania

Nazwa Ścieżka Typ Opis
Przedmioty
 RecognitionResponse

Zadanie

Nazwa Ścieżka Typ Opis
title
 title string
opis
 description string
assignedTo
 assignedTo array of object
userPrincipalName
 assignedTo.user.userPrincipalName string
nazwa wyświetlana
 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

Tasks

Nazwa Ścieżka Typ Opis
Przedmioty
 Task

User

Nazwa Ścieżka Typ Opis
userPrincipalName
 userPrincipalName string
createdAt
 createdAt string
lastLoginDate
 lastLoginDate string
departament
 department string
data zatrudnienia pracownika
 employeeHireDate string
rola
 role string
country
 country string
hasManager
 hasManager boolean
isManager
 isManager boolean
tytuł stanowiska
 jobTitle string
officeLocation
 officeLocation string
preferowanyJęzyk
 preferredLanguage string
nazwa
 name string
attachments
 attachments array of object
items
 attachments object