Novidades da API versão 17

O Adobe Workfront lançou a API versão 17 em 12 de outubro de 2023. A API versão 17 apresenta as seguintes alterações da versão 16.

Recursos adicionados

Documento externo (EXTDOC)

Um objeto ExternalDocument é um documento ou outro ativo digital localizado em um provedor de armazenamento de documentos externo ao Workfront. Esses ativos podem ser vinculados ao Workfront e vice-versa.

Campos diretos
  • dateModified

  • descrição

  • documentProviderID

  • ext

  • fileType

  • iconURL

  • ID

  • name

  • caminho

  • providerType

  • readOnly

  • tamanho

  • thumbnailURL

Campos principais
  • dateModified

  • descrição

  • documentProviderID

  • ext

  • fileType

  • iconURL

  • ID

  • isGoogleRootItem

  • isTeamDriveItem

  • name

  • objCode

  • caminho

  • providerType

  • readOnly

  • tamanho

  • thumbnailURL

  • value

Campos padrão
  • ID

  • name

  • objCode

Ações
  • browseListWithLinkAction

  • getDocumentDownloadUrl

  • getRootFolderID

  • getRootFolderIDFromDB

  • linkExternalDocumentObjects

  • setLinkedFolderMetadata

Consultas
  • browseList

  • getFolderMetaData

  • searchExternalDocuments

Operações
  • SEARCH

UserLocation (USRLOC)

Campos diretos
  • classifierID

  • customerID

  • endDate

  • ID

  • isCurrent

  • startDate

  • userID

Campos de referência
  • cliente

  • usuário

Campos principais
  • ID

  • objCode

Recursos removidos

Nenhum recurso foi removido para a API versão 17

Recursos modificados

Os recursos a seguir foram modificados para a API versão 17.

Linha de base (BLIN)

Linhas de Base são instantâneos de como era o desempenho de um projeto em um determinado momento. Eles armazenam informações importantes sobre o projeto, como datas importantes, progresso, valores de custo e receita.

O objeto de Linha de Base removeu o sinalizador INLINE_EDITABLE.

Registro de Cobrança (BILL)

Um objeto BillingRecord registra a receita, as horas ou as despesas que podem ser faturadas. Essas informações podem ser usadas para criar faturas em um sistema de contabilidade externo.

O objeto BillingRecord removeu o sinalizador INLINE_EDITABLE.

Empresa (CMPY)

Um objeto Company representa uma organização que consiste em uma coleção de pessoas.

Campos diretos
  • InterfacePadrão

    Removido

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

    Adição do valor possível "config.defaultToNewHomeDescription" (customer:config.defaultToNewHome)>/p?

    Isso permite que uma organização torne a nova experiência da Página inicial a padrão para seus usuários.

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).

Campos diretos
  • externalIntegrationType

    Adição do possível valor "Frame.io" (FRAMEIO)

  • tipoArquivo

    Adição do possível valor "enum.filetype.site" (site)

Taxa de Câmbio (EXRATE)

Um objeto ExchangeRate representa uma taxa de câmbio de moeda configurada no Workfront. Os objetos ExchangeRate não são dinâmicos.

Campos diretos

Os seguintes campos foram adicionados:

  • endDate

  • startDate

Ações
  • getCustomerCurrencies

    Adição de.

Despesa (EXPNS)

As despesas representam os custos não mão de obra que podem ser incorridos durante a vida útil de um projeto.

O objeto Expense removeu o sinalizador INLINE_EDITABLE.

Grupo (GRUPO)

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

Campos diretos
  • InterfacePadrão

    Removido

Hora (HORA)

Um objeto Hour representa uma hora registrada por um usuário em uma folha de horas.

O objeto Hour removeu o sinalizador INLINE_EDITABLE.

Iteração (ITRN)

Um objeto de Iteração representa uma única Iteração Agile. Iterações são períodos discretos usados para planejar e concluir histórias Agile.

O objeto de Iteração removeu o sinalizador INLINE_EDITABLE.

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

    Foram adicionados os seguintes valores possíveis:

    • Aprovador adicionado (AAA)
    • Revisor adicionado (AAR)
    • Revisor removido (ARR)
    • Aprovador removido (ARA)
    • Decisão aprovada (ADA)
    • Decisão aprovada com alterações (ADC)
    • A decisão precisa de trabalho (ADN)
    • Decisão revogada (RAL)
    • Aprovador alterado (AAC)
    • Revisor alterado (ARC)
    • Revisão concluída (RDC)
    • Revisão revogada (RDR)
    • Publish (PUB)

Quadro Kanban (KNBNBD)

Um quadro Kanban é usado para rastrear tarefas em um ambiente Agile.

O objeto do Quadro Kanban removeu o sinalizador INLINE_EDITABLE.

LinkedFolder (LNKFDR)

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

Campos diretos
  • externalIntegrationType

    Valor possível adicionado "Frame.io (FRAMEIO)

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.

O objeto Problema removeu o sinalizador INLINE_EDITABLE.

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.

O objeto Project removeu o sinalizador INLINE_EDITABLE.

Usuário de Projeto (PRTU)

Um objeto ProjectUser representa um usuário associado a um projeto específico.

