Freigeben über


Teamflect (Vorschau)

Verbessern Sie Ihre Workfloweffizienz mit dem Teamflect. Integrieren Sie die robusten Leistungsverwaltungsfeatures von Teamflect nahtlos in Ihr vorhandenes Ökosystem, einschließlich Zielen, Feedback und Rezensionen. Automatisieren Sie Routineaufgaben, synchronisieren Sie Daten plattformübergreifend, und erstellen Sie dynamische, datengesteuerte Workflows, um die Produktivität und das Engagement in Ihrer Organisation zu steigern.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Bora Unlu
URL https://teamflect.com/contact-us
Email support@teamflect.com
Connectormetadaten
Herausgeber Teamflect
Webseite https://teamflect.com
Datenschutzrichtlinie https://teamflect.com/privacy
Kategorien Unternehmensverwaltung

Teamflect Power Automate Connector

Hinweis: Dies ist ein benutzerdefinierter Connector, der die umfangreichen APIs von Teamflect in Ihre automatisierten Workflows in Power Automate und Power Apps integriert.

Mit dem Teamflect Power Automate Connector können Sie Ziele, Feedback, Erkennungen und Aufgaben direkt aus Ihren automatisierten Workflows verwalten und damit interagieren. Durch die Nutzung dieses Connectors können Benutzer ihre Leistungsverwaltungsprozesse optimieren, indem sie sie nahtlos in Microsoft Power Automate integrieren.


Voraussetzungen

Um diesen Connector zu verwenden, benötigen Sie Folgendes:

  1. Ein Microsoft Power Apps- oder Power Automate-Plan , der Unterstützung für benutzerdefinierte Connectors enthält.

  2. Ein Teamflect-Konto mit den erforderlichen API-Berechtigungen für den Zugriff auf die relevanten Daten.

  3. Power Platform CLI Tools zum Erstellen und Bereitstellen des Connectors.


Erstellen des Verbinders

Teamflect-APIs werden über API-Schlüssel gesichert. Um über diesen Connector auf die APIs zuzugreifen, müssen Sie Ihren Teamflect-API-Schlüssel abrufen und ihn sicher in Power Automate konfigurieren.

Schritte zum Erstellen und Konfigurieren des Connectors:

  1. Abrufen eines API-Schlüssels:

    • Melden Sie sich bei Ihrem Teamflect-Konto an, und navigieren Sie zur Seite mit den API-Einstellungen.

    • Generieren Sie einen API-Schlüssel, und bewahren Sie ihn sicher auf. Sie müssen diesen Schlüssel beim Konfigurieren des Connectors verwenden.

  2. Connectordateien herunterladen:

    • Stellen Sie sicher, dass Sie über die API-Definition (OpenAPI/Swagger-Datei) für die Teamflect-API verfügen. Diese Datei definiert die Vorgänge und die Datenstruktur, die vom Connector unterstützt werden.
  3. Bereitstellen des Connectors:

    • Verwenden Sie die Power Platform CLI, um den Connector bereitzustellen.

    • Führen Sie den folgenden Befehl aus, um den Connector zu erstellen:

      paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
      
  4. Testen Sie den Connector:

    • Testen Sie den Connector nach der Bereitstellung, indem Sie einen Power Automate-Fluss mithilfe eines der unterstützten Vorgänge erstellen.

Unterstützte Vorgänge

Der Teamflect Connector unterstützt die folgenden Vorgänge:

Feedbackverwaltung

  • Feedbackanfrage senden: Initiieren einer Feedbackanforderung für einen bestimmten Benutzer.

  • Senden einer externen Feedbackanfrage: Senden sie eine Feedbackanfrage an eine externe E-Mail-Adresse.

Zielmanagement

  • Ziel nach ID abrufen: Abrufen von Details zu einem bestimmten Ziel.

  • Ziele abrufen: Auflisten mehrerer Ziele basierend auf Suchkriterien.

  • Neues Ziel erstellen: Ein neues Ziel für einen Benutzer erstellen.

  • Status des Ziels aktualisieren: Aktualisieren des Fortschritts oder Status eines Ziels.

  • Kommentar zu Ziel: Hinzufügen eines Kommentars zu einem Ziel.

