Novedades de la versión 17 de la API

Adobe Workfront lanzó la versión 17 de la API el 12 de octubre de 2023. La versión 17 de la API incorpora los siguientes cambios con respecto a la versión 16.

Recursos añadidos

Documento externo (EXTDOC)

Un objeto ExternalDocument es un documento u otro recurso digital que se encuentra en un proveedor de almacenamiento de documentos externo a Workfront. Estos recursos se pueden vincular desde y hacia Workfront.

Campos directos
  • dateModified

  • description

  • documentProviderID

  • ext.

  • fileType

  • iconURL

  • Identificador

  • name

  • ruta

  • providerType

  • readOnly

  • talla

  • thumbnailURL

Campos principales
  • dateModified

  • description

  • documentProviderID

  • ext.

  • fileType

  • iconURL

  • Identificador

  • isGoogleRootItem

  • isTeamDriveItem

  • name

  • objCode

  • ruta

  • providerType

  • readOnly

  • talla

  • thumbnailURL

  • valor

Campos predeterminados
  • Identificador

  • name

  • objCode

Acciones
  • browseListWithLinkAction

  • getDocumentDownloadUrl

  • getRootFolderID

  • getRootFolderIDFromDB

  • linkExternalDocumentObjects

  • setLinkedFolderMetadata

Consultas
  • browseList

  • getFolderMetaData

  • searchExternalDocuments

Operaciones
  • SEARCH

UserLocation (USRLOC)

Campos directos
  • classifierID

  • customerID

  • endDate

  • Identificador

  • isCurrent

  • startDate

  • userID

Campos de referencia
  • cliente

  • usuario

Campos principales
  • Identificador

  • objCode

Recursos eliminados

No se han eliminado recursos para la versión 17 de la API

Recursos modificados

Se modificaron los siguientes recursos para la versión 17 de la API.

Línea base (BLIN)

Las líneas de base son instantáneas del aspecto que tuvo el rendimiento de un proyecto en un momento determinado. Almacenan información clave sobre el proyecto, como fechas clave, progreso, valores de costes e ingresos.

El objeto Baseline quitó el indicador INLINE_EDITABLE.

Registro de facturación (FACTURA)

Un objeto BillingRecord registra los ingresos, horas o gastos que se pueden facturar. Esta información se puede utilizar para crear facturas en un sistema de contabilidad externo.

El objeto BillingRecord quitó el indicador INLINE_EDITABLE.

Empresa (CMPY)

Un objeto Company representa una organización formada por una colección de personas.

Campos directos
  • defaultInterface

    Eliminado

Preferencias del cliente (CUSTPR)

Un objeto CustomerPreferences representa el conjunto de preferencias que un cliente ha establecido para su instancia de Workfront.

Campos directos
  • nombre

    Se ha agregado el posible valor "config.defaultToNewHomeDescription" (customer:config.defaultToNewHome)>/p?

    Esto permite a una organización hacer que la nueva experiencia de Inicio sea la predeterminada para sus usuarios.

DocumentVersion (DOCV)

Un objeto DocumentVersion representa una versión específica de un archivo (como material escrito, imágenes u otras formas de información).

Campos directos
  • externalIntegrationType

    Se ha añadido el valor posible "Frame.io" (FRAMEIO)

  • tipoDeArchivo

    Se ha agregado el posible valor "enum.filetype.site" (site)

Tipo de cambio (EXRATE)

Un objeto ExchangeRate representa un tipo de cambio de divisa configurado en Workfront. Los objetos ExchangeRate no son dinámicos.

Campos directos

Se agregaron los campos siguientes:

  • endDate

  • startDate

Acciones
  • getCustomerCurrencies

    Añadido.

Gasto (EXPNS)

Los gastos representan los costos no laborales en los que se podría incurrir durante la duración de un proyecto.

El objeto Expense eliminó el marcador INLINE_EDITABLE.

Grupo (GROUP)

Un objeto Group representa un conjunto de usuarios y equipos. Los grupos a menudo representan la estructura departamental.

Campos directos
  • defaultInterface

    Eliminado

Hora (HORA)

Un objeto Hour representa una hora registrada por un usuario en una plantilla de horas.

