Sdílet prostřednictvím

Teamflect (Preview)

Zvyšte efektivitu pracovního postupu pomocí Teamflectu. Bezproblémová integrace robustních funkcí správy výkonu teamflectu, včetně cílů, zpětné vazby a kontrol, do stávajícího ekosystému. Automatizujte rutinní úlohy, synchronizujte data napříč platformami a vytvářejte dynamické pracovní postupy řízené daty, které zvyšují produktivitu a zapojení v celé organizaci.

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 Bora Unlu
URL https://teamflect.com/contact-us
Email support@teamflect.com
Metadata konektoru
Vydavatel Teamflect
Internetová stránka https://teamflect.com
Zásady ochrany osobních údajů https://teamflect.com/privacy
Kategorie Řízení podniku

Konektor Teamflect Power Automate

Poznámka: Jedná se o vlastní konektor, který umožňuje integrovat rozsáhlá rozhraní API teamflectu do automatizovaných pracovních postupů v Power Automate a Power Apps.

Konektor Teamflect Power Automate umožňuje spravovat cíle, zpětnou vazbu, rozpoznávání a úkoly přímo z automatizovaných pracovních postupů a pracovat s nimi. Díky využití tohoto konektoru můžou uživatelé zjednodušit procesy správy výkonu tím, že je bezproblémově integrují s Microsoft Power Automate.

Požadavky

Abyste mohli tento konektor použít, budete potřebovat následující:

  1. Plán Microsoft Power Apps nebo Power Automate , který zahrnuje podporu vlastních konektorů.

  2. Účet Teamflect s potřebnými oprávněními rozhraní API pro přístup k relevantním datům.

  3. Nástroje rozhraní příkazového řádku Power Platform pro sestavení a nasazení konektoru

Sestavení spojnice

Rozhraní API Teamflect jsou zabezpečená prostřednictvím klíčů rozhraní API. Pokud chcete získat přístup k rozhraním API prostřednictvím tohoto konektoru, budete muset získat klíč rozhraní API Teamflect a bezpečně ho nakonfigurovat v Rámci Power Automate.

Postup sestavení a konfigurace konektoru:

  1. Získání klíče rozhraní API:

    • Přihlaste se ke svému účtu Teamflect a přejděte na stránku nastavení rozhraní API.

    • Vygenerujte klíč rozhraní API a bezpečně ho zachovejte. Tento klíč budete muset použít při konfiguraci konektoru.

  2. Stažení souborů konektoru:

    • Ujistěte se, že máte definici rozhraní API (soubor OpenAPI/Swagger) pro teamflect API. Tento soubor definuje operace a datovou strukturu podporovanou konektorem.

  3. Nasazení konektoru:

    • K nasazení konektoru použijte rozhraní příkazového řádku Power Platform.

    • Spuštěním následujícího příkazu vytvořte konektor:

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

  4. Otestujte konektor:

    • Jakmile konektor nasadíte, otestujte ho vytvořením toku Power Automate pomocí některé z podporovaných operací.

Podporované operace

Konektor Teamflect podporuje následující operace:

Správa zpětné vazby

  • Odeslat žádost o zpětnou vazbu: Zahajte žádost o zpětnou vazbu pro zadaného uživatele.

  • Odeslat žádost o externí zpětnou vazbu: Odešlete žádost o zpětnou vazbu na externí e-mailovou adresu.

Správa cílů

  • Získání cíle podle ID: Načtěte podrobnosti o konkrétním cíli.

  • Získání cílů: Zobrazení více cílů na základě kritérií hledání

  • Vytvořit nový cíl: Vytvoření nového cíle pro uživatele

  • Průběh cíle aktualizace: Aktualizujte průběh nebo stav cíle.

  • Komentář k cíli: Přidejte komentář k cíli.

Uznání

  • Vytvoření rozpoznávání: Vytvořte nové rozpoznávání pro jednoho nebo více uživatelů.

  • Získání rozpoznávání podle ID: Načtěte podrobnosti o konkrétním rozpoznávání.

  • Získat rozpoznávání: Vypsat více rozpoznávání.