Campos diretos
  • ID

    Adição de.

Campos principais
  • ID

    Adição de.

Taxa (RATE)

Um objeto de Taxa representa uma taxa de cobrança no Workfront.

O objeto Rate removeu o sinalizador INLINE_EDITABLE.

Ações

As seguintes ações foram adicionadas para oferecer suporte à funcionalidade Cartão de taxa:

  • deleteRateForRole

  • editRatesForRole

  • getUsedClassifierIds

  • setRatesFromRateCard

A ação setRatesForRole foi modificada para adicionar os seguintes campos:

  • classifierID
  • currencyCode
  • sourceRateCardID

Risco (RISK)

Um objeto de Risco representa um evento possível que pode impedir que um projeto seja concluído no prazo ou dentro do orçamento. Os riscos são adicionados aos projetos na fase de planejamento para identificar possíveis obstáculos antes da aprovação de qualquer trabalho.

O objeto Risk removeu o sinalizador INLINE_EDITABLE.

Função/Função (ROLE)

Um objeto Função (função de trabalho) representa uma capacidade funcional ou um conjunto de habilidades que um usuário pode preencher, como Designer ou Gerente de produto.

Campos diretos
  • InterfacePadrão

    Removido

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).

O objeto Task removeu o sinalizador INLINE_EDITABLE.

Equipe (TEAMOB)

Um objeto Equipe é uma coleção de Usuários que pode ser atribuída a um item de trabalho.

Campos diretos
  • InterfacePadrão

    Removido

Integrante da equipe (TEAMMB)

Um objeto TeamMember é um usuário associado a uma equipe específica.

Campos diretos
  • ID

    Adição de.

Campos principais
  • ID

    Adição de.

TemplateUser (TMTU)

Campos diretos
  • ID

    Adição de.

Campos principais
  • ID

    Adição de.

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 diretos
  • objCode

    Removido

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
  • changeType

    Os seguintes valores foram adicionados:

    • Aprovador adicionado (assetapprovalAddApprover)
    • Revisor adicionado (assetapprovalAddReviewer)
    • Aprovador removido (assetapprovalRemoveApprover)
    • Revisor removido (assetapprovalRemoveReviewer)
    • Decisão aprovada (assetapprovalDecisionApproved)
    • A decisão precisa de trabalho (assetapprovalDecisionNeedsWork)
    • Decisão aprovada com alterações (assetapprovalDecisionApprovedChanges)
    • Decisão revogada (assetapprovalDecisionRevoked)
    • Aprovador alterado (assetapprovalApproverChanged)
    • Revisor alterado (assetapprovalReviewerChanged)
    • Revisão concluída (assetapprovalReviewerDecisionComplete)
    • Revisão revogada (assetapprovalReviewerDecisionRevoked)
    • Erro de envio de documento externo (externalDocumentSendError)
    • Versão do documento publicada (documentVersionPublish)
    • Fluxo de trabalho de pasta vinculado (linkedFolderWorkflow)

Usuário (USER)

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

O objeto User removeu o sinalizador INLINE_EDITABLE.

Campos diretos
  • horárioTrabalho

    Este campo foi adicionado e é um número entre 0 e 1 que representa a porcentagem de tempo que um usuário pode gastar no trabalho do projeto (trabalho não administrativo) a cada dia. Um valor de 1 significa que o usuário pode gastar 100% de seu tempo no trabalho do projeto.

Campos de coleção
  • userLocations

Grupos de usuários (USRGPS)

Campos diretos
  • ID

    Adição de.

Campos principais
  • ID

    Adição de.

Nota de Usuário (USRNOT)

Um objeto UserNote é uma notificação.

Campos diretos
  • changeType

    Os seguintes valores foram adicionados:

    • O documento precisa de sua aprovação (AAA)
    • O documento precisa de sua revisão (AAR)
    • O documento não precisa mais de sua aprovação (ARA)
    • O documento não precisa mais de sua revisão (ARR)
    • Necessidades de documento (usuário) para aprovação (ATA)
    • Revisão (ATR) das necessidades do documento (usuário)
    • O documento não precisa mais da aprovação (RTA) do (usuário)
    • O documento não precisa mais da revisão (RTR) do (usuário)
    • Documento aprovado (ADA)
    • Documento aprovado com alterações (ADC)
    • O documento precisa de trabalho (ADN)
    • (Usuário) marcou (documento) como aprovado. Sua aprovação não é mais necessária. AAN)
    • (Usuário) marcou (documento) como aprovado com alterações. Sua aprovação não é mais necessária. (ACN)
    • (Usuário) marcou (documento) como precisa do trabalho. Sua aprovação não é mais necessária. (AWN)
    • O documento precisa de sua revisão agora em vez de aprovação (AAC)
    • O documento precisa de sua aprovação agora em vez de uma revisão (ADN)
    • Documento revisado (RDC)
    • Documento revisado (TRC)
    • (Usuário) revisou (documento) como concluído. Sua revisão não é mais necessária. TRN)

Função do usuário (USRROL)

Campos diretos
  • ID

    Adição de.

Campos principais
  • ID

    Adição de.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43