Expand my Community achievements bar.

SOLVED

Workfront API - Difference in Actual Hours Fields for Tasks

Avatar

Community Advisor

I'm curious if anyone knows and can explain the difference between these fields in the API explorer. My assumption was hours vs minutes but when I use them both in text mode, they both return the values in minutes. 

 

KellieGardner_0-1743094753009.png

KellieGardner_1-1743096732170.png

 

 




Topics

Topics help categorize Community content and increase your ability to discover relevant content.

1 Accepted Solution

Avatar

Correct answer by
Community Advisor

Just like Planned Hours has a work and workRequired option, it looks like Actual Hours similarly have an actualWork and actualWorkRequired options.

 

When I send an API call looking for work and workRequired, what I get back is in hours and minutes based on the option. Likely the same thing goes for Actual Hours. Attaching a screenshot of a task with half an hour on the planned hours field. Edited to add that this is more relevant on the fusion side of things, as the field you pull in and want to transform will be in a particular format that you will want to keep in mind when you act on it.

 

Screenshot 2025-03-27 115921.png

View solution in original post

6 Replies

Avatar

Community Advisor

the difference is the value format - integer vs a value with decimals

Not sure why there is a double option it's not like we cut PLANNED hours to seconds...

Avatar

Community Advisor

Thanks, I see the field types are different however, it doesn't seem to affect the data in any way. 

 

I know Workfront stores hours as minutes, so I can see why the numbers are not showing as hours but really trying to understand the need for both in the API and when you would use one vs the other. 

 

Additional note: The native field for Actual Hours in reporting pulls "actualWorkRequired" and the filter for actual hours uses "actualWork"

 

KellieGardner_0-1743101137215.png

 




Avatar

Correct answer by
Community Advisor

Just like Planned Hours has a work and workRequired option, it looks like Actual Hours similarly have an actualWork and actualWorkRequired options.

 

When I send an API call looking for work and workRequired, what I get back is in hours and minutes based on the option. Likely the same thing goes for Actual Hours. Attaching a screenshot of a task with half an hour on the planned hours field. Edited to add that this is more relevant on the fusion side of things, as the field you pull in and want to transform will be in a particular format that you will want to keep in mind when you act on it.

 

Screenshot 2025-03-27 115921.png

Avatar

Community Advisor

BOOM - Skye FTW again

So work and actualWork = in hours, hence the format Double
WorkRequired & actualWorkRequired = in minutes no decimals needed > Integer.

SveniX_0-1743102675615.png

 

Avatar

Community Advisor

Note for newbies to Fusion: it can be pretty frustrating figuring out which one is which in Fusion (both are called the same thing, I usually pull in both).

 

Screenshot 2025-03-27 122046.png

Avatar

Community Advisor

It looks like there is some data massaging going on in the report for them to both show minutes. 
What valueformat is it using? 

That cracked me up


The native field for Actual Hours in reporting pulls "actualWorkRequired" and the filter for actual hours uses "actualWork"

I don't have a good response to that.