Megosztás:

Saját órák (előzetes verzió)

Projektek, tevékenységek, ügyfelek és címkék időkövetése és kezelése dinamikus jelölőkkel. Ez az összekötő végpontokat tesz elérhetővé entitások létrehozásához és kereséséhez.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Régiók
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Érintkezés
Név Saját órák
URL https://myhours.com
Email support@myhours.com
Összekötő metaadatai
Kiadó Spica International
Webhely https://myhours.com
Adatvédelmi irányelvek https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Kategóriák Termelékenység

Saját órák – Összekötő – bevezetés

A My Hours összekötővel nyomon követheti a projektek, tevékenységek, ügyfelek és címkék idejét és kezelését.

Authentication

Típus: API-kulcs (fejléc)

Kapcsolat létrehozásakor adja meg a teljes értéket az Engedélyezés nevű egyetlen mezőben, pontosan ezt a formátumot használva:

Példa: apikey 123abcXYZ

Az összekötő minden kérés fejléceként elküldi ezt az Authorization értéket.

A kulcs lekérésének helye: A Saját órák fiók beállításai között. API-kulcs létrehozása vagy másolása. Tartsa titokban, és forgassa el, ha ki van téve.

Támogatott műveletek

  • Ügyfél létrehozása – Új ügyfél létrehozása.
  • Ügyfél keresése név szerint – A megadott névnek megfelelő ügyfeleket adja vissza.
  • Projekt létrehozása – Új projekt létrehozása.
  • Projekt keresése név szerint – Projekt keresése név szerint.
  • Tevékenység hozzáadása a projekthez – Tevékenység létrehozása egy kijelölt projekten.
  • Tevékenység keresése név szerint – Projekttevékenység keresése név és projektazonosító szerint.
  • Címke létrehozása – Új címke létrehozása (hexa színnel).
  • Címke keresése név szerint – Címke keresése név szerint.
  • Időnapló létrehozása – Új időnapló létrehozása.
  • Időnaplók lekérése – Részletes tevékenység-/időnaplók lekérése egy dátumtartományhoz.

Támogatott eseményindítók

  • Új projekt létrehozásakor – Új projekt megjelenésekor aktiválódik.
  • Új tevékenység létrehozásakor – Új projekttevékenység megjelenésekor aktiválódik.
  • Új időnapló létrehozásakor – Új időnapló megjelenésekor aktiválódik.

Használati megjegyzések > korlátai

  • Engedélyezési formátum – A kapcsolathoz szükség van a konstans előtagra apikey , majd a kulcsra. Ha kihagyja az előtagot, vagy további karaktereket ad hozzá, a kérelmek 400 vagy 401-zel meghiúsulhatnak.
  • Dátum-/időformátumok – A dátumok YYYYY-MM-DD. A dátum/idő értékek ISO 8601 (például 2025-09-05T08:30:00Z helyi eltolás).
  • Időnaplók létrehozása– Adja megduration a (másodperc) vagy mindkettőtstart.end Mindhárom beszolgáltatás érvénytelen.
  • Dinamikus jelölők – A Project, a Task, a Tag és a User mezők dinamikus listákat használnak; győződjön meg arról, hogy a fiókja rendelkezik engedéllyel az entitások olvasására, vagy a listák üresek lehetnek.
  • Környezet – Csak az éles API-gazdagép támogatott: https://api2.myhours.com.

Hibakezelés

Az összekötő szabványos HTTP-állapotkódokat ad vissza:

Kód Meaning Tipikus okok
200 Success Olvasási/listázási műveletek.
201 Létrehozott Sikeres létrehozási műveletek.
400 Hibás kérés Hiányzó/érvénytelen bemenetek, helytelen fejlécformátum, ütköző törzsmezők.
500 Kiszolgálóhiba Ideiglenes háttérbeli probléma vagy váratlan hiba.

Troubleshooting

  1. Ellenőrizze, hogy az engedélyezési érték pontosan a formátumot apikey YOUR_API_KEY használja-e.
  2. Ellenőrizze, hogy a szükséges mezők meg vannak-e jelen és érvényesek-e.
  3. A létrehozási időnaplóban ellenőrizze, hogy megfelelt-e vagyduration (start és )end

Változások naplója

  • 1.0.0 – Kezdeti beküldés a minősítéshez.

Support

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:
Alapértelmezett A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Kötelező
Authorization securestring Az api engedélyezése True

Szabályozási korlátok

