Workload

Resumo de capacidade do time (Workload)

Consulta (get) a visão de capacidade (Workload) do time, a mesma da tela Tarefas > Workload: por executor, quanto está alocado, quanto tem disponível e quanto há de trabalho atrasado. Os valores já vêm calculados, em minutos e em texto (campos *Formatted, como 2h30min): basta apresentá-los. Todos os parâmetros são opcionais. Por padrão considera de hoje até hoje + 6 dias; a data inicial nunca é anterior a hoje, como na tela. O período realmente calculado vem em period (confira period.startDate, period.endDate e period.adjusted); veja a observação sobre períodos longos em endDate. Só entram as tarefas ativas e não excluídas que o usuário pode ver. Tarefas ágeis com etapa de co-execução definida também são computadas para o co-executor, mas com previsto e realizado zerados (não somam minutos). Para as tarefas de um executor use get_workload_executor_tasks.

GET
/tasks/workload/summary

Query Parameters

executorIds?string

Ids dos executores (usuários), separados por vírgula. Omita para trazer todos os executores com tarefas. Obtenha os ids em list_admin_editors_users. Id que não é de um usuário da empresa (convidados não contam) gera erro 400.

workspaceIds?string

Ids de workspaces, separados por vírgula (apenas números), para considerar só as tarefas delas. Omita para todas as que o usuário pode ver. Obtenha os ids em list_short_workspaces. Id de workspace fora da empresa ou sem acesso gera erro 400.

startDate?string

Início do período, formato yyyy-MM-dd. Padrão: hoje. Nunca começa antes de hoje: datas passadas são deslocadas para hoje (e o fim é deslocado mantendo a mesma duração), como na tela.

Formatdate
endDate?string

Fim do período, formato yyyy-MM-dd. Padrão: startDate + 6 dias. Não pode ser anterior a startDate. Atenção a períodos longos: quando a diferença entre startDate e endDate passa de 30 dias, a API desloca a data inicial em 30 dias (comportamento atual do código). A duração resultante não é necessariamente de 30 dias, e a regra de limite está pendente de esclarecimento, portanto não presuma um limite máximo. Confira sempre period.startDate, period.endDate e period.adjusted no retorno.

Formatdate
includeExecutorsWithoutTasks?boolean

true para incluir também executores sem nenhuma tarefa no período (totalmente disponíveis). Padrão: false.

detail?string

summary (padrão): totais por executor. daily: acrescenta a grade dia a dia de cada executor (days). Comece por summary e use daily só se pedirem o detalhe por dia. Para as tarefas de um executor não use este parâmetro: use get_workload_executor_tasks.

Default"summary"
Value in"summary" | "daily"
curl -X GET "https://loading/tasks/workload/summary"
Empty
Empty