Anerkennungen

  • Erkennung erstellen: Erstellen Sie eine neue Erkennung für einen oder mehrere Benutzer.

  • Abrufen der Erkennung nach ID: Abrufen von Details einer bestimmten Erkennung.

  • Abrufen von Erkennungen: Auflisten mehrerer Erkennungen.

Aufgabenverwaltung

  • Aufgabe nach ID abrufen: Abrufen einer Aufgabe anhand des eindeutigen Bezeichners.

  • Aufgaben abrufen: Aufgaben basierend auf Suchkriterien auflisten.


Bereitstellungsnotizen

  • Stellen Sie sicher, dass Ihr API-Schlüssel sicher gespeichert ist und nicht öffentlich freigegeben wird.

  • Verwenden Sie den Connector verantwortungsbewusst, um zu vermeiden, dass API-Geschwindigkeitsgrenzwerte erreicht werden.

  • Ausführliche Informationen zur API, einschließlich Fehlercodes und zusätzlicher Parameter, finden Sie in der Teamflect-API-Dokumentation.


Zusatzinformation

Weitere Informationen zur Teamflect-Plattform finden Sie auf unserer Website. Wenn Probleme auftreten oder Hilfe benötigen, wenden Sie sich bitte an unser Supportteam unter support@teamflect.com.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Aktualisieren des Fortschritts eines Ziels

Aktualisieren des Fortschritts eines Ziels

Aktualisiert einen Benutzer mit ausgewählten Attributen.

Aktualisiert die Attribute eines Benutzers.

Erstellt ein neues Ziel

Erstellt ein neues Ziel

Erstellt eine neue Erkennung

Erstellt eine neue Erkennung

Fügt einem Ziel einen Kommentar hinzu

Fügt einem Ziel einen neuen Kommentar hinzu.

Gibt die Erkennungen basierend auf den angewendeten Filtern zurück.

Gibt die Erkennungen basierend auf den angewendeten Filtern zurück.

Gibt Vorgänge basierend auf den angewendeten Filtern zurück.

Gibt Vorgänge basierend auf den angewendeten Filtern zurück.

Gibt Ziele basierend auf den angewendeten Filtern zurück.

Gibt Ziele basierend auf den angewendeten Filtern zurück.

Ruft ein Ziel nach ID ab

Ruft ein Ziel nach ID ab

Ruft eine Aufgabe nach ID ab.

Ruft eine Aufgabe nach ID ab.

Ruft eine Erkennung nach ID ab.

Ruft eine Erkennung nach ID ab.

Ruft einen Benutzer per E-Mail ab

Ruft einen Benutzer per E-Mail ab

Sendet eine neue externe Feedbackanfrage

Sendet eine neue externe Feedbackanfrage

Sendet eine neue Feedbackanfrage

Sendet eine neue Feedbackanfrage.

Aktualisieren des Fortschritts eines Ziels

Aktualisieren des Fortschritts eines Ziels

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ziel-ID
goalId True string

Eindeutiger Bezeichner des zu aktualisierenden Ziels

Neuer Statuswert
newValue True string

Neuer Fortschrittswert für das Ziel

Kommentar aktualisieren
comment string

Kommentieren des Statusupdates

Neuer Status
status string

Neuer Status für das Ziel

Updatertyp
goalUpdater True string

Wer das Ziel aktualisiert (Besitzer oder System)

Systemname
goalUpdaterSystemName True string

Name des Systems, das das Ziel aktualisiert

Gibt zurück

Body
Goal

Aktualisiert einen Benutzer mit ausgewählten Attributen.

Aktualisiert die Attribute eines Benutzers.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-E-Mail
userMail string

Die E-Mail-Adresse des zu aktualisierenden Benutzers.

Attributbezeichnung
label string

Der Name des zu aktualisierenden Attributs.

Attributwert
value string

Der Wert des zu aktualisierenden Attributs.

Erstellt ein neues Ziel

Erstellt ein neues Ziel

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zieltitel
title True string

Titel des neuen Ziels