Name Hívások Megújítási időszak
API-hívások kapcsolatonként 100 60 másodperc

Műveletek

Címke keresése név szerint

Keressen egy címkét a neve alapján.
Címke létrehozása

Hozzon létre egy új címkét.
Feladat megkeresése név szerint

Projekttevékenység keresése név és projektazonosító alapján.
Időnapló létrehozása

Hozzon létre egy időnaplót. Vagy az "időtartam" mezőt, vagy a "kezdési időpont" és a "befejezési idő" mezőt kell kitölteni. Ha mind a hármat kitölti, hibaüzenet jelenik meg
Időnaplók lekérése

Részletes tevékenység- vagy időnaplók lekérése egy dátumtartományhoz.
Projekt keresése név szerint

Projekt megkeresése név alapján.
Projekt létrehozása

Új projekt létrehozása.
Tevékenység hozzáadása a Projekthez

Tevékenység létrehozása egy kijelölt projekten.
Ügyfél keresése név szerint

A megadott névnek megfelelő ügyfeleket adja vissza.
Ügyfél létrehozása

Hozzon létre egy új ügyfélrekordot.

Címke keresése név szerint

Műveletazonosító:
FindTag

Keressen egy címkét a neve alapján.

Paraméterek

Name Kulcs Kötelező Típus Description
Címke neve
 tagName True string

Címke neve.

Válaszok

Törzs
Tag

Címke létrehozása

Műveletazonosító:
CreateTag

Hozzon létre egy új címkét.

Paraméterek

Name Kulcs Kötelező Típus Description
Címke neve
 name True string

Címke neve.
Hexa szín
 hexColor True string

Hexa szín

Válaszok

Törzs
Tag

Feladat megkeresése név szerint

Műveletazonosító:
FindTask

Projekttevékenység keresése név és projektazonosító alapján.

Paraméterek

Name Kulcs Kötelező Típus Description
Tevékenység neve
 projectTaskName True string

Tevékenység neve.
Projektazonosító
 projectId True integer

Projektazonosító.

Válaszok

Törzs
ProjectTask

Időnapló létrehozása

Műveletazonosító:
CreateLog

Hozzon létre egy időnaplót. Vagy az "időtartam" mezőt, vagy a "kezdési időpont" és a "befejezési idő" mezőt kell kitölteni. Ha mind a hármat kitölti, hibaüzenet jelenik meg

Paraméterek

Name Kulcs Kötelező Típus Description
Date
 date True date

Dátum YYYY-MM-DD formátumban.
Kezdési időpont
 start date-time

Kezdési idő UTC vagy helyi ISO 8601 formátumban.
Befejezési idő
 end date-time

Befejezési idő UTC vagy helyi ISO 8601 formátumban.
Időtartam
 duration integer

Időtartam másodpercben.
Description
 Note string

Jegyzet.
Projektazonosító
 ProjectId integer

Projektazonosító.
Tevékenységazonosító
 TaskId integer

Tevékenységazonosító.
Címkeazonosító
 TagId integer

Címkeazonosító.

Válaszok

Törzs
TimeLog

Időnaplók lekérése

Műveletazonosító:
GetTimeLogs

Részletes tevékenység- vagy időnaplók lekérése egy dátumtartományhoz.

Paraméterek

Name Kulcs Kötelező Típus Description
Dátum innen:
 dateFrom True date

Kezdési dátum YYYY-MM-DD formátumban.
Dátum:
 dateTo True date

Záró dátum YYYY-MM-DD formátumban.

Válaszok

Törzs
ActivityReportResponse

Projekt keresése név szerint

Műveletazonosító:
FindProject

Projekt megkeresése név alapján.

Paraméterek

Name Kulcs Kötelező Típus Description
Projekt neve
 projectName True string

Projekt neve.

Válaszok

Törzs
Project

Projekt létrehozása

Műveletazonosító:
CreateProject

Új projekt létrehozása.

Paraméterek

Name Kulcs Kötelező Típus Description
Név
 name True string

Projekt neve.
Ügyfélazonosító
 clientId integer

Ügyfélazonosító.
Jegyzetek
 notes string

Notes.
Hozzárendelt felhasználó
 autoAssignUserId integer

A projekthez rendelt felhasználó.

Válaszok

Törzs
Project

Tevékenység hozzáadása a Projekthez

Műveletazonosító:
CreateProjectTask

Tevékenység létrehozása egy kijelölt projekten.

Paraméterek