El objeto Hour quitó el indicador INLINE_EDITABLE.

Iteración (ITRN)

Un objeto Iteration representa una sola iteración Agile. Las iteraciones son períodos de tiempo discretos que se utilizan para planificar y completar historias de Agile.

El objeto Iteration quitó el marcador INLINE_EDITABLE.

Entrada de diario (JRNLE)

El objeto JournalEntry se puede configurar para que registre información sobre campos de objeto específicos cada vez que se modifiquen dichos campos. Cuando un campo está configurado para registrarse como parte del objeto Entrada de cuaderno, se creará una Entrada de cuaderno correspondiente cada vez que se modifique ese campo.

Campos directos
  • changeType

    Se agregaron los siguientes valores posibles:

    • Aprobador agregado (AAA)
    • Se ha agregado un revisor (AAR)
    • Revisor eliminado (ARR)
    • Aprobador eliminado (ARA)
    • Decisión aprobada (ADA)
    • Decisión aprobada con cambios (ADC)
    • La decisión necesita trabajo (ADN)
    • Decisión revocada (ADR)
    • Aprobador cambiado (AAC)
    • Revisor cambiado (ARC)
    • Revisión finalizada (RDC)
    • Revisión revocada (RDR)
    • Publish (PUB)

Panel Kanban (KNBNBD)

Se utiliza un panel Kanban para realizar el seguimiento de tareas en un entorno Agile.

El objeto Panel Kanban eliminó el indicador INLINE_EDITABLE.

LinkedFolder (LNKFDR)

Un objeto LinkedFolder representa una carpeta vinculada desde un proveedor de documentos externo, como Google Drive o Dropbox.

Campos directos
  • externalIntegrationType

    Se ha agregado el valor posible "Frame.io (FRAMEIO)

OpTask / Problema (OPTASK)

Un objeto OpTask suele conocerse como Problema. Un problema es un elemento de trabajo que normalmente indica que hay un problema que impide la finalización de una tarea o proyecto. Un problema también puede ser una solicitud del servicio de asistencia. Las solicitudes de cambio, las solicitudes y los errores también son problemas.

El objeto Issue eliminó el indicador INLINE_EDITABLE.

Proyecto (PROJ)

Los proyectos son elementos de trabajo dentro de Workfront y son un bloque de creación principal en la forma en que Workfront ayuda a las personas a realizar su trabajo. Un objeto Project representa un grupo de tareas con un objetivo común y específico.

El objeto Project quitó el marcador INLINE_EDITABLE.

Usuario de proyecto (PRTU)

Un objeto ProjectUser representa un usuario asociado a un proyecto específico.

Campos directos
  • ID

    Añadido.

Campos principales
  • ID

    Añadido.

Tasa (TASA)

Un objeto Rate representa una tarifa de facturación en Workfront.

El objeto Rate quitó el marcador INLINE_EDITABLE.

Acciones

Se han agregado las siguientes acciones para admitir la funcionalidad Tarjeta de tarifa:

  • deleteRateForRole

  • editRatesForRole

  • getUsedClassifierIds

  • setRatesFromRateCard

La acción setRatesForRole se ha modificado para agregar los campos siguientes:

  • classifierID
  • currencyCode
  • sourceRateCardID

Riesgo (RIESGO)

Un objeto Risk representa un posible evento que puede impedir que un proyecto finalice a tiempo o dentro del presupuesto. Se añaden riesgos a los proyectos en la fase de planificación para identificar posibles obstáculos antes de la aprobación de cualquier trabajo.

El objeto Risk quitó el marcador INLINE_EDITABLE.

Rol / Rol (ROLE)

Un objeto Role (función del puesto) representa una capacidad funcional o un conjunto de aptitudes que un usuario podría completar, como Designer o Product Manager.

Campos directos
  • defaultInterface

    Eliminado

Tarea (TAREA)

Un objeto Task representa un elemento de trabajo que debe realizarse como un paso hacia el logro de un objetivo final (completar un proyecto).

El objeto Task quitó el marcador INLINE_EDITABLE.

Equipo (TEAMOB)

Un objeto Team es una colección de usuarios que se pueden asignar a un elemento de trabajo.