Správa úkolů

  • Získat úkol podle ID: Načtěte úkol podle jeho jedinečného identifikátoru.

  • Získání úkolů: Zobrazení seznamu úkolů na základě kritérií hledání

Poznámky k nasazení

  • Ujistěte se, že je klíč rozhraní API bezpečně uložený a nesdílí se veřejně.

  • Využijte konektor zodpovědně, abyste se vyhnuli dosažení limitů rychlosti rozhraní API.

  • Podrobné informace o rozhraní API, včetně kódů chyb a dalších parametrů, najdete v dokumentaci k rozhraní Teamflect API.

Další informace

Další podrobnosti o platformě Teamflect najdete na našich webových stránkách. Pokud narazíte na nějaké problémy nebo potřebujete pomoc, obraťte se na náš tým podpory na adrese support@teamflect.com.

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í.

Název Typ Description Povinné
Klíč rozhraní API securestring Klíč rozhraní API pro toto rozhraní API Pravdivé

Limity omezování

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

Akce

Aktualizace průběhu cíle

Aktualizace průběhu cíle
Aktualizuje uživatele s vybranými atributy.

Aktualizuje atributy uživatele.
Odešle novou žádost o externí zpětnou vazbu.

Odešle novou žádost o externí zpětnou vazbu.
Odešle novou žádost o zpětnou vazbu.

Odešle novou žádost o zpětnou vazbu.
Přidá komentář k cíli.

Přidá do cíle nový komentář.
Vrátí cíle na základě použitých filtrů.

Vrátí cíle na základě použitých filtrů.
Vrátí rozpoznávání na základě použitých filtrů.

Vrátí rozpoznávání na základě použitých filtrů.
Vrátí úkoly na základě použitých filtrů.

Vrátí úkoly na základě použitých filtrů.
Vytvoří nové rozpoznávání.

Vytvoří nové rozpoznávání.
Vytvoří nový cíl.

Vytvoří nový cíl.
Získá cíl podle ID

Získá cíl podle ID
Získá rozpoznávání podle ID.

Získá rozpoznávání podle ID.
Získá uživatele poštou.

Získá uživatele poštou.
Získá úkol podle ID.

Získá úkol podle ID.

Aktualizace průběhu cíle

ID operace:
Update_goal

Aktualizace průběhu cíle

Parametry

Name Klíč Vyžadováno Typ Description
ID cíle
 goalId True string

Jedinečný identifikátor cíle pro aktualizaci
Nová hodnota průběhu
 newValue True string

Nová hodnota průběhu pro cíl
Aktualizovat komentář
 comment string

Komentář k aktualizaci průběhu
Nový stav
 status string

Nový stav cíle
Typ aktualizátoru
 goalUpdater True string

Kdo aktualizuje cíl (vlastník nebo systém)
Název systému
 goalUpdaterSystemName True string

Název systému, který aktualizuje cíl

Návraty

Body
Goal

Aktualizuje uživatele s vybranými atributy.

ID operace:
Update_user

Aktualizuje atributy uživatele.

Parametry

Name Klíč Vyžadováno Typ Description
E-mail uživatele
 userMail string

E-mailová adresa uživatele, kterou chcete aktualizovat.
Popisek atributu
 label string

Název atributu, který se má aktualizovat.
Hodnota atributu
 value string

Hodnota atributu, který se má aktualizovat.

Odešle novou žádost o externí zpětnou vazbu.

ID operace:
Send_external_feedback_Request

Odešle novou žádost o externí zpětnou vazbu.

Parametry

Name Klíč Vyžadováno Typ Description
Předmět zpětné vazby
 feedbackAboutUPNorId True string

E-mail nebo ID osoby, která dostává zpětnou vazbu
Externí e-mail
 externalEmail True string

E-mailová adresa externího poskytovatele zpětné vazby
Název poskytovatele
 onBehalfName True string

Název, který se má zobrazit pro externího poskytovatele zpětné vazby
Žádost o poznámku
 feedbackNote True string

Poznámka, která se má zahrnout do žádosti o zpětnou vazbu
Název šablony
 templateTitle True string