Name Kulcs Kötelező Típus Description
Projektazonosító
 projectId True integer

Projektazonosító.
Lista neve
 listName string

Feladatlista neve.
Név
 name True string

Tevékenység neve.
Description
 description string

Description.

Válaszok

Törzs
ProjectTask

Ügyfél keresése név szerint

Műveletazonosító:
FindClient

A megadott névnek megfelelő ügyfeleket adja vissza.

Paraméterek

Name Kulcs Kötelező Típus Description
Ügyfélnév
 clientName True string

Ügyfélnév pontos vagy részleges egyezéssel.

Válaszok

response
array of Client

Ügyfél létrehozása

Műveletazonosító:
CreateClient

Hozzon létre egy új ügyfélrekordot.

Paraméterek

Name Kulcs Kötelező Típus Description
Név
 Name True string

Ügyfélnév.

Válaszok

Törzs
Client

Triggerek

Új időnapló létrehozásakor

Új időnapló létrehozásakor aktiválódik.
Új projekt létrehozásakor

Új projekt létrehozásakor aktiválódik.
Új tevékenység létrehozásakor

Új projekttevékenység létrehozásakor aktiválódik.

Új időnapló létrehozásakor

Műveletazonosító:
NewTimeLog

Új időnapló létrehozásakor aktiválódik.

Válaszok

Törzs
TriggerLogsEnvelope

Új projekt létrehozásakor

Műveletazonosító:
NewProject

Új projekt létrehozásakor aktiválódik.

Válaszok

Törzs
TriggerProjectsEnvelope

Új tevékenység létrehozásakor

Műveletazonosító:
NewTask

Új projekttevékenység létrehozásakor aktiválódik.

Válaszok

Törzs
TriggerProjectTasksEnvelope

Definíciók

TimeSlice

Name Elérési út Típus Description
azonosító
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
futás
 running boolean
törölt
 deleted boolean

Attachment

Name Elérési út Típus Description
fileName
 fileName string
fileUrl
 fileUrl string
azonosító
 id integer

Tag

Name Elérési út Típus Description
név
 name string
hexColor
 hexColor string
Archivált
 archived boolean
dateArchived
 dateArchived string
azonosító
 id integer

Ügyfél

Name Elérési út Típus Description
név
 name string
kapcsolatnév
 contactName string
kapcsolatE-mail cím
 contactEmail string
kapcsolatTelefon
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
azonosító
 id integer

Projekt

Name Elérési út Típus Description
invoiceMethod
 invoiceMethod integer
arány
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
jegyzetek
 notes string
jóváhagyott
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
esedékesség dátuma
 dueDate string
dateCreated
 dateCreated string
createdByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
Számlázható
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
név
 name string
Archivált
 archived boolean
customId
 customId string
azonosító
 id integer

ProjectTask

Name Elérési út Típus Description
név
 name string
orderNo
 orderNo integer
leírás
 description string
Befejezett
 completed boolean
Archivált
 archived boolean
startDate
 startDate string
esedékesség dátuma
 dueDate string
arány
 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
azonosító
 id integer

TimeLog

Name Elérési út Típus Description
jegyzet
 note string
date
 date string
duration
 duration integer
Felhasználónév
 userName string
projektnév
 projectName string
taskName
 taskName string
clientName
 clientName string
futás
 running boolean
startTime
 startTime string
endTime
 endTime string
szer
 times array of TimeSlice
állapot
 status integer
projectId
 projectId integer
taskId
 taskId integer
Számlázható
 billable boolean
költség
 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
azonosító
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name Elérési út Típus Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
Felhasználónév
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
projektnév
 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
arány
 rate float
Számlázható
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
mennyiség
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
költség
 expense float
billableExpense
 billableExpense float
költség
 cost float
jegyzet
 note string
állapot
 status string
számla azonosító
 invoiceId integer
Számlázott
 invoiced boolean
billableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
egyenleg
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
Csapat
 teams array of string
futás
 running boolean
startTime
 startTime string
endTime
 endTime string
szer
 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 Elérési út Típus Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name Elérési út Típus Description
naplók
 logs array of TimeLog

TriggerProjectsEnvelope

Name Elérési út Típus Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
név
 projects.name string
customId
 projects.customId string
azonosító
 projects.id integer

TriggerProjectTasksEnvelope

Name Elérési út Típus Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
név
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
leírás
 projectTasks.description string
arány
 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
azonosító
 projectTasks.id integer