Meine Stunden (Vorschau)
Nachverfolgen von Zeit und Verwalten von Projekten, Aufgaben, Clients und Tags mit dynamischen Auswahlen. Dieser Connector macht Endpunkte zum Erstellen und Suchen von Entitäten verfügbar.
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 | Meine Stunden |
| URL | https://myhours.com |
| support@myhours.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Spica International |
| Webseite | https://myhours.com |
| Datenschutzrichtlinie | https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services |
| Kategorien | Produktivität |
Meine Stunden - Connector-Einführung
Nachverfolgen von Zeit und Verwalten von Projekten, Aufgaben, Clients und Tags mithilfe des Connectors "Meine Stunden".
Authentifizierung
Art: API-Schlüssel (Header)
Geben Sie beim Erstellen einer Verbindung den vollständigen Wert in das einzelne Feld namens "Autorisierung " ein, indem Sie dieses genaue Format verwenden:
Beispiel:
apikey 123abcXYZ
Der Connector sendet diesen Wert als Authorization Header für jede Anforderung.
Wo der Schlüssel abgerufen werden soll: Aus ihren Einstellungen für mein Stundenkonto. Erstellen oder kopieren Sie einen API-Schlüssel. Behalten Sie es geheim, und drehen Sie sie, wenn sie verfügbar gemacht wird.
Unterstützte Aktionen
- Create Client – Create a new client.
- Suchen Sie "Client nach Name" – Geben Sie Clients zurück, die dem angegebenen Namen entsprechen.
- Projekt erstellen – Ein neues Projekt erstellen.
- Projekt nach Name suchen – Suchen Sie ein Projekt anhand des Namens.
- Vorgang zu Project hinzufügen – Erstellen sie einen Vorgang für ein ausgewähltes Projekt.
- Vorgang nach Name suchen – Suchen Sie einen Projektvorgang anhand des Namens und der Projekt-ID.
- Tag erstellen – Erstellen eines neuen Tags (mit Hexadenzfarbe).
- Tag nach Name suchen – Suchen Sie ein Tag anhand des Namens.
- Zeitprotokoll erstellen – Erstellen eines neuen Zeitprotokolls.
- Abrufen von Zeitprotokollen – Abrufen detaillierter Aktivitäts-/Uhrzeitprotokolle für einen Datumsbereich.
Unterstützte Trigger
- Wenn ein neues Projekt erstellt wird – wird ausgelöst, wenn ein neues Projekt angezeigt wird.
- Wenn ein neuer Vorgang erstellt wird – wird ausgelöst, wenn eine neue Projektaufgabe angezeigt wird.
- Wenn ein neues Zeitprotokoll erstellt wird – Wird ausgelöst, wenn ein neues Zeitprotokoll angezeigt wird.
Nutzungsnotizen und Grenzwerte
-
Autorisierungsformat – Für die Verbindung ist das Literalpräfix
apikeygefolgt von Ihrem Schlüssel erforderlich. Wenn Sie das Präfix weglassen oder zusätzliche Zeichen hinzufügen, können Anforderungen mit 400 oder 401 fehlschlagen. -
Datums-/Uhrzeitformate – Datumsangaben sind JJJJ-MM-TT. Datums-/Uhrzeitwerte sind ISO 8601 (z. B.
2025-09-05T08:30:00Zein lokaler Offset). -
Erstellen von Zeitprotokollen – Geben Sie entweder
duration(Sekunden) oder beides und beidesstartanend. Die Bereitstellung aller drei Elemente ist ungültig. - Dynamische Auswahl – In den Feldern "Projekt", "Aufgabe", "Tag" und "Benutzer" werden dynamische Listen verwendet; Stellen Sie sicher, dass Ihr Konto über die Berechtigung zum Lesen dieser Entitäten verfügt oder die Listen leer sind.
-
Umgebung – Nur der Produktions-API-Host wird unterstützt:
https://api2.myhours.com.
Fehlerbehandlung
Der Connector gibt standardmäßige HTTP-Statuscodes zurück:
| Code | Bedeutung | Typische Ursachen |
|---|---|---|
| 200 | Success | Lese-/Listenvorgänge. |
| 201 | Erstellt | Erfolgreiche Erstellungsvorgänge. |
| 400 | Fehlerhafte Anfrage | Fehlende/ungültige Eingaben, falsches Headerformat, widersprüchliche Textkörperfelder. |
| 500 | Serverfehler | Temporäres Back-End-Problem oder unerwarteter Fehler. |
Problembehandlung
- Überprüfen Sie, ob der Autorisierungswert das genaue
apikey YOUR_API_KEYFormat verwendet. - Überprüfen Sie erforderliche Felder, die vorhanden und gültig sind.
- Bestätigen Sie für das Erstellen des Zeitprotokolls, dass Sie entweder
durationoder (startundend) bestanden haben.
Änderungsprotokoll
- 1.0.0 – Erste Einreichung zur Zertifizierung.
Support
- Website: https://myhours.com/
- E-Mail: support@myhours.com
Eine Verbindung wird erstellt
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 |
|---|---|---|---|
| Autorisierung | securestring | Die Autorisierung für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Zeitprotokollen |
Abrufen detaillierter Aktivitäts- oder Zeitprotokolle für einen Datumsbereich. |
| Aufgabe nach Name suchen |
Suchen Sie einen Projektvorgang anhand des Namens und der Projekt-ID. |
| Client erstellen |
Erstellen Sie einen neuen Clientdatensatz. |
| Client nach Name suchen |
Gibt Clients zurück, die dem angegebenen Namen entsprechen. |
| Projekt erstellen |
Erstelle ein neues Projekt. |
| Projekt nach Name suchen |
Suchen Sie ein Projekt anhand des Namens. |
| Tag erstellen |
Erstellen Sie ein neues Tag. |
| Tag nach Name suchen |
Suchen Sie ein Tag anhand des Namens. |
| Vorgang zu Project hinzufügen |
Erstellen Sie einen Vorgang für ein ausgewähltes Projekt. |
| Zeitprotokoll erstellen |
Erstellen Sie ein Zeitprotokoll. Entweder das Feld "Dauer" oder die Felder "Startzeit" und "Endzeit" sollten ausgefüllt werden. Wenn alle drei ausgefüllt werden, erhalten Sie eine Fehlermeldung. |
Abrufen von Zeitprotokollen
Abrufen detaillierter Aktivitäts- oder Zeitprotokolle für einen Datumsbereich.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datum von
|
dateFrom | True | date |
Startdatum im JJJJ-MM-DD Format. |
|
Datum bis
|
dateTo | True | date |
Enddatum im Format JJJJ-MM-DD. |
Gibt zurück
Aufgabe nach Name suchen
Suchen Sie einen Projektvorgang anhand des Namens und der Projekt-ID.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Taskname
|
projectTaskName | True | string |
Vorgangsname. |
|
Projektkennung
|
projectId | True | integer |
Projekt-ID. |
Gibt zurück
- Body
- ProjectTask
Client erstellen
Erstellen Sie einen neuen Clientdatensatz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
Name | True | string |
Clientname. |
Gibt zurück
- Body
- Client
Client nach Name suchen
Gibt Clients zurück, die dem angegebenen Namen entsprechen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Clientname
|
clientName | True | string |
Clientname mit exakter oder teilweiser Übereinstimmung. |
Gibt zurück
- response
- array of Client
Projekt erstellen
Erstelle ein neues Projekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | True | string |
Projektname. |
|
Kunden-ID
|
clientId | integer |
Kundenkennung. |
|
|
Hinweise
|
notes | string |
Notizen. |
|
|
Zugewiesener Benutzer
|
autoAssignUserId | integer |
Dem Projekt zugewiesener Benutzer. |
Gibt zurück
- Body
- Project
Projekt nach Name suchen
Suchen Sie ein Projekt anhand des Namens.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Projektname
|
projectName | True | string |
Projektname. |
Gibt zurück
- Body
- Project
Tag erstellen
Erstellen Sie ein neues Tag.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tagname
|
name | True | string |
Tagname. |
|
Hexfarbe
|
hexColor | True | string |
Hexfarbe in |
Gibt zurück
- Body
- Tag
Tag nach Name suchen
Suchen Sie ein Tag anhand des Namens.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tagname
|
tagName | True | string |
Tagname. |
Gibt zurück
- Body
- Tag
Vorgang zu Project hinzufügen
Erstellen Sie einen Vorgang für ein ausgewähltes Projekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Projektkennung
|
projectId | True | integer |
Projekt-ID. |
|
Listenname
|
listName | string |
Aufgabenlistenname. |
|
|
Name
|
name | True | string |
Vorgangsname. |
|
Description
|
description | string |
Beschreibung. |
Gibt zurück
- Body
- ProjectTask
Zeitprotokoll erstellen
Erstellen Sie ein Zeitprotokoll. Entweder das Feld "Dauer" oder die Felder "Startzeit" und "Endzeit" sollten ausgefüllt werden. Wenn alle drei ausgefüllt werden, erhalten Sie eine Fehlermeldung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datum
|
date | True | date |
Datum im JJJJ-MM-DD Format. |
|
Startzeit
|
start | date-time |
Startzeit im UTC- oder lokalen ISO 8601-Format. |
|
|
Endzeitpunkt
|
end | date-time |
Endzeit im UTC- oder lokalen ISO 8601-Format. |
|
|
Dauer
|
duration | integer |
Dauer in Sekunden. |
|
|
Description
|
Note | string |
Anmerkung. |
|
|
Projektkennung
|
ProjectId | integer |
Projekt-ID. |
|
|
Vorgangs-ID
|
TaskId | integer |
Vorgangs-ID. |
|
|
Tag-ID
|
TagId | integer |
Tag-ID. |
Gibt zurück
- Body
- TimeLog
Auslöser
| Beim Erstellen eines neuen Projekts |
Auslösen, wenn ein neues Projekt erstellt wird. |
| Beim Erstellen eines neuen Zeitprotokolls |
Auslösen, wenn ein neues Zeitprotokoll erstellt wird. |
| Wenn eine neue Aufgabe erstellt wird |
Wird ausgelöst, wenn eine neue Projektaufgabe erstellt wird. |
Beim Erstellen eines neuen Projekts
Beim Erstellen eines neuen Zeitprotokolls
Wenn eine neue Aufgabe erstellt wird
Wird ausgelöst, wenn eine neue Projektaufgabe erstellt wird.
Gibt zurück
Definitionen
TimeSlice
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | integer | |
|
duration
|
duration | integer | |
|
startTime
|
startTime | string | |
|
endTime
|
endTime | string | |
|
Wird ausgeführt
|
running | boolean | |
|
gelöscht
|
deleted | boolean |
Attachment
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
fileName
|
fileName | string | |
|
fileUrl
|
fileUrl | string | |
|
id
|
id | integer |
Tag
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
name
|
name | string | |
|
hexColor
|
hexColor | string | |
|
archiviert
|
archived | boolean | |
|
dateArchived
|
dateArchived | string | |
|
id
|
id | integer |
Kunde
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
name
|
name | string | |
|
Name des Kontakts
|
contactName | string | |
|
KontaktE-Mail
|
contactEmail | string | |
|
KontaktTelefon
|
contactPhone | string | |
|
address
|
address | string | |
|
customId
|
customId | string | |
|
customFieldValues
|
customFieldValues | string | |
|
id
|
id | integer |
Project
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
invoiceMethod
|
invoiceMethod | integer | |
|
Rate
|
rate | float | |
|
budgetType
|
budgetType | integer | |
|
budgetValue
|
budgetValue | integer | |
|
budgetAlertPercent
|
budgetAlertPercent | integer | |
|
Notizen
|
notes | string | |
|
gebilligt
|
approved | boolean | |
|
roundType
|
roundType | integer | |
|
roundInterval
|
roundInterval | integer | |
|
firstLogDate
|
firstLogDate | string | |
|
budgetTarget
|
budgetTarget | integer | |
|
budgetPeriodType
|
budgetPeriodType | string | |
|
startDate
|
startDate | string | |
|
fälliges Datum
|
dueDate | string | |
|
dateCreated
|
dateCreated | string | |
|
createdByUserId
|
createdByUserId | integer | |
|
createdByUserName
|
createdByUserName | string | |
|
verrechenbar
|
billable | boolean | |
|
customFieldValues
|
customFieldValues | string | |
|
Kunden-ID
|
clientId | integer | |
|
clientName
|
clientName | string | |
|
clientCustomId
|
clientCustomId | string | |
|
name
|
name | string | |
|
archiviert
|
archived | boolean | |
|
customId
|
customId | string | |
|
id
|
id | integer |
ProjectTask
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
name
|
name | string | |
|
orderNo
|
orderNo | integer | |
|
Beschreibung
|
description | string | |
|
abgeschlossen
|
completed | boolean | |
|
archiviert
|
archived | boolean | |
|
startDate
|
startDate | string | |
|
fälliges Datum
|
dueDate | string | |
|
Rate
|
rate | float | |
|
billableByDefault
|
billableByDefault | boolean | |
|
budgetValue
|
budgetValue | float | |
|
budgetSpent
|
budgetSpent | float | |
|
budgetSpentPercentage
|
budgetSpentPercentage | float | |
|
projectBudgetType
|
projectBudgetType | integer | |
|
projectTaskUserIds
|
projectTaskUserIds | array of integer | |
|
customFieldValues
|
customFieldValues | string | |
|
customId
|
customId | string | |
|
projectCustomId
|
projectCustomId | string | |
|
clientCustomId
|
clientCustomId | string | |
|
id
|
id | integer |
TimeLog
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anmerkung
|
note | string | |
|
date
|
date | string | |
|
duration
|
duration | integer | |
|
Nutzername
|
userName | string | |
|
Projektname
|
projectName | string | |
|
taskName
|
taskName | string | |
|
clientName
|
clientName | string | |
|
Wird ausgeführt
|
running | boolean | |
|
startTime
|
startTime | string | |
|
endTime
|
endTime | string | |
|
mal
|
times | array of TimeSlice | |
|
status
|
status | integer | |
|
projectId
|
projectId | integer | |
|
taskId
|
taskId | integer | |
|
verrechenbar
|
billable | boolean | |
|
Kosten
|
expense | float | |
|
userId
|
userId | integer | |
|
billableRate
|
billableRate | float | |
|
billableAmount
|
billableAmount | float | |
|
laborRate
|
laborRate | float | |
|
laborCost
|
laborCost | float | |
|
customField1Name
|
customField1Name | string | |
|
customField2Name
|
customField2Name | string | |
|
customField3Name
|
customField3Name | string | |
|
customField1Value
|
customField1Value | string | |
|
customField2Value
|
customField2Value | string | |
|
customField3Value
|
customField3Value | string | |
|
tags
|
tags | string | |
|
durationInHours
|
durationInHours | float | |
|
id
|
id | integer | |
|
tagsData
|
tagsData | array of Tag | |
|
attachments
|
attachments | array of Attachment |
ActivityLogRow
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
logId
|
logId | integer | |
|
userId
|
userId | integer | |
|
date
|
date | string | |
|
teamsNames
|
teamsNames | string | |
|
Nutzername
|
userName | string | |
|
userCustomId
|
userCustomId | string | |
|
Kunden-ID
|
clientId | integer | |
|
clientName
|
clientName | string | |
|
clientCustomId
|
clientCustomId | string | |
|
projectId
|
projectId | integer | |
|
Projektname
|
projectName | string | |
|
projectCustomId
|
projectCustomId | string | |
|
projectStartDate
|
projectStartDate | string | |
|
projectDueDate
|
projectDueDate | string | |
|
projectBudgetType
|
projectBudgetType | string | |
|
projectBudgetTarget
|
projectBudgetTarget | string | |
|
projectBudgetPeriodType
|
projectBudgetPeriodType | string | |
|
projectBudgetValue
|
projectBudgetValue | integer | |
|
taskListName
|
taskListName | string | |
|
taskId
|
taskId | integer | |
|
taskName
|
taskName | string | |
|
taskCustomId
|
taskCustomId | string | |
|
taskStartDate
|
taskStartDate | string | |
|
taskDueDate
|
taskDueDate | string | |
|
taskCompleted
|
taskCompleted | boolean | |
|
userCustomFieldValues
|
userCustomFieldValues | string | |
|
projectCustomFieldValues
|
projectCustomFieldValues | string | |
|
clientCustomFieldValues
|
clientCustomFieldValues | string | |
|
taskCustomFieldValues
|
taskCustomFieldValues | string | |
|
tags
|
tags | string | |
|
Rate
|
rate | float | |
|
verrechenbar
|
billable | boolean | |
|
inLockedPeriod
|
inLockedPeriod | boolean | |
|
billableAmount
|
billableAmount | float | |
|
Menge
|
amount | float | |
|
laborCost
|
laborCost | float | |
|
laborRate
|
laborRate | float | |
|
logDuration
|
logDuration | integer | |
|
logDurationBillable
|
logDurationBillable | integer | |
|
laborDuration
|
laborDuration | integer | |
|
startEndTime
|
startEndTime | string | |
|
Kosten
|
expense | float | |
|
billableExpense
|
billableExpense | float | |
|
kosten
|
cost | float | |
|
Anmerkung
|
note | string | |
|
status
|
status | string | |
|
Rechnung-ID
|
invoiceId | integer | |
|
Rechnung gestellt
|
invoiced | boolean | |
|
billableHours
|
billableHours | integer | |
|
billableHoursLogBillable
|
billableHoursLogBillable | integer | |
|
laborHours
|
laborHours | integer | |
|
customField1
|
customField1 | integer | |
|
customField2
|
customField2 | integer | |
|
customField3
|
customField3 | integer | |
|
Gleichgewicht
|
balance | integer | |
|
monthOfYear
|
monthOfYear | string | |
|
weekNo
|
weekNo | integer | |
|
weekOfYear
|
weekOfYear | string | |
|
Teams
|
teams | array of string | |
|
Wird ausgeführt
|
running | boolean | |
|
startTime
|
startTime | string | |
|
endTime
|
endTime | string | |
|
mal
|
times | array of TimeSlice | |
|
tagsData
|
tagsData | array of Tag | |
|
attachments
|
attachments | array of Attachment | |
|
roundType
|
roundType | string | |
|
invoicedAmount
|
invoicedAmount | float | |
|
uninvoicedAmount
|
uninvoicedAmount | float |
ActivityReportResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
body
|
body | array of ActivityLogRow |
TriggerLogsEnvelope
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
logs
|
logs | array of TimeLog |
TriggerProjectsEnvelope
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
projects
|
projects | array of object | |
|
Kunden-ID
|
projects.clientId | integer | |
|
clientName
|
projects.clientName | string | |
|
clientCustomId
|
projects.clientCustomId | string | |
|
name
|
projects.name | string | |
|
customId
|
projects.customId | string | |
|
id
|
projects.id | integer |
TriggerProjectTasksEnvelope
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
projectTasks
|
projectTasks | array of object | |
|
projectId
|
projectTasks.projectId | integer | |
|
listName
|
projectTasks.listName | string | |
|
listOrderNo
|
projectTasks.listOrderNo | integer | |
|
name
|
projectTasks.name | string | |
|
orderNo
|
projectTasks.orderNo | integer | |
|
Beschreibung
|
projectTasks.description | string | |
|
Rate
|
projectTasks.rate | float | |
|
budgetValue
|
projectTasks.budgetValue | float | |
|
projectBudgetType
|
projectTasks.projectBudgetType | integer | |
|
customId
|
projectTasks.customId | string | |
|
billableByDefault
|
projectTasks.billableByDefault | boolean | |
|
projectCustomId
|
projectTasks.projectCustomId | string | |
|
clientCustomId
|
projectTasks.clientCustomId | string | |
|
id
|
projectTasks.id | integer |