Description
description True string

Detaillierte Beschreibung des neuen Ziels

Startdatum
startDate True string

Datum, an dem das Ziel beginnen soll

Fälligkeitsdatum
dueDate True string

Datum, an dem das Ziel abgeschlossen werden soll

Zieltyp
goalType True string

Typ des Ziels

Zielbesitzer
goalOwnerUPNorId True

E-Mail oder ID des Zielbesitzers

Zielersteller
goalCreatorUPNorId True string

E-Mail oder ID des Zielerstellers

Ist privat
isPrivate True boolean

Ob das Ziel privat sein soll

Statusformat
progressFormatType True string

Formattyp zum Nachverfolgen des Fortschritts

Währungscode
currencyCode True string

Währungscode für geldpolitische Ziele

Anfangswert
initialValue True number

Anfangsfortschrittswert

Zielwert
targetValue True number

Zielstatuswert

Übergeordnete Ziel-ID
parentGoalId True string

ID des übergeordneten Ziels, wenn dies ein Unterziel ist

Besitzer benachrichtigen
sendNotificationToOwner True boolean

Gibt an, ob der Zielbesitzer benachrichtigt werden soll.

Gibt zurück

Body
Goal

Erstellt eine neue Erkennung

Erstellt eine neue Erkennung

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Erkennungssender
senderIdOrUPN True string

E-Mail oder ID der Person, die die Erkennung sendet

Erkennungsempfänger
recipientsIdsOrUPNS True array of string

Liste der E-Mails oder IDs von Personen, die die Erkennung erhalten

Signaltitel
badgeTitle True string

Titel des Erkennungssignals

Ist privat
isPrivate True boolean

Gibt an, ob die Erkennung privat ist

Erkennungsnachricht
description True string

In der Erkennung enthaltene Nachricht

Gibt zurück

Fügt einem Ziel einen Kommentar hinzu

Fügt einem Ziel einen neuen Kommentar hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID des Ziels
goalId True string

ID des Ziels

Objekt-ID oder Benutzerprinzipalname des Kommentarers
commenterIdOrUPN True string

Objekt-ID oder Benutzerprinzipalname des Kommentarers

Kommentar selbst
commentText True string

Kommentar selbst

Gibt zurück

Body
Goal

Gibt die Erkennungen basierend auf den angewendeten Filtern zurück.

Gibt die Erkennungen basierend auf den angewendeten Filtern zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zu durchsuchende Empfänger
recipientsIdsOrUPNS True array of string

Liste der Empfänger-E-Mails oder IDs, nach der gesucht werden soll

Erkennungstitel
title True string

Erkennungstitel, nach dem gesucht werden soll

Aktualisierungsdatum
updated True string

Datum der letzten Aktualisierung, nach dem gefiltert werden soll

Erstellungsdatum
created True string

Erstellungsdatum zum Filtern nach

Gibt zurück

Gegenstände
RecognitionResponses

Gibt Vorgänge basierend auf den angewendeten Filtern zurück.

Gibt Vorgänge basierend auf den angewendeten Filtern zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzerobjekt-ID
userOID string

Objekt-ID des Benutzers, dessen Aufgaben abgerufen werden sollen

Benutzer-E-Mail
userUPN string

Benutzerprinzipalname (E-Mail) des Benutzers, dessen Aufgaben abgerufen werden sollen

Suchtext
search string

Text, nach dem in Aufgabentiteln und Beschreibungen gesucht werden soll

Ergebnislimit
limit number

Maximale Anzahl von Vorgängen, die zurückgegeben werden sollen

Anzahl überspringen
skip number

Anzahl der Aufgaben, die für die Paginierung übersprungen werden sollen

Startdatum
startDate string

Startdatum für Filteraufgaben

Enddatum
endDate string

Enddatum für Filteraufgaben

Gibt zurück

Gegenstände
Tasks

Gibt Ziele basierend auf den angewendeten Filtern zurück.

Gibt Ziele basierend auf den angewendeten Filtern zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzerobjekt-ID
userOID string

Objekt-ID des Benutzers, dessen Ziele abgerufen werden sollen