Název šablony zpětné vazby, která se má použít
Termín splnění
 dueDateInDays True number

Počet dnů do splnění zpětné vazby
Je soukromé
 isPrivate True boolean

Jestli má být zpětná vazba soukromá
Je anonymní
 isAnonymous True boolean

Jestli má být zpětná vazba anonymní

Návraty

Body
Feedback

Odešle novou žádost o zpětnou vazbu.

ID operace:
Send_feedback_request

Odešle novou žádost o zpětnou vazbu.

Parametry

Name Klíč Vyžadováno Typ Description
Předmět zpětné vazby
 feedbackAboutUPNorId True string

E-mail nebo ID osoby, která dostává zpětnou vazbu
Poskytovatel zpětné vazby
 feedbackRequestReceiverUPNorId True string

E-mail nebo ID osoby, která bude poskytovat zpětnou vazbu
Žádost o poznámku
 feedbackNote True string

Poznámka, která se má zahrnout do žádosti o zpětnou vazbu
Název šablony
 templateTitle True string

Název šablony zpětné vazby, která se má použít
Termín splnění
 dueDateInDays True number

Počet dnů do splnění zpětné vazby
Je soukromé
 isPrivate True boolean

Jestli má být zpětná vazba soukromá

Návraty

Body
Feedback

Přidá komentář k cíli.

ID operace:
Add_comment_goal

Přidá do cíle nový komentář.

Parametry

Name Klíč Vyžadováno Typ Description
ID cíle
 goalId True string

ID cíle
ID objektu nebo hlavní název uživatele komentátoru
 commenterIdOrUPN True string

ID objektu nebo hlavní název uživatele komentátoru
Samotný komentář
 commentText True string

Samotný komentář

Návraty

Body
Goal

Vrátí cíle na základě použitých filtrů.

ID operace:
Get_goals

Vrátí cíle na základě použitých filtrů.

Parametry

Name Klíč Vyžadováno Typ Description
ID objektu uživatele
 userOID string

ID objektu uživatele, jehož cíle se mají načíst
E-mail uživatele
 userUPN string

Hlavní název uživatele (e-mail) uživatele, jehož cíle se mají načíst
Hledat text
 search string

Text, který se má hledat v názvech a popisech cílů
Popisky cílů
 selectedLabels string

Popisky pro filtrování cílů podle
Limit výsledků
 limit string

Maximální počet vrácených cílů
Přeskočit počet
 skip string

Počet cílů, které se mají přeskočit pro stránkování
Datum zahájení
 startDate string

Počáteční datum pro filtrování cílů
Datum ukončení
 endDate string

Koncové datum pro filtrování cílů

Návraty

Položky
Goals

Vrátí rozpoznávání na základě použitých filtrů.

ID operace:
Get_recognitions

Vrátí rozpoznávání na základě použitých filtrů.

Parametry

Name Klíč Vyžadováno Typ Description
Příjemci, kteří mají hledat
 recipientsIdsOrUPNS True array of string

Seznamech
Název rozpoznávání
 title True string

Název rozpoznávání, který se má vyhledat
Datum aktualizace
 updated True string

Datum poslední aktualizace pro filtrování podle
Datum vytvoření
 created True string

Datum vytvoření pro filtrování podle

Návraty

Položky
RecognitionResponses

Vrátí úkoly na základě použitých filtrů.

ID operace:
Get_tasks

Vrátí úkoly na základě použitých filtrů.

Parametry

Name Klíč Vyžadováno Typ Description
ID objektu uživatele
 userOID string

ID objektu uživatele, jehož úkoly se mají načíst
E-mail uživatele
 userUPN string

Hlavní název uživatele (e-mail) uživatele, jehož úkoly se mají načíst
Hledat text
 search string

Text, který se má hledat v názvech a popisech úkolů
Limit výsledků
 limit number

Maximální počet úkolů, které se mají vrátit
Přeskočit počet
 skip number

Počet úkolů, které se mají přeskočit pro stránkování
Datum zahájení
 startDate string

Počáteční datum pro filtrování úkolů
Datum ukončení
 endDate string

