Novidades da API versão 15

Última atualização: 17 de julho de 2024
  • Tópicos:

Criado para:

  • Desenvolvedor

O Adobe Workfront lançou a API versão 15 em 14 de junho de 2022. A API versão 15 apresenta as seguintes alterações da versão 14.

Recursos adicionados

Iniciativa INITIV

O objeto Iniciativa cria estimativas no Planejador de cenários da Workfront para o tipo e o número de funções de trabalho, os Custos fixos e o Benefício planejado.

Para obter mais informações sobre Iniciativas, consulte Visão geral das Iniciativas no Scenario Planner.

Campos diretos

  • customerID

    Este é um objeto interno.

  • duração

    A quantidade de tempo entre endDate e startDate.

  • endDate

    A data de conclusão planejada da iniciativa.

  • enteredByID

    A ID associada ao usuário que enviou a solicitação.

  • ID

    A ID associada à ação

  • IDdaIniciativa

    A ID associada à iniciativa.

  • lastPublishedDate

    A data em que a Iniciativa foi publicada pela última vez no Planejador de cenários do Workfront.

  • nome

    O nome da Iniciativa

  • IDdoPlano

    A ID do plano associado à iniciativa.

  • planName

    O nome do Plano associado à Iniciativa.

  • IDdoProjeto

    A ID do projeto associado à iniciativa.

  • IDdoCenário

    A ID do cenário no Planejador de cenários do Workfront associado à iniciativa.

  • startDate

    A data de início planejada da iniciativa.

Campos de referência

  • cliente

  • enteredBy

  • projeto

Campos principais

  • ID

  • nome

  • objCode

Operações

  • CONTAGEM

  • GET

  • RELATÓRIO

  • PESQUISAR

IssueDef (ISSDEF)

O objeto IssueDef representa um conjunto de dados relativos ao formato dos problemas. Este objeto pode ser anexado a Projetos ou Modelos e afeta os problemas adicionados a esse Projeto ou Modelo.

Campos diretos

  • ID

  • isInlineAddEnabled

Campos principais

  • ID

  • objCode

ObjectIntegration (OBJINT)

Em alguns casos, é possível vincular itens de trabalho do Workfront diretamente a objetos em um produto de software externo. O objeto ObjectIntegration representa esse link.

Campos diretos

  • customerID

    Este é um objeto interno.

  • entryDate

    A data e a hora em que a Integração de objetos foi inserida no Sistema Workfront.

  • ID

    A ID exclusiva do Workfront do objeto ObjectIntegration específico.

  • integrationType

    O software externo com o qual o objeto ObjectIntegration cria um link. Os valores possíveis são:

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • objID

    O objeto no Workfront ao qual a ObjectIntegration está associada.

  • objObjCode

    O código do objeto no Workfront ao qual a ObjectIntegration está associada.

  • parâmetro1

  • parâmetro2

  • param3

  • URL

Campos de referência
  • cliente
Campos principais

  • ID

  • objCode

TaskDef (TSKDEF)

O objeto TaskDef representa um conjunto de dados relativos ao formato de tarefas. Este objeto pode ser anexado a Projetos ou Modelos e afeta as tarefas adicionadas a esse Projeto ou Modelo.

Campos diretos

  • autoCalcPlannedHours

  • ID

Campos de referência
  • defaultApprovalProcess
Campos de coleção
  • objectCategories
Campos principais

  • ID

  • objCode

Aprovação do usuário (USRAPV)

Campos diretos

  • IDdoAprovador

  • customerID

  • ID

  • requestedDate

  • IDdoSolicitante

  • status

  • userID

Campos de referência

  • aprovador

  • cliente

  • solicitante

  • usuário

Campos principais

  • ID

  • objCode

Campos padrão

  • IDdoAprovador

  • IDdoSolicitante

  • status

  • userID

Ações

  • aprovar

  • rejeitar

Operações

  • ADICIONAR

  • CONTAGEM

  • DELETE

  • GET

  • RELATÓRIO

  • PESQUISAR

Recursos removidos

Nenhum recurso foi removido para a API versão 15.

Recursos modificados

AccessLevel (ACSLVL)

Um objeto AccessLevel está associado a usuários e descreve o conjunto de AccessLevelPermissions que determinam o que o usuário pode acessar.

Para obter mais informações sobre níveis de acesso, consulte Níveis de acesso.