Campos directos
  • defaultInterface

    Eliminado

Miembro del equipo (TEAMMB)

Un objeto TeamMember es un usuario asociado a un equipo específico.

Campos directos
  • ID

    Añadido.

Campos principales
  • ID

    Añadido.

Usuario de plantilla (TMTU)

Campos directos
  • ID

    Añadido.

Campos principales
  • ID

    Añadido.

Hoja de horas (TSHET)

Un objeto Timesheet representa un parte de horas virtual que permite a los usuarios especificar horas trabajadas reales para tareas, proyectos y tipos de horas generales.

Campos directos
  • objCode

    Eliminado

Actualizar (UPDATE)

Los elementos de trabajo de Workfront se pueden actualizar para mantener a los usuarios informados del estado actual. Un objeto Update representa una de estas actualizaciones. Los usuarios pueden introducir actualizaciones o el sistema de Workfront puede crearlas.

Campos directos
  • changeType

    Se agregaron los siguientes valores:

    • Aprobador agregado (assetapprovalAddApprover)
    • Se ha agregado un revisor (assetapprovalAddReviewer)
    • Aprobador eliminado (assetapprovalRemoveApprover)
    • Revisor eliminado (assetapprovalRemoveReviewer)
    • Decisión aprobada (assetapprovalDecisionApproved)
    • La decisión necesita trabajo (assetapprovalDecisionNeedsWork)
    • Decisión aprobada con cambios (assetapprovalDecisionApprovedChanges)
    • Decisión revocada (assetapprovalDecisionRevked)
    • Aprobador modificado (assetapprovalApproverChanged)
    • Revisor modificado (assetapprovalReviewerChanged)
    • Revisión completa (assetapprovalReviewerDecisionComplete)
    • Revisión revocada (assetapprovalReviewerDecisionRevked)
    • Error de envío de documento externo (externalDocumentSendError)
    • Versión de documento publicada (documentVersionPublish)
    • Flujo de trabajo de carpeta vinculada (linkedFolderWorkflow)

Usuario (USER)

Un objeto User representa a una persona con una cuenta en Workfront que puede iniciar sesión e interactuar con el sistema.

El objeto User quitó el marcador INLINE_EDITABLE.

Campos directos
  • tiempoDeTrabajo

    Este campo se ha agregado y es un número entre 0 y 1 que representa el porcentaje de tiempo que un usuario puede dedicar al trabajo del proyecto (trabajo no general) cada día. El valor 1 significa que el usuario puede dedicar el 100% de su tiempo al trabajo del proyecto.

Campos de colección
  • userLocations

Grupos de usuarios (USRGPS)

Campos directos
  • ID

    Añadido.

Campos principales
  • ID

    Añadido.

UserNote (USRNOT)

Un objeto UserNote es una notificación.

Campos directos
  • changeType

    Se agregaron los siguientes valores:

    • El documento necesita su aprobación (AAA)
    • El documento necesita su revisión (AAR)
    • El documento ya no necesita su aprobación (ARA)
    • El documento ya no necesita su revisión (ARR)
    • El documento necesita la aprobación (ATA) del usuario
    • Documento necesita revisión (ATR) del usuario
    • El documento ya no necesita la aprobación de (usuario) (RTA)
    • El documento ya no necesita revisión (RTR) del usuario
    • Documento aprobado (ADA)
    • Documento aprobado con cambios (ADC)
    • El documento necesita trabajo (AND)
    • (Usuario) ha marcado (documento) como aprobado. Ya no necesita su aprobación. (AAN)
    • (Usuario) ha marcado (documento) como aprobado con cambios. Ya no necesita su aprobación. (ACN)
    • (Usuario) ha marcado (documento) como necesita trabajar. Ya no necesita su aprobación. (AWN)
    • El documento necesita su revisión ahora, no su aprobación (AAC)
    • El documento necesita su aprobación ahora, en lugar de una revisión (Y)
    • Documento revisado (RDC)
    • Documento revisado (TRC)
    • (Usuario) ha revisado (documento) como completado. Ya no necesita su revisión. (TRN)

UserRole (USROL)

Campos directos
  • ID

    Añadido.

Campos principales
  • ID

    Añadido.

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