Koncové datum pro filtrování úkolů

Návraty

Položky
Tasks

Vytvoří nové rozpoznávání.

ID operace:
Create_recognition

Vytvoří nové rozpoznávání.

Parametry

Name Klíč Vyžadováno Typ Description
Odesílatel rozpoznávání
 senderIdOrUPN True string

E-mail nebo ID osoby odesílajícího rozpoznávání
Rozpoznávání příjemců
 recipientsIdsOrUPNS True array of string

Seznam e-mailů nebo ID osob, které přijímají rozpoznávání
Název odznaku
 badgeTitle True string

Název odznáček rozpoznávání
Je soukromé
 isPrivate True boolean

Zda je rozpoznávání soukromé
Zpráva o rozpoznávání
 description True string

Zpráva zahrnutá do rozpoznávání

Návraty

Body
RecognitionCreateResponse

Vytvoří nový cíl.

ID operace:
Create_goal

Vytvoří nový cíl.

Parametry

Name Klíč Vyžadováno Typ Description
Název cíle
 title True string

Název nového cíle
Description
 description True string

Podrobný popis nového cíle
Datum zahájení
 startDate True string

Datum zahájení cíle
Termín splnění
 dueDate True string

Datum dokončení cíle
Typ cíle
 goalType True string

Typ cíle
Vlastník cíle
 goalOwnerUPNorId True

E-mail nebo ID vlastníka cíle
Tvůrce cílů
 goalCreatorUPNorId True string

E-mail nebo ID autora cíle
Je soukromé
 isPrivate True boolean

Jestli má být cíl soukromý
Formát průběhu
 progressFormatType True string

Typ formátu pro sledování průběhu
Kód měny
 currencyCode True string

Kód měny pro peněžní cíle
Počáteční hodnota
 initialValue True number

Počáteční hodnota průběhu
Cílová hodnota
 targetValue True number

Cílová hodnota průběhu
ID nadřazeného cíle
 parentGoalId True string

ID nadřazeného cíle, pokud se jedná o dílčí cíl
Upozornit vlastníka
 sendNotificationToOwner True boolean

Jestli chcete informovat vlastníka cíle

Návraty

Body
Goal

Získá cíl podle ID

ID operace:
Get_goal

Získá cíl podle ID

Parametry

Name Klíč Vyžadováno Typ Description
ID cíle
 goalId True string

Jedinečný identifikátor cíle k načtení

Návraty

Body
Goal

Získá rozpoznávání podle ID.

ID operace:
Get_recognition

Získá rozpoznávání podle ID.

Parametry

Name Klíč Vyžadováno Typ Description
ID rozpoznávání
 recognitionId True string

Jedinečný identifikátor rozpoznávání, který se má načíst

Návraty

Body
RecognitionResponse

Získá uživatele poštou.

ID operace:
Get_user

Získá uživatele poštou.

Parametry

Name Klíč Vyžadováno Typ Description
E-mail uživatele
 userMail True string

E-mailová adresa uživatele k načtení

Návraty

Body
User

Získá úkol podle ID.

ID operace:
Get_task

Získá úkol podle ID.

Parametry

Name Klíč Vyžadováno Typ Description
ID úkolu
 taskId True string

Jedinečný identifikátor úlohy, která se má načíst

Návraty

Body
Task

Definice

Feedback

Name Cesta Typ Description
ID zpětné vazby
 id string

Jedinečný identifikátor zpětné vazby
Datum vytvoření
 createdAt string

Datum a čas vytvoření zpětné vazby
oid
 createdBy.oid string
zobrazované jméno
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
oid
 feedbackAboutUser.oid string
zobrazované jméno
 feedbackAboutUser.displayName string
userPrincipalName
 feedbackAboutUser.userPrincipalName string
oid
 feedbackRequestRecipient.oid string
zobrazované jméno
 feedbackRequestRecipient.displayName string
userPrincipalName
 feedbackRequestRecipient.userPrincipalName string
poznámka
 note string
isPrivate
 isPrivate boolean

Goal

Name Cesta Typ Description
oid
 createdBy.oid string