Campos diretos

  • fieldAccessPrivileges (string[])

    Foram adicionados os seguintes valores possíveis:

    • VTMAWMG (Exibir equipes associadas aos meus grupos)

    • VALLTM (Exibir todas as equipes)

Permissões de Nível de Acesso (ALVPER)

Um objeto AccessLevelPermissions representa uma permissão específica para acessar, criar ou modificar um objeto Workfront. Essas permissões podem ser associadas a um Nível de acesso.

Campos diretos

  • coreAction (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • forbiddenActions (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • secondaryActions (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

Solicitação de acesso (ACSREQ)

Se um usuário não tiver acesso a um objeto no Workfront necessário, ele poderá solicitar acesso a esse objeto. O objeto AccessRequest representa essa solicitação.

Campos diretos

  • ação (cadeia de caracteres)

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • autoShareAction (cadeia de caracteres)

    Adição do seguinte valor possível:

    • WDL

Regra de acesso (ACSRUL)

Um objeto AccessRule representa um conjunto de regras em níveis de acesso personalizados que determina como os usuários podem compartilhar projetos criados por eles.

Campos diretos

  • coreAction (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • forbiddenActions (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • secondaryActions (string[])

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

Aprovação (APPROVAL)

Um determinado item de trabalho, como uma tarefa, um documento ou uma folha de horas, pode exigir que um supervisor ou outro usuário faça logoff no item de trabalho. Um objeto de Aprovação representa a ação de desconectar em um item de trabalho.

Campos diretos
  • resourcePlannerBudgetedHours
Campos de referência

  • iniciativa

    Adição de.

    O objeto Iniciativa cria estimativas no Planejador de cenários da Workfront para o tipo e o número de funções de trabalho, os Custos fixos e o Benefício planejado.

  • issueDef

    Adição de.

  • taskDef

    Adição de.

Campos de coleção

  • objectIntegrations

    Adição de.

    Em alguns casos, é possível vincular itens de trabalho do Workfront diretamente a objetos em um produto de software externo. O objeto ObjectIntegration representa esse link.

Categoria (CTGY)

Um objeto de Categoria é um formulário personalizado.

Campos diretos

  • catObjCode (cadeia de caracteres)

    Adição do seguinte valor possível:

    • GROUP (Grupo)

  • objTypes (cadeia[])

    Adição de.

    Esse parâmetro é uma matriz de objetos possíveis aos quais o formulário personalizado pode ser anexado. Ele foi adicionado para oferecer suporte à capacidade de anexar um formulário personalizado a vários tipos de objetos.

    Valores possíveis:

    COMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

Campos de coleção

  • objTypes (cadeia[])

    Adição de.

    Esse parâmetro é uma matriz de objetos possíveis aos quais o formulário personalizado pode ser anexado. Ele foi adicionado para oferecer suporte à capacidade de anexar um formulário personalizado a vários tipos de objetos.

    Valores possíveis:

    COMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

Parâmetro da categoria (CTGYPA)

Campos diretos

  • ocultarFórmulaDaDescrição

    Adição de.

  • journaledObjCodes

    Adição de.

  • rawCustomExpression

    Adição de.

Preferências do cliente (CUSTPR)

Um objeto CustomerPreferences representa o conjunto de preferências que um cliente definiu para sua instância do Workfront.

Campos diretos

  • nome

    Os seguintes valores foram adicionados:

    • password:sharePointV2IntegrationEnabled (Integração do SharePoint (API gráfica) ativada)

      Este valor oferece suporte à integração atualizada com o Sharepoint.

    • project.mgmt:default.project.allowcreatewithouttemplate (Permitir que os usuários criem projetos sem usar um modelo)

    • project.mgmt:taskissue.delegate (config.taskissue.delegate)

DocumentFolder (DOCFDR)

Os documentos podem ser organizados em pastas. Você pode criar pastas pessoais na área Documentos pessoal. O objeto DocumentFolder representa uma dessas pastas.

O objeto DocumentFolder adicionou o sinalizador SHARABLE.

Versão do documento (DOCV)

Um objeto DocumentVersion representa uma versão específica de um arquivo (como material escrito, imagens ou outras formas de informação).

Para obter mais informações sobre versões de documentos, consulte Carregar uma nova versão de um documento.

Campos diretos

  • externalIntegrationType

    Adição do seguinte valor:

    • SHAREPOINT_V2 (SharePoint (Graph API))

      Este valor oferece suporte à integração atualizada com o Sharepoint.

Grupo (GRUPO)

Um objeto Grupo representa um conjunto de usuários e equipes. Os grupos geralmente representam a estrutura departamental.

Para obter mais informações sobre grupos, consulte Grupos versus equipes.

O objeto Group adicionou o sinalizador DATA_EXTENDIBLE

Campos diretos

Os seguintes campos foram adicionados:

  • categoryID

    Uma categoria é um formulário personalizado. Esse parâmetro foi adicionado para oferecer suporte à capacidade de adicionar Forms personalizado a objetos de Grupo.

  • estáAtivo

    Este é um parâmetro booleano cujo valor é verdadeiro se um objeto estiver Ativo e falso se não estiver. Os objetos definidos como Ativos aparecem em menus suspensos e campos de digitação antecipada e podem ser anexados a outros objetos.

Campos de referência

Os seguintes campos foram adicionados:

  • aprovador

  • cliente

  • solicitante

  • usuário

Campos de coleção

Os seguintes campos foram adicionados:

  • objectCategories

  • objectIntegrations

    Em alguns casos, é possível vincular itens de trabalho do Workfront diretamente a objetos em um produto de software externo. O objeto ObjectIntegration representa esse link.

Campos padrão

O seguinte campo foi adicionado:

  • estáAtivo

    Este é um parâmetro booleano cujo valor é verdadeiro se um objeto estiver Ativo e falso se não estiver. Os objetos definidos como Ativos aparecem em menus suspensos e campos de digitação antecipada e podem ser anexados a outros objetos.

Ações

Os seguintes campos foram adicionados:

  • calculateDataExtension

    Esta ação recalcula as expressões em campos de formulário personalizados.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

JournalEntry (JRNLE)

O objeto JournalEntry pode ser configurado para registrar informações sobre campos de objeto específicos sempre que esses campos forem modificados. Quando um campo é configurado para ser registrado como parte do objeto de Entrada de diário, uma Entrada de diário correspondente será criada toda vez que o campo for modificado.

Campos diretos

changeType

Adição do seguinte valor:

  • DW (Download)

LinkedFolder (LNKFDR)

Um objeto LinkedFolder representa uma pasta vinculada de um provedor de documentos externo, como Google Drive ou Dropbox.

Para obter mais informações sobre Pastas vinculadas, consulte Vincular documentos de aplicativos externos.

Campos diretos

  • externalIntegrationType

    Adição do seguinte valor:

    • SHAREPOINT_V2 (SharePoint (Graph API))

      Este valor oferece suporte à integração atualizada com o Sharepoint.

OpTask/Problema (OPTASK)

Um objeto OpTask é comumente conhecido como um Problema. Um problema é um item de trabalho que geralmente indica que há um problema que impede a conclusão de uma tarefa ou projeto. Um problema também pode ser uma solicitação de Help Desk. Pedidos de alteração, solicitações e bugs também são problemas.

Ações

As seguintes ações foram adicionadas:

  • bulkMoveWithOptions

  • getRequestPath

A seguinte ação foi modificada:

  • copyIssue

    Campo adicionado parentID

Parâmetro (PARAM)

Um objeto Parameter é um campo personalizado.

Campos diretos

O seguinte campo foi adicionado:

  • fieldDefinition

Os seguintes campos foram modificados:

  • dataType

    Adicionado o valor possível WIDGET (Widget)

    Este valor suporta o uso de imagens em formulários personalizados.

  • displayType

    Adicionado o valor possível WIDGET (Widget)

    Este valor suporta o uso de imagens em formulários personalizados.

Portfolio (PORTA)

Um objeto Portfolio é uma coleção de projetos que competem pelos mesmos recursos, normalmente dinheiro ou pessoas para concluí-los.

Campos de coleção
  • objectIntegrations
Ações

  • linkExternalObject

  • unlinkExternalObject

Programa (PRGM)

Um objeto Programa é um subconjunto de projetos em um portfólio, em que projetos semelhantes podem ser agrupados.

Campos de coleção
  • objectIntegrations
Ações

  • linkExternalObject

  • unlinkExternalObject

Projeto (PROJ)

Os projetos são itens de trabalho no Workfront e um elemento principal da maneira como o Workfront ajuda as pessoas a trabalhar. Um objeto Projeto representa um grupo de tarefas com uma meta comum e específica.

Campos diretos
  • resourcePlannerBudgetedHours
Campos de referência

  • iniciativa

    O objeto Iniciativa cria estimativas no Planejador de cenários da Workfront para o tipo e o número de funções de trabalho, os Custos fixos e o Benefício planejado.

  • issueDef

  • taskDef

Campos de coleção

  • objectIntegrations

    Em alguns casos, é possível vincular itens de trabalho do Workfront diretamente a objetos em um produto de software externo. O objeto ObjectIntegration representa esse link.

QueueDef (QUED)

Um objeto QueueDef representa uma Fila, que é um projeto publicado na área Help Desk para permitir que os usuários enviem problemas a ele.

Para obter mais informações sobre Filas de solicitações, consulte Criar uma fila de solicitações.

Campos diretos

  • solicitanteCoreAction

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

  • solicitanteForbiddenActions

    Foram adicionados os seguintes valores possíveis:

    • EDIT_TEAMS_I_AM_ON (Editar equipes em que estou)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipes nos grupos que eu gerencio (somente Administradores de grupo))

ScoreCardQuestion (SCOREQ)

Um objeto ScoreCardQuestion representa uma pergunta que foi adicionada a um Scorecard. Essas perguntas geralmente são determinadas pelo gerente de Portfolio, e suas respostas permitem que o gerente entenda como um projeto se alinha com as metas do portfólio.

Para obter mais informações sobre Perguntas do Scorecard, consulte Criar um scorecard.

Campos diretos

  • displayType

    Adicionado o valor possível WIDGET (Widget)

Tarefa (TASK)

Um objeto Tarefa representa um item de trabalho que deve ser executado como uma etapa para atingir uma meta final (concluir um Projeto).

Campos de coleção

  • objectIntegrations

    Em alguns casos, é possível vincular itens de trabalho do Workfront diretamente a objetos em um produto de software externo. O objeto ObjectIntegration representa esse link.

Modelo (TMPL)

Um objeto Modelo representa um padrão para um projeto. Os projetos podem ser criados a partir de modelos para economizar tempo. Um modelo contém uma equipe e tarefas, que serão copiadas para qualquer projeto criado a partir do modelo.

Campos de referência

  • issueDef

  • taskDef

Planilha de horas (TSHET)

Um objeto de Planilha de Horas representa um cartão de ponto virtual que permite aos Usuários inserir as horas reais trabalhadas para Tarefas, Projetos e Tipos de Horas Gerais.

Campos principais

O seguinte campo foi removido:

  • objCode

Visualização (UIVIEW)

Campos diretos

  • uiviewType

    Os seguintes valores possíveis foram removidos:

    • FOUR_COL (Layout de quatro colunas)

    • UPDATES (Atualizações)

    • UPDATESTOOLBAR_FEED (Atualizações)

    • WORKINGON (Trabalhando Em)

    • CUSTOMDATA (Dados personalizados)

    • CUSTOMDATA_UPDATE (Atualizar dados personalizados)

    • STATUS_UPDATE (Atualização de Status)

    • OPTASK_STATUS_UPDATE (Atualização de Status)

    • PROJ_STATUS_UPDATE (Atualização de Status)

    • PROJECT_TIMEENTRY (Atualização de Status)

    • DLIST (Lista Detalhada)

    • DLIST_SECTION (Seção Lista Detalhada)

Atualizar (UPDATE)

Os itens de trabalho no Workfront podem ser atualizados para manter os usuários informados sobre o status atual. Um objeto Update representa uma dessas atualizações. As atualizações podem ser inseridas por usuários ou criadas pelo sistema do Workfront.

Campos diretos

  • updateType

    Adicionado o valor possível documentVersionDownload (enum.updatetypeenum.documentversiondownload)

Usuário (USER)

Um objeto Usuário representa uma pessoa com uma conta no Workfront que pode fazer logon e interagir com o sistema.

Campos de referência
  • userApproval
Ações

  • getUsersAvailableTime

  • redefinirSenhaRopg

Nota de Usuário (USRNOT)

Um objeto UserNote é uma notificação.

Campos diretos

  • eventType

    Foram adicionados os seguintes valores possíveis:

    • DUP (Solicitou que você revise um documento)

    • DUV (Permite que você exiba um documento)