Benutzer-E-Mail
userUPN string

Benutzerprinzipalname (E-Mail) des Benutzers, dessen Ziele abgerufen werden sollen

Suchtext
search string

Text, nach dem in Zieltiteln und Beschreibungen gesucht werden soll

Zielbeschriftungen
selectedLabels string

Bezeichnungen zum Filtern von Zielen nach

Ergebnislimit
limit string

Maximale Anzahl der zurückzugebenden Ziele

Anzahl überspringen
skip string

Anzahl der Ziele, die für die Paginierung übersprungen werden sollen

Startdatum
startDate string

Startdatum für Filterziele

Enddatum
endDate string

Enddatum für Filterziele

Gibt zurück

Gegenstände
Goals

Ruft ein Ziel nach ID ab

Ruft ein Ziel nach ID ab

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Ziel-ID
goalId True string

Eindeutiger Bezeichner des abzurufenden Ziels

Gibt zurück

Body
Goal

Ruft eine Aufgabe nach ID ab.

Ruft eine Aufgabe nach ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorgangs-ID
taskId True string

Eindeutiger Bezeichner der abzurufenden Aufgabe

Gibt zurück

Body
Task

Ruft eine Erkennung nach ID ab.

Ruft eine Erkennung nach ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Erkennungs-ID
recognitionId True string

Eindeutiger Bezeichner der abzurufenden Erkennung

Gibt zurück

Ruft einen Benutzer per E-Mail ab

Ruft einen Benutzer per E-Mail ab

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-E-Mail
userMail True string

E-Mail-Adresse des abzurufenden Benutzers

Gibt zurück

Body
User

Sendet eine neue externe Feedbackanfrage

Sendet eine neue externe Feedbackanfrage

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Feedbackbetreff
feedbackAboutUPNorId True string

E-Mail oder ID der Person, die Feedback erhält

Externe E-Mail
externalEmail True string

E-Mail-Adresse des externen Feedbackanbieters

Anbietername
onBehalfName True string

Name, der für den externen Feedbackanbieter angezeigt werden soll

Anforderungsnotiz
feedbackNote True string

Hinweis zur Aufnahme in die Feedbackanfrage

Vorlagentitel
templateTitle True string

Titel der zu verwendenden Feedbackvorlage

Fälligkeitstage
dueDateInDays True number

Anzahl der Tage, bis das Feedback fällig ist

Ist privat
isPrivate True boolean

Gibt an, ob das Feedback privat sein soll

Ist anonym
isAnonymous True boolean

Gibt an, ob das Feedback anonym sein soll

Gibt zurück

Body
Feedback

Sendet eine neue Feedbackanfrage

Sendet eine neue Feedbackanfrage.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Feedbackbetreff
feedbackAboutUPNorId True string

E-Mail oder ID der Person, die Feedback erhält

Feedbackanbieter
feedbackRequestReceiverUPNorId True string

E-Mail oder ID der Person, die Feedback geben soll

Anforderungsnotiz
feedbackNote True string

Hinweis zur Aufnahme in die Feedbackanfrage

Vorlagentitel
templateTitle True string

Titel der zu verwendenden Feedbackvorlage

Fälligkeitstage
dueDateInDays True number

Anzahl der Tage, bis das Feedback fällig ist

Ist privat
isPrivate True boolean

Gibt an, ob das Feedback privat sein soll

Gibt zurück

Body
Feedback

Definitionen

Rückmeldung

Name Pfad Typ Beschreibung
Feedback-ID
id string

Eindeutiger Bezeichner des Feedbacks

Erstellungsdatum
createdAt string

Datum und Uhrzeit der Erstellung des Feedbacks

oid
createdBy.oid string
Anzeigename
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
oid
feedbackAboutUser.oid string
Anzeigename
feedbackAboutUser.displayName string
userPrincipalName
feedbackAboutUser.userPrincipalName string
oid
feedbackRequestRecipient.oid string
Anzeigename
feedbackRequestRecipient.displayName string
userPrincipalName
feedbackRequestRecipient.userPrincipalName string
Anmerkung
note string
isPrivate
isPrivate boolean