zobrazované jméno
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
startDate
 startDate string
splatné datum
 dueDate string
majitelé
 owners array of object
pošta
 owners.mail string
zobrazované jméno
 owners.displayName string
userPrincipalName
 owners.userPrincipalName string
oddělení
 owners.department string
název pracovní pozice
 owners.jobTitle string
oid
 owners.oid string
title
 title string
goalType
 goalType string
isPrivate
 isPrivate boolean
createdAt
 createdAt string
relatedGroups
 relatedGroups array of object
items
 relatedGroups object
labels
 labels array of object
title
 labels.title string
popis
 labels.description string
identifikační číslo
 id string
popis
 description string
identifikační číslo
 parentGoal.id string
title
 parentGoal.title string
Typ formátu
 progress.formatType string
initialValue
 progress.initialValue number
targetValue
 progress.targetValue number
currentValue
 progress.currentValue number
stav
 status string
výsledek
 outcome string

Cíle

Name Cesta Typ Description
Položky
 Goal

RecognitionCreateResponse

Name Cesta Typ Description
successfullyTransactions
 successfullyTransactions array of object
transactionId
 successfullyTransactions.transactionId string
recipients
 successfullyTransactions.recipients array of object
pošta
 successfullyTransactions.recipients.mail string
zobrazované jméno
 successfullyTransactions.recipients.displayName string
userPrincipalName
 successfullyTransactions.recipients.userPrincipalName string
oid
 successfullyTransactions.recipients.oid string
popis
 successfullyTransactions.badge.description string
title
 successfullyTransactions.badge.title string
imageUrl
 successfullyTransactions.badge.imageUrl string
bgImage
 successfullyTransactions.badge.bgImage string
zařadit
 successfullyTransactions.badge.rank number
popis
 successfullyTransactions.description string
comments
 successfullyTransactions.comments array of object
items
 successfullyTransactions.comments object
má rád
 successfullyTransactions.likes array of object
items
 successfullyTransactions.likes object
failedTransactions
 failedTransactions array of string

RecognitionResponse

Name Cesta Typ Description
recipients
 recipients array of object
pošta
 recipients.mail string
zobrazované jméno
 recipients.displayName string
userPrincipalName
 recipients.userPrincipalName string
popis
 badge.description string
title
 badge.title string
imageUrl
 badge.imageUrl string
bgImage
 badge.bgImage string
oid
 badge.updatedBy.oid string
zobrazované jméno
 badge.updatedBy.displayName string
userPrincipalName
 badge.updatedBy.userPrincipalName string
pošta
 badge.updatedBy.mail string
popis
 description string
comments
 comments array of object
businessPhones
 comments.user.businessPhones array of string
zobrazované jméno
 comments.user.displayName string
Jméno
 comments.user.givenName string
název pracovní pozice
 comments.user.jobTitle string
pošta
 comments.user.mail string
officeLocation
 comments.user.officeLocation string
preferovaný jazyk
 comments.user.preferredLanguage string
příjmení
 comments.user.surname string
userPrincipalName
 comments.user.userPrincipalName string
identifikační číslo
 comments.user.id string
komentář
 comments.comment string
má rád
 likes array of object
items
 likes object

RecognitionResponses

Name Cesta Typ Description
Položky
 RecognitionResponse

Task

Name Cesta Typ Description
title
 title string
popis
 description string
přiřazeno
 assignedTo array of object
userPrincipalName
 assignedTo.user.userPrincipalName string
zobrazované jméno
 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

Name Cesta Typ Description
Položky
 Task

Uživatel

Name Cesta Typ Description
userPrincipalName
 userPrincipalName string
createdAt
 createdAt string
lastLoginDate
 lastLoginDate string
oddělení
 department string
datumNastupuZamestnance
 employeeHireDate string
role
 role string
země
 country string
hasManager
 hasManager boolean
isManager
 isManager boolean
název pracovní pozice
 jobTitle string
officeLocation
 officeLocation string
preferovaný jazyk
 preferredLanguage string
název
 name string
attachments
 attachments array of object
items
 attachments object