Ziel

Name Pfad Typ Beschreibung
oid
createdBy.oid string
Anzeigename
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
startDate
startDate string
fälliges Datum
dueDate string
owners
owners array of object
mail
owners.mail string
Anzeigename
owners.displayName string
userPrincipalName
owners.userPrincipalName string
Abteilung
owners.department string
Berufsbezeichnung
owners.jobTitle string
oid
owners.oid string
title
title string
goalType
goalType string
isPrivate
isPrivate boolean
ErstelltAm
createdAt string
relatedGroups
relatedGroups array of object
items
relatedGroups object
labels
labels array of object
title
labels.title string
Beschreibung
labels.description string
id
id string
Beschreibung
description string
id
parentGoal.id string
title
parentGoal.title string
formatType
progress.formatType string
initialValue
progress.initialValue number
targetValue
progress.targetValue number
currentValue (aktueller Wert)
progress.currentValue number
status
status string
Ergebnis
outcome string

Ziele

Name Pfad Typ Beschreibung
Gegenstände
Goal

RecognitionCreateResponse

Name Pfad Typ Beschreibung
erfolgreichTransactions
successfullyTransactions array of object
Transaktions-ID
successfullyTransactions.transactionId string
recipients
successfullyTransactions.recipients array of object
mail
successfullyTransactions.recipients.mail string
Anzeigename
successfullyTransactions.recipients.displayName string
userPrincipalName
successfullyTransactions.recipients.userPrincipalName string
oid
successfullyTransactions.recipients.oid string
Beschreibung
successfullyTransactions.badge.description string
title
successfullyTransactions.badge.title string
imageUrl
successfullyTransactions.badge.imageUrl string
bgImage
successfullyTransactions.badge.bgImage string
Rang
successfullyTransactions.badge.rank number
Beschreibung
successfullyTransactions.description string
comments
successfullyTransactions.comments array of object
items
successfullyTransactions.comments object
mag
successfullyTransactions.likes array of object
items
successfullyTransactions.likes object
failedTransactions
failedTransactions array of string

RecognitionResponse

Name Pfad Typ Beschreibung
recipients
recipients array of object
mail
recipients.mail string
Anzeigename
recipients.displayName string
userPrincipalName
recipients.userPrincipalName string
Beschreibung
badge.description string
title
badge.title string
imageUrl
badge.imageUrl string
bgImage
badge.bgImage string
oid
badge.updatedBy.oid string
Anzeigename
badge.updatedBy.displayName string
userPrincipalName
badge.updatedBy.userPrincipalName string
mail
badge.updatedBy.mail string
Beschreibung
description string
comments
comments array of object
businessPhones
comments.user.businessPhones array of string
Anzeigename
comments.user.displayName string
givenName
comments.user.givenName string
Berufsbezeichnung
comments.user.jobTitle string
mail
comments.user.mail string
officeLocation
comments.user.officeLocation string
preferredLanguage
comments.user.preferredLanguage string
Familienname
comments.user.surname string
userPrincipalName
comments.user.userPrincipalName string
id
comments.user.id string
Kommentar
comments.comment string
mag
likes array of object
items
likes object

RecognitionResponses

Name Pfad Typ Beschreibung
Gegenstände
RecognitionResponse

Aufgabe

Name Pfad Typ Beschreibung
title
title string
Beschreibung
description string
assignedTo
assignedTo array of object
userPrincipalName
assignedTo.user.userPrincipalName string
Anzeigename
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

Aufgaben

Name Pfad Typ Beschreibung
Gegenstände
Task

Benutzer

Name Pfad Typ Beschreibung
userPrincipalName
userPrincipalName string
ErstelltAm
createdAt string
lastLoginDate
lastLoginDate string
Abteilung
department string
MitarbeiterEinstellungsdatum
employeeHireDate string
role
role string
country
country string
hasManager
hasManager boolean
isManager
isManager boolean
Berufsbezeichnung
jobTitle string
officeLocation
officeLocation string
preferredLanguage
preferredLanguage string
name
name string
attachments
attachments array of object
items